SVGAngle: convertToSpecifiedUnits() メソッド

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.

convertToSpecifiedUnits()SVGAngle インターフェイスのメソッドで、角度の値を指定した単位型に変換することができます。

この関数は次のことを行います。

  • 指定された単位型で unitType プロパティを更新する
  • valueInSpecifiedUnits および valueAsString プロパティを更新し、角度値が指定された単位型で表現されるようにする

構文

js
convertToSpecifiedUnits(unitType)

引数

unitType

角度値を変換する単位型を表す定数です。 これは、 unitType プロパティに対して定義された定数値のいずれかでなければならず、 SVG_ANGLETYPE_UNKNOWN は例外となります。

  • SVGAngle.SVG_ANGLETYPE_DEG: 度に変換
  • SVGAngle.SVG_ANGLETYPE_RAD: ラジアンに変換
  • SVGAngle.SVG_ANGLETYPE_GRAD: グラードに変換
  • SVGAngle.SVG_ANGLETYPE_UNSPECIFIED: 単位なしの値に変換、度として解釈される

返値

なし (undefined)。

角度を度に変換

js
// SVGAngle オブジェクトを取得
const svg = document.querySelector("svg");
const angle = svg.createSVGAngle();

// 角度の値をラジアンで設定 (Math.PI / 2)
angle.newValueSpecifiedUnits(SVGAngle.SVG_ANGLETYPE_RAD, Math.PI / 2);

// 角度の値を文字列として受け取る
console.log(angle.valueAsString); // 出力: 1.5708rad
console.log(angle.unitType); // 出力: 3 (SVG_ANGLETYPE_RAD)

// 角度の値を度に変換
angle.convertToSpecifiedUnits(SVGAngle.SVG_ANGLETYPE_DEG);

// 角度の値を文字列として受け取る
console.log(angle.valueAsString); // 出力: 90deg
console.log(angle.unitType); // 出力: 2 (SVG_ANGLETYPE_DEG)

仕様書

Specification
Scalable Vector Graphics (SVG) 2
# __svg__SVGAngle__convertToSpecifiedUnits

ブラウザーの互換性

関連情報