樣式編輯器

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

內建的 樣式編輯器 是一個全面的工具,允許您通過 標記、設計表、樣式規則 和 主題 的組合來為 Roblox 遊戲創建、管理和應用 UI 樣式。

通過 UI 標籤訪問 樣式編輯器。

在 Studio 工具欄的 UI 標籤中指示的樣式編輯器工具

打開後,單擊 創建設計 按鈕以生成基本樣式集。

樣式編輯器開啟對話框中的創建設計按鈕。

樣式標記

樣式 標記 通過 StyleSheet 的 屬性 定義,表示可以在樣式和組件中使用的 UI 屬性變量;例如,Frame.BackgroundColor3、TextLabel.TextColor3 和 UIStroke.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 對象(例如 Frame 和 TextLabel)的類規則。它還包含兩個 StyleDerive 實例,這些實例從基本樣式表中派生(繼承) 標記 和樣式,以便在您的自定義樣式配置中使用。

樣式編輯器中設計表的初始配置。

一旦您擁有設計表,您可以設置一個測試 螢幕容器 以與樣式編輯器一起使用,或者如果需要,也可以設置一個 遊戲內容器。

  1. 在 資源管理器 中將鼠標懸停在 StarterGui 上,並插入一個 ScreenGui。

  2. 確認在 ScreenGui 下出現一個新的 StyleLink 實例,其 StyleSheet 屬性設置為 StyleSheet 設計表。

樣式規則

樣式 規則 會應用於每個符合規則的 Selector 定義的實例,以匹配類名、實例標籤和層次結構關係等特徵。在高層次上,通過規則的 Selector 定義進行實例匹配和修改的操作如下:

類規則

樣式 類 選擇器針對給定 UI 類的所有實例。以下規則設置樣式所有 Frames 具有統一的背景顏色和大小。

  1. 在樣式編輯器的左側列中,選擇 Frame 在 UI Elements 分支中。

    樣式編輯器中的默認類樣式。
  2. 將兩個先前創建的 樣式標記 鏈接到兩個 Frame 屬性:

    屬性樣式標記
    BackgroundColor3$Magenta
    Size$SquareL
    1. 在主面板中單擊 添加屬性… 並選擇所需的屬性。請注意,您可以輸入關鍵字以更快地在下拉菜單中查找屬性。
    2. 不要輸入靜態值,單擊 ⋮ 按鈕並選擇 鏈接 標記。
    3. 單擊出現在值字段中的 $,然後選擇正確的關聯標記。
    樣式編輯器中標記鏈接工作流程的圖示。
    在樣式編輯器中配置標記的類規則。
  3. 在您之前 創建並鏈接 的 ScreenGui 中插入一個新的 Frame。您定義的樣式應自動應用於它。

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

標籤規則

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

  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(例如 UICorner 或 UIStroke)應用於進一步樣式化對象。以下規則設置樣式一個 TextLabel,並設置自定義文本大小和圓角。

  1. 在樣式編輯器的左側列中,選擇 TextLabel 在 UI 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. 在樣式編輯器的左側列中,選擇 ImageButton 在 UI Elements 分支中。

    樣式編輯器中的默認類樣式。
  2. 單擊 ⋮ 按鈕並導航到 新建 ⟩ GuiState ⟩ Hover。

    在樣式編輯器中創建狀態規則。

    一個新的 Hover 狀態修飾符實例出現在左側列的 ImageButton 元素下。

    在樣式編輯器中生成的狀態規則。
  3. 在左側列中選擇新的 Hover 修飾符,在主面板中單擊 添加 屬性… 並選擇 Rotation。請記住,您可以輸入關鍵字以更快地在下拉菜單中查找屬性。

  4. 在屬性的值字段中輸入 -4。

    在樣式編輯器中配置標記的狀態規則。
  5. 在您之前 創建並鏈接 的 ScreenGui 中插入一個新的 ImageButton。當您在視口中將鼠標懸停在按鈕上時,它應該逆時針旋轉 4 度。

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

樣式查詢

樣式 查詢,類似於 CSS 容器和媒體查詢,允許您根據容器大小、輸入類型或其他因素對 UI 應用條件邏輯。樣式編輯器提供了一個簡化的工作流程來創建查詢邏輯(條件)和結果樣式作為統一集。

內建查詢

一些 StyleQuery 條件非常常見,例如根據 ViewportDisplaySize 更改屬性。為了簡化這一點,樣式編輯器包括 內建 查詢,允許您創建條件規則,而無需擁有 StyleQuery 的偽實例或真實實例;相反,您只需使用具有預定義選擇器的查詢規則,例如 ViewportDisplaySizeSmall。

以下步驟演示如何為 TextLabel 生成內建查詢,以處理 Small、Medium 和 Large 視口大小。

  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. 更改 設備模擬器 中的 設備,以查看文本實時變化。

      大小示例模擬
      LargePS5、PS4、Xbox One
      Medium普通筆記本電腦、HD 720
      SmalliPhone XR、iPad 第七代

自定義查詢

您可以將樣式查詢添加到任何現有規則中,以創建響應式 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 對象屬性,例如 BackgroundColor3 的 TextButton。主題表必須使用一組通用標記才能正常工作。

在樣式編輯器的左側列中選擇 ThemeA:

  1. 將三個先前創建的 樣式標記 鏈接到三個新的主題標記:

    主題標記樣式標記
    BackColor$Gold
    ButtonFont$Oswald
    ButtonTextSize$Text32
    1. 在主面板中單擊 添加標記… 並輸入主題標記的名稱。
    2. 單擊出現在值字段中的 $,然後選擇關聯的樣式標記。
    在樣式編輯器中配置標記的主題。
  2. 在樣式編輯器的左側列中,選擇 TextButton 在 UI 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 是我們在美國及其他國家地區的部分註冊與未註冊商標。