USS を使用する場合、UI コード内のビルトインの VisualElement プロパティーの値や カスタムプロパティーの値を指定できます。
USS ファイルからそれらの値を読み込むことに加えて、ビルトインのプロパティー値は VisualElement の C# プロパティーを使用して C# で割り当てることができます。C# で割り当てられた値は、Unity スタイルシート (USS) から値をオーバーライドします。
カスタムプロパティーの API を使用して USS を拡張できます。カスタムの USS プロパティーは -- プレフィックスを必要とします。
ここでは、サポートされている型を列挙します。
UIElements only supports the pixel (px) unit of measurement. If a unit of measurement is not specified, UIElements assumes that the property type is expressed in pixels. It is good practice to specify px as the unit of measurement.
For example, a width of two hundred pixels should be expressed as width:200px;. Note that 0 is a special value that doesn’t require a unit of messurement.
数値は、浮動小数点数または整数リテラルで表されます。例えば、flex:1.0 です。
一部のビルトインプロパティーでは、特定のキーワードがサポートされています。キーワードは、数字ではなく説明的な名前を提供します。例えば、position:absolute です。すべてのプロパティーは、プロパティーをデフォルト値にリセットする initial グローバルキーワードをサポートします。キーワードのリストについては、サポートされているプロパティー を参照してください。
UIElement は、以下のリテラルの色の値と関数をサポートします。
#FFFF00 (rgba はチャンネルごとに 1 バイト)、#0F0 (rgb)rgb(255, 255, 0)
rgba(255, 255, 0, 1.0)
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"。