API свойств и значений CSS
Модуль API свойств и значений CSS определяет метод для регистрации новых свойств CSS, определения типа данных свойства, поведения наследования и, необязательно, начального значения. Этот API расширяет модуль CSS пользовательских свойств для каскадных переменных, который позволяет авторам определять пользовательские свойства в CSS с помощью синтаксиса с двумя тире (--). API свойств и значений CSS является частью набора API CSS Houdini.
Пользовательские свойства позволяют повторно использовать значения в проекте для упрощения сложных или повторяющихся таблиц стилей. Базовые пользовательские свойства определяются в модуле CSS пользовательских свойств для каскадных переменных. API свойств и значений CSS расширяет этот модуль, позволяя добавлять метаданные к пользовательским свойствам с помощью CSS с помощью правила @property или, как альтернатива, с помощью метода JavaScript CSS.registerProperty.
Независимо от того, зарегистрированы ли пользовательские свойства с помощью CSS или JavaScript, установка метаданных на пользовательские свойства обеспечивает ожидаемый тип данных, который браузер может использовать в зависимости от контекста, определяет начальное значение и позволяет управлять наследованием.
Регистрация пользовательских свойств API свойств и значений CSS более надежна, чем более базовая декларация пользовательских свойств CSS каскадных переменных, особенно когда речь идет о плавных переходах и анимации значений, так как браузеры могут интерполировать между пользовательскими значениями этого типа, в то время как свойства, использующие синтаксис с двумя тире (--), ведут себя скорее как подстановка строк.
API свойств и значений в действии
Чтобы увидеть, как пользовательские свойства и значения могут быть использованы через API, наведите курсор на квадрат ниже.
Квадрат имеет фон, состоящий из линейного градиента от --stop-color (пользовательского свойства) до lavenderblush. Значение --stop-color устанавливается на cornflowerblue вначале, но при наведении курсора на квадрат --stop-color переходит к aquamarine в течение двух секунд (linear-gradient(to right, aquamarine, lavenderblush)).
Справочник
Правила
Интерфейсы и API
Руководства
- Использование API свойств и значений CSS
-
Объясняет, как регистрировать пользовательские свойства в CSS и JavaScript, с подсказками по обработке неопределенных и недопустимых значений, fallback'ов и наследования.
- API Houdini
-
Объясняет, что такое CSS Houdini и его преимущества, а также список доступных API и их статусы.
Связанные понятия
Спецификации
| Спецификация |
|---|
| CSS Properties and Values API Level 1 |
См. также
© 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/CSS_properties_and_values_API