синтаксис

Базовая версия 2024

Новое

С июля 2024 года эта функция работает во всех последних версиях браузеров и устройств. Возможно, эта функция не будет работать на более старых устройствах или браузерах.

Описание syntax CSS требуется при использовании правила @property и описывает допустимый синтаксис свойства.

Синтаксис

Ниже приведены все допустимые строки синтаксиса:

syntax: "<color>"; /* accepts a color */

syntax: "<length> | <percentage>"; /* accepts lengths or percentages but not calc expressions with a combination of the two */

syntax: "small | medium | large"; /* accepts one of these values set as custom idents. */

syntax: "*"; /* any valid token */

Значения

Строка с поддерживаемым синтаксисом, определенным в спецификации. Поддерживаемые синтаксисы — это подмножество типов CSS. Их можно использовать по отдельности или в сочетании.

"<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>": Список допустимых значений <transform-function>.

Формальное определение

Соответствующее правило at-rule	`@property`
Начальное значение	`n/a (required)`
Вычисленное значение	как указано

Формальный синтаксис

syntax = 
  <string>

Примеры

Добавьте проверку типа к --my-color пользовательскому свойству, используя синтаксис <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",
});

Спецификации

Спецификация
CSS Properties and Values API Level 1 # the-syntax-descriptor

Совместимость с браузерами

	Рабочий стол					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`syntax`	85	85	128	71	16.4	85	128	60	16.4	14.0	85

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/CSS/@property/syntax