CSSPrimitiveValue
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.
Giao diện CSSPrimitiveValue kế thừa từ giao diện CSSValue và đại diện cho giá trị tính toán hiện tại của một thuộc tính CSS.
Note: Giao diện 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.
Giao diện này đại diện cho một giá trị CSS đơn lẻ. Nó có thể được sử dụng để xác định giá trị của một thuộc tính style cụ thể hiện đang được đặt trong một block hoặc để đặt rõ ràng một thuộc tính style cụ thể trong block. Một đối tượng của giao diện này có thể được lấy từ phương thức getPropertyCSSValue() của giao diện CSSStyleDeclaration. Một đối tượng CSSPrimitiveValue chỉ xuất hiện trong ngữ cảnh của một thuộc tính CSS.
Việc chuyển đổi được cho phép giữa các giá trị tuyệt đối (từ milimet sang centimet, từ độ sang radian, v.v.) nhưng không phải giữa các giá trị tương đối. (Ví dụ, giá trị pixel không thể chuyển đổi sang giá trị centimet.) Giá trị phần trăm không thể chuyển đổi vì chúng tương đối so với giá trị cha (hoặc giá trị thuộc tính khác). Có một ngoại lệ cho giá trị phần trăm màu: vì giá trị phần trăm màu tương đối so với phạm vi 0-255, giá trị phần trăm màu có thể chuyển đổi thành số (xem thêm giao diện RGBColor).
Thuộc tính phiên bản
Kế thừa các thuộc tính từ lớp cha, CSSValue.
CSSPrimitiveValue.primitiveTypeRead only Deprecated-
Một
unsigned shortđại diện cho kiểu của giá trị. Các giá trị có thể là:Hằng số Mô tả CSS_ATTRGiá trị là hàm attr(). Giá trị có thể lấy bằng phương thứcgetStringValue().CSS_CMGiá trị là <length>tính bằng centimet. Giá trị có thể lấy bằng phương thứcgetFloatValue().CSS_COUNTERGiá trị là hàm counter hoặc counters. Giá trị có thể lấy bằng phương thức getCounterValue().CSS_DEGGiá trị là <angle>tính bằng độ. Giá trị có thể lấy bằng phương thứcgetFloatValue().CSS_DIMENSIONGiá trị là <number>với kích thước không xác định. Giá trị có thể lấy bằng phương thứcgetFloatValue().CSS_EMSGiá trị là <length>tính bằng đơn vị em. Giá trị có thể lấy bằng phương thứcgetFloatValue().CSS_EXSGiá trị là <length>tính bằng đơn vị ex. Giá trị có thể lấy bằng phương thứcgetFloatValue().CSS_GRADGiá trị là <angle>tính bằng grad. Giá trị có thể lấy bằng phương thứcgetFloatValue().CSS_HZGiá trị là <frequency>tính bằng Hertz. Giá trị có thể lấy bằng phương thức getFloatValue.CSS_IDENTGiá trị là một định danh. Giá trị có thể lấy bằng phương thức getStringValue().CSS_INGiá trị là <length>tính bằng inch. Giá trị có thể lấy bằng phương thứcgetFloatValue().CSS_KHZGiá trị là <frequency>tính bằng Kilohertz. Giá trị có thể lấy bằng phương thứcgetFloatValue().CSS_MMGiá trị là <length>tính bằng milimet. Giá trị có thể lấy bằng phương thứcgetFloatValue().CSS_MSGiá trị là <time>tính bằng miligiây. Giá trị có thể lấy bằng phương thứcgetFloatValue().CSS_NUMBERGiá trị là <number>đơn giản. Giá trị có thể lấy bằng phương thứcgetFloatValue().CSS_PCGiá trị là <length>tính bằng pica. Giá trị có thể lấy bằng phương thứcgetFloatValue().CSS_PERCENTAGEGiá trị là <percentage>. Giá trị có thể lấy bằng phương thứcgetFloatValue().CSS_PTGiá trị là <length>tính bằng điểm. Giá trị có thể lấy bằng phương thứcgetFloatValue().CSS_PXGiá trị là <length>tính bằng pixel. Giá trị có thể lấy bằng phương thứcgetFloatValue().CSS_RADGiá trị là <angle>tính bằng radian. Giá trị có thể lấy bằng phương thứcgetFloatValue().CSS_RECTGiá trị là hàm rect(). Giá trị có thể lấy bằng phương thứcgetRectValue().CSS_RGBCOLORGiá trị là <color>. Giá trị có thể lấy bằng phương thứcgetRGBColorValue().CSS_SGiá trị là <time>tính bằng giây. Giá trị có thể lấy bằng phương thứcgetFloatValue().CSS_STRINGGiá trị là <string>. Giá trị có thể lấy bằng phương thứcgetStringValue().CSS_UNKNOWNGiá trị không phải là giá trị CSS2 được nhận dạng. Giá trị chỉ có thể lấy bằng thuộc tính cssText.CSS_URIGiá trị là <url>. Giá trị có thể lấy bằng phương thứcgetStringValue().
Phương thức phiên bản
CSSPrimitiveValue.getCounterValue()Deprecated-
Phương thức này dùng để lấy giá trị counter. Nếu giá trị CSS này không chứa giá trị counter, một
DOMExceptionsẽ được ném ra. Việc sửa đổi thuộc tính style tương ứng có thể được thực hiện bằng giao diệnCounter. CSSPrimitiveValue.getFloatValue()Deprecated-
Phương thức này dùng để lấy giá trị float theo đơn vị đã chỉ định. Nếu giá trị CSS này không chứa giá trị float hoặc không thể chuyển đổi sang đơn vị đã chỉ định, một
DOMExceptionsẽ được ném ra. CSSPrimitiveValue.getRGBColorValue()Deprecated-
Phương thức này dùng để lấy giá trị màu RGB. Nếu giá trị CSS này không chứa giá trị màu RGB, một
DOMExceptionsẽ được ném ra. Việc sửa đổi thuộc tính style tương ứng có thể được thực hiện bằng giao diệnRGBColor. CSSPrimitiveValue.getRectValue()Deprecated-
Phương thức này dùng để lấy giá trị Rect. Nếu giá trị CSS này không chứa giá trị rect, một
DOMExceptionsẽ được ném ra. Việc sửa đổi thuộc tính style tương ứng có thể được thực hiện bằng giao diệnRect. CSSPrimitiveValue.getStringValue()Deprecated-
Phương thức này dùng để lấy giá trị chuỗi. Nếu giá trị CSS không chứa giá trị chuỗi, một
DOMExceptionsẽ được ném ra. CSSPrimitiveValue.setFloatValue()Deprecated-
Phương thức đặt giá trị float với đơn vị đã chỉ định. 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ị float đã chỉ định, giá trị sẽ không thay đổi và một
DOMExceptionsẽ được ném ra. CSSPrimitiveValue.setStringValue()Deprecated-
Phương thức đặt giá trị chuỗi với đơn vị đã chỉ định. 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
DOMExceptionsẽ được ném ra.
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.