Modificateurs d'apparence de l'UI

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

En utilisant des modificateurs d'apparence, vous pouvez personnaliser davantage l'apparence de vos GuiObjects.

Dégradé

L'objet UIGradient applique un dégradé de couleur et de transparence à son parent GuiObject.

Vous pouvez configurer le dégradé en :

Séquence de couleurs

Pour définir la séquence de couleurs d'un dégradé :

  1. Dans la fenêtre Explorateur, sélectionnez le UIGradient.

  2. Dans la fenêtre Propriétés, cliquez dans le champ de propriété Color, puis cliquez sur le bouton ⋯ à droite de la zone de saisie.

  3. Chaque triangle sur l'axe inférieur de la séquence de couleurs est un point clé qui détermine la valeur de couleur à ce point.

    Fenêtre contextuelle de séquence de couleurs de blanc à blanc
    1. Cliquez sur un point clé dans la séquence de couleurs pour le sélectionner ou le repositionner, ou ajoutez un autre point clé en cliquant n'importe où sur le graphique.
    2. Cliquez sur le petit carré à côté de Couleur pour ouvrir la fenêtre contextuelle Couleurs, puis sélectionnez la couleur souhaitée pour le point clé.
    3. Si nécessaire, répétez ces étapes pour ajouter/ajuster les couleurs sur le graphique.

Transparence

Pour ajuster la transparence d'un dégradé sur sa plage :

  1. Dans la fenêtre Explorateur, sélectionnez le UIGradient.

  2. Dans la fenêtre Propriétés, cliquez dans le champ de propriété Transparency, puis cliquez sur le bouton ⋯ à droite de la zone de saisie.

  3. Chaque carré sur le graphique de la séquence numérique est un point clé qui détermine la valeur de transparence à ce point.

    Points clés étiquetés dans la fenêtre contextuelle de séquence numérique
    1. Cliquez sur un point clé dans la séquence numérique pour le sélectionner ou le repositionner, ou ajoutez un autre point clé en cliquant n'importe où sur le graphique.
    2. Entrez une combinaison de temps/valeur spécifique via les entrées Temps et Valeur.
    3. Si nécessaire, répétez ces étapes pour ajouter/ajuster les niveaux de transparence sur le graphique.

Type

La propriété Type d'un dégradé définit son type parmi Linear, Radial, Elliptical, ou Conical.

  • Linear — La séquence de couleur/transparence se transitionne en ligne droite à travers l'élément. La direction est contrôlée par sa rotation et la position par son décalage. C'est le paramètre par défaut.

  • Radial — La séquence de couleur/transparence rayonne vers l'extérieur depuis le centre de l'élément, éventuellement décalée par Offset. Le rayon est défini par la moyenne de la largeur et de la hauteur de l'élément divisée par deux, soit (largeur+hauteur)/4\text{(largeur+hauteur)/4}. Rotation n'a aucun effet sur un dégradé radial.

  • Elliptical — La séquence de couleur/transparence rayonne vers l'extérieur depuis le centre de l'élément en ellipse, éventuellement décalée par Offset. Les rayons horizontal et vertical de l'ellipse sont la moitié de la largeur et de la hauteur de l'élément, de sorte que l'ellipse s'adapte aux limites de l'élément. Rotation fait pivoter les axes de l'ellipse.

  • Conical — La séquence de couleur/transparence balaye dans le sens des aiguilles d'une montre autour du centre de l'élément, éventuellement décalée par Offset. Rotation contrôle l'angle de départ et de fin du balayage. Par défaut, cela balaye de 0 à 360 degrés, mais des valeurs de Scale inférieures à 1 peuvent réduire cet angle.

Décalage et rotation

Les propriétés Offset et Rotation vous permettent d'ajuster les points de contrôle du dégradé et son angle. Comme illustré dans les diagrammes suivants, Offset est basé sur un pourcentage de la largeur ou de la hauteur du parent, et les valeurs positives ou négatives sont valides.

Offset.X = 0.25
Offset.X = -0.25

De même, lorsque vous faites pivoter le dégradé, les points de contrôle tournent également :

Échelle

L'échelle Scale d'un dégradé multiplie l'étendue du dégradé, contrôlant combien de la séquence de couleur/transparence est visible dans l'élément.

  • Lorsque Scale est inférieur à 1, le dégradé s'étend sur moins que l'étendue complète. La couleur/transparence restante est remplie selon la propriété TileMode.

  • Lorsque Scale est supérieur à 1, le dégradé s'étend sur plus que l'étendue complète et seule une partie de la couleur/transparence est visible.

  • Pour les dégradés Elliptical, Scale affecte les deux rayons de l'ellipse.

Scale = 1
Scale = 0.25
Scale = 1.8

Mode de tuilage

La propriété TileMode définit comment le dégradé se répète lorsque la séquence complète ne couvre pas entièrement l'élément parent.

  • Clamp — Mode par défaut où les valeurs de couleur/transparence au début et à la fin de la séquence s'étendent à l'infini, de sorte que les valeurs de départ remplissent toute zone avant le dégradé et les valeurs de fin remplissent toute zone après.

  • Repeat — Le dégradé se répète en enveloppant les tuiles de séquence de couleur/transparence de manière transparente de la fin au début. Cela peut produire une couture visible si les premières et dernières valeurs de couleur/transparence dans la séquence diffèrent.

  • Mirror — Le dégradé se reflète à chaque frontière, de sorte que la séquence de couleur/transparence ping-pong. Cela produit une répétition fluide sans couture, car la direction s'inverse à chaque bord de tuile.

Contour

L'instance UIStroke applique un contour au texte ou à une bordure. Les caractéristiques clés incluent :

Épaisseur

Vous pouvez définir la largeur du contour via la propriété Thickness, qui est mesurée en pixels (par défaut) ou mise à l'échelle par rapport au parent, selon le StrokeSizingMode du modificateur. Si le contour est sur du texte et que StrokeSizingMode est défini sur ScaledSize, l'épaisseur est relative à la taille de la police.

Couleur ou dégradé

Vous pouvez définir la couleur du contour via la propriété Color, ainsi qu'insérer une instance enfant UIGradient pour créer des contours dégradés.

UIStroke.Color = (0, 95, 225)
UIStroke avec enfant UIGradient

Contour de texte ou bordure

Selon son type de parent, UIStroke fonctionne soit comme un contour de texte, soit comme une bordure. Lorsque vous parenté UIStroke à un objet texte comme TextLabel, il s'applique au contour du texte ; lorsque vous parenté UIStroke à d'autres GuiObjects, il s'applique à la bordure.

TextLabel avec enfant UIStroke
Frame avec UIStroke et UICorner enfants

Lorsqu'il est appliqué à un objet texte, vous pouvez remplacer le comportement par défaut du contour par la propriété ApplyStrokeMode, vous permettant d'appliquer le contour aux limites de l'objet plutôt qu'au texte lui-même. Vous pouvez même contrôler indépendamment le contour de texte et la bordure en parentant deux instances UIStroke à un objet texte, l'une définie sur Contextuel et l'autre sur Bordure.

Position/décalage de la bordure

BorderStrokePosition définit la position du contour par rapport à la bordure de son parent et BorderOffset vous permet de spécifier un décalage supplémentaire à la position du contour.

BorderOffset = (0.15, 0)
BorderOffset = (0, -16)

Transparence

La propriété Transparency définit la transparence du contour indépendamment de la BackgroundTransparency de l'objet parent ou de la TextTransparency. Cela vous permet de rendre le texte et les bordures "creux" (consistant uniquement en un contour).

Style de coin

La propriété LineJoinMode vous permet de contrôler comment les coins sont interprétés. Elle accepte une valeur de Round, Bevel, ou Miter.

Superposition

Pour superposer plusieurs instances de UIStroke sur un GuiObject de l'avant vers l'arrière, vous pouvez utiliser la propriété ZIndex. Celles avec un ZIndex inférieur s'affichent en dessous (derrière) de celles avec un ZIndex supérieur.

Notez que l'ordre de rendu pour les instances UIStroke ayant le même ZIndex est indéfini. N'appliquez pas plusieurs instances UIStroke avec le même index si leur ordre de rendu est important.

Coins

L'instance UICorner applique une déformation aux coins de son parent GuiObject. Vous pouvez contrôler le rayon appliqué via la propriété CornerRadius en utilisant soit Scale soit Offset.

Scale arrondit les coins à un pourcentage basé sur la longueur totale du plus court bord du parent, ce qui signifie qu'un échelle de 0.5 ou plus déforme le parent en une forme de "gélule", quelle que soit sa largeur ou sa hauteur. Offset arrondit les coins à un nombre spécifique de pixels, quelle que soit la largeur/hauteur du parent.

Scale = 0.25  ·  Offset = 0
Scale = 0.5  ·  Offset = 0
Scale = 0  ·  Offset = 32
Scale = 0  ·  Offset = 64

Vous pouvez également contrôler des coins individuels via les propriétés TopLeftRadius, TopRightRadius, BottomRightRadius, et BottomLeftRadius.

TopLeftRadius = (0, 0)
TopRightRadius = (0, 48)
BottomRightRadius = (0, 48)
BottomLeftRadius = (0, 0)

Remplissage

Un objet UIPadding applique un remplissage supérieur, inférieur, gauche et/ou droit au contenu de l'objet parent GuiObject. Par exemple, vous pouvez déplacer le texte à l'intérieur d'une étiquette de texte vers le bas ou vers le haut en appliquant un décalage à la propriété PaddingBottom du modificateur.

Ombre

Un objet UIShadow rend une ombre pour son instance UI parent. Une ombre peut suivre la forme rectangulaire du parent ou les glyphes d'un objet texte. Les ombres de forme peuvent apparaître à l'extérieur ou à l'intérieur du parent, et masquer la zone directement derrière le parent. Les ombres de forme et de texte peuvent utiliser un dégradé de couleur.

Si le parent a un UICorner ou une GuiObject.Rotation non nulle, son ombre de forme suit les mêmes coins ou rotation. UIShadow ne prend pas en charge Path2D ou les textures.

Ombres de forme et de texte

La propriété Mode détermine ce qui projette l'ombre, et les deux modes peuvent coexister sous le même parent.

Spread, Inset, et ShowBehindParent n'ont aucun effet en mode texte.

Flou

La propriété BlurRadius détermine le flou de l'ombre. Une valeur plus grande rend les bords de l'ombre plus doux. Notez que le facteur de scale de cette propriété UDim est relatif à la largeur ou à la hauteur du parent, selon ce qui est le plus court.

BlurRadius = (0, 0)
BlurRadius = (0.75, 0)

Couleur et transparence

La propriété Color détermine la couleur de l'ombre, tandis que Transparency définit la transparence de l'ombre avec 0 étant complètement opaque et 1 étant complètement transparent.

Color = (255, 255, 255)  ·  Transparency = 0.6
Color = (50, 0, 35)  ·  Transparency = 0

Pour une ombre multicolore, insérez un UIGradient comme enfant du UIShadow. Le dégradé affecte l'ombre sans changer le remplissage du parent.

Un UIGradient applique un dégradé de cyan à violet à l'ombre de forme.

Décalage et étalement

La propriété Offset déplace l'ombre par rapport à la position du parent, tandis que Spread étend ou réduit l'ombre par rapport à la taille du parent.

Offset = {0, -14}, {0, 6}
Offset = {0.1, 0}, {-0.15, 0}
Spread = {0, 10}, {0, 10}
Spread = {0.3, 0}, {0.3, 0}

Ombres en retrait

Définissez Inset sur true pour rendre l'ombre au-dessus et à l'intérieur du parent plutôt que derrière. Des valeurs positives de Spread étendent une ombre en retrait vers le centre du parent.

Inset = false
Inset = true

Révéler le contenu derrière un parent transparent

Par défaut, ShowBehindParent est true, donc toute l'ombre de forme est rendue, y compris la portion directement derrière le parent. Définissez-le sur false pour masquer cette portion de l'ombre. Cela empêche l'ombre d'assombrir le contenu visible à travers un parent transparent.

Cette propriété n'a aucun effet sur les ombres en retrait ou de texte.

Ombres superposées

Ajoutez plusieurs instances de UIShadow au même parent pour combiner les effets. La propriété ZIndex contrôle leur ordre de rendu. Les ombres avec des valeurs inférieures s'affichent derrière les ombres avec des valeurs plus élevées.

L'ordre de rendu des ombres qui partagent le même ZIndex est indéfini. Assignez à chaque ombre sœur une valeur différente lorsque leur ordre est important.

©2026 Société Roblox. Roblox, le logo Roblox et Powering Imagination font partie de nos marques déposées aux États-Unis et dans d'autres pays.