The CSS Properties and Values API — part of the
CSS Houdini
umbrella of APIs — allows developers to explicitly define their
css custom properties
, allowing for property type checking, default values, and properties that do or do not inherit their value.
CSS.registerProperty
css custom properties
. Access this interface through
CSS.registerProperty
in JavaScript.
@property
css custom properties
. Access this interface through
@property
in CSS.
The following uses
CSS.registerProperty
in JavaScript to type a
css custom properties
,
--my-color
, as a color, give it a default value, and not allow it to inherit its value:
window.CSS.registerProperty({
name: '--my-color',
syntax: '<color>',
inherits: false,
initialValue: '#c0ffee',
});
The same registration can take place in CSS using the following
@property
:
@property --my-color {
syntax: '<color>';
inherits: false;
initial-value: #c0ffee;
}
| 规范 | 状态 | 注释 |
|---|---|---|
| CSS Properties and Values API Level 1 | 工作草案 | 初始定义。 |
See individual interfaces