initial-value
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.
Mô tả initial-value của at-rule @property at-rule chỉ định giá trị ban đầu cho thuộc tính tùy chỉnh CSS đã đăng ký.
Đây là mô tả bắt buộc trừ khi giá trị của mô tả syntax là cú pháp phổ quát (*).
Nếu cần nhưng bị thiếu hoặc không hợp lệ, toàn bộ quy tắc @property sẽ không hợp lệ và bị bỏ qua.
Cú pháp
/* Đặt giá trị màu ban đầu */
initial-value: rebeccapurple;
/* Đặt giá trị độ dài ban đầu */
initial-value: 16px;
Giá trị
Một giá trị khớp với kiểu được chỉ định trong mô tả syntax.
Ví dụ, nếu syntax là <color>, thì initial-value phải là giá trị color hợp lệ.
Nếu giá trị của mô tả syntax không phải là định nghĩa cú pháp phổ quát, mô tả initial-value phải là giá trị độc lập về mặt tính toán. Điều này có nghĩa là giá trị có thể được chuyển đổi thành giá trị tính toán mà không phụ thuộc vào các giá trị khác, ngoại trừ các định nghĩa "toàn cục" độc lập với CSS. Ví dụ, 10px là độc lập về mặt tính toán - nó không thay đổi khi được chuyển đổi thành giá trị tính toán. 2in cũng hợp lệ, vì 1in luôn tương đương với 96px. Tuy nhiên, 3em không hợp lệ, vì giá trị của em phụ thuộc vào font-size của phần tử cha.
Định nghĩa chính thức
| Related at-rule | @property |
|---|---|
| Initial value | n/a (required) |
| Computed value | as specified |
Cú pháp chính thức
initial-value =
<declaration-value>?
Ví dụ
>Đặt giá trị ban đầu cho thuộc tính tùy chỉnh
Ví dụ này cho thấy cách định nghĩa thuộc tính tùy chỉnh --my-color với giá trị màu ban đầu là #c0ffee. Giá trị ban đầu này sẽ được sử dụng khi thuộc tính không được kế thừa (inherits: false) và không có giá trị nào khác được đặt trên phần tử.
@property --my-color {
syntax: "<color>";
inherits: false;
initial-value: #c0ffee;
}
Sử dụng JavaScript CSS.registerProperty():
window.CSS.registerProperty({
name: "--my-color",
syntax: "<color>",
inherits: false,
initialValue: "#c0ffee",
});
Thông số kỹ thuật
| Specification |
|---|
| CSS Properties and Values API Level 1> # initial-value-descriptor> |