样式编辑器

*此内容使用人工智能(Beta)翻译,可能包含错误。若要查看英文页面,请点按 此处

内置的 样式编辑器 是一个全面的工具,允许您通过 tokens设计表样式规则主题 来创建、管理和应用 Roblox 游戏的UI样式。

通过 UI 选项卡访问 样式编辑器

在Studio工具栏的UI选项卡中标识的样式编辑工具

打开后,单击 创建设计 按钮生成基础样式集。

样式编辑器打开对话框中的创建设计按钮。

样式标记

样式 标记 是通过 StyleSheet属性 定义的,表示可以在样式和组件中使用的UI属性变量。例如,Frame.BackgroundColor3TextLabel.TextColor3UIStroke.Color 可能存在一个共同的颜色。标记可以与 CSS 变量 相提并论。

  1. 创建一个新的标记样式表:

    1. 在样式编辑器的左列中,悬停在 标记 上,单击 ,并选择 新建 标记 样式表
    2. 将新表重命名为 TokenSheet
    在样式编辑器中创建的新标记表。
  2. 选择新的标记表,通过单击主面板中的 添加 标记… 来创建几个标记。这些标记将在本指南中用于 规则主题

    样式编辑器中的标记添加区域。
    标记名称类型
    GoldColor3#ffcc00
    MagentaColor3#ff0099
    OrangeColor3#dd6030
    OswaldFontOswald
    Rad20UDim0, 20
    RectLUDim20, 300, 0, 160
    SquareLUDim20, 200, 0, 200
    Text24number24
    Text32number32
    在样式编辑器中添加到TokenSheet的标记。

设计表

设计样式表聚合 样式规则 并可以链接到 DataModel 树,以将样式属性应用于UI实例。每个给定树只能应用一个 StyleSheet,尽管您可以使用 主题 在您的UI中交换相关样式,后面的指南中将介绍此概念。

通过 创建 设计 按钮创建一个名为 StyleSheet 的预填充设计表。它包含常见UI对象(如 FrameTextLabel)的类规则。它还包含两个 StyleDerive 实例,从基础样式表中继承(获得) 标记 和样式,以便在您的自定义样式配置中使用。

样式编辑器中设计表的初始配置。

获得设计表后,您可以设置测试 屏幕上容器 以与样式编辑器一起使用,或者如果需要,可以设置 体验内容器

  1. 资源管理器 中悬停在 StarterGui 上,插入一个 ScreenGui

  2. 确保在 ScreenGui 下新出现的 StyleLink 实例的 StyleSheet 属性设置为 StyleSheet 设计表。

样式规则

样式 规则 应用到与规则的 Selector 定义匹配的每个实例,以匹配特征,如类名、实例标记和层次关系。从高层次上看,实例匹配和通过规则的 Selector 定义进行修改的操作是通过以下方式进行的:

类规则

样式 选择器目标是给定UI类的所有实例。以下规则设置样式所有的 Frames 具有统一的背景颜色和大小。

  1. 在样式编辑器的左列中,选择 FrameUI Elements 分支中。

    样式编辑器中的默认类样式。
  2. 将两个先前创建的 样式标记 链接到两个 Frame 属性:

    属性样式标记
    BackgroundColor3$Magenta
    Size$SquareL
    1. 在主面板中单击 添加属性… 并选择所需的属性。请注意,您可以键入关键字以更快地在下拉菜单中找到属性。
    2. 不输入静态值,而是单击 按钮并选择 链接 标记
    3. 单击值字段中出现的 $ 并选择适当的关联标记。
    样式编辑器中标记链接工作流的图示。
    在样式编辑器中配置标记的类规则。
  3. 插入一个新的 Frame 进入您之前 创建并链接ScreenGui。您定义的样式应自动应用于它。

    样式编辑器中的最终样式类规则。

标签规则

实例 标签 选择器目标是通过 CollectionService 标记的特定UI对象。以下规则设置样式 TextButton,其标记为 ButtonPrimary,并具有自定义背景颜色、字体和文本大小。

  1. 在样式编辑器的左列中,悬停在 样式表 上,单击 按钮,并导航到 新建 ⟩ 标签

    在样式编辑器中创建标签规则。
  2. 将新的标签规则重命名为 .ButtonPrimary(注意前导 .)。

    在样式编辑器中重命名的标签规则。
  3. 将三个先前创建的 样式标记 链接到三个 TextButton 属性:

    属性样式标记
    BackgroundColor3$Gold
    FontFace$Oswald
    TextSize$Text32
    1. 在主面板中单击 添加属性… 并选择所需的属性。请记住,您可以键入关键字以更快地在下拉菜单中找到属性。
    2. 不输入静态值,而是单击 按钮并选择 链接 标记
    3. 单击值字段中出现的 $ 并选择适当的关联标记。
    样式编辑器中标记链接工作流的图示。
    在样式编辑器中配置标记的标签规则。
  4. 将一个新的 TextButton 插入到您之前 创建并链接ScreenGui 中,并将其 标记ButtonPrimary。方便的快捷方式如下:

    1. 确保在 资源管理器 中选择新的 TextButton
    2. 在样式编辑器的左列中选择 .ButtonPrimary 标签规则,单击主面板中的 应用 标签。您定义的样式应该自动应用于该按钮。
    样式编辑器中标签链接的工作流图示。
    样式编辑器中的最终样式标签规则。

UI 修改器

实例修改器选择器将幻影的 UIComponents(如 UICornerUIStroke)应用于进一步样式化对象。以下规则设置样式 TextLabel,具有自定义文本大小和圆角。

  1. 在样式编辑器的左列中,选择 TextLabelUI Elements 分支中。

    样式编辑器中的默认类样式。
  2. 将先前创建的一个 样式标记 链接到 TextSize 属性:

    1. 在主面板中单击 添加属性… 选择 TextSize 属性。请记住,您可以键入关键字以更快地在下拉菜单中找到属性。
    2. 不输入静态值,而是单击 按钮并选择 链接 标记
    3. 单击值字段中出现的 $ 并选择 $Text32 标记。
    样式编辑器中标记链接工作流的图示。
    样式编辑器中配置的类规则。

需要一个 伪实例 来配置并将圆角应用于其他元素。要创建一个:

  1. 在左列中,悬停在 TextLabel 上,单击 按钮,导航到 新建 ⟩ 伪实例 ⟩ UICorner

    在样式编辑器中创建伪实例。

    一个新的 UICorner 伪实例出现在左列中的 TextLabel 元素下。

    在样式编辑器中结果的伪实例。
  2. 选择新的 UICorner 实例,与之前创建的 样式标记 链接到 CornerRadius 属性:

    1. 在主面板中单击 添加属性… 并选择 CornerRadius 属性。
    2. 不输入静态值,而是单击 按钮并选择 链接 标记
    3. 单击值字段中出现的 $ 并选择 $Rad20 标记。
    在样式编辑器中配置的伪实例。
  3. 在您之前 创建并链接ScreenGui 中插入一个新的 TextLabel。您定义的样式应该自动应用于它。

    样式编辑器中的最终样式修改器规则。

状态规则

GuiObject 状态 选择器对应于四个 GuiState 枚举值之一,如 Hover,让您能够自动配置交互状态的样式更改。以下规则设置为所有 ImageButtons 创建一个旋转 -4 度的悬停状态。

  1. 在样式编辑器的左列中,选择 ImageButtonUI Elements 分支中。

    样式编辑器中的默认类样式。
  2. 单击 按钮并导航到 新建 ⟩ GuiState ⟩ Hover

    在样式编辑器中创建状态规则。

    一个新的 Hover 状态修改器实例出现在左列中的 ImageButton 元素下。

    在样式编辑器中结果的状态规则。
  3. 选择新的 Hover 修改器,在主面板中单击 添加 属性… 并选择 Rotation。请记住,您可以键入关键字以更快地在下拉菜单中找到属性。

  4. 在属性值字段中输入 -4

    在样式编辑器中配置的状态规则。
  5. 在您之前 创建并链接ScreenGui 中插入一个新的 ImageButton。当您在视口中将鼠标悬停在按钮上时,它应该逆时针旋转4度。

    样式编辑器中的最终样式状态规则。

样式查询

样式 查询,类似于 CSS 容器和媒体查询,允许您根据容器大小、输入类型或其他因素在 UI 中应用条件逻辑。样式编辑器提供了一种简化的工作流程,以创建查询逻辑(条件)以及结果样式作为统一的集合。

内置查询

一些 StyleQuery 条件非常常见,比如根据 ViewportDisplaySize 更改属性。为了简化这一点,样式编辑器包括 内置 查询,允许您创建条件规则,而不需要 StyleQuery 的伪实例或真实实例;相反,您只需使用具有预定义选择器的查询规则,如 ViewportDisplaySizeSmall

下面的步骤演示如何生成一个 TextLabel 的内置查询,以处理 SmallMediumLarge 视口大小。

  1. 在样式编辑器的左列中,悬停在 TextLabel 上,单击 按钮并导航到 新建 ⟩ StyleQuery ⟩ Builtin ⟩ ViewportDisplaySize

    在样式编辑器中创建内置 StyleQuery。

    这将在 TextLabel 规则下创建 查询 文件夹,包含三个查询规则:

    • @ViewportDisplaySizeLarge — 定义在视口为 Large 时应用的属性。
    • @ViewportDisplaySizeMedium — 定义在视口为 Medium 时应用的属性。
    • @ViewportDisplaySizeSmall — 定义在视口为 Small 时应用的属性。
    类规则中的 StyleQuery 层次结构。
  2. 在每个查询规则下单击 添加属性…,设置当该查询处于活动状态时应显示的特定 Text 字符串:

    查询规则属性
    @ViewportDisplaySizeLargeTextLarge Text
    @ViewportDisplaySizeMediumTextMedium Text
    @ViewportDisplaySizeSmallTextSmall Text
  3. 为了验证查询,使用 设备模拟器 测试UI如何响应不同设备上的不同分辨率:

    1. ScreenGui 中插入一个新的 TextLabel

    2. 更改 设备模拟器 中的 设备,以查看文本实时更改。

      大小示例模拟
      LargePS5PS4Xbox One
      Medium普通笔记本电脑高清720
      SmalliPhone XRiPad第7代

自定义查询

您可以将样式查询添加到任何现有规则,以创建适应其容器的响应式 UI。以下设置将配置一个 TextLabel,使其仅在扩展到 400 像素或更宽的情况下自动更改外观。

  1. 在样式编辑器的左列中,悬停在 TextLabel 上,单击 按钮,并导航到 新建 ⟩ StyleQuery ⟩ Custom

    在样式编辑器中创建自定义 StyleQuery。

    此操作会在 TextLabel 规则下创建一个 查询 文件夹,包含两个链接项目:

    • ::StyleQuery 伪实例规则,在此定义 条件
    • @StyleQuery 规则,在此定义当满足这些条件时应用的 属性
    类规则中的 StyleQuery 层次结构。
  2. 在主面板中选择父 TextLabel 规则并定义以下默认属性:

    属性
    BackgroundColor3$Magenta
    Text默认文本
  3. 在主面板中选择 ::StyleQuery 规则,单击 添加 条件…,并配置以下内容:

    条件
    MinSize400, 0
  4. 在主面板中选择 @StyleQuery 规则并设置在查询处于活动状态时应应用的属性:

    属性
    BackgroundColor3$Gold
    TextLarge Text

要验证查询,您可以手动调整视口中 TextLabel 的大小。

  1. ScreenGui 中插入一个新的 TextLabel

  2. 调整其宽度以实时查看样式交换。

    TextLabel 的宽度较小时,MinSize 条件未满足,标签使用默认的背景颜色和文本。

    TextLabel 在手机视口上呈现为洋红色,文本为 '默认文本'。

样式过渡

样式 过渡,可与 CSS 过渡 相比,让您在设定的持续时间内对属性值进行插值。

默认

要对许多UI属性应用相同的参数,您可以设置一个默认过渡,适用于 所有 属性,除非为特定属性明确设置了其他过渡。

  1. UI Elements 分支中选择 TextButton,然后在主面板中添加以下三个新属性:

    样式编辑器中的类样式。
  2. 在父 TextButton 行上悬停,单击 按钮并导航到 插入 ⟩ 过渡

    在样式编辑器中添加默认过渡到规则。

    默认过渡的 1, Quad, Out, 0 直接插入到 TextButton 规则下,表示1 秒的过渡,缓和样式 Quad,缓和方向 Out,且无延迟。

    在样式编辑器中高亮显示的默认过渡。
  3. 在父 TextButton 行上悬停,单击 按钮并导航到 新建 ⟩ GuiState ⟩ Hover

    在样式编辑器中创建状态规则。
  4. 对于新的 Hover 修改器,添加两个新属性作为悬停状态的 目标

    属性
    BackgroundColor3#33AAFF
    Rotation-5
    在样式编辑器中的悬停状态规则属性。
  5. 在您之前 创建并链接ScreenGui 中插入一个新的 TextButton。当您在视口中将鼠标悬停在按钮上时,它应该逐渐变亮并同时逆时针旋转5度。

    样式编辑器中的最终样式状态规则。

标记链接

要在多个规则之间重用过渡行为,您可以定义表示 TweenInfo 数据类型的 标记。以下规则设置创建一个悬停状态以插值所有的 TextButtons 的 -5 度旋转和更浅的背景颜色。

  1. 如果还没有,请创建一个名为 TokenSheet标记样式表

    在样式编辑器中创建的新标记表。
  2. 选择新的标记表,在主面板中通过单击 添加 标记… 创建两个新标记。

    标记名称类型过渡参数
    CubicOutTweenInfo
    • Duration = 1.25
    • EasingStyle = Cubic
    • EasingDirection = Out
    • Delay = 0
    QuadInOutTweenInfo
    • Duration = 0.5
    • EasingStyle = Quad
    • EasingDirection = InOut
    • Delay = 0
    在样式编辑器中添加到TokenSheet的标记。
  3. UI Elements 分支中选择 TextButton,然后在主面板中添加以下三个新属性:

    样式编辑器中的类样式。
  4. 对于每个新属性,除了 AutoButtonColor,悬停在其行上,单击 按钮,选择 插入 ⟩ 过渡

    在样式编辑器中添加过渡到属性。
  5. 在每个属性下的新 过渡 行悬停,单击 按钮并选择 链接 标记。然后,而不是输入静态值,单击值字段中出现的 $ 并选择适当的过渡标记。

    样式编辑器中标记链接工作流的图示。
    属性过渡过渡标记
    BackgroundColor3$CubicOut
    Size$QuadInOut
    在样式编辑器中链接的过渡标记。
  6. 悬停在父 TextButton 行上,单击 按钮,导航至 新建 ⟩ GuiState ⟩ Hover

    在样式编辑器中创建状态规则。
  7. 对于新的 Hover 修改器,添加两个新属性作为悬停状态的 目标

    属性
    BackgroundColor3#33AAFF
    Rotation-5
    在样式编辑器中的悬停状态规则属性。
  8. 在您之前 创建并链接ScreenGui 中插入一个新的 TextButton。当你将鼠标悬停在视口中的按钮上时,它应该逐渐变亮并逆时针旋转 5 度。

    样式编辑器中的最终样式状态规则。

样式主题

样式 主题 由特定标记的集合组成,可以进行替换,例如定义“浅色”和“深色”主题的颜色标记。

创建主题

为了可扩展性,主题组织为文件夹。虽然单个文件夹通常足够,但如果需要,您可以自由地将主题组织成例如“颜色”或“字体”的文件夹。

  1. 创建一个新的主题文件夹:

    1. 在样式编辑器的左列中,悬停在 主题 上,单击 ,选择 新建 主题
    2. 将新的 文件夹 项重命名为 通用
    在样式编辑器中创建的新主题文件夹。
  2. 创建一个新的主题样式表:

    1. 在新创建的 通用 文件夹上悬停,单击 按钮,选择 新建 主题 样式表
    2. 将其重命名为 ThemeA
    在样式编辑器中创建的新主题。

主题标记

一旦构建了主题,您可以将其标记链接到各种UI对象属性,例如 BackgroundColor3TextButton。主题表必须使用共同的标记集才能正常工作。

在样式编辑器的左列中选择 ThemeA

  1. 将三个先前创建的 样式标记 链接到三个新的主题标记:

    主题标记样式标记
    BackColor$Gold
    ButtonFont$Oswald
    ButtonTextSize$Text32
    1. 在主面板中单击 添加标记…,输入主题标记的名称。
    2. 点击值字段中出现的 $ 并选择关联的样式标记。
    在样式编辑器中配置的主题。
  2. 在样式编辑器的左列中选择 TextButtonUI Elements 分支中。

    样式编辑器中的默认类样式。
  3. 将主题的标记链接到三个新的 TextButton 属性:

    属性主题标记
    BackgroundColor3$BackColor
    FontFace$ButtonFont
    TextSize$ButtonTextSize
    1. 在主面板中单击 添加属性… 并选择所需的属性。
    2. 不输入静态值,而是单击 按钮并选择 链接 标记
    3. 点击值字段中出现的 $ 并选择适当的主题标记。
    样式编辑器中标记链接工作流的图示。
    在样式编辑器中使用主题标记配置的类规则。

主题复制

一旦您大致建立了主题,您可以 复制 它并更改各种标记以定义独特的主题样式。

  1. 在样式编辑器的左列中,悬停在 ThemeA 主题上,单击 按钮并选择 复制

  2. 将复制的主题重命名为 ThemeB

    在样式编辑器中复制的主题。
  3. 将主题的两个标记链接到两个不同的样式标记:

    主题标记样式标记
    BackColor$Magenta
    ButtonTextSize$Text24
    1. 在属性值字段的右侧,单击 按钮并选择 取消链接 标记
    2. 再次单击 并选择 链接标记
    3. 在其值字段中单击 $ 并选择新的关联样式标记。
    在样式编辑器中配置的主题。

主题交换

一旦您有 多个主题,您可以通过主题的文件夹或通过脚本在 SetDerives() 中进行切换。

  1. 在样式编辑器的左列中,选择 主题 分支中的 通用 文件夹。

  2. 在主面板中通过单选按钮在主题之间进行交换。

    在样式编辑器中交换的ThemeA。
©2026 Roblox Corporation、Roblox、Roblox 标志及 Powering Imagination 是我们在美国及其他国家或地区的注册与未注册商标。