スタイルと Unity スタイルシート

各 VisualElement にはスタイルのプロパティが含まれており、backgroundColor や borderColor など、要素の寸法と要素が画面上でどのように描画されるかを設定します。

スタイルのプロパティは、C# かスタイルシートで設定します。スタイルプロパティは、独自のデータ構造 (IStyle インターフェース) で再グループ化されます。

UI Toolkit は USS (Unity スタイルシート) で書かれたスタイルシートをサポートします。USS ファイルは、HTML のカスケーディングスタイルシート (Cascading Style Sheets、CSS) からヒントを得たテキストファイルです。USS 形式は CSS に似ていますが、USS は Unity でうまく動作するためのオーバーライドとカスタマイズが含まれています。

ここでは、USS とその構文、CSS と比較した違いの詳細を説明しています。

Unity スタイルシートの定義

Unity スタイルシート (USS) の基本的な事項は以下の通りです。

• USS はアセットとして認識されるテキストファイルです。テキストファイルには .uss 拡張子が必要です。
• USS はスタイルのルールのみをサポートします。
• スタイルのルールはセレクターと宣言ブロックで構成されます。
• セレクターは、どのビジュアル要素がスタイルのルールに影響するかを識別します。
• 中括弧 {} で囲まれた宣言ブロックには、1 つ以上のスタイル宣言が含まれます。各スタイル宣言は、プロパティと値で構成されます。各スタイル宣言はセミコロンで終わります。
• 各スタイルプロパティの値はリテラルであり、パースされるときに、ターゲットプロパティ名と一致する必要があります。

スタイルルールの一般的な構文は下のとおりです。

selector {
  property1:value;
  property2:value;
}

USS をビジュアル要素に設定

Unityスタイルシート (USS) をビジュアル要素に設定できます。スタイルルールは、ビジュアル要素とすべての子孫要素に適用されます。スタイルシートは必要に応じて自動的に再適用されます。

AssetDatabase.Load() や Resources.Load() などの標準的な Unity API を使用して StyleSheet オブジェクトを読み込み ます。VisualElement.styleSheets.Add() メソッドを使用して、スタイルシートをビジュアル要素にアタッチします。

EditorWindow の実行中に USS ファイルを変更すると、スタイルの変更は即座に適用されます。

スタイルアプリケーションのプロセスは、UI Toolkit を使用する開発者にとって透過的です。スタイルシートは、必要な場合 (階層の変更、スタイルシートの再ロード) に自動的に再適用されます。

ルールに一致するスタイル

Once a style sheet is defined, it can be applied to a tree of visual elements.

この処理の間、USS ファイルから適用されるプロパティを解決するためにセレクターは要素と照合されます。セレクターが要素に適合すると、要素にスタイル宣言が適用されます。

例えば、以下のルールはすべての Button オブジェクトに適合します。

Button {
  width: 200px;
}

VisualElement の照合

UI Toolkit は次の条件を使用して、ビジュアル要素をそのスタイルルールと照合します。

• その C# クラス名 (常にもっとも派生したクラス)
• name プロパティ (文字列)
• クラスリスト (一揃いの文字列)
• ビジュアルツリー内の VisualElement の祖先と位置

これらの特性は、スタイルシートのセレクターで使用されます。

CSS を使い慣れているユーザーには、HTML タグ名、id 属性、class 属性と似ていることがお判りでしょう。

• 2018–11–02 修正されたページ