transform
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年9月.
transform 属性は、要素とその要素の子に適用される座標変換定義のリストを定義します。
メモ:
プレゼンテーション属性であるため、 transform には対応する CSS プロパティ transform があります。両方が指定された場合、 CSS プロパティが優先されます。ただし、 CSS プロパティとこの属性との間には構文の違いがあるので注意が必要です。
要素
SVG 2 では、 transform 属性は <svg> ルート要素を含む任意の要素に使用できます。
なお、<svg> ルート要素への transform 適用は新しい機能であるため、対応状況はブラウザーの互換性を確認する必要があります。
<svg> ルートへの transform 適用は、追加のラッパー要素や CSS による回避策を必要とせず、SVG 画像全体に変換を適用するのに便利です。
SVG 1.1 では、 <a>, <circle>, <clipPath>, <defs>, <ellipse>, <foreignObject>, <g>, <image>, <line>, <path>, <polygon>, <polyline>, <rect>, <switch>, <text>, <use> の 16 要素でのみ使用することができました。
また、 SVG 1.1 の名残として、 <linearGradient> と <radialGradient> は gradientTransform 属性に対応しており、 <pattern> は patternTransform 属性に対応しており、どちらも transform 属性と全く同じように動作します。
値
| 値 |
<transform-list>
|
|---|---|
| デフォルト値 | なし |
| アニメーション | 可 |
例
座標変換を単一の SVG 要素に適用
この例では、SVG 文書内の単一の <g> 要素に transform を適用します。
<svg
viewBox="-40 0 150 100"
xmlns="http://www.w3.org/2000/svg"
xmlns:xlink="http://www.w3.org/1999/xlink">
<g
fill="grey"
transform="rotate(-10 50 100)
translate(-36 45.5)
skewX(40)
scale(1 0.5)">
<path
id="heart"
d="M 10,30 A 20,20 0,0,1 50,30 A 20,20 0,0,1 90,30 Q 90,60 50,90 Q 10,60 10,30 z" />
</g>
<use href="#heart" fill="none" stroke="red" />
</svg>
座標変換を SVG 文書全体に適用
この例では、transform を <svg> ルート要素に適用します。これは、変換が SVG 文書全体に適用されるということです。
<svg
viewBox="-40 0 150 100"
xmlns="http://www.w3.org/2000/svg"
xmlns:xlink="http://www.w3.org/1999/xlink"
transform="rotate(-10 50 100)
translate(-36 15.5)
skewX(40)
scale(1 0.5)">
<g fill="grey">
<path
id="heart"
d="M 10,30 A 20,20 0,0,1 50,30 A 20,20 0,0,1 90,30 Q 90,60 50,90 Q 10,60 10,30 z" />
</g>
<use href="#heart" fill="none" stroke="red" />
</svg>
座標変換関数
以下の変換関数は、 transform 属性の <transform-list> で使用することができます。
警告: 仕様書によれば、 CSS の座標変換関数も使用することができます。しかし、互換性は保証されていません。
matrix
matrix(<a> <b> <c> <d> <e> <f>) 変換関数は、6 つの値の変換行列の形式で変形を指定します。 matrix(a,b,c,d,e,f) は次の変換行列を適用することと等価です。
これは、前の座標系から新しい座標系への座標の写像を次の行列の等式によって行うものです。
例
<svg viewBox="0 0 200 200" xmlns="http://www.w3.org/2000/svg">
<rect x="10" y="10" width="30" height="20" fill="green" />
<!--
In the following example we are applying the matrix:
[a c e] [3 -1 30]
[b d f] => [1 3 40]
[0 0 1] [0 0 1]
which transform the rectangle as such:
top left corner: oldX=10 oldY=10
newX = a * oldX + c * oldY + e = 3 * 10 - 1 * 10 + 30 = 50
newY = b * oldX + d * oldY + f = 1 * 10 + 3 * 10 + 40 = 80
top right corner: oldX=40 oldY=10
newX = a * oldX + c * oldY + e = 3 * 40 - 1 * 10 + 30 = 140
newY = b * oldX + d * oldY + f = 1 * 40 + 3 * 10 + 40 = 110
bottom left corner: oldX=10 oldY=30
newX = a * oldX + c * oldY + e = 3 * 10 - 1 * 30 + 30 = 30
newY = b * oldX + d * oldY + f = 1 * 10 + 3 * 30 + 40 = 140
bottom right corner: oldX=40 oldY=30
newX = a * oldX + c * oldY + e = 3 * 40 - 1 * 30 + 30 = 120
newY = b * oldX + d * oldY + f = 1 * 40 + 3 * 30 + 40 = 170
-->
<rect
x="10"
y="10"
width="30"
height="20"
fill="red"
transform="matrix(3 1 -1 3 30 40)" />
</svg>
translate
translate(<x> [<y>]) 変換関数は、オブジェクトを x と y によって移動します。 y が提供されなかった場合は、 0 と見なします。
言い換えれば、次の通りです。
xNew = xOld + <x> yNew = yOld + <y>
例
<svg viewBox="0 0 100 100" xmlns="http://www.w3.org/2000/svg">
<!-- No translation -->
<rect x="5" y="5" width="40" height="40" fill="green" />
<!-- Horizontal translation -->
<rect
x="5"
y="5"
width="40"
height="40"
fill="blue"
transform="translate(50)" />
<!-- Vertical translation -->
<rect
x="5"
y="5"
width="40"
height="40"
fill="red"
transform="translate(0 50)" />
<!-- Both horizontal and vertical translation -->
<rect
x="5"
y="5"
width="40"
height="40"
fill="yellow"
transform="translate(50 50)" />
</svg>
scale
scale(<x> [<y>]) 変換関数は、 x と y による拡大縮小操作を指定します。 y が提供されなかった場合は、 x と同じと見なします。
例
<svg viewBox="-50 -50 100 100" xmlns="http://www.w3.org/2000/svg">
<!-- uniform scale -->
<circle cx="0" cy="0" r="10" fill="red" transform="scale(4)" />
<!-- vertical scale -->
<circle cx="0" cy="0" r="10" fill="yellow" transform="scale(1, 4)" />
<!-- horizontal scale -->
<circle cx="0" cy="0" r="10" fill="pink" transform="scale(4, 1)" />
<!-- No scale -->
<circle cx="0" cy="0" r="10" fill="black" />
</svg>
rotate
rotate(<a> [<x> <y>]) 変換関数は、指定された点を軸に a 度の回転を指定します。オプションの引数 x と y が提供されなかった場合、回転は現在のユーザーの座標系の原点を基準に行われます。オプションの引数 x と y が指定された場合は、回転は (x, y) を基準に行われます。
例
<svg viewBox="-12 -2 34 14" xmlns="http://www.w3.org/2000/svg">
<rect x="0" y="0" width="10" height="10" />
<!-- rotation is done around the point 0,0 -->
<rect x="0" y="0" width="10" height="10" fill="red" transform="rotate(100)" />
<!-- rotation is done around the point 10,10 -->
<rect
x="0"
y="0"
width="10"
height="10"
fill="green"
transform="rotate(100, 10, 10)" />
</svg>
skewX
skewX(<a>) 変換関数は、 X 軸を基準に a 度の傾斜座標変換を指定します。
例
<svg viewBox="-5 -5 10 10" xmlns="http://www.w3.org/2000/svg">
<rect x="-3" y="-3" width="6" height="6" />
<rect x="-3" y="-3" width="6" height="6" fill="red" transform="skewX(30)" />
</svg>
skewY
skewY(<a>) 変換関数は、 Y 軸を基準に a 度の傾斜座標変換を指定します。
例
<svg viewBox="-5 -5 10 10" xmlns="http://www.w3.org/2000/svg">
<rect x="-3" y="-3" width="6" height="6" />
<rect x="-3" y="-3" width="6" height="6" fill="red" transform="skewY(30)" />
</svg>
仕様書
| Specification |
|---|
| CSS Transforms Module Level 1 # svg-transform |
| Scalable Vector Graphics (SVG) 2 # TransformProperty |
ブラウザーの互換性
Loading…
関連情報
- CSS の
transformプロパティ