Version: 2019.4
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.




UIElements supports pixels (px) and percentages (%) as units of measurement for length. Pixel values are absolute, while percentages are usually relative to the element’s parent.


  • width:200px; expresses a width of 200 pixels.
  • width:50%; expresses a width of half of the parent element’s width.

It is important to specify the unit of measurement. If you do not specify a unit of measurement, UIElements assumes that the property value is expressed in pixels.

Note: 0 is a special value that doesn’t require a unit of measurement.


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 は、以下のリテラルの色の値と関数をサポートします。

  • A Hexadecimal value: #FFFF00 (rgba one byte per channel), #0F0 (rgb)
  • The RGB function: rgb(255, 255, 0)
  • The RGBA function: rgba(255, 255, 0, 1.0)
  • Color keywords: blue, transparent


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 でサポートされるプロパティー