Version: 2018.4
USS 选择器
USS 支持的属性

属性类型

内置属性与自定义属性

使用 USS 时,可为内置的 VisualElement 属性或 UI 代码中的自定义属性指定值。

除了从 USS 文件中读取值之外,还可以使用 VisualElement 的 C# 属性在 C# 中分配内置属性值。在 C# 中分配的值将覆盖 Unity 样式表 (USS) 中的值。

可使用自定义属性 API 来扩展 USS。

属性值

本节列出了支持的类型。

关键字

以下关键字具有特殊含义:

  • auto
  • inherit
  • unset
  • true
  • false
  • none

限制:关键字 autoinheritunset 会正确导入,但在运行时不受支持。

数值属性

UIElements 不支持单位。所有属性类型都应该以像素为单位指定。

数值是浮点或整数字面值。例如:flex:1.0width:200。数值存储为浮点数,包括整数字面值。

枚举

只有基于枚举的内置属性才支持枚举。枚举提供可读名称而不是数字。例如:position-type:absolute

颜色

UIElements 支持以下字面颜色值和函数:

  • 十六进制值:#FFFF00(rgba,每个通道一个字节)、#0F0 (rgb)
  • RGB 函数:rgb(255, 255, 0)
  • RGBA 函数:rgba(255, 255, 0, 1.0)
  • HSL 函数:hsl(0, 100%, 50%)

资源

可使用 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")

url() 函数要求文件路径相对于项目根目录或包含 USS 文件的文件夹。必须包含文件扩展名。例如:background-image: url("Images/my-image.png")

对于纹理,如果文件的版本具有 @2x 后缀,则会自动为 Retina 或高 DPI 屏幕加载此文件。

字符串

使用引号指定字符串值。例如:my-property: "foo"


  • 2018–11–16 页面已修订并只进行了有限的编辑审查
USS 选择器
USS 支持的属性