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.

Cú pháp

js
newValueSpecifiedUnits(unitType, valueInSpecifiedUnits)

Tham số

unitType

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 unitTypeSVG_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ể

js
// 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)

Thông số kỹ thuật

Thông số kỹ thuật
Scalable Vector Graphics (SVG) 2
# __svg__SVGLength__newValueSpecifiedUnits

Tương thích trình duyệt

Xem thêm