SVGLength: convertToSpecifiedUnits() 方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

SVGLength 介面的 convertToSpecifiedUnits() 方法允許您將長度值轉換為指定的單位型別。

此函式將

語法

js
convertToSpecifiedUnits(unitType)

引數

unitType

表示長度值應轉換為的單位型別的常量。它必須是為 unitType 屬性定義的常量值之一,但 SVG_LENGTHTYPE_UNKNOWN 除外。

  • SVGLength.SVG_LENGTHTYPE_NUMBER:轉換為無單位的數字
  • SVGLength.SVG_LENGTHTYPE_PERCENTAGE:轉換為百分比
  • SVGLength.SVG_LENGTHTYPE_EMS:轉換為 em 單位
  • SVGLength.SVG_LENGTHTYPE_EXS:轉換為 ex 單位
  • SVGLength.SVG_LENGTHTYPE_PX:轉換為畫素
  • SVGLength.SVG_LENGTHTYPE_CM:轉換為釐米
  • SVGLength.SVG_LENGTHTYPE_MM:轉換為毫米
  • SVGLength.SVG_LENGTHTYPE_IN:轉換為英寸
  • SVGLength.SVG_LENGTHTYPE_PT:轉換為點
  • SVGLength.SVG_LENGTHTYPE_PC:轉換為派卡(picas)

返回值

無(undefined)。

示例

將長度轉換為毫米

js
// Get an SVGLength object
const svg = document.querySelector("svg");
const length = svg.createSVGLength();

// Set a length value in centimeters
length.valueAsString = "0.5cm";

// Convert the length to millimeters
length.convertToSpecifiedUnits(SVGLength.SVG_LENGTHTYPE_MM);

console.log(length.unitType); // Output: 7 (SVG_LENGTHTYPE_MM)
console.log(length.valueInSpecifiedUnits); // Output: 5
console.log(length.valueAsString); // Output: "5mm"

規範

規範
Scalable Vector Graphics (SVG) 2
# __svg__SVGLength__convertToSpecifiedUnits

瀏覽器相容性

另見