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

css
/* Đặ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<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 valuen/a (required)
Computed valueas 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ử.

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

Sử dụng JavaScript CSS.registerProperty():

js
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

Khả năng tương thích trình duyệt

Xem thêm