CSS Properties and Values API

Baseline 2024
Newly available

Since July 2024, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

CSS Properties and Values API, là một phần của nhóm API CSS Houdini, cho phép các nhà phát triển khai báo rõ ràng thuộc tính tùy chỉnh CSS của họ, hỗ trợ kiểm tra kiểu thuộc tính, giá trị mặc định và các thuộc tính có hoặc không kế thừa giá trị.

Giao diện

CSS.registerProperty

Định nghĩa cách trình duyệt nên phân tích thuộc tính tùy chỉnh CSS. Truy cập giao diện này qua CSS.registerProperty trong JavaScript.

@property

Định nghĩa cách trình duyệt nên phân tích thuộc tính tùy chỉnh CSS. Truy cập giao diện này qua at-rule @property at-rule trong CSS.

Ví dụ

Ví dụ dưới đây sẽ đăng ký một thuộc tính tùy chỉnh có tên --my-color sử dụng CSS.registerProperty trong JavaScript. --my-color sẽ sử dụng cú pháp màu CSS, có giá trị mặc định là #c0ffee và sẽ không kế thừa giá trị:

js
window.CSS.registerProperty({
  name: "--my-color",
  syntax: "<color>",
  inherits: false,
  initialValue: "#c0ffee",
});

Việc đăng ký tương tự có thể diễn ra trong CSS sử dụng at-rule @property at-rule:

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

Thông số kỹ thuật

Thông số kỹ thuật
CSS Properties and Values API Level 1
# the-css-property-rule-interface
CSS Properties and Values API Level 1
# the-registerproperty-function

Tương thích trình duyệt

api.CSSPropertyRule

api.CSS.registerProperty_static

Xem thêm