Version: 2019.2
USS セレクター
USS でサポートされるプロパティー

USS Properties types

ビルトインとカスタムのプロパティー

USS を使用する場合、UI コード内のビルトインの VisualElement プロパティーの値や カスタムプロパティーの値を指定できます。

USS ファイルからそれらの値を読み込むことに加えて、ビルトインのプロパティー値は VisualElement の C# プロパティーを使用して C# で割り当てることができます。C# で割り当てられた値は、Unity スタイルシート (USS) から値をオーバーライドします。

You can extend USS with the Custom Properties API. Custom USS Properties require the -- prefix.

プロパティー値

ここでは、サポートされている型を列挙します。

Length

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.

Numeric

Numeric values are expressed as either floating points or integer literals. For example, flex:1.0.

キーワード

Specific keywords are supported for some built-in properties. Keywords provide a descriptive name instead of a number. For example: position:absolute. All properties support the initial global keyword which resets a property to its default value. See supported properties for a list of keywords.

UIElement は、以下のリテラルの色の値と関数をサポートします。

  • 16 進数値: #FFFF00 (rgba はチャンネルごとに 1 バイト)、#0F0 (rgb)
  • RGB 関数:rgb(255, 255, 0)
  • RGBA 関数: rgba(255, 255, 0, 1.0)

アセット

You can reference Assets with either the resource() or url() functions. For example, specify background-image: resource("Images/img.png") to specify the img.png in the Images directory as the background image. Referenced Assets are resolved during import.

resource() 関数は Resources フォルダーか Editor Default Resources フォルダー下のファイルを受け取ります。以下の注意点があります。

  • ファイルが Resources フォルダー下にある場合は、ファイル拡張子を入れないでください。例えば background-image: resource("Images/my-image")
  • ファイルが Editor Default Resources下にある場合は、ファイル拡張子を入れる必要があります。例えば background-image: resource("Images/default-image.png")

Additionally, when loading Textures, the resource() offers a convienient way to deal with High DPI/Retina screens. If a Texture with an identical file name and a @2x suffix exists at the same location, Unity loads it automatically depending on the screen DPI. For example, if you use resource("myimage") in USS, Unity loads either Resources/myimage.png or Resources/myimage@2x.png.

The url() function expects the file path to be relative to either the project root or the folder containing the USS file. You must include the file extension. In the following examples, the USS file is located at Assets\Editor\USS and the thumb.png background image is located at Assets\Editor\Resources:

  • Use this example for a relative path, based on the location of the USS file: url("../Resources/thumb.png");
  • Use one of the following examples for an absolute path, based on the location of the project: url("/Assets/Editor/Resources/thumb.png"); or url("project:/Assets/Editor/Resources/thumb.png"); or url("project:///Assets/Editor/Resources/thumb.png"); For example: background-image: url("Images/my-image.png").

文字列

Use quotes to specify a string value. For example: --my-property: "foo".


  • 2018–11–16 Page amended
USS セレクター
USS でサポートされるプロパティー