大网数据广告活动
Web 标准与前端开发

syntax

· 52CE 我爱测

**`syntax`** CSS 描述符在使用@property at-rule时是必需的,它描述了该属性所允许的语法结构。

syntax CSS 描述符在使用@property at-rule时是必需的,它描述了该属性所允许的语法结构。

语法

如下是所有的有效 syntax 字符串:

syntax: "<color>"; /* 接收一个颜色值 */

syntax: "<length> | <percentage>"; /* 接收长度或百分比参数,但是二者之间不进行计算合并 */

syntax: "small | medium | large"; /* 接收这些参数值之一作为自定义标识符 */

syntax: "*"; /* 任何有效字符 */

取值

规范定义的、受语法支持的字符串。支持的语法是CSS types的子集。这些可以单独使用,一些类型也可以结合使用。

  • "<length>"
    • : 任何有效的 <length> 值。
  • "<number>"
    • : 任何有效的 <number> 值。
  • "<percentage>"
    • : 任何有效的 <percentage> 值。
  • "<length-percentage>"
    • : 任何有效的 <length-percentage> 值。
  • "<color>"
    • : 任何有效的 <color> 值。
  • "<image>"
    • : 任何有效的 <image> 值。
  • "<url>"
    • : 任何有效的 url() 值。
  • "<integer>"
    • : 任何有效的 <integer> 值。
  • "<angle>"
    • : 任何有效的 <angle> 值。
  • "<time>"
    • : 任何有效的 <time> 值。
  • "<resolution>"
    • : 任何有效的 <resolution> 值。
  • "<transform-function>"
    • : 任何有效的 <transform-function> 值。
  • "<custom-ident>"
    • : 任何有效的 <custom-ident> 值。
  • "<transform-list>"
    • : A list of valid <transform-function> 值。

形式定义

形式语法

实例

为 --my-color --*添加颜色值类型检测、设置默认值并且设置属性值不允许被继承。

使用 CSS @property 规则:

@property --my-color {
  syntax: "<color>";
  inherits: false;
  initial-value: #c0ffee;
}

使用 JavaScript 中的 CSS.registerProperty函数:

window.CSS.registerProperty({
  name: "--my-color",
  syntax: "<color>",
  inherits: false,
  initialValue: "#c0ffee",
});

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。