Spec-Zone.ru › CSS

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)).

Справочник

Правила

  • @property
    • синтаксис descriptor
      • + и # множители
      • | комбинатор
    • inherits descriptor
    • initial-value descriptor

Интерфейсы и API

  • CSSPropertyRule
  • CSS.registerProperty()

Руководства

Использование API свойств и значений CSS

Объясняет, как регистрировать пользовательские свойства в CSS и JavaScript, с подсказками по обработке неопределенных и недопустимых значений, fallback'ов и наследования.

API Houdini

Объясняет, что такое CSS Houdini и его преимущества, а также список доступных API и их статусы.

Связанные понятия

  • var()
  • CSSRule
  • CSSStyleValue
  • CSS области видимости
  • Использование Shadow DOM
  • API набора типов объектов CSS
  • API отрисовки CSS
  • Worklet

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

Спецификация
CSS Properties and Values API Level 1

См. также

  • Каскад и наследование CSS
  • Модуль CSS области видимости
  • Использование Shadow DOM
  • Модуль API отрисовки CSS
  • Интерфейс Worklet
  • CSS env()
  • CSS набор типов объектов

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API