SVGLength: newValueSpecifiedUnits() method

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Phương thức newValueSpecifiedUnits() của giao diện SVGLength đặt lại giá trị dưới dạng số với unitType liên kết, thay thế các giá trị của tất cả thuộc tính trên đối tượng.

Một hằng số đại diện cho loại đơn vị mà giá trị độ dài cần được chuyển đổi sang. Đây phải là một trong các giá trị hằng số được định nghĩa cho thuộc tính unitType, ngoại trừ SVG_LENGTHTYPE_UNKNOWN.

SVGLength.SVG_LENGTHTYPE_NUMBER: chuyển sang số không đơn vị
SVGLength.SVG_LENGTHTYPE_PERCENTAGE: chuyển sang phần trăm
SVGLength.SVG_LENGTHTYPE_EMS: chuyển sang đơn vị em
SVGLength.SVG_LENGTHTYPE_EXS: chuyển sang đơn vị ex
SVGLength.SVG_LENGTHTYPE_PX: chuyển sang pixel
SVGLength.SVG_LENGTHTYPE_CM: chuyển sang centimeter
SVGLength.SVG_LENGTHTYPE_MM: chuyển sang millimeter
SVGLength.SVG_LENGTHTYPE_IN: chuyển sang inch
SVGLength.SVG_LENGTHTYPE_PT: chuyển sang point
SVGLength.SVG_LENGTHTYPE_PC: chuyển sang pica

valueInSpecifiedUnits

Hệ số số của giá trị độ dài, được biểu thị theo loại đơn vị đã chỉ định.

Giá trị trả về

Không có (undefined).

Ngoại lệ

Phương thức này có thể ném ra DOMException với một trong các kiểu sau:

NotSupportedError DOMException: Được ném ra nếu unitType là SVG_LENGTHTYPE_UNKNOWN hoặc không phải hằng số loại đơn vị hợp lệ.
NoModificationAllowedError DOMException: Được ném ra nếu SVGLength tương ứng với thuộc tính chỉ đọc hoặc khi chính đối tượng là chỉ đọc.

Ví dụ

Đặt giá trị độ dài với các đơn vị cụ thể

// Lấy đối tượng SVGLength
const svg = document.querySelector("svg");
const length = svg.createSVGLength();

// Đặt giá trị mới với các đơn vị cụ thể
length.newValueSpecifiedUnits(SVGLength.SVG_LENGTHTYPE_NUMBER, 45);
console.log(length.valueInSpecifiedUnits); // Output: 45
console.log(length.unitType); // Output: 1 (SVG_LENGTHTYPE_NUMBER)
console.log(length.value); // Giá trị được chuyển đổi sang hệ tọa độ người dùng

// Thay đổi giá trị sang pixel
length.newValueSpecifiedUnits(SVGLength.SVG_LENGTHTYPE_PX, 100);
console.log(length.valueInSpecifiedUnits); // Output: 100
console.log(length.unitType); // Output: 5 (SVG_LENGTHTYPE_PX)