USS を使用する場合、UI コード内のビルトインの VisualElement
プロパティの値や カスタムプロパティの値を指定できます。
USS ファイルからそれらの値を読み込むことに加えて、ビルトインのプロパティ値は VisualElement
の C# プロパティを使用して C# で割り当てることができます。C# で割り当てられた値は、Unity スタイルシート (USS) から値をオーバーライドします。
カスタムプロパティ で USS を拡張することができます。カスタム USS プロパティには --
というプレフィックスが必要です。
ここでは、サポートされている型を列挙します。
UI Toolkit は長さの単位としてピクセル (px
) とパーセンテージ (%
) をサポートします。ピクセル値は絶対値ですが、パーセンテージは通常、要素の親に相対的です。
例:
width:200px;
は、幅が 200 ピクセルであることを表します。width:50%;
は、幅が親要素の半分であることを表しています。It is important to specify the unit of measurement. If you do not specify a unit of measurement, UI Toolkit assumes that the property value is expressed in pixels.
注意: 0
は、測定単位を必要としない特別な値です。
数値は、浮動小数点数または整数リテラルで表されます。例えば、flex:1.0
です。
一部のビルトインプロパティでは、特定のキーワードがサポートされています。キーワードは、数字ではなく説明的な名前を提供します。例えば、position:absolute
です。すべてのプロパティは、プロパティをデフォルト値にリセットする initial
グローバルキーワードをサポートします。キーワードのリストについては、サポートされているプロパティ を参照してください。
UI Toolkit は、以下のリテラルの色の値と関数をサポートします。
#FFFF00
(rgba はチャンネルごとに 1 バイト)、#0F0
(rgb)rgb(255, 255, 0)
rgba(255, 255, 0, 1.0)
blue
、transparent
resource()
や url()
関数を使ってアセットを参照することができます。例えば background-image: resource("Images/img.png")
を指定すると Images
ディレクトリの img.png
を背景画像として指定できます。参照されたアセットはインポート中に解決されます。
resource()
関数は Resources
フォルダーか Editor Default Resources
フォルダー下のファイルを受け取ります。以下の注意点があります。
Resources
フォルダー下にある場合は、ファイル拡張子を入れないでください。例えば background-image: resource("Images/my-image")
。Editor Default Resources
下にある場合は、ファイル拡張子を入れる必要があります。例えば background-image: resource("Images/default-image.png")
。さらに、テクスチャをロードするとき、resource()
は高 DPI/Retina 画面を処理するための便利な方法を提供します。同じファイル名と @2x
サフィックスを持つテクスチャが同じ場所に存在する場合、Unity は画面の DPI に応じて自動的にそれをロードします。
例えば、USS で resource("myimage")
を使用する場合、Unity は Resources/myimage.png か Resources/myimage@2x.png のいずれかをロードします。
url()
関数は、ファイルパスがプロジェクトルートへの相対パス、または USS ファイルを含むフォルダーのいずれかへの相対パスであると想定します。ファイル拡張子を含む必要があります。以下の例では、USS ファイルは Assets\Editor\USS にあり、 thumb.png 背景画像は Assets\Editor\Resources にあります。
url("../Resources/thumb.png");
url("/Assets/Editor/Resources/thumb.png");
url("project:/Assets/Editor/Resources/thumb.png");
url("project:///Assets/Editor/Resources/thumb.png");
例えば background-image: url("Images/my-image.png")
のようになります。引用符を使用して文字列の値を指定します。例えば --my-property: "foo"
。