CSSStyleSheet: addRule() method

Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.

Phương thức legacy addRule() của giao diện CSSStyleSheet đã lỗi thời thêm một quy tắc mới vào bảng kiểu. Bạn nên tránh sử dụng phương thức này, và thay vào đó nên sử dụng phương thức tiêu chuẩn hơn insertRule().

Cú pháp

js
addRule(selector, styleBlock, index)

Tham số

selector

Một chuỗi chỉ định phần bộ chọn của quy tắc CSS. Giá trị mặc định là chuỗi undefined.

styleBlock

Một chuỗi chỉ định khối kiểu dáng áp dụng cho các phần tử khớp với selector. Giá trị mặc định là chuỗi undefined.

index Optional

Một chỉ số tùy chọn trong CSSRuleList của bảng kiểu để chèn quy tắc mới vào. Nếu không chỉ định index, chỉ số tiếp theo sau mục cuối cùng hiện có trong danh sách sẽ được sử dụng (cụ thể là giá trị của cssStyleSheet.cssRules.length).

Giá trị trả về

Luôn trả về -1.

Lưu ý rằng do các quy tắc khá phức tạp về vị trí bạn có thể chèn quy tắc hợp lệ, nên có thể một ngoại lệ sẽ được ném ra. Xem insertRule() để biết thêm thông tin.

Ghi chú sử dụng

Phương thức này được các trình duyệt triển khai bằng cách xây dựng một chuỗi sử dụng template literal `${selector}{${styleBlock}}`, sau đó truyền nó vào phương thức tiêu chuẩn insertRule().

Do đó, với mã hiện có như sau:

js
cssStyleSheet.addRule(selector, styles, 0);

Bạn có thể viết lại để sử dụng insertRule() tiêu chuẩn hơn như sau:

js
cssStyleSheet.insertRule(`${selector} {${styles}}`, 0);

Specifications

Thông số kỹ thuật
CSS Object Model (CSSOM)
# dom-cssstylesheet-addrule

Browser compatibility

See also