Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

使用主題編輯器

本文介紹如何通過 Godot 編輯器及其主題編輯器工具來建立並管理 UI 主題。我們推薦您在開始前先閱讀 序言,熟悉一下 GUI 換皮/主題背後的基本知識。

主題編輯器是底部面板工具,當一個 Theme 資源被選中進行編輯時,面板會自動啟動。面板包含了新增、刪除和調整主題型別和主題專案的必要使用者介面。面板有一個預覽區,用於測試你做出的變化,以及一個視窗對話方塊,用於對主題專案進行批量操作。

建立主題

和其他任何資源一樣,主題可以直接在檔案系統面板中建立:右鍵,選擇**新建資源...**,然後選擇 Theme 並點擊**建立**。用來建立專案範圍的主題很方便。

也可以在任何控制項節點中建立主題。在場景樹中選擇控制項節點後,找到屬性面板中的 theme 熟悉。然後就可以選擇**新建 Theme**。

../../_images/new_theme.png

這樣就會建立一個空主題,並且打開主題編輯器。請記住,這樣建立的資源預設是和場景綁定的。可以使用本文功能表將新建的主題保存為單獨的檔。

雖然主題編輯器提供了管理主題型別和專案的工具,主題也包括預設的備用字形,你只能使用屬性面板面板來編輯。這同樣適用於複雜的資源型別的內容,如:ref:`樣式盒 <class_StyleBox>`和圖示——它們會在屬性面板中打開編輯。

../../_images/default_font.png

編輯器

../../_images/theme_editor.png

主題編輯器有兩個主要部分。主要的主題編輯器位於Godot編輯器的底部,為使用者提供了快速建立、編輯和刪除主題專案和型別的工具。它提供了挑選和改變控制項的視覺化工具,抽象了底層的主題概念。另一方面,**管理主題專案**對話方塊,提供解決手動改變主題的需求。其對於建立新的編輯器主題時很有用。

主題預覽

主編輯器左側的是一組預覽分頁。**預設預覽**分頁預設可見,裡面有處於各種狀態的大多數常用控制項。預覽是可互動的,所以也可以預覽中間狀態(比如滑鼠懸停)。

../../_images/default_preview.png

可以使用你自己專案中的任意場景建立更多的分頁。場景的根節點必須是控制項節點才能進行預覽。點擊**新增預覽**按鈕然後從檔案系統中選擇已保存的場景,就可以新增一個新的分頁。

../../_images/scene_preview.png

對場景的修改不會自動反映到預覽中。更新預覽需要點擊工具列上的重新載入按鈕。

還可以使用預覽快速選擇要編輯的主題型別。點擊工具列上的吸管按鈕,將滑鼠懸停到預覽區域就可以將控制項節點高亮。高亮的控制項節點會顯示類別名稱。點擊高亮的控制項就可以將它在右側打開並編輯。

../../_images/theme_preview_picker.png

主題型別與專案

主題編輯器的右側提供了編輯主題資源中可用的主題型別列表,以及所選型別的內容。型別的專案列表分為幾個分頁,對應於主題中可用的每種資料型別(顏色、常數、樣式等)。如果啟用了**顯示預設**選項,則對於每個內建型別,其預設主題值都會顯示為灰色。如果禁用該選項,則只顯示編輯主題本身的可用專案。

../../_images/theme_type_editor.png

通過點擊專案旁邊的**Override**按鈕,可以將預設主題中的個別專案新增到目前主題中。你也可以通過點擊**Override All**按鈕來覆蓋所選主題型別的所有預設專案。然後可以用**Remove Item**按鈕移除被覆蓋的屬性。屬性也可以用**Rename Item**按鈕重命名,完全自訂的屬性可以用它下面的文字欄位新增到列表中。

覆蓋的主題專案可以直接在右側面板中編輯,除非它們是資源。資源具有可用的基本控制項,但必須在屬性面板欄中進行編輯。

../../_images/theme_item_inspector.png

樣式盒子有一個獨特的功能,您可以在其中固定列表中的單個樣式盒子。固定樣式盒子就像包頭一樣,當您更改其屬性時,所有相同型別的樣式盒子都會隨之更新。這允許您同時編輯多個樣式盒子的屬性。

../../_images/theme_pin_the_stylebox.png

雖然可以從預覽中選擇主題型別,但也可以手動新增。按一下型別列表旁邊的加號按鈕可以打開**新增專案型別**功能表。在功能表中,可以從列表中選擇一種型別,也可以輸入任意名稱來建立自訂型別。文字欄位篩選控制項節點列表。

../../_images/add_item_type.png

訊號與屬性

按一下**Manage Items**按鈕會打開**Manage Theme Items**對話方塊。在**Edit Items**分頁中,您可以查看和新增主題型別,以及查看和編輯所選型別的主題專案。

../../_images/manage_items.png

你可以通過點擊相應的 Add X Item 並指定其名稱,建立、重命名和刪除單個主題專案。你也可以按資料型別(使用列表中的畫筆圖示)或按品質批量刪除主題項。**Remove Class Items**將刪除你為一個控制節點型別定制的所有內建主題專案。**Remove Custom Items**將刪除所選型別的所有自訂主題專案。\\**Remove All Items**將刪除該型別的所有專案。

從**Import Items**\\分頁,你可以從其他主題匯入主題專案.你可以從Godot預設主題匯入專案,如Godot編輯器主題或者其他自訂主題.你可以匯入單個或多個專案並選擇匯入或忽略他們的資料.有幾種選擇專案的放大,包括手動、按結構層次、按資料型別等等.選擇包括資料將複製所有專案到你的主題.忽略資料將建立具有相應資料型別和名稱的專案,但是他們會保存為空,以所指定的方式建立了範本.

../../_images/import_items.png