1. 序論
◎非規範的`transform$p ~propと それに関係する各~propは、 `~box$を それが~lay-outされた位置から相対的に， 任意に位置し直す（回転する, 拡縮する, 等々）ことを許容する — 当の~page上の他の要素の~layoutを妨害することなく。 これらの位置は，~CSSで［ ~animateできる／遷移できる ］が、 比較的~単純な仕方 — ~boxを その開始~時の位置から終了~時の位置へ真直な線~内で移動すること — に限られていた。 ◎ The transform property and its related properties allow a box to be arbitrarily repositioned (and rotated, scaled, etc) relative to its laid out position, without disrupting the layout of any other elements on the page. These positions can be animated or transitioned with CSS, but only in relatively simple ways: moving a box in a straight line from its starting position to its ending position.
この仕様は、 `~offset変形$を定義するための一式の~prop — `offset$p 略式, その下位propたち — を導入する。 `~offset変形@ は、 要素~上の特定0の点（ `offset-anchor$p ）を ある`~path^em（ `offset-path$p ）上の `~offset位置@ （ `offset-distance$p ）に整列することに加え， 任意選択で要素を~path方向に従うよう回転する（ `offset-rotate$p ）変形である。 ◎ This specification introduces the offset shorthand, and its suite of associated longhand properties, which define an offset transform: a transform which aligns a particular point on an element (offset-anchor) to an offset position on a path (offset-path and offset-distance), and optionally rotates it to follow the path direction (offset-rotate).
これは、 いくつかの強力な変形のアリ性を新たに許容する — 極-座標を利用して位置したり （ `translate$f 関数により利用される標準な矩形な座標ではなく， `ray$f 関数で）， `定義された~path^emに沿って要素を~animateすることで，二次元~空間~上で複階的な遷移を容易に定義できるようにする。 ◎ This allows a number of powerful new transform possibilities, such as positioning using polar coordinates (with the ray() function) rather than the standard rectangular coordinates used by the translate() function, or animating an element along a defined path, making it easy to define complex and beautiful 2d spatial transitions.
例えば，次の絵図は、 曲な~path（破線で指示される）と~pathに沿って様々な点に位置された飛行機~graphicを示す。 飛行機は、 ~path上の各~位置にて，~pathが進む方向を向く。 ◎ For example, the following picture shows a curving path (indicated with dotted lines), and an airplane graphic positioned at various points along the path. The plane faces in the direction of the path at each position on the path.
`offset-distance$p の異なる値たち — `0%^v, `50%^v, `100%^v — に対応する所に示された飛行機。 ◎ The plane is shown at different offset-distance values: 0%, 50%, and 100%.
1.1. ~module間の相互作用
この仕様は、 要素に適用できる変形（ `CSS-TRANSFORMS-1$r ）として， 追加的な型を定義する。 ◎ This specification defines additional types of transforms (see [css-transforms-1]) that can be applied to an element.
この文書により定義される変形は、 `CSS-TRANSFORMS-2$r `§ 現在の変形~行列＠~TRANSFORM2#ctm$ にて述べられるとおり，個々の変形~prop — `translate$p, `rotate$p, `scale$p （ `CSS-TRANSFORMS-2$r ） — より後かつ `transform$p ~prop（ `CSS-TRANSFORMS-1$r ） より前に適用される。 ◎ As described in CSS Transforms 2 § 6 Current Transformation Matrix, the transforms defined by this document are layered after the individual transform properties (translate/rotate/scale, defined in [css-transforms-2]) and before the transform property (defined in [css-transforms-1]).
1.2. 値
`basic-shape$t 型は `CSS-SHAPES$r にて定義される。 `coord-box$t 型は `CSS-BOX-3$r にて定義される。 ◎ This specification follows the CSS property definition conventions from [CSS21]. The <basic-shape> type is defined in CSS Shapes Module Level 1 [CSS-SHAPES]. The <coord-box> type is defined in CSS Box Model Module Level 3 [CSS-BOX-3].＼
【 以下、 この節の内容は `~CSS日本語訳 共通~page＠~CSScommon#values$に移譲。 】 ◎ Value types not defined in these specifications are defined in CSS Values and Units Module Level 3 [CSS3VAL]. ◎ In addition to the property-specific values listed in their definitions, all properties defined in this specification also accept CSS-wide keywords such as initial and inherit as their property value [CSS3VAL]. For readability it has not been repeated explicitly.
2. ~motion~path
2.1. ~pathの定義-法： `offset-path^p ~prop
◎名 `offset-path@p ◎値 `none^v | `offset-path$t || `coord-box$t ◎初 `none^v ◎適 `変形-可能な要素$ ◎継 されない ◎百 受容しない ◎算 指定されたとおおり ◎順 文法に従う ◎ア 算出された値~型による ◎表終`~offset~path@ を指定する — それは，幾何的な~pathであり、 ~boxは，その`~anchor点$がその上に乗るよう位置される。 ◎ Specifies the offset path, a geometrical path the box gets positioned on.
`offset-path@t = `ray()$t | `url$t | `basic-shape$t
各種 値の意味は： ◎ Values have the following meanings:
- `none@v
- 要素は、 `~offset変形$を有さない。 ◎ The element does not have an offset transform.
- `offset-path$t
- 要素は、 ある`~offset~path$により定義される`~offset変形$を有する。 `~offset変形$を計算する方法についての詳細は、 `§ ~offset変形の計算-法＠#transform$ を見よ。 ◎ The element has an offset transform, defined by some offset path. See § 2.7 Calculating The Offset Transform for details on how to calculate the offset transform.
- `transform$p を有することによる通例の効果（`積層~文脈$を作成する，等々）は、 すべて適用される — 詳細は、 `CSS-TRANSFORMS-1$r `§ 変形の描画~model＠~TRANSFORM#transform-rendering$ を見よ。 ◎ All the usual effects of having a transform apply (such as creating a stacking context, etc.) See CSS Transforms 1 § 2 The Transform Rendering Model for details.
- 省略された場合の既定は、 `inset(0 round X)^v になる — ここで %X は、 この要素~用の`包含塊$を確立した要素~上の `border-radius$p の算出d値になるとする。 ◎ If <offset-path> is omitted, it defaults to inset(0 round X), where X is the value of border-radius on the element that establishes the containing block for this element.＼ ↓↓ If <coord-box> is omitted, it defaults to border-box.
-
各~成分の解釈は、 以下に従う： ◎ See the specific values (below) for the interpretation of each component.
- `ray()$t
-
`~offset~path$は、
`射線$になる。
詳細は
`§
ray()関数＠#ray-function$ を見よ。 ◎ The offset path is a line extending from the origin at some angle. See § 2.1.1 The ray() Function for details. - `coord-box$t は、 当の`射線$用の`基準box$を供する。 ◎ The <coord-box> provides the reference box for the ray.
- `url$t
- 所与の~URLは，ある~SVG`図形~要素$ `SVG2$r への~URL参照になる場合、 `~offset~path$は，参照された要素に`等価な~path$0になる。 ◎ A URL reference to an SVG shape element. The offset path is the referenced element’s equivalent path. [SVG2]
- 他の場合 （`無効な参照＠~SVGlinking#TermInvalidReference$である場合）、 代わりに， `path("m 0 0")^v （ある `basic-shape$t ）として挙動する。 ◎ If the URL does not reference a shape element (because it references a different element, or resolves to a non-SVG document, or doesn’t resolve at all, etc) this behaves as path("m 0 0") (a <basic-shape>) instead.
- `coord-box$t は、 当の`図形~要素$用の［ `表示域~座標系$, `利用元~座標系$ ］を定義する — その原点は左上~隅にあり，~sizeにおける単位は `1px^v とする。 ◎ The <coord-box> defines the viewport and user coordinate system for the shape element, with the origin (the 0,0 point) at the top left corner, and units being 1px in size.
- `basic-shape$t
- `~offset~path$は、 当の `basic-shape$t 関数に`等価な~path$になる。 ◎ The offset path is the equivalent path of the <basic-shape> function.
-
`basic-shape$t を成す各~関数のうち，
`at^v `position^t引数を受容するものに対しては、 その引数が省略された場合， その引数~用には次が利用される：- 当の要素は `offset-position$p を介して`開始~時の~offset位置$を定義する場合、 それ
- 他の場合、 当の関数~用に指定された既定。
- `coord-box$t は、 `basic-shape$t 用の`基準box$を供する。 ◎ The <coord-box> provides the [=/reference box=] for the <basic-shape>.
- `coord-box$t
- `offset-path$t は、 この引数が定義する~boxの中で~sizeされる。 ◎ Defines the box that the <offset-path> sizes into.
- ~CSS文脈においては、 参照されるのは，［ この要素~用に`包含塊$を確立する要素 ］用の~boxである。 【例えば `content-box^v ならば、包含塊を確立する要素の内容~box, 等々】 ◎ In CSS contexts, the boxes being referenced are from the element that establishes the containing block for this element.
- ~SVG文脈においては、 すべての値は `view-box$v として挙動する。 ◎ In SVG contexts, all values behave as view-box.
- 省略された場合の既定は、 `border-box^v になる。 ◎ ↑↑
2.1.1. `ray^f 関数
`ray$f 関数は、 `~offset~path$を `射線@ — ある点から ある角度で出ている真直な線 — として定義する： ◎ The ray() function defines an offset path as a straight line emerging from a point at some defined angle:
`ray()@t = ray( `angle$t && `ray-size$t? && `contain$v? && [at `position$t]? ) `ray-size@t = `closest-side^v | `closest-corner^v | `farthest-side^v | `farthest-corner^v | `sides^v
以下の記述においては ⇒＃ %要素 は，この関数を `offset-path$p に利用している要素を指す。 %包含塊 は， %要素 の`包含塊$を指す。
`ray$f 関数の各~引数は： ◎ Its arguments are:
- `angle$t
- `射線$が始点から出る方向を指定する。 `~gradient関数$と同じく， 値は方角を与える角度として解釈される ⇒＃ `0deg^v は真上を指す。 正な角度は時計回りな回転を表現する。 ◎ The offset path is a single line segment that starts from the offset starting position and proceeds in the direction defined by the specified <angle>. (Its length is determined by the other arguments.) As with gradient functions, <angle> values are interpreted as bearing angles, with 0deg pointing up and positive angles representing clockwise rotation.
- `ray-size$t
- `射線$の`総-長さ$【！(the distance between...】 （`~offset距離$【！`offset-distance$p】 0% の所から 100% の所までの距離） を %包含塊 に相対的に指定する。 ◎ Specifies the length of the offset path (the distance between the offset-distance: 0% and offset-distance: 100% points) relative to the containing box.
- 指定されない場合の既定は、 `closest-side$v になる。 ◎ If no <ray-size> is specified it defaults to closest-side.
- 注記： この値が `sides$v をとる場合、 距離は，指定された `angle^t に依存する — 他の場合は `angle^t に依存しない。 ◎ Note: For sides, the distance depends on the <angle> specified; for all other values, the distance is constant regardless of the <angle>.
-
個々の~keywordは： ◎ Individual keywords are:
- `closest-side@v
- 始点から %包含塊 の各~側のうち最も近い所までの距離。 ◎ The distance from the ray’s starting point to whichever side of the containing block is closest.
- `closest-corner@v
- 始点から %包含塊 の各~隅のうち最も近い所までの距離。 ◎ The distance from the ray’s starting point to whichever corner of the containing block is closest.
- `farthest-side@v
- 始点から %包含塊 の各~側のうち最も遠い所までの距離。 ◎ The distance from the ray’s starting point to whichever side of the containing block is farthest.
- `farthest-corner@v
- 始点から %包含塊 の各~隅のうち最も遠い所までの距離。 ◎ The distance from the ray’s starting point to whichever corner of the containing block is farthest.
- `sides@v
- 始点から［ `射線$が %包含塊 の境界に交差する点 ］までの距離。 ◎ The distance from the ray’s starting point to the point where the offset path intersects the containing block’s boundary.
- 始点が %包含塊 の境界~上か外側にある場合、 距離は 0 になる。 ◎ If the ray’s starting point is on the containing block’s boundary, or outside its bounds entirely, the distance is zero.
- 注記： ［ `closest-side$v ／ `closest-corner$v ］に対しては、 `射線$の始点が［ 辺／隅 ］に一致しているならば，それが最も近いものになる （言い換えれば、 距離は 0 になる）。 ◎ Note: For closest-side and closest-corner, if the ray’s starting point is on an edge/corner, that’s the closest one. (In other words, the distance is zero.)
- 注記： ［ `closest-side$v ／ `farthest-side$v ］に対しては、 `射線$の始点が %包含塊 の外側にあるならば， %包含塊 の各~辺は無限に延伸するものと見なされる。 ◎ Note: For closest-side and farthest-side, if the ray’s starting point is outside the containing block entirely, the edges of the containing block are considered to extend out to infinity.
- `contain@v
- 【 この~keywordに関する一部の記述は、 不明瞭な箇所がいくつもあるので （`課題 #363＠https://github.com/w3c/fxtf-drafts/issues/363$）， 当面の間は未訳。 】
- `射線$の長さは， %要素 が %包含塊 の中に居続けるよう抑制される — `~offset距離$【！`offset-distance$p】 `100%^v の所でも。 ◎ The length of the offset path is reduced so that the element stays within the containing block even at offset-distance: 100%. ◎ Specifically, the path’s length is reduced by half the width or half the height of the element’s border box, whichever is larger, and floored at zero.
-
注記： この挙動は、 ~AND↓ が満たされる事例に最適化したものである：
- %要素 の横幅と縦幅は，ほぼ等しい
- %要素 の~borderは `border-radius$p により完全に丸められたか，その各~隅は %要素 の外観には関連していない
- `ray-size$t として `closest-side$v が利用されている
- %要素 の `offset-anchor$p は `center^v に設定されている
これらは、 %要素 を丸い時計の文字盤の周辺近くに位置する様な状況 【`例＠#_clock-face$】 において共通的に満たされる。 これらの条件の下では、 この値は，次を確保する ⇒ %要素 は、 `~offset距離$【！`offset-distance$p】 100% にて 文字盤の内縁~辺にきっちりはまるよう位置される。 ◎ Under these conditions, which are common for situations like positioning elements around the edge of a round clock face, this ensures that each element is positioned fairly snugly against the inner edge of the clock face at offset-distance: 100%.
他の条件においても，`類似に^em動作することになるが、 さほど最適な結果を与えないかもしれない。 ◎ In other conditions this will act similarly but might not give quite as optimal a result.
- `at^v `position$t
- `射線の原点@ — `射線$の始点（ 0% 位置） — を指定する。 それは、 `position$t を利用して， %包含塊 の中で縦横とも~size 0 の~obj区画を位置することにより解決される。 ◎ Specifies the origin of the ray, where the ray’s line begins (the 0% position). It’s resolved by using the <position> to position a 0x0 object area within the box’s containing block.
- 省略された場合の始点は、 %要素 に`開始~時の~offset位置$（ `offset-position$p ）が指定された場合は，それを利用する — 他の場合、 `at center^v として挙動する。 ◎ If omitted, it uses the offset starting position of the element, given by offset-position. ◎ If the element doesn’t have an offset starting position either, it behaves as at center.
- 注記： 現時点では、 `ray$f は`~offset~path$以外には利用-可能でない。 他にも利用-可能になるよう拡張された場合、 `offset-position$p における `ray^f の用法【？】は，もっぱら `ray^f が`~offset~path$を与えるときに制限されることになる — 他の `basic-shape$t 関数と類似に。 ◎ Note: ray() is currently only usable as an offset path. If it ever gets extended to other uses, its usage of offset-position will be limited solely to when it’s an offset path, similar to other <basic-shape> functions.
以下の各~例は、 すべて書き直す必要がある。 ◎ all of these examples need to be rewritten.
ここに，いくつか例を与える。 1 個目の例は、 ~boxを成すある部分が包含塊【！`~offset~path$】の外側にあることを示す。 ◎ Here are some examples. The first example shows that some parts of boxes are outside of the offset path.
<style>
body {
transform-style: preserve-3d;
width: 200px;
height: 200px;
}
.box {
width: 50px;
height: 50px;
offset-position: 50% 50%;
offset-distance: 100%;
offset-rotate: 0deg;
}
#redBox {
background-color: red;
offset-path: ray(45deg closest-side);
}
#blueBox {
background-color: blue;
offset-path: ray(180deg closest-side);
}
</style>
<body>
<div class="box" id="redBox"></div>
<div class="box" id="blueBox"></div>
</body>
2 個目の例では、 ~overflowを避けるため， 各~boxの `offset-path$p 値に `contain$v が与えられている。 ◎ In the second example, contain is given to the offset-path value of each box to avoid overflowing.
<style>
body {
transform-style: preserve-3d;
width: 200px;
height: 200px;
}
.box {
width: 50px;
height: 50px;
offset-position: 50% 50%;
offset-distance: 100%;
offset-rotate: 0deg;
}
#redBox {
background-color: red;
offset-path: ray(45deg closest-side contain);
}
#blueBox {
background-color: blue;
offset-path: ray(180deg closest-side contain);
}
</style>
<body>
<div class="box" id="redBox"></div>
<div class="box" id="blueBox"></div>
</body>
3 個目の例では、 当の~boxが包含され得るように~path~sizeが増やされる【？】。 `使用~offset距離$は負になる【？】。 ◎ In the third example, the path size is increased so that the box can be contained. The used offset distance is negative.
<style>
body {
transform-style: preserve-3d;
width: 250px;
height: 250px;
}
.box {
width: 60%;
height: 10%;
offset-position: 20% 20%;
offset-distance: 0%;
offset-rotate: 0deg;
offset-anchor: 200% -300%;
}
#blueBox {
background-color: blue;
offset-path: ray(-90deg closest-side contain);
}
</style>
<body>
<div class="box" id="blueBox"></div>
</body>
4 個目の例においては、 初期~位置は，包含塊の外側にある。 ◎ In the fourth example, the initial position is outside the containing block.
<style>
#container {
transform-style: preserve-3d;
width: 200px;
height: 200px;
}
.box {
width: 20%;
height: 20%;
offset-position: 140% 70%;
offset-distance: 100%;
}
#redBox {
background-color: red;
offset-path: ray(-90deg sides);
}
#blueBox {
background-color: blue;
offset-path: ray(180deg closest-side);
}
</style>
<div id="container">
<div class="box" id="redBox"></div>
<div class="box" id="blueBox"></div>
</div>
2.1.2. `basic-shape^t による位置決めの例
この例は、 暗黙的な中心~位置を伴う真円を利用する。 ◎ This example uses a circle with implicit center position.
<style>
body {
width: 323px;
height: 131px;
margin: 0px;
border: 2px solid black;
padding: 8px;
transform-style: preserve-3d;
}
.item {
width: 90px;
height: 40px;
background-color: violet;
}
#middle {
offset-position: auto;
offset-path: circle(60%) margin-box;
offset-distance: 25%;
offset-anchor: left top;
}
</style>
<body>
<div class="item"></div>
<div class="item" id="middle"></div>
<div class="item"></div>
</body>
2.1.3. `coord-box$t による位置決めの例
この例は、 `coord-box$t による`~offset~path$が， `border-radius$p との組合nにおいて どう働くかを示す。 ◎ This example shows how <coord-box> offset path works in combination with border-radius.
<style>
body {
width: 500px;
height: 300px;
border-radius: 80px;
border: dashed aqua;
margin: 0;
}
#blueBox {
width: 40px;
height: 20px;
background-color: blue;
offset-path: margin-box;
}
</style>
<body>
<div id="blueBox"></div>
</body>
2.2. ~path上の位置： `offset-distance^p ~prop
◎名 `offset-distance@p ◎値 `length-percentage$t ◎初 `0^v ◎適 `変形-可能な要素$ ◎継 されない ◎百 `~offset~path$の`総-長さ$に相対的 ◎算 `length-percentage$t の算出d値 ◎順 文法に従う ◎ア 算出された値~型による ◎表終`~offset距離@ 【言い換えれば、 `offset-distance$p の算出d値】 を指定する — それは、 `~offset位置$が`~offset~path$に沿って どこにあるかを与える。 ◎ Specifies where along the offset path the offset position is.
- `length-percentage$t
- `~offset位置$は、 要素の`~offset~path$に沿って指定された距離にある点にある。 ~pathに沿う距離を計算する方法についての詳細は、 `§ ~pathに沿って算出される距離の計算-法＠#path-distance$ を見よ。 ◎ The offset position is the point that is the specified distance along the element’s offset path. See § 2.2.1 Calculating the computed distance along a path for details about how to calculate distances along a path.
- 百分率は、 `~offset~path$の総-長さに相対的になる。 ◎ Percentages are relative to the total length of the offset path.
注記： `offset-distance$p を~animateすることにより、 当の要素は複階的な~pathを容易になぞれる。 ◎ Note: By animating the offset-distance, an element can easily trace out a complex path.
当の要素が`~offset~path$を有さない場合、 この~propは，何もしない。 ◎ If the element does not have an offset path, this property does nothing.
2.2.1. ~pathに沿って算出される距離の計算-法
`~offset~path$に沿う距離の処理は、 当の~pathの資質に依存して，異なる演算になる： ◎ Processing the distance along an offset path operates differently depending upon the nature of the offset path:
- 射線の場合、 `contain$v を伴うか否か ◎ References to <angle> offset paths with contain are unclosed intervals. ◎ References to <angle> offset paths without contain are unbounded rays.
-
他の場合、 閉な~loopであるか否か。
閉な~loopとは、 当の~offset~pathに`等価な~path$0の最終-~commandは `~closepath$pC ~command（ `z^c ／ `Z^c ）であることをいう — 具体的には：
- 次に挙げる~SVG要素 ⇒ `circle$e, `ellipse$e, `image$e, `polygon$e, `rect$e
- `basic-shape$t のうち［ `path$f ／ `shape$f ］以外のもの（ “基本的な~CSS図形” ）
- ［ `path$f ／ `shape$f ／ ~SVG `path$e 要素 ］のうち閉な~loopであるもの。
次に挙げるものは、 閉な~loopでない（開な~pathである）：
- 次に挙げる~SVG要素 ⇒ `line$e, `polyline$e
- ［ `path$f ／ `shape$f ／ ~SVG `path$e 要素 ］のうち閉な~loopでないもの。
`使用~offset距離@ 【言い換えれば、 `offset-distance$p の使用~値】 を決定するときは、 所与の ( `~offset~path$ %~offset~path, `~offset距離$ %~offset距離 ) に対し： ◎ To determine the used offset distance for a given offset path and offset distance:
- `総-長さ@ ~LET %~offset~path の総-長さ — すべての下位-~pathも含めた ◎ Let the total length be the total length of offset path with all sub-paths.
- %~offset距離 ~SET %~offset距離 を~pixel単位に換算した結果 — 100% は`総-長さ$に対応付ける下で ◎ Convert offset distance to pixels, with 100% being converted to total length.
-
~IF［ %~offset~path は`射線$である ］：
- ~IF［ %~offset~path は `contain$v を伴う ］ ⇒ 【以下、この段の内容は未訳】
- ~ELSE ⇒ ~RET %~offset距離
- ~IF［ %~offset~path は閉な~loopでない ］ ⇒ ~RET `min^op( %~offset距離, ~pathの総-長さ ) ◎ If offset path is any other unclosed interval: • Let used offset distance be equal to offset distance clamped by 0 and the total length of the path.
-
~RET ~pathの総-長さ に応じて ⇒＃ 0 ならば 0 ／ ~ELSE_ %~offset距離 の~pathの総-長さを法とする剰余 ◎ Otherwise offset path is a closed loop: • Let used offset distance be equal to offset distance modulo the total length of the path. If the total length of the path is 0, used offset distance is also 0.
注記： ここでの “剰余” は 伝統的な数学的な定義を利用する — 出力は、 常に 0 以上になるよう。 ◎ Note: “Modulo” here uses the traditional mathematical definition, where the output is always non-negative.
この例は、 開な~pathに沿って配置された~boxを示す。 ◎ This example shows boxes placed along an unclosed interval.
<style>
.item {
width: 100px;
height: 40px;
offset-position: 0% 0%;
offset-path: path('m 0 0 h 200 v 150');
}
#box1 {
background-color: red;
offset-distance: -280%;
}
#box2 {
background-color: green;
offset-distance: 190%;
}
</style>
<body>
<div class="item" id="box1"></div>
<div class="item" id="box2"></div>
</body>
この例は、 閉な~pathに沿って配置された~boxを示す。 ◎ This example shows boxes placed along a closed interval.
<style>
.item {
width: 100px;
height: 40px;
offset-position: 0% 0%;
offset-path: path('m 0 0 h 200 v 150 z');
}
#box1 {
background-color: red;
offset-distance: -280%;
}
#box2 {
background-color: green;
offset-distance: 190%;
}
</style>
<body>
<div class="item" id="box1"></div>
<div class="item" id="box2"></div>
</body>
この例は、［ `offset-path$p, `offset-distance$p ］を利用して，極-座標系の中で~boxを整列する仕方を示す。 ◎ This example shows a way to align boxes within the polar coordinate system using offset-path, offset-distance.
<style>
body {
transform-style: preserve-3d;
width: 300px;
height: 300px;
border: dashed gray;
border-radius: 50%;
}
.circleBox {
position: absolute;
left: 50%;
top: 50%;
width: 40px;
height: 40px;
background-color: red;
border-radius: 50%;
}
#circle1 {
offset-path: ray(0deg farthest-side);
offset-distance: 50%;
}
#circle2 {
offset-path: ray(90deg farthest-side);
offset-distance: 20%;
}
#circle3 {
offset-path: ray(225deg farthest-side);
offset-distance: 100%;
}
</style>
<body>
<div class="circleBox" id="circle1"></div>
<div class="circleBox" id="circle2"></div>
<div class="circleBox" id="circle3"></div>
</body>
2.3. ~pathを開始する点： `offset-position^p ~prop
◎名 `offset-position@p ◎値 `normal$v | `~autoP$v | `position$t ◎初 `normal$v ◎適 `変形-可能な要素$ ◎継 されない ◎百 包含塊の~sizeを~~基準にする ◎算 指定された~keyword／ `position$t の算出d値 ◎ The normal or auto keywords, or a computed <position> ◎順 文法に従う ◎ア 算出された値~型による ◎表終`開始~時の~offset位置@ を指定する — それは、 `offset-path$t 関数が自前の開始~時の位置を指定しない場合に利用される。 ◎ Specifies the offset starting position that is used by the <offset-path> functions if they don’t specify their own starting position.
各種 値は、 次に従って定義される： ◎ Values are defined as follows:
- `normal@v
- 当の要素には`開始~時の~offset位置$は無い。 ◎ The element does not have an offset starting position.
- `~autoP@v
- `開始~時の~offset位置$は、 当の~boxの左上~隅になる。 ◎ The offset starting position is the top-left corner of the box.
- 注記： これは、［ 要素の`包含塊$ではなく，要素の`自前の~box^em ］の左上~隅になる。 この値は、 `position$t として `top left^v を指定する【！specifiying】こととは，完全に異なる。 この値には、［ 例えば， `path$f が当の要素の自前の位置に相対的な所から開始する ］ことを許容することが意味される。 ◎ Note: This is the top-left corner of the element’s own box, not that of its containing block! It’s completely different from specifiying top left. It’s meant, for example, to allow a path() to start relative to the element’s own position.
- `position$t
- `開始~時の~offset位置$は、 `position$t を利用して， ~boxの`包含塊$の中で縦横とも~size 0 の~obj区画を位置した結果になる。 ◎ The offset starting position is the result of using the <position> to position a 0x0 object area within the box’s containing block.
~boxを `offset-position$p で位置する例。 ◎ This example shows positioning a box with offset-position.
<style>
#wrap {
position: relative;
width: 300px;
height: 300px;
border: 1px solid black;
}
#box {
width: 100px;
height: 100px;
background-color: green;
position: absolute;
top: 100px;
left: 80px;
offset-position: auto;
offset-anchor: center;
offset-path: ray(45deg);
}
</style>
<body>
<div id="wrap">
<div id="box"></div>
</div>
</body>
この例は［ `transform$p ~prop／ 個々の変形~prop（ `rotate$p ） ］との相互作用を示す。 ~motion~path変形は、 ( `left$p, `top$p ) を `offset-position$p へ縦に移動する並進になる。 ◎ This example shows the interaction with the transform property, and with an individual transform property (rotate). The motion path transform is a vertical translation moving (left, top) to offset-position.
<style>
#wrap {
transform-style: preserve-3d;
width: 400px;
height: 350px;
}
.item {
position: absolute;
left: 200px;
top: 0px;
offset-position: 200px 100px; /*
( 0px【？】, 100px ) だけ並進する
◎
translates by 0px,100px
*/
offset-anchor: left top;
transform-origin: left top;
width: 130px;
height: 80px;
border-top-right-radius: 23px;
}
#box1 {
background-color: tomato;
offset-position: auto;
}
#box2 {
background-color: green;
}
#box3 {
background-color: navy;
rotate: 90deg; /*
~motion~path変形より前に適用される
◎
applied before motion path transform
*/
}
#box4 {
background-color: gold;
transform: rotate(90deg); /*
~motion~path変形より後に適用される
◎
applied after motion path transform
*/
}
</style>
<body>
<div id="wrap">
<div class="item" id="box1"></div>
<div class="item" id="box2"></div>
<div class="item" id="box3"></div>
<div class="item" id="box4"></div>
</div>
</body>
この例は `position$p に `static$v を利用するので、 `offset-position$p は通常~flow位置からの並進を生成する。 `scale$p を利用して これらの並進を増幅することにより、 通常~flowは， `offset-position$p の周りで 180° 回転され【なぜ？】， ~boxどうしは互いに離れていく。 ◎ This example uses position static, so offset-position generates translations from the normal flow positions. By amplifying these translations using scale, the normal flow is rotated 180 degrees around the offset-position, and the boxes are exploded away from each other.
<style>
#wrap {
transform-style: preserve-3d;
width: 500px;
height: 250px;
line-height: 0px;
}
span {
position: static;
display: inline-block;
width: 100px;
height: 50px;
border-top-right-radius: 23px;
scale: 2.5 2.5; /*
~motion~path変形より前に適用される
◎
applied before motion path transform
*/
offset-position: center;
transform: scale(0.4); /*
~motion~path変形より後に適用される
◎
applied after motion path transform
*/
}
#box1 {
background-color: tomato;
}
#box2 {
background-color: green;
}
#box3 {
background-color: navy;
}
#box4 {
background-color: gold;
}
</style>
<body>
<div id="wrap">
<div>
<span id="box1"></span><span id="box2"></span>
</div>
<div>
<span id="box3"></span><span id="box4"></span>
</div>
</div>
</body>
この例では、 各 `offset-position$p の値は無視される — `offset-path$p は `geometry-box$t であるが、 他の~offset~propは， — `offset-position$p: `right bottom^v 用の `that^en に等価な効果を有するよう組合せるので【？】。 ◎ In this example, each offset-position value is ignored as offset-path is a <geometry-box>, but the other offset properties combine to have an effect equivalent to that for offset-position 'right bottom'.
<style>
#wrap {
transform-style: preserve-3d;
width: 540px;
height: 420px;
}
.item {
position: absolute;
width: 90px;
height: 70px;
border-top-right-radius: 23px;
scale: 0.8 0.8; /*
~motion~path変形より前に適用される
◎
applied before motion path transform
*/
offset-path: padding-box;
offset-distance: 50%;
offset-rotate: 0deg;
offset-anchor: right bottom;
transform: scale(1.25); /*
~motion~path変形より後に適用される
◎
applied after motion path transform
*/
}
#box1 {
background-color: tomato;
position: static;
offset-position: auto; /*
無視される
◎
ignored
*/
}
#box2 {
background-color: green;
right: 0px;
top: 0px;
offset-position: 23% 45%; /*
無視される
◎
ignored
*/
}
#box3 {
background-color: navy;
left: 0px;
bottom: 0px;
offset-position: 34% 56px; /*
無視される
◎
ignored
*/
}
#box4 {
background-color: gold;
right: 0px;
bottom: 0px;
offset-position: 45px 67px; /*
無視される
◎
ignored
*/
}
</style>
<body>
<div id="wrap">
<div class="item" id="box1"></div>
<div class="item" id="box2"></div>
<div class="item" id="box3"></div>
<div class="item" id="box4"></div>
</div>
</body>
2.4. 要素の~anchor点： `offset-anchor^p ~prop
◎名 `offset-anchor@p ◎値 `~autoA$v | `position$t ◎初 `~autoA$v ◎適 `変形-可能な要素$ ◎継 されない ◎百 要素の`基準box$の［ 横幅, 縦幅 ］に相対的 ◎算 ~keyword `~autoA$v ／ `position$t の算出d値 ◎順 文法に従う ◎ア 算出された値~型による ◎表終要素の `~anchor点@ を指定する — それは、 `~offset~path$に沿って`~offset位置$と整列される点を定義する。 ◎ Defines the element’s offset anchor point—the point that is aligned with the offset position along the offset path.
各種 値の意味は： ◎ Values have the following meanings:
- `~autoA@v
- `~anchor点$は、 `transform-origin$p の`算出d値$ — 特定的には、 その値を `position$t として当の要素の`基準box$を基準に解決した結果 — により指示される点になる。 ◎ The anchor point is the same as the point indicated by transform-origin. ◎ Specifically, the computed value of transform-origin is resolved as a <position> against the element’s reference box.
- `position$t
- `~anchor点$は、 所与の `position$t を当の要素の`基準box$を~~基準に解決した結果になる。 ◎ The anchor point is the result of resolving the <position> against the element’s reference box.
これが どの~boxを~~基準に解決されるかは、 `課題 #503＠https://github.com/w3c/fxtf-drafts/issues/503$ にて論じられている。 ◎ Which box this is resolved against is being discussed in Issue 503.
~boxの`~anchor点$を設定する方法を説明する例。 ◎ The following explains how to set the anchor point of the box.
#plane {
offset-anchor: center;
}
図形の真中にある赤い丸は、 `~anchor点$を指示する。 ◎ The red dot in the middle of the shape indicates the anchor point of the shape.
この例は、 異なる`~anchor点$を伴う 4 個の~boxの整列を示す。 ◎ This example shows an alignment of four boxes with different anchor points.
<style>
body {
transform-style: preserve-3d;
width: 300px;
height: 300px;
border: 2px solid gray;
border-radius: 50%;
}
.box {
width: 50px;
height: 50px;
background-color: orange;
offset-position: 50% 50%;
offset-distance: 100%;
offset-rotate: 0deg;
}
#item1 {
offset-path: ray(45deg closest-side);
offset-anchor: right top;
}
#item2 {
offset-path: ray(135deg closest-side);
offset-anchor: right bottom;
}
#item3 {
offset-path: ray(225deg closest-side);
offset-anchor: left bottom;
}
#item4 {
offset-path: ray(315deg closest-side);
offset-anchor: left top;
}
</style>
<body>
<div class="box" id="item1"></div>
<div class="box" id="item2"></div>
<div class="box" id="item3"></div>
<div class="box" id="item4"></div>
</body>
この例は、 中心が `offset-position$p に~~一致する~boxを示す。 ◎ This example shows boxes centered at their offset-position.
<style>
body {
width: 500px;
height: 500px;
}
.box {
background-color: mediumpurple;
offset-path: none;
offset-anchor: center;
}
#item1 {
offset-position: 90% 20%;
width: 60%;
height: 20%;
}
#item2 {
offset-position: 100% 100%;
width: 30%;
height: 10%;
}
#item3 {
offset-position: 50% 100%;
width: 20%;
height: 60%;
}
#item4 {
offset-position: 0% 100%;
width: 30%;
height: 90%;
}
</style>
<body>
<div class="box" id="item1"></div>
<div class="box" id="item2"></div>
<div class="box" id="item3"></div>
<div class="box" id="item4"></div>
</body>
この例は、 `offset-anchor$p が，どう `offset-position^en に算出するかを示す 【 `offset-position$p？ `~offset位置$？】。 ◎ This example shows how offset-anchor computes to their offset-position.
<style>
body {
width: 500px;
height: 500px;
}
.box {
background-color: mediumpurple;
offset-path: none;
offset-anchor: auto;
}
#item1 {
offset-position: 90% 20%;
width: 60%;
height: 20%;
}
#item2 {
offset-position: 100% 100%;
width: 30%;
height: 10%;
}
#item3 {
offset-position: 50% 100%;
width: 20%;
height: 60%;
}
#item4 {
offset-position: 0% 100%;
width: 30%;
height: 90%;
}
</style>
<body>
<div class="box" id="item1"></div>
<div class="box" id="item2"></div>
<div class="box" id="item3"></div>
<div class="box" id="item4"></div>
</body>
2.5. ~pathに合致するための回転-法： `offset-rotate^p ~prop
◎名 `offset-rotate@p ◎値 [ `~autoR$v | `reverse^v ] || `angle$t ◎初 `~autoR$v ◎適 `変形-可能な要素$ ◎継 されない ◎百 受容しない ◎算 ( 省略可能な `~autoR$v, `angle$t の算出d値 ) が成す組 ◎ computed <angle> value, optionally preceded by auto ◎順 文法に従う ◎ア 算出された値~型による ◎表終`~offset変形$の回転~成分を定義する — 場合によっては、 `~offset~path$の`~offset位置$における方向に基づくよう。 ◎ Defines a rotation component of the offset transform, possibly based on the direction of the offset path at the offset position. Values have the following meanings:
回転~成分は、 `angle$t に指定された角度 — 省略時は 0° — に指定された~keywordが指示する角度 — 省略時は 0° — を加算した結果になる。 ~keywordが指示する角度は：
- `~autoR@v
- ［ X 軸の正な方向（すなわち，右へ向かって伸びる線） ］から時計回りに［ `~offset~path$の`~offset位置$における方向 ］までが成す角度。
- `reverse@v
- `~autoR$v が指示する角度に `180deg^v を加算した結果。
以下の各~例では、 当の要素が飛行機の図形を利用して示される。 飛行機は、 回転されないときは，右を向いている。 図形の真中にある赤い丸は、 要素の`~anchor点$を指示する。 ◎ The following examples use the shape of a plane. The red dot in the middle of the shape indicates the anchor point of the shape.＼ When no offset properties are set, the shape is not translated or rotated along the path.
以下においては、 図形の`~anchor点$が，~path上の いくつかの位置に配置される。 ◎ When the shape’s anchor point is placed at different positions along the path＼
`offset-rotate$p を `0deg^v に設定した場合、 当の図形は，回転されない。 ◎ and offset-rotate is 0deg, the shape is not rotated.
`offset-rotate$p ~propを `~autoR$v に設定した場合、 図形は，その現在の位置において — ~pathが進む方向を向くよう — そこでの勾配に基づいて回転される。 ◎ If the offset-rotate property is set to auto, and the shape’s anchor point is placed at different positions along the path, the shape is rotated based on the gradient at the current position and faces the direction of the path at this position.
`offset-rotate$p ~propを `reverse$v に設定した場合、 ~path上の どの位置においても，飛行機は~pathが進む反対~方向を向く。 ◎ In this example, the offset-rotate property is set to reverse. The plane faces the opposite direction of the path at each position on the path.
`offset-rotate$p ~propを `-45deg^v に設定した場合、 図形は，はじめに反時計回りに 45° だけ回転され， その回転を~path上の各~位置において保つ。 ◎ The last example sets the offset-rotate property to -45deg. The shape is rotated anticlockwise by 45 degree once and keeps the rotation at each position on the path.
この例は［ `~autoR$v ／ `reverse$v ］と `angle$t を組合せて指定したとき，どう働くかを示す。 `angle^t の算出d値は、［ `auto^v ／`reverse^v ］の算出d値に加算される。 ◎ This example shows how auto or reverse work when specified in combination with <angle>. The computed value of <angle> is added to the computed value of auto or reverse.
<style>
body {
width: 300px;
height: 300px;
margin: 0px;
border: solid gray;
border-radius: 50%;
}
.circle {
offset-position: 150px 150px;
offset-distance: 86%;
width: 42px;
height: 42px;
background-color: mediumpurple;
border-radius: 50%;
display: flex;
align-items: center;
justify-content: center;
}
#item1 {
offset-path: ray(0deg closest-side);
offset-rotate: auto 90deg;
}
#item2 {
offset-path: ray(45deg closest-side);
offset-rotate: auto 90deg;
}
#item3 {
offset-path: ray(135deg closest-side);
offset-rotate: auto -90deg;
}
#item4 {
offset-path: ray(180deg closest-side);
offset-rotate: auto -90deg;
}
#item5 {
offset-path: ray(225deg closest-side);
offset-rotate: reverse 90deg;
}
#item6 {
offset-path: ray(-45deg closest-side);
offset-rotate: reverse -90deg;
}
</style>
<body>
<div class="circle" id="item1">1</div>
<div class="circle" id="item2">2</div>
<div class="circle" id="item3">3</div>
<div class="circle" id="item4">4</div>
<div class="circle" id="item5">5</div>
<div class="circle" id="item6">6</div>
</body>
2.6. `offset^p 略式
◎名 `offset@p ◎値 [ `offset-position$tp? [ `offset-path$tp [ `offset-distance$tp || `offset-rotate$tp ]? ]? ]! [ / `offset-anchor$tp ]? ◎初 個々の~propを見よ ◎適 `変形-可能な要素$ ◎継 個々の~propを見よ ◎百 個々の~propを見よ ◎算 個々の~propを見よ ◎順 文法に従う ◎ア 個々の~propを見よ ◎表終これは、 次に挙げる~propを設定するための略式~propである — 省略された値は、 各自の初期~値に設定される ⇒＃ `offset-position$p, `offset-path$p, `offset-distance$p, `offset-rotate$p `offset-anchor$p ◎ This is a shorthand property for setting offset-position, offset-path, offset-distance, offset-rotate and offset-anchor. Omitted values are set to their initial values.
2.7. ~offset変形の計算-法
`~offset変形$は、 ある並進にある回転が後続する二次元な変形である： ◎ The offset transform is a 2d transform, a translation followed by a rotation:
- 要素を［ その`~anchor点$, その`~offset位置$ ］が整列するよう並進する。 ◎ Translate the element by the (X, Y) that aligns its anchor point with its offset position.
- `offset-rotate$p により指定された角度だけ要素を回転する。 ◎ Rotate the element by the angle specified by offset-rotate.
3. `basic-shape^t 用の等価な~path
`css-shapes$r においては、 `basic-shape$t を成す各~関数を，ある`図形^em — ［ 外形線, 内側, 外側 ］を伴う二次元な~~図形 — を生産するものとして定義する。 ◎ The <basic-shape> definition given by [css-shapes] defines each function as producing a shape—a 2-dimensional figure with an outline, an inside, and an outside.
この仕様は、 `basic-shape$t を代わりに，`~path^em — 特定0の図形の外形線をなぞる線であって，［ 開始~時の点, 終了~時の点, 方向 ］を伴うもの — を生産するものとして利用する。 何が~pathを成すかの詳細は、 ~SVGにより定義される。 `SVG2$r ◎ This specification instead uses <basic-shape> as producing a path—a line with a starting point, ending point, and direction, that happens to trace out a particular shape’s outline. The details of what makes up a path are defined by SVG. [SVG2]
以下に挙げる各種 `basic-shape$t 値~用の `等価な~path@ は、 同じ図形を表現する［ 対応する~SVG要素 ］用の`等価な~path$0と同じに構成される： ◎ The equivalent path for all the <basic-shape> values are:
| `basic-shape$t | ~SVG要素 |
|---|---|
| `path$f | `path$e |
| `shape$f | `path$e |
| `circle$f | `circle$e |
| `ellipse$f | `ellipse$e |
| `rect$f | `rect$e |
| `inset$f | `rect$e |
| `xywh$f | `rect$e |
| `polygon$f | `polygon$e |
【 原文では，これらの各~図形~用の~pathを概略的に述べているが、 この訳では，単に~SVG図形~要素への参照を与えるだけにする — 実質的に，それらに定義される等価な~pathと同じであり（下に注記されるとおり）、 それらの記述の方が より精確なので。 】
◎ path() shape() • The path is the defined path. [SVG11] ◎ circle() ellipse() • The path is the outline of the circle/ellipse. It starts at the rightmost point of the circle/ellipse, and then is composed of four circular arcs, each comprising a quarter of the circle/ellipse, proceeding clockwise, ending with a segment-completing close path operation. ◎ rect() inset() xywh() • The path is the outline of the (possibly-rounded) rectangle, composed of four or eight segments (depending on whether rounded corners are specified or not), and ending with a segment-completing close path operation. It starts at the left end of the top straight edge, immediately to the right of any rounded corners, and continues to the right (clockwise). ◎ polygon() • The path is the outline of the polygon, composed of straight line segments connecting each coordinate pair to the following coordinate pair, and finally connecting the last back to the first, with a segment-completing close path operation.これらすべてにおける~path上の所与の点における方向は、 ~SVGにより定義される — `SVG2$r `§ ~pathの方向性＠~SVGpaths#PathDirectionality$ を見よ。 ◎ For all of these, the direction at any point along the path is defined by SVG; see SVG 2 § 9.4 Path directionality.
注記： これらすべては、 類似な~SVG`図形~要素$用に定義される “等価な~path” に合致することが意味される。 ◎ Note: All of these are meant to match the "equivalent paths" defined for the similar SVG shape elements.
注記： この~listは、 `css-shapes$r にて定義される `basic-shape$t 関数たちが成す集合と全部的に同期cするべきである。 何かが欠落な場合、 仕様の~bugと見なされるべきである。 この~listは，将来には `css-shapes$r へ移動されるかもしれないが、 この仕様だけが この情報を利用しているので，今の所はここに保たれる。 ◎ Note: This list should be in sync with the full set of <basic-shape> functions defined in [css-shapes]. If anything is missing, this should be considered a specification bug. This list might move to Shapes in the future, but for now is kept here as this spec is the only consumer of this information.
4. ~privacyの考慮点
この仕様が導入する新たな~privacyの考慮点は、 無い。 ◎ This specification introduces no new privacy considerations.
5. ~securityの考慮点
この仕様が導入する新たな~securityの考慮点は、 無い。 ◎ This specification introduces no new security considerations.
変更点
◎非規範的以下に挙げる変更点は、 `2015年 4月 9日 最初の公な作業草案＠~TR/2015/WD-motion-1-20150409/$ から為された。 ◎ The following changes were made since the 9 April 2015 First Public Working Draft.
- `polar-angle＠~TR/2016/WD-css-round-display-1-20160301/#polar-angle-property$p を統合するため， `motion-path＠~TR/2015/WD-motion-1-20150409/#motion-path-property$p を `offset-path$p に改称した。 ◎ Renamed motion-path to offset-path for integrating with polar-angle.
- `~offset~path$を線~区分として定義するため `ray$f を追加した。 【！which direction is ...】 ◎ Added the ray() to define an offset path as a line segment which direction is specified by <angle>.
- `ray$f 用の引数【！値】として，［ `size^t 【今や `ray-size$t 】, `contain$v ］を追加した。 ◎ Added <size> and contain value for the ray().
- `polar-distance＠~TR/2016/WD-css-round-display-1-20160301/#polar-distance-property$p を統合するため、 `motion-offset＠~TR/2015/WD-motion-1-20150409/#propdef-motion-offset$p を `offset-distance$p に改称した。 ◎ Renamed motion-offset to offset-distance for integrating with polar-distance.
- `motion-rotation＠~TR/2015/WD-motion-1-20150409/#propdef-motion-rotation$p を `offset-rotate$p に改称した。 ◎ Renamed motion-rotation to offset-rotate.
- ~pathの`開始~時の~offset位置$を指定するため、 `offset-position$p を追加した — `CSS-ROUND-DISPLAY-1$r から `polar-origin＠~TR/2016/WD-css-round-display-1-20160301/#polar-origin-property$p を併合することにより。 ◎ Added offset-position to specify the offset starting position of the path by merging polar-origin from [CSS-ROUND-DISPLAY-1].
- 要素の`~anchor点$【！原点】を指定するための `offset-anchor$p を追加した — `CSS-ROUND-DISPLAY-1$r から `polar-anchor＠~TR/2016/WD-css-round-display-1-20160301/#polar-anchor-property$p を併合することにより。 ◎ Added offset-anchor to specify the origin point of the element by merging polar-anchor from [CSS-ROUND-DISPLAY-1].
- `motion＠~TR/2015/WD-motion-1-20150409/#propdef-motion$p 略式~propを `offset$p に改称した。 ◎ Renamed the shorthand property motion to offset.
- `offset-rotate$p を［ `~autoR$v ／ `reverse$v ］と `angle$t との組合nにより回転~変形nを指定するようにした。 ◎ Made offset-rotate specify the rotation transformation by auto or reverse in combination with <angle>.
謝辞
`fantasai^en 氏, `Hyojin Song^en 氏, ならびに 他の~CSS~WG~memberたち すべてからの［ 考査, ~comment, 訂正 ］に謝意を。 ◎ Thanks to fantasai, Hyojin Song, and all the rest of the CSS WG members for their reviews, comments, and corrections.