initial-value

Базовая 2024

Новое поступление

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

Дескриптор initial-value CSS необходим при использовании @property правила, если синтаксис не принимает любой допустимый поток токенов. Он задаёт начальное значение свойства.

Выбранное значение initial-value должно быть правильно обработано в соответствии с определением синтаксиса. Поэтому, если синтаксис <color> , то начальное значение должно быть допустимым значением color.

Синтаксис

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

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

Значения

Строка со значением, которое является корректным значением для выбранного syntax.

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

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

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

initial-value = 
  <declaration-value>?

Примеры

Добавление проверки типов к --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",
});

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

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

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

	Рабочий стол					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`initial-value`	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/initial-value