樣式編輯器

*此內容是使用 AI(Beta 測試版)翻譯,可能含有錯誤。若要以英文檢視此頁面,請按一下這裡

內建的 樣式編輯器 是一個全面的工具,允許您通過 標記設計表樣式規則主題 的組合來為 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. 在您之前 創建並鏈接ScreenGui 中插入一個新的 Frame。您定義的樣式應自動應用於它。

    樣式編輯器中的最終樣式類規則。

標籤規則

實例 標籤 選擇器針對通過 CollectionService 標記的特定 UI 對象。以下規則設置樣式一個標記為 ButtonPrimaryTextButton,並設置自定義背景顏色、字體和文本大小。

  1. 在樣式編輯器的左側列中,將鼠標懸停在 StyleSheet 表上,單擊 按鈕,然後導航到 新建 ⟩ 標籤

    在樣式編輯器中創建標籤規則。
  2. 將新標籤規則重命名為 .ButtonPrimary(注意前面的 .)。

    在樣式編輯器中重命名的標籤規則。
  3. 將三個先前創建的 樣式標記 鏈接到三個 TextButton 屬性:

    屬性樣式標記
    BackgroundColor3$Gold
    FontFace$Oswald
    TextSize$Text32
    1. 在主面板中單擊 添加屬性… 並選擇所需的屬性。請記住,您可以輸入關鍵字以更快地在下拉菜單中查找屬性。
    2. 不要輸入靜態值,單擊 按鈕並選擇 鏈接 標記
    3. 單擊出現在值字段中的 $,然後選擇正確的關聯標記。
    樣式編輯器中標記鏈接工作流程的圖示。
    在樣式編輯器中配置標記的標籤規則。
  4. 在您之前 創建並鏈接ScreenGui 中插入一個新的 TextButton,並將其 標記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 規則下創建一個 Queries 文件夾,包含三個查詢規則:

    • @ViewportDisplaySizeLarge — 定義在視口為 Large 時應用的屬性。
    • @ViewportDisplaySizeMedium — 定義在視口為 Medium 時應用的屬性。
    • @ViewportDisplaySizeSmall — 定義在視口為 Small 時應用的屬性。
    樣式查詢在類規則中的層次結構。
  2. 在每個查詢規則下單擊 添加屬性… 並設置當該查詢處於活動狀態時應顯示的特定 Text 字串:

    查詢規則屬性
    @ViewportDisplaySizeLargeTextLarge Text
    @ViewportDisplaySizeMediumTextMedium Text
    @ViewportDisplaySizeSmallTextSmall Text
  3. 要驗證查詢,使用 設備模擬器 測試 UI 如何響應不同解析度,跨三個不同設備進行測試:

    1. ScreenGui 中插入一個新的 TextLabel

    2. 更改 設備模擬器 中的 設備,以查看文本實時變化。

      大小示例模擬
      LargePS5PS4Xbox One
      Medium普通筆記本電腦HD 720
      SmalliPhone XRiPad 第七代

自定義查詢

您可以將樣式查詢添加到任何現有規則中,以創建響應式 UI,根據其容器進行調整。以下設置配置 TextLabel,使其在擴展到 400 像素或更寬時自動更改外觀。

  1. 在樣式編輯器的左側列中,將鼠標懸停在 TextLabel 上,單擊 按鈕,然後導航到 新建 ⟩ StyleQuery ⟩ Custom

    在樣式編輯器中創建自定義 StyleQuery。

    此操作會在 TextLabel 規則下創建一個 Queries 文件夾,包含兩個鏈接項:

    • ::StyleQuery 偽實例規則,您在此定義 條件
    • @StyleQuery 規則,您在此定義當滿足這些條件時應用的 屬性
    樣式查詢在類規則中的層次結構。
  2. 在主面板中選擇父 TextLabel 規則,並定義以下默認屬性:

    屬性
    BackgroundColor3$Magenta
    TextDefault Text
  3. 在主面板中選擇 ::StyleQuery 規則,單擊 添加 條件…,並配置以下內容:

    條件
    MinSize400, 0
  4. 在主面板中選擇 @StyleQuery 規則,並設置當查詢處於活動狀態時應應用的屬性:

    屬性
    BackgroundColor3$Gold
    TextLarge Text

要驗證查詢,您可以手動調整視口中的 TextLabel 大小。

  1. ScreenGui 中插入一個新的 TextLabel

  2. 調整其寬度以查看樣式實時切換。

    TextLabel 寬度較小時,MinSize 條件未滿足,標籤使用其默認背景顏色和文本。

    TextLabel 在手機視口上顯示為品紅色,文本為 'Default Text'。

樣式過渡

樣式 過渡,可與 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. 將新的 文件夾 項目重命名為 General
    在樣式編輯器中創建的新主題文件夾。
  2. 創建一個新的主題樣式表:

    1. 將鼠標懸停在新的 General 文件夾上,單擊 按鈕,然後選擇 新建 主題 樣式表
    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. 在樣式編輯器的左側列中,選擇 主題 分支中的 General 文件夾。

  2. 在主面板中,使用單選按鈕在主題之間切換。

    在樣式編輯器中切換的 ThemeA。
©2026 Roblox Corporation、Roblox、Roblox 標誌及 Powering Imagination 是我們在美國及其他國家地區的部分註冊與未註冊商標。