Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

主題型別變種

在設計使用者介面時，有時候你可能會希望某個 Control 節點擁有與 Theme 預設樣式不同的外觀。每個控制項節點都支援主題屬性覆寫，讓你可以針對單獨的 UI 元素重新定義樣式。

如果你需要多個控制項共用同一種自訂外觀，這種做法很快就會變得難以管理。想像一下，假設你的專案中需要灰色、藍色和紅色的 Button 變體，每次介面上新增按鈕時都要重複設定，會非常繁瑣。

為了便於管理並發揮 主題的強大功能，你可以使用主題型別變種。這些變種運作方式和一般主題型別類似，但它們不是獨立存在，而是擴充自其他基礎型別。

延續前述例子，你可以在主題中為 Button 型別定義樣式、顏色與字型，自訂所有按鈕的外觀。如果要有灰色、紅色或藍色的按鈕，可以建立新型別（如 GrayButton），並標記為基礎 Button 型別的變種。

型別變種可以覆蓋基礎型別的部分屬性，同時保留其他屬性，也能定義基礎型別未定義的屬性。例如，你的 GrayButton 可以覆寫基礎 Button 的 normal 樣式，並新增 Button 沒有定義的 font_color。控制項會同時結合兩者，並優先採用型別變種的設定。

備註

控制項如何決定使用哪個型別、哪個主題的項目，在《GUI 皮膚簡介》一文的 自訂專案 章節有詳細說明。

建立型別變種

要建立型別變種，請打開主題編輯器，點擊編輯器右側 型別 下拉選單旁的加號圖示。在文字框中輸入你要為主題型別變種取的名稱，然後點擊 新增型別。

在 型別 下拉選單下方是屬性分頁。請切換到圖示為扳手與螺絲起子的分頁。

點擊 基礎型別 欄位旁的加號圖示。這裡你可以選擇基礎型別，通常是控制項節點的類別名稱（如 Button、Label 等）。型別變種也能巢狀擴充其他型別變種，這與控制項節點繼承基底類別的風格相同。例如，CheckButton 會繼承 Button 的風格，因為對應的節點型別是擴充關係。

選擇好基礎型別後，你應該就能在主題編輯器的其他分頁中看到對應的屬性，並可照常編輯。

使用型別變種

現在已經建立型別變種，你可以將它套用到節點上。在屬性檢視器中，控制項節點的 Theme 屬性下會有 Theme Type Variation 屬性。預設為空，代表僅基礎型別會影響此節點。

你可以從下拉選單中選擇型別變種，也可以手動輸入名稱。只有屬於專案主題的型別變種才會顯示在清單中，專案主題可在專案設定裡設定。其他情況下，請點擊右側鉛筆圖示手動輸入型別變種名稱，再點選勾選圖示或按下 Enter 鍵。若存在該名稱的型別變種，節點就會開始使用它。