CSS によるテキスト装飾 — CSS Text Decoration Module Level 4

1.1. ~module間の相互作用

この~moduleは、 `CSS-TEXT-DECOR-3$r にて定義された，~textを装飾するための特能を置換して拡張する。 ◎ This module replaces and extends the text-decorating features defined in [CSS-TEXT-DECOR-3].

この~moduleに与える，すべての~propは、［ `first-line$pe ／ `first-letter$pe ］`疑似要素$にも適用できる。 ◎ All of the properties in this module can be applied to the ::first-line and ::first-letter pseudo-elements.

1.2. 値~定義

【 この節の内容は、 `~CSS日本語訳 共通~page＠~CSScommon#values$に移譲。 】

1.3. 各種用語

この仕様にて利用される用語［ `~typographic文字~単位$（ `文字@ ）, `~typographic字l~単位$（ `字l@ ）, `内容~言語$ ］は、 `CSS-TEXT-3$r にて定義される。 この仕様にて利用される 他の各種用語と概念は［ `CSS2$r, `CSS-WRITING-MODES-4$r【, `CSS-INLINE-3$r】 ］にて定義される。 ◎ The terms typographic character unit (character), typographic letter unit (letter), and content language as used in this specification are defined in [CSS-TEXT-3]. Other terminology and concepts used in this specification are defined in [CSS2] and [CSS-WRITING-MODES-4].

【 この訳では、 次の用語も追加的に定義する： 】

`縦書き~mode@ とは、［ `~typographic~mode$が，縦書き用字系における縦方向~flowである ］ことを意味する略記である。 `横書き~mode@ とは、 `縦書き~mode$でないことを意味する （`縦組み$の中で縦方向に回転された横方向~flowも含む）。

2.1. ~text装飾~線： `text-decoration-line^p ~prop

この~propは， `text-decoration$p 略式の`下位prop$であり、 要素に追加する装飾線を指定する, または追加しないことを指定する。 `none^v 以外の値は、 指示された~text装飾が要素から出生するようにして， § `装飾線$にて述べたとおりに，それを［ 適用する, 伝播させる ］。 ◎ This property, which is a sub-property of the text-decoration shorthand, specifies what line decorations, if any, are added by the element. Values other than none cause the element to originate the indicated text decorations, and to apply and propagate it as described above.

注記： 行lの［ 色／~style／太さ ］を`~cascade$において低優先度な宣言で設定することが欲されない限り、 この`下位prop$よりも `text-decoration$p `略式~prop$を利用する方が安全である。 ◎ Note: Unless it is desired for the color, style, and thickness of the lines to be set by declarations lower in the cascade, it is safer to use the text-decoration shorthand instead of this longhand.

各種~値の意味は： ◎ Values have the following meanings:

`none@v

~text装飾を生産することも, 妨げることもない。 ◎ Neither produces nor inhibits text decoration.

`underline@v

~textの各~行lには、 下線が引かれる。 ◎ Each line of text is underlined.

`overline@v

~textの各~行lには、 上線（すなわち，下線と反対~側）が引かれる。 ◎ Each line of text has a line over it (i.e. on the opposite side from an underline).

`line-through@v

~textの各~行lには、 真中を通る線が引かれる。 ◎ Each line of text has a line through the middle.

`blink@v

~textは点滅する（可視と不可視の間で交替する）。 適合~UAは、 単純に~textを点滅させなくしてもヨイ。 ~textを点滅させないことは、 `checkpoint 3.3 of WAI-UAAG＠~TR/UAAG/guidelines.html#tech-on-off-blinking-text$en を満たす技法の一つであることに注意。 この値は、 `CSS3-ANIMATIONS$r への支持を受けて非推奨にされた。 ◎ The text blinks (alternates between visible and invisible). Conforming user agents may simply not blink the text. Note that not blinking the text is one technique to satisfy checkpoint 3.3 of WAI-UAAG. This value is deprecated in favor of Animations [CSS3-ANIMATIONS].

`spelling-error@v

この値は、 ~UAが誤った綴りを強調するために利用する種別の~text装飾を指示する。 その外観は~UAにより定義され，~platformに依存し得る。 これは、 赤い波状な下線で描画されることが多い。 ◎ This value indicates the type of text decoration used by the user agent to highlight spelling mistakes. Its appearance is UA-defined, and may be platform-dependent. It is often rendered as a red wavy underline.

`grammar-error@v

この値は、 ~UAが文法の誤りを強調するために利用する種別の~text装飾を指示する。 その外観は、 ~UAにより定義され，~platformに依存し得る。 これは、 緑色な波状な下線で描画されることが多い。 ◎ This value indicates the type of text decoration used by the user agent to highlight grammar mistakes. Its appearance is UA defined, and may be platform-dependent. It is often rendered as a green wavy underline.

注記： `縦組み$においては、 `text-underline-position$p により，［ 下線, 上線 ］が引かれる側を切替えることもできる。 これにより、 下線の位置を，言語に特有な選好に自動的に基づかせることが可能になる。 ◎ Note: In vertical writing modes, text-underline-position can cause the underline and overline to switch sides. This allows the position of underlines to key off of language-specific preferences automatically.

［ `spelling-error$v ／ `grammar-error$v ］が適用されるときは、 ~UAは［ `text-decoration$p の他の`下位prop$ ］および［ 概して装飾線の外観にも影響する他の~prop （ `text-underline-position$p, `color$p, `stroke$p, `fill$p など） ］を無視rするモノトスル。 しかしながら，~UAは、 `accent-color$p ~propを織り込んでもヨイ。 ◎ When spelling-error or grammar-error apply, the user agent must disregard the other sub-properties of text-decoration, as well any other properties typically affecting the appearance of line decorations (such as text-underline-position, color, stroke, or fill) when rendering these decorations. However, the user agent may take into account the accent-color property.

2.2. ~text装飾~style： `text-decoration-style^p ~prop

この~propは， `text-decoration$p 略式の`下位prop$であり、 要素~上の `text-decoration-line$p にて指定された［ 下線／上線／打消線 ］を描くときの~styleを設定する。 この~styleは、 子孫~boxが異なる~styleを指定していても， この要素から出生しているすべての装飾に影響する。 ◎ This property, which is a sub-property of the text-decoration shorthand, sets the line-drawing style of underlines, overlines, and line-throughs specified on the element with text-decoration-line, and affects all decorations originating from this element even if descendant boxes specify a different style.

`wavy@v は波線を指示する — それ以外の各種 値の意味は、 `border-*-style$p ~prop `CSS-BACKGROUNDS-3$r 用の同じ名前の値と同じである。 ◎ Values have the same meaning as for the border-style properties [CSS-BACKGROUNDS-3]. wavy indicates a wavy line.

2.3. ~text装飾~色： `text-decoration-color^p ~prop

この~propは， `text-decoration$p 略式の`下位prop$であり、 要素~上の `text-decoration-line$p にて指定された［ 下線／上線／打消線 ］の色を設定する。 この色は、 子孫~boxが異なる色を指定していても，この要素から出生しているすべての装飾にも影響する。 ◎ This property, which is a sub-property of the text-decoration shorthand, sets the color of underlines, overlines, and line-throughs specified on the element with text-decoration-line, and affects all decorations originating from this element even if descendant boxes specify a different color.

2.4.~text装飾~線の太さ： `text-decoration-thickness^p ~prop

この~propは， `text-decoration$p 略式の`下位prop$であり、 要素~上の `text-decoration-line$p にて指定された［ 下線／上線／打消線 ］の太さを設定する。 この太さは、 子孫~boxが異なる太さを指定していても，この要素から出生している すべての装飾に影響する。 ◎ This property, which is a sub-property of the text-decoration shorthand, sets the stroke thickness of underlines, overlines, and line-throughs specified on the element with text-decoration-line, and affects all decorations originating from this element even if descendant boxes specify a different thickness.

各種~値の意味は： ◎ Values have the following meanings:

`auto@v

~UAは、 ~text装飾~線~用に適切な太さを選ぶ — 下を見よ。 ◎ The UA chooses an appropriate thickness for text decoration lines; see below.

`from-font@v

`可用な最初の~font$が［ 選好される下線~幅を指示する計量 ］を有するならば、 その幅を利用する — 他の場合、 `auto$v として挙動する。 ◎ If the first available font has metrics indicating a preferred underline width, use that width, otherwise behaves as auto.

`length-percentage$t

長さ値は、 ~text装飾~線の太さを固定d長さとして指定する。 ◎ A length value specifies the thickness of text decoration lines as a fixed length.

注記： 長さは，固定d値として継承されるので、 ~fontと伴に拡縮されることはない。 ◎ Note: A length will inherit as a fixed value, and will not scale with the font.

百分率~値は、 ~text装飾~線の太さを `1em^v の百分率として指定する。 ◎ A percentage value specifies the thickness of text decoration lines as a percentage of 1em.

注記： 百分率は，相対~値として継承されるので、 継承-時には，~fontの変化に伴い拡縮される。 ◎ Note: A percentage will inherit as a relative value, and will therefore scale with changes in the font as it inherits.

~UAは、 `実際の値$を［ 最も近い整数~機器~画素に丸めた上で， 1 機器~画素~以上になることを確保する ］ベキである。 ◎ The UA should round the actual value to the nearest integer device pixel, and ensure it is at least one device pixel.

2.5. 装飾線の位置, 太さの決定-法

この節は、 ~level 3 の早期~草案からの複製であり， 依然として考査の下にある — ［ `text-underline-offset$p, `text-decoration-thickness$p ］との統合が必要である。 ◎ This section is copied over from early drafts of Text Decoration Level 3. It is still under review, and needs integration with text-underline-offset and text-decoration-thickness.

装飾線は，~font~sizeや縦方向の整列がまちまちな要素にも~spanし得るので、 装飾線~用の最良な位置は， `装飾ng~box$により規定される理想的な位置になるとは限らない。 代わりにそれは、 行lごとに，その行l上で `考慮される~text@ — 当の行l上にある，`装飾ng~box$により装飾されるすべての~text — に対し計算される。 しかしながら，`装飾ng~box$の子孫のうち次に挙げるものは、 `考慮される~text$の集合からは除外される： ◎ Since line decorations can span elements with varying font sizes and vertical alignments, the best position for a line decoration is not necessarily the ideal position dictated by the decorating box. Instead, it’s calculated, per line, from all text decorated by the decorating box on that line, the considered text. However,＼

• その `text-decoration-skip$p に因り飛ばされるもの ◎ descendants of the decorating box that are skipped due to text-decoration-skip,＼
• `行内$【`行内~box$？】であって， その `text-decoration-skip$p は【新たに導入され得る値】 `ink^v をとるもの ◎ descendant inlines with text-decoration-skip: ink,＼
• 当の`装飾ng~box$の`行内~整形~文脈$には関与しないもの ◎ and any descendants that do not participate in the decorating box’s inline formatting context＼ ↑ are excluded from the set of considered text.

装飾線の位置は、 行lごとに次に従って計算される（ ［ `上面$／`下面$ ］に位置された［ 下線／上線 ］は［ `上面$／`下面$ ］線として扱う下で）： ◎ The line decoration positions are then calculated per line as follows (treating over-positioned underlines as over lines and under-positioned overlines as under lines):

`上面$線 ◎ over lines

装飾線を［ `考慮される~text$【を成す各~glyph】の最も高い`上面$にある~EM~box辺 ］に~~相対的に整列する。 ◎ Align the line decoration with respect to the highest over EM-box edge of the considered text.

~alphabetic下線 ◎ alphabetic underlines

~alphabetic下線の位置は、 `考慮される~text$を成す各~連なりの（ `alphabetic$bL 基底線からの）理想的な~offsetをとって, それらを平均してから， 実際に線を位置するときには【各~連なりの】 `alphabetic$bL 基底線のうち最も低いものを利用することにより計算される。 （`支配的な基底線$が `alphabetic$bL でない場合、 【各~連なりの】 `alphabetic$bL 基底線は， `baseline$v 【親の`支配的な基底線$】に整列された~boxごとに相違し得る）。 ［ 上付文字／下付文字 ］がこの位置を狂わすことを防止するため、［ 行内のうち `vertical-align$p の算出d値は初期~値でないもの ］は，その親の理想的な下線~位置を有するものとして扱われる。 ◎ The alphabetic underline position is calculated by taking the ideal offset (from the alphabetic baseline) of each run of considered text, averaging those, and then using the lowest alphabetic baseline to actually position the line. (Alphabetic baselines can differ between baseline-aligned boxes if the dominant baseline is non-alphabetic.) To prevent superscripts and subscripts from throwing this position off-kilter, an inline with a non-initial computed vertical-align is treated as having the ideal underline position of its parent.

~alphabeticでない`下面$線 ◎ non-alphabetic under lines

装飾線を［ `考慮される~text$【を成す各~glyph】の最も低い`下面$ ~EM~box辺 ］に~~相対的に位置する。 ◎ Position the line decoration with respect to the lowest under EM-box edge of the considered text.

打消線 （ `line-through^en ） 【 `strike-through^en とも称されるが、この訳では同じ語に統一する。】 ◎ line-throughs

打消線は、 本質的には， ~alphabeticな下線~用のそれと同じ類の平均-法を利用するが、 `font-size$p の算出d値が異なる子孫たちをまたぐように描くときには， 位置を算出し直す （これは、 実質的に，［ ~font~sizeが変化しても打消線が~textを “横切り” 続ける ］ことを確保する）。 ［ `考慮される~text$を成す各~連なりのうち，同じ `font-size$p を伴うもの ］に対し，その~font計量から平均された理想的な位置を算出する。 ［ 上付文字／下付文字 ］がこの位置を狂わすのを防ぐため、［ 行内~levelの~boxのうち `vertical-align$p の算出d値が初期~値をとらないもの ］は，その親の理想的な下線~位置を有するものと扱われる。 当の線を成す部位のうち装飾された各~断片にまたがるものは、 その位置【下線~位置？算出し直された位置？】に位置する。 ◎ Line-throughs essentially use the same sort of averaging as for alphabetic underlines, but recompute the position when drawing across a descendant with a different computed font-size. (This ensures that the text remains effectively “crossed out” despite any font size changes.) For each run of considered text with the same font-size, compute an ideal position averaged from its font metrics. To prevent superscripts and subscripts from throwing this position off-kilter, an inline with a non-initial computed vertical-align is treated as having the ideal underline position of its parent. Position the portion of the line across each decorated fragment at that position.

単純にするため、 各~要素~越しの打消線は，当の要素に［ 選好される／平均された ］位置に描くベキである。 これは，望ましくない段差を生産し得るが、［ すべての~instanceにおいて正しくなるよう，それを避ける仕方 ］は見当たらず，すべての試みは複階的になり過ぎる。 異なる~font-sizeを伴うが`考慮される~text$が無い要素~越しの打消線は、 どの位置を採用するベキか？ ◎ For simplicity, line-throughs should draw over each element at that element’s preferred/averaged position. This can produce some undesirable jumpiness, but there doesn’t appear to be any way to avoid that which is correct in all instances, and all attempts are worryingly complex. What position should line-throughs adopt over elements that have a different font-size, but no considered text?

~CSSは、 装飾線の太さを定義しない。 ~UAは、 ~text装飾~線の太さを決定するにあたっては，［ 各~子孫の~fontの［ ~size, 書体f, ~weight ］も考慮する下で，適切に平均された太さ ］を供してもヨイ。 ◎ CSS does not define the thickness of line decorations. In determining the thickness of text decoration lines, user agents may consider the font sizes, faces, and weights of descendants to provide an appropriately averaged thickness.

2.6. ~text装飾： `text-decoration^p 略式~prop

この~propは、［ `text-decoration-line$p, `text-decoration-color$p, `text-decoration-thickness$p, `text-decoration-style$p ］を 1 個の宣言で設定するための略式~propである。 省略された値は、 各自の初期~値に設定される。 ◎ This property is a shorthand for setting text-decoration-line, text-decoration-thickness, text-decoration-style, and text-decoration-color in one declaration. Omitted values are set to their initial values.

:link {
    color: blue;
    text-decoration: underline;
    text-decoration: navy dotted underline; /* 
CSS1／CSS2 ~UAにおいては，`無視される＠~CSSSYN#css-ignored$
◎
Ignored in CSS1/CSS2 UAs
 */
}

注記： `text-underline-position$p ~propがこの~propから省かれているわけは、 それが内容に基づく［ 言語／書記体系 ］に依存する設定であり， （継承されない） `text-decoration$p 略式~propによる~style上の設定とは独立に~cascadeして継承できるようにするためである。 ◎ Note: The shorthand purposefully omits the text-underline-position property, which is a language/writing-system–dependent setting that keys off the content, so that it can cascade and inherit independently from the (uninherited) stylistic settings of the text-decoration shorthand.

2.7. ~text下線の位置： `text-underline-position^p ~prop

この~propは、 `text-decoration$p 略式の`下位prop$`ではない^em。 それは、 ~textに~~相対的な下線の位置を設定することに加え， `text-underline-offset$p による更なる調整~用に下線の`~zero位置$も定義する。 この下線~位置は、 子孫~boxが異なる位置を指定していても，この要素から出生しているすべての装飾に影響するが、 先祖~要素が指定した下線には影響しない。 ◎ This property, which is not a sub-property of the text-decoration shorthand, sets the position of an underline with respect to the text, and defines its zero position for further adjustment by text-underline-offset. It affects all decorations originating from this element, even if descendant boxes specify a different position. It does not affect underlines specified by ancestor elements.

:root:lang(ja), [lang|=ja], :root:lang(ko), [lang|=ko] {
   text-underline-position: under right;
}
:root:lang(zh), [lang|=zh] {
   text-underline-position: under left;
}

［ `left$v ／ `right$v ］のみが指定された場合、 `auto$v も含意される。 各種~値の意味は： ◎ If left or right is specified alone, auto is also implied. Values have the following meanings:

`auto@v

~UAは、 下線の位置を決定するにあたり，どのような~algoを利用してもヨイが、 `alphabetic$bL 基底線の所か それより下に引くモノトスル。 ◎ The user agent may use any algorithm to determine the underline’s position; however it must be placed at or under the alphabetic baseline.

注記： ~UAには、 既定の下線~位置は `alphabetic$bL 基底線になるべく近くすることが示唆される — ~alphabeticな下線が高過ぎて，下付文字~化された（あるいは低くされた）~textに交叉したり, 漢字や~Tibetanなどの~Asian用字系の~glyph越しに描くことになる場合、 `under$v にて述べたとおり，下線を［ 低くズラすか, ~em~box辺に整列する ］方が適切になろう。 ◎ Note: It is suggested that the default underline position be close to the alphabetic baseline, unless that would either cross subscripted (or otherwise lowered) text or draw over glyphs from Asian scripts such as Han or Tibetan for which an alphabetic underline is too high: in such cases, shifting the underline lower or aligning to the em box edge as described for under may be more appropriate.

`from-font@v

`可用な最初の~font$が［ 選好される下線~offsetを指示する計量 ］を有するならば その~offsetを利用する — 他の場合、 `auto$v として挙動する。 ◎ If the first available font has metrics indicating a preferred underline offset, use that offset, otherwise behaves as auto.

`under@v

下線は、 要素の~text内容の`下面$に位置される。 この事例では、 下線は通例的には~descenderと交叉しない （これは “`accounting^en” 下線と呼ばれることもある）。 この値は、 `縦書き~mode$において特定0の側が選好されるならば［ `left$v ／ `right$v ］と組合せることもできる。 ◎ The underline is positioned under the element’s text content. In this case the underline usually does not cross the descenders. (This is sometimes called “accounting” underline.) This value can be combined with left or right if a particular side is preferred in vertical typographic modes.

`text-underline-position$p は継承され, また `text-decoration$p 略式~propが それを設定し直すことはないので、 次の例は［ 文書が `under$v による下線を利用する ］ように切替える。 これは、 長く, 複雑な~descenderを伴う書記体系~用には，より適切になることもある。 また、 下付文字を多用する［ 数学／化学 ］~~分野の~text用にも，有用になることが多い。 ◎ Because text-underline-position inherits, and is not reset by the text-decoration shorthand, the following example switches the document to use under underlining, which can be more appropriate for writing systems with long, complicated descenders. It is also often useful for mathematical or chemical texts that use many subscripts.

:root { text-underline-position: under; }

注記： 値 `under^v は、 下線が~glyphと競合しないことを保証するものではない — ~fontには、［ ~descender／発音区別符 ］が，~fontの~descent計量の下へ拡張するものもあるので。 ◎ Note: The under value does not guarantee that the underline will not conflict with glyphs, as some fonts have descenders or diacritics that extend below the font’s descent metrics.

`left@v

`縦書き~mode$においては、 下線は，常に~textの左端~辺に整列されることを除いて， `under$v に対するときと同様に整列され、 上線は，その反対~側に整列される。 ◎ In vertical typographic modes, the underline is aligned as for under, except it is always aligned to the left edge of the text. If this causes the underline to be drawn on the "over" side of the text, then an overline also switches sides and is drawn on the "under" side.

`right@v

“左端” を “右端” に読み替える下で， `left$v と同様になる。 ◎ In vertical typographic modes, the underline is aligned as for under, except it is always aligned to the right edge of the text. If this causes the underline to be drawn on the "over" side of the text, then an overline also switches sides and is drawn on the "under" side.

2.8. ~text下線~offset： `text-underline-offset^p ~prop

この~propは、 `text-decoration$p 略式の`下位prop$`ではない^em。 これは、 下線の`~zero位置$からの~offsetを設定する。 ［ 正な／負な ］~offsetは、 ~textからの［ 外方／内方 ］への距離を表現する。 この~offsetは、 子孫~boxが異なる位置を指定していても，この要素から出生しているすべての装飾に影響するが、 先祖~要素により指定された下線には影響しない。 ◎ This property, which is not a sub-property of the text-decoration shorthand, sets the offset of underlines from their zero position. Positive offsets represent distances outward from the text; negative offsets inward. It affects all decorations originating from this element, even if descendant boxes specify a different position. It does not affect underlines specified by ancestor elements.

各種~値の意味は： ◎ Values have the following meanings:

`auto@v

~UAは下線~用に適切な~offsetを選ぶ。 ◎ The UA chooses an appropriate offset for underlines.

しかしながら，この~offsetは、 次に該当する場合は 0 にするモノトスル ⇒ ［ `text-underline-position$p の算出d値は `from-font$v1 ］~AND［ ~UAは，利用する適切な計量を~fontから抽出-可能である ］ ◎ However, this offset must be zero if the computed value of text-underline-position is from-font and the UA was able to extract an appropriate metric to use from the font.

`length-percentage$t

長さ値は、 下線の~offsetを固定d長さとして指定する。 ◎ A length value specifies the offset of underlines as a fixed length.

注記： 長さは，固定d値として継承されるので、 ~fontと伴に拡縮されることはない。 ◎ Note: A length will inherit as a fixed value, and will not scale with the font.

百分率~値は、 下線の~offsetを `1em^v の百分率として指定する。 ◎ A percentage value specifies the offset of underlines as a percentage of 1em.

注記： 百分率は，相対~値として継承されるので、 継承-時には，~fontの変化に伴い拡縮される。 ◎ Note: A percentage will inherit as a relative value, and will therefore scale with changes in the font as it inherits.

`text-decoration-line$p ~propの値が［ `spelling-error$v1 ／ `grammar-error$v1 ］のときは、 ~UAは， `text-underline-position$p の値を無視するモノトスル。 ◎ When the value of the text-decoration-line property is either spelling-error or grammar-error, the UA must ignore the value of text-underline-position.

2.9. ~text装飾~線の一様性

装飾線の正確な［ 位置, 太さ ］は、 上で定義したとおり，［ `text-underline-position$p, `text-underline-offset$p, `text-decoration-thickness$p ］の値に依存する。 他の場合【それらの値が初期~値 `auto^v をとる場合】、 ~UAにより定義される。 しかしながら，~UAは、 同じ`装飾ng~box$から導出される装飾~用には，各［ 下線／上線 ］用の［ 位置, 太さ ］を一定にするモノトスル。 ◎ The exact position and thickness of line decorations depends on the values of text-underline-position, text-underline-offset, and text-decoration-thickness as defined above, and is otherwise UA-defined. However, for underlines and overlines the UA must use a single thickness and position on each line for the decorations deriving from a single decorating box.

~UAは、 線の［ 位置, 太さ ］に対し： ◎ UAs＼

• 次のいずれかにより，`装飾ng~box$がズラされたときは、 線の位置をズラされた計量に合致するよう調整するモノトスル： ⇒＃ `baseline$v 以外の値をとる `vertical-align$p 【！`CSS2$r 】／ `font-variant-position$p `CSS-FONTS-3$r を介して［ 下付文字／上付文字 ］化された ◎ must adjust line positions to match the shifted metrics of decorating boxes shifted with vertical-align values other than baseline [CSS2] or subscripted/superscripted via font-variant-position [CSS-FONTS-3],＼
• 線の［ 位置, 太さ ］を`装飾ng~box$の子孫の【装飾~用の】~styleに呼応して`調整しない^emモノトスル （そうであっても、 そのように~styleされていない子孫を収容するためとして， 位置を`調整してもヨイ^em — 上で注記したような、 単に異なる~font~sizeで植字されるものがある場合など）。 ◎ but must not adjust the line position or thickness in response to descendants of a decorating box that are so styled (even though it may adjust the position to accommodate descendants that are not so styled, such as those merely typeset in a different font size as noted above).＼

これは、［ 上付文字や下付文字が（下線, 打消線【！struck through】, 等々で）適正に装飾される ］ことを許容する一方で，［ 先祖による装飾の位置決めが，それらの~styleにより歪められたり分断される ］ことを防止する。 ◎ This allows superscripts and subscripts to be properly decorated (underlined, struck through, etc.) but prevents them from distorting or breaking the positioning of such decorations on their ancestors.

2.10. ~text装飾~線の連続性： `text-decoration-skip^p 略式~prop, その下位prop

~CSS~WGは、 飛法の機能性を個々の~propに分割するものと解決した — `along the lines of^en `text-decoration-skip-ink$p 【？】， その~cascade法の挙動を改善するため。 `843$issue における論点と`解決＠https://lists.w3.org/Archives/Public/www-style/2017Feb/0049.html$ を見よ。 この節は，大まかな草案であり、 まだ~CSS~WGにより審査されてはいない。 ◎ The CSSWG resolved to be split skipping functionality into individual properties along the lines of text-decoration-skip-ink, to improve its cascading behavior. See discussion and resolution. This section is a rough draft and has not yet been vetted by the CSSWG

`text-decoration-skip$p ~propと その下位prop （ `text-decoration-skip-self$p, `text-decoration-skip-box$p, `text-decoration-skip-spaces$p, `text-decoration-skip-ink$p ）は、 `装飾ng~box$である［ 要素またはその先祖 ］による装飾線における途切れを制御する。 値 `none@v は、 すべての下位propを `none^v に設定する。 値 `auto@v は、 すべての下位propを 各自の初期~値に設定する。 ◎ The text-decoration-skip property and its sub-properties (text-decoration-skip-self, text-decoration-skip-box, text-decoration-skip-spaces, text-decoration-skip-ink) control interruptions in line decorations for which the element or an ancestor is the decorating box. The none value sets all sub-properties to none, and the auto value sets all sub-properties to their initial values.

この `none$v の定義は~Web互換になるか？ ~Web互換性を得るには `ink^v 値も追加する必要があるか？ ◎ Is this none definition Web-compatible? Do we also need to add an ink value for Web-compat?

注記： これらの~propは，継承される。 また、 子孫~要素を異なる設定にし得る。 ◎ Note that these properties inherit and that descendant elements can have a different setting.

~HTML用の既定の~UA~stylesheetに，次に挙げる追加が為された： ◎ The following addition is made to the default UA stylesheet for HTML:

ins, del { text-decoration-skip: none; }

`text-decoration-line$p ~propの値が［ `spelling-error$v1 ／ `grammar-error$v1 ］のときは、 ~UAは，これらの どの~propの値も無視してもヨイ。 ◎ When the value of the text-decoration-line property is either spelling-error or grammar-error, the UA may ignore any or all of these properties.

3.1. 圏点~style： `text-emphasis-style^p ~prop

要素の~textに適用する圏点は、 この~propで与える。 各種~値の意味は： ◎ This property applies emphasis marks to the element’s text. Values have the following meanings:

`none@v

圏点は無い。 ◎ No emphasis marks.

`filled@v

形状をベタ色で塗潰す。 ◎ The shape is filled with solid color.

`open@v

形状を中空（縁取り）にする。 ◎ The shape is hollow.

`dot@v

小さな丸を圏点0として表示する。 塗潰しの小丸は `2022^U ／ 縁取りの小丸は `25E6^U。 ◎ Display small circles as marks. The filled dot is U+2022 '•', and the open dot is U+25E6 '◦'.

`circle@v

大きい丸を圏点0として表示する。 塗潰しの丸は `25CF^U ／ 縁取りの丸は `25CB^U。 ◎ Display large circles as marks. The filled circle is U+25CF '●', and the open circle is U+25CB '○'.

`double-circle@v

二重丸を圏点0として表示する。 塗潰しの二重丸は `25C9^U ／ 縁取りの二重丸は `25CE^U 。 Display double circles as marks. The filled double-circle is U+25C9 '◉', and the open double-circle is U+25CE '~25CE'.

`triangle@v

三角を圏点0として表示する。 塗潰しの三角は `25B2^U ／ 縁取りの三角は `25B3^U。 ◎ Display triangles as marks. The filled triangle is U+25B2 '▲', and the open triangle is U+25B3 '△'.

`sesame@v

ゴマを圏点0として表示する。 塗潰しのゴマは `FE45^U ／ 縁取りのゴマは `FE46^U。 ◎ Display sesames as marks. The filled sesame is U+FE45 '﹅', and the open sesame is U+FE46 '﹆'.

`string$t

所与の文字列を圏点0として表示する。 ◎ Display the given string as marks.＼

作者は、 この値に複数の`文字$（書記素~cluster）を指定するベキでない。 ~UAは、 そのような文字列を切落しても無視してもヨイ。 ◎ Authors should not specify more than one character in <string>. The UA may truncate or ignore strings consisting of more than one grapheme cluster.

形状~keywordが指定された下で［ `filled$v ／ `open$v ］が指定されなかった場合、 `filled$v に算出される【！見做される】。 ［ `filled$v ／ `open$v ］のみが指定された場合、 形状~keywordは［ `横書き~mode$の下では `circle$v ／ `縦書き~mode$の下では `sesame$v ］に算出される。 ◎ If a shape keyword is specified but neither of filled nor open is specified, filled is assumed. If only filled or open is specified, the shape keyword computes to circle in horizontal typographic modes and sesame in vertical typographic modes.

圏点0は、 要素の~font設定群に加えて `ruby$v 特能も利用する下で， ~size 50% に縮小して描かれるベキである。 ［ これらの~glyphを有さない~font／ これらの符号位置による圏点に不適切な~sizeを利用する~font ］もあるので、 ~UAは， 圏点に適することが既知な~fontを利用することにしても, 代わりになる圏点0を合成してもヨイ。 圏点0は、 `縦書き~mode$においては正立に保つモノトスル — ~CJK文字の様に［ `書字~mode$に合致するよう回転される ］ことはない。 `縦組み$における`横書き~mode$における圏点0の方位は、 この~levelでは未定義とする （が、 確たる利用事例が発生したなら，将来の~levelにおいて定義されよう）。 ◎ The marks should be drawn using the element’s font settings with the addition of the ruby feature and the size scaled down 50%. However, since not all fonts have all these glyphs, and some fonts use inappropriate sizes for emphasis marks in these code points, the UA may opt to use a font known to be good for emphasis marks, or the marks may instead be synthesized by the UA. Marks must remain upright in vertical typographic modes: like CJK characters, they do not rotate to match the writing mode. The orientation of marks in horizontal typographic modes of vertical writing modes is undefined in this level (but may be defined in a future level if definitive use cases arise).

注記： 圏点に適する~fontの例として、 `Kenten Generic OpenType Font＠https://github.com/adobe-fonts/kenten-generic$en （ Adobe の~opensource） が挙げられる — それは、 圏点~用に特別に設計されている。 ◎ Note: One example of good fonts for emphasis marks is Adobe’s open source, Kenten Generic OpenType Font, which is specially designed for the emphasis marks.

圏点0は各`~typographic文字~単位$ごとに 1 個ずつ描かれる。 ただし、 次に挙げる`文字$には，圏点は描かれない： ◎ The marks are drawn once for each typographic character unit. However, emphasis marks are not drawn for:

• `単語~分離子$, または~Unicode分離子~class（ `Z*^uc ）に属する`文字$ （ただし、 何らかの結合~文字と結合された~space用には，`圏点は描かれる^emことに注意。） 【 `Z*^uc の `*^uc は~wildcard。次の `P*^uc も同様。】 ◎ Word separators or other characters that belong to the Unicode separator classes (Z*). (But note that emphasis marks are drawn for a space that combines with any combining characters.)
• 約物 — 特定的には、 `~Unicode一般~字種$ `P*^uc に属していて，次に挙げるどの記号にも NFKD 正規化- `UAX15$r されないもの ⇒＃ `0023^U `NUMBER SIGN^cn, `0025^U `PERCENT SIGN^cn, `2030^U `PER MILLE SIGN^cn, `2031^U `PER TEN THOUSAND SIGN^cn, `066A^U `ARABIC PERCENT SIGN^cn, `0609^U `ARABIC-INDIC PER MILLE SIGN^cn, `060A^U `ARABIC-INDIC PER TEN THOUSAND SIGN^cn, `0026^U `AMPERSAND^cn, `204A^U `TIRONIAN SIGN ET^cn, `0040^U `COMMERCIAL AT^cn, `00A7^U `SECTION SIGN^cn, `00B6^U `PILCROW SIGN^cn, `204B^U `REVERSED PILCROW SIGN^cn, `2053^U `SWUNG DASH^cn, `303D^U `PART ALTERNATION MARK^cn ◎ Punctuation--specifically, any characters that belong to the Unicode P* general category and do not NFKD normalize [UAX15] to any of the following symbols: ◎ # U+0023 NUMBER SIGN % U+0025 PERCENT SIGN ‰ U+2030 PER MILLE SIGN ‱ U+2031 PER TEN THOUSAND SIGN ٪ U+066A ARABIC PERCENT SIGN ؉ U+0609 ARABIC-INDIC PER MILLE SIGN ؊ U+060A ARABIC-INDIC PER TEN THOUSAND SIGN & U+0026 AMPERSAND ⁊ U+204A TIRONIAN SIGN ET @ U+0040 COMMERCIAL AT § U+00A7 SECTION SIGN ¶ U+00B6 PILCROW SIGN ⁋ U+204B REVERSED PILCROW SIGN ⁓ U+2053 SWUNG DASH 〽️ U+303D PART ALTERNATION MARK
• ［ 制御~code／未割当てな文字 ］用の~Unicode~class（ `Cc^uc, `Cf^uc, `Cn^uc ）に属するもの。 ◎ Characters belonging to the Unicode classes for control codes and unassigned characters (Cc, Cf, Cn).

注記： どの文字に圏点0が付与されるかの制御は、 ~level 4 にて追加されることになる。 （約物の~listも，さらに精緻化され得る — 特に~CJKでない約物。） ◎ Note: Control over which characters are marked will be added in Level 4. (The list of punctuation may also be further refined, particularly for non-CJK punctuation.)

【 ~level 4 は，この文書なので、 この注記は余計であろう — ~level 3 にも同じ注記があることに加え、 該当する制御として `text-emphasis-skip$p が，この文書に定義されているので。 】

3.2. 圏点の色： `text-emphasis-color^p ~prop

この~propは、 圏点の前景~色を指定する。 ◎ This property specifies the foreground color of the emphasis marks.

注記： `currentcolor$v ~keywordは、 それ自身に算出され， 継承が遂行された後に【当の要素の】 `color$p の値に解決される。 これは、 `text-emphasis-color$p は，既定では~textの `color$p に合致することを意味する — `color$p が各~要素にわたって変化するときでも。 ◎ Note: currentcolor keyword computes to itself and is resolved to the value of color after inheritance is performed. This means text-emphasis-color by default matches the text color even as color changes across elements.

3.3. 圏点： `text-emphasis^p 略式~prop

この~propは、［ `text-emphasis-style$p, `text-emphasis-color$p ］を 1 個の宣言で設定する略式~propである。 省略された値は、 各自の初期~値に設定される。 ◎ This property is a shorthand for setting text-emphasis-style and text-emphasis-color in one declaration. Omitted values are set to their initial values.

注記： この略式~propは、 `text-emphasis-position$p を設定し直すことはない。 同じ`内容~言語$の下では、 形状や色は概して文書~全体を通して変わる一方で， 位置は一貫することが多いので。 したがって、 位置は独立に継承されるベキである。 ◎ Note that text-emphasis-position is not reset in this shorthand. This is because typically the shape and color vary, but the position is consistent for a particular language throughout the document. Therefore the position should inherit independently.

3.4. 圏点の位置： `text-emphasis-position^p ~prop

この~propは、 圏点がどこに描かれるかを述べる。 [ `right$v | `left$v ] ~~成分が省略された場合の既定は `right$v とする。 各種 値の意味は： ◎ This property describes where emphasis marks are drawn at. If [ right | left ] is omitted, it defaults to right. The values have following meanings:

`over@v

`横書き~mode$において圏点0たちを ~textの上面に描く。 ◎ Draw marks over the text in horizontal typographic modes.

`under@v

`横書き~mode$において圏点0たちを ~textの下面に描く。 ◎ Draw marks under the text in horizontal typographic modes.

`right@v

`縦書き~mode$において圏点0たちを ~textの右端に描く。 ◎ Draw marks to the right of the text in vertical typographic modes.

`left@v

`縦書き~mode$において圏点0たちを ~textの左端に描く。 ◎ Draw marks to the left of the text in vertical typographic modes.

圏点は、 各~文字に，~ruby注釈~textとして — 正確に， `text-emphasis-position$p により与えられる~ruby位置に, ~ruby整列は中央寄せにされて — アテガわれていたかのように描かれる。 この位置は、 下線や上線による装飾と競合することになる場合には，調整され得る／してもヨイことに注意。 ◎ Emphasis marks are drawn exactly as if each character was assigned the mark as its ruby annotation text with the ruby position given by text-emphasis-position and the ruby alignment as centered. Note that this position may be adjusted if it would conflict with underline or overline decorations.

行l高さに対する圏点の効果は、 ~ruby~textに対するときと同じである。 ◎ The effect of emphasis marks on the line height is the same as for ruby text.

文字に適用される圏点は、 同じ位置に~rubyも描かれる場合には，~rubyの外側に配置される。 これには［ `自動で隠される$／空な ］`~ruby注釈$も含まれる。 ◎ If emphasis marks are applied to characters for which ruby is drawn in the same position as the emphasis mark, the emphasis marks are placed outside the ruby. This includes auto-hidden and empty ruby annotations.

ruby { text-emphasis: none; }

em { text-emphasis: dot; } /* 
`em^e 要素~用の `text-emphasis$p を設定する
◎
Set text-emphasis for <em> elements
 */
em rt { display: none; }   /* 
`em^e 要素の内側にある~rubyを隠す
◎
Hide ruby inside <em> elements
 */

3.5. 圏点を飛ばす： `text-emphasis-skip^p ~prop

この節は、 模索中にある。 また，この~propは、 必要かどうかさえ，まだ明瞭でない — 各~公表版の間で，欲される挙動に相違があるにもかかわらず。 ◎ This section is under brainstorming. It’s also not yet clear if this property is needed quite yet, despite differences in desired behavior among publications.

この~propは、 どの文字に圏点0を描くかを述べる。 各種~値の意味は： ◎ This property describes for which characters marks are drawn. The values have following meanings:

`spaces@v

次に挙げる`文字$を飛ばす ⇒＃ `単語~分離子$／ ~Unicode分離子~字種（ `Z*^uc ）に属するもの ◎ Skip word separators or other characters belonging to the Unicode separator category (Z*).＼

（が、 結合~文字と結合された~space用には， `圏点は描かれる^emことに注意）。 ◎ (But note that emphasis marks are drawn for a space that combines with any combining characters.)

`punctuation@v

次に挙げる文字（ “約物” ）を飛ばす ⇒ `~Unicode一般~字種$ `P*^uc に属する文字のうち， `symbols$v に挙げるもの以外 ◎ Skip punctuation. Punctuation in this definition includes characters belonging to the Unicode P* category that are not defined as symbols (see below).

`symbols@v

次に挙げる文字（ “記号” ）を飛ばす：

• `~Unicode一般~字種$ `S*^uc に属する`~typographic文字~単位$
• 次に挙げる`~Unicode一般~字種$ `Po^uc に属する`文字$に `NFKD^ 等価なもの `UAX15$r ⇒＃ `0023^U `NUMBER SIGN^cn, `0025^U `PERCENT SIGN^cn, `2030^U `PER MILLE SIGN^cn, `2031^U `PER TEN THOUSAND SIGN^cn, `066A^U `ARABIC PERCENT SIGN^cn, `0609^U `ARABIC-INDIC PER MILLE SIGN^cn, `060A^U `ARABIC-INDIC PER TEN THOUSAND SIGN^cn, `0026^U `AMPERSAND^cn, `204A^U `TIRONIAN SIGN ET^cn, `0040^U `COMMERCIAL AT^cn, `00A7^U `SECTION SIGN^cn, `00B6^U `PILCROW SIGN^cn, `204B^U `REVERSED PILCROW SIGN^cn, `2053^U `SWUNG DASH^cn, `303D^U `PART ALTERNATION MARK^cn

◎ Skip symbols. Symbols in this definition includes all typographic character units belonging to the Unicode S* general category as well as any which are NFKD-equivalent [UAX15] to the following characters from the Unicode Po category: ◎ # U+0023 NUMBER SIGN % U+0025 PERCENT SIGN ‰ U+2030 PER MILLE SIGN ‱ U+2031 PER TEN THOUSAND SIGN ٪ U+066A ARABIC PERCENT SIGN ؉ U+0609 ARABIC-INDIC PER MILLE SIGN ؊ U+060A ARABIC-INDIC PER TEN THOUSAND SIGN & U+0026 AMPERSAND ⁊ U+204A TIRONIAN SIGN ET @ U+0040 COMMERCIAL AT § U+00A7 SECTION SIGN ¶ U+00B6 PILCROW SIGN ⁋ U+204B REVERSED PILCROW SIGN ⁓ U+2053 SWUNG DASH 〽️ U+303D PART ALTERNATION MARK

`narrow@v

次に挙げる文字を飛ばす ⇒ ~Unicode~database `UAX44$r の `East_Asian_Width^uc ~prop `UAX11$r は［ `F^uc（ `Fullwidth^uc ）／ `W^uc（ `Wide^uc ） ］でないもの 【！https://ja.wikipedia.org/wiki/%E6%9D%B1%E3%82%A2%E3%82%B8%E3%82%A2%E3%81%AE%E6%96%87%E5%AD%97%E5%B9%85】 ◎ Skip characters where the East_Asian_Width property [UAX11] of the Unicode database [UAX44] is not F (Fullwidth) or W (Wide).

次に挙げる文字は、 この~propの値が何であれ飛ばされる ⇒ ［ 制御~code／未割当てな文字 ］用の~Unicode~class（ `Cc^uc, `Cf^uc, `Cn^uc ）に属するもの ◎ Characters belonging to the Unicode classes for control codes and unassigned characters (Cc, Cf, Cn) are skipped regardless of the value of this property.

この構文は、 ~UAが~space用の圏点0を描くよう実装することを要求する。 それ用の利用事例はあるのか？ ないならば， ~space用に描かれる圏点0を許容しないよう構文を改変するべきか？ ◎ This syntax requires UA to implement drawing marks for spaces. Is there any use case for doing so? If not, should we modify the syntax not to allow drawing marks for spaces?

`839$issueにおける初期~値の論点も見よ。 ◎ See also discussion of the initial value.

5.1. ~text装飾の塗ng順序

~text装飾は、 `CSS2$r と同じく， それが装飾する~textの直上または直下にある層に次の順序で描かれる （最初が最下~層）： ◎ As in [CSS2], text decorations are drawn immediately over/under the text they decorate, in the following order (bottommost first):

1. 影（ `text-shadow$p ） ◎ shadows (text-shadow)
2. 下線（ `text-decoration$p ） ◎ underlines (text-decoration)
3. 上線（ `text-decoration$p ） ◎ overlines (text-decoration)
4. ~text ◎ text
5. 圏点（ `text-emphasis$p ） ◎ emphasis marks (text-emphasis)
6. 打消線（ `text-decoration$p ） ◎ line-through (text-decoration)

ここで、 `装飾線$が［ ~box装飾／`不可分な行内$ ］をまたぐように描かれる所では、 `有位置$でない内容の上, かつ有位置な子孫（ CSS2.1 Appendix E の層 #8 ）の直下にある層に描かれる。 ◎ Where line decorations are drawn across box decorations or atomic inlines, they are drawn over non-positioned content and just below any positioned descendants (immediately below layer #8 in CSS2.1 Appendix E).

5.2. ~text装飾の~overflow

`~box$の外側にはみ出た~text装飾は、 `~ink~overflow$と見なされ，`~scroll可能な~overflow区画$を拡張しない。 `css-overflow-3$r ◎ Text decorations that leak outside a box are considered ink overflow: they do not extend the scrollable overflow region. [css-overflow-3]