CSSPrimitiveValue: setStringValue() 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 setStringValue() của giao diện CSSPrimitiveValue dùng để đặt giá trị chuỗi. Nếu thuộc tính gắn với giá trị này không chấp nhận đơn vị hoặc giá trị chuỗi đã chỉ định, giá trị sẽ không thay đổi và một DOMException sẽ được ném ra.
Note: Phương thức này là một phần của nỗ lực tạo ra CSS Object Model có kiểu. Nỗ lực này đã bị từ bỏ và hầu hết các trình duyệt không triển khai nó.
Để đạt được mục đích của bạn, bạn có thể sử dụng:
- CSS Object Model không có kiểu, được hỗ trợ rộng rãi, hoặc
- CSS Typed Object Model API hiện đại, ít được hỗ trợ hơn và được coi là thử nghiệm.
Cú pháp
setStringValue(stringType, stringValue)
Tham số
stringType-
Một
unsigned shortđại diện cho kiểu của giá trị. Các giá trị có thể là: stringValue-
Một chuỗi đại diện cho giá trị chuỗi mới.
Giá trị trả về
Không có (undefined).
Ngoại lệ
InvalidAccessErrorDOMException-
Được ném ra nếu giá trị CSS không chứa giá trị chuỗi hoặc giá trị chuỗi không thể chuyển đổi sang đơn vị đã chỉ định.
NoModificationAllowedErrorDOMException-
Được ném ra nếu thuộc tính chỉ đọc.
Thông số kỹ thuật
Tính năng này ban đầu được định nghĩa trong đặc tả DOM Style Level 2, nhưng kể từ đó đã bị loại bỏ khỏi mọi nỗ lực chuẩn hóa.
Nó đã được thay thế bởi một CSS Typed Object Model API hiện đại nhưng không tương thích, hiện đang trong lộ trình chuẩn hóa.