序論
作者は、 文書~treeを成していない内容を ~UAに描画させたいと求めることもある。 馴染みの例として、 見出し用の番号を，明示的に~mark-upすることなく ~UAに自動的に生成させたいときが挙げられる。 ~counterと~markerが、 これらの効果を達成するために利用される。 ◎ Authors sometimes want user agents to render content that does not come from the document tree. One familiar example of this is numbered headings; the author does not want to mark the numbers up explicitly, they want the user agent to generate them automatically. Counters and markers are used to achieve these effects.
h1::before { content: counter(節) ": "; }
同様に，作者は、 ~UAに各 図の~captionの前に単語 "図" を挿入したり， 7 個目の章の~titleの前に行l "第 7 章" を挿入したいと求めることもある。 ◎ Similarly, authors may want the user agent to insert the word "Figure" before the caption of a figure, or "Chapter 7" on a line before the seventh chapter title.
chapter { counter-increment: 章; }
chapter > title::before { content: "第 " counter(章) " 章\A"; }
要素を画像~その他の~multimedia内容で置換する効果も，共通的にある。 すべての~UAがすべての~multimedia形式を~supportするわけではないので、 ~fallbackを供する必要もあろう。 ◎ Another common effect is replacing elements with images or other multimedia content. Since not all user agents support all multimedia formats, fallbacks may have to be provided.
/* ~UAが~supportする形式を利用して，`logo^e 要素を~siteの~logoに置換する。 ◎ Replace <logo> elements with the site’s logo, using a format supported by the UA */ logo { content: url(logo.mov), url(logo.mng), url(logo.png), none; } /* `figure^e 要素を参照先の文書に置換する — 失敗した場合， `alt^a 属性が［ 在れば その内容／無ければ要素~自身の内容 ］で置換する。 ◎ Replace <figure> elements with the referenced document, or, failing that, with either the contents of the alt attribute or the contents of the element itself if there is no alt attribute */ figure[alt] { content: attr(href url), attr(alt); } figure:not([alt]) { content: attr(href url), contents; }
値~定義
【 この節の内容は、 `~CSS日本語訳 共通~page＠~CSScommon#values$に移譲。 】
1. 内容の挿入-法と置換-法： `content^p ~prop
◎名 `content@p ◎値 `normal^v | `none^v | [ `content-replacement$t | `content-list$t ] [/ [ `string$t | `counter$t | `attr()$t ]+ ]? ◎初 `normal^v ◎適 すべての要素／`~treeに留まる疑似要素$／`~page~margin~box$ ◎ all elements, tree-abiding pseudo-elements, and page margin boxes ◎継 されない ◎百 受容しない ◎算 下の注釈文を見よ ◎順 文法に従う ◎ア 離散的 ◎表終~UAには、 視覚的でないものも含め，どの媒体でもこの~propを~supportすることが期待される。 ◎ User agents are expected to support this property on all media, including non-visual ones.
`content$p ~propは、［ 要素／疑似要素 ］の内側に何が描画されるかを規定する： ◎ The content property dictates what is rendered inside an element or pseudo-element.
- 要素~用には、 目的は 1 つだけであり，要素を次のどちらにするかを制御する ⇒＃ 通常通り描画する／ 画像（場合によっては要素に結付けられた何らかの “代替（ `alt^en ）~text” ）で置換する ◎ For elements, it has only one purpose: specifying that the element renders as normal, or replacing the element with an image (and possibly some associated "alt text").
- ［ 疑似要素／`~page~margin~box$ ］用には、 これはもっと強力になり，要素を次のどれにするかを制御する ⇒＃ まったく描画しない【！renders at all】 ／ 画像で置換する ／ 任意の行内~内容（~textや画像）で置換する ◎ For pseudo-elements and margin boxes, it is more powerful. It controls whether the element renders at all, can replace the element with an image, or replace it with arbitrary inline content (text and images).
- `normal@v
- これは、［ 要素／`~page~margin~box$ ］用には， `contents$v に算出される。 ◎ For an element or page margin box, this computes to contents.
- これは、［ `before$pe ／ `after$pe ］疑似要素~用には， `~noneC$v に算出される。 ◎ For ::before and ::after, this computes to none.
- これは、［ `marker$pe ／ `placeholder$pe ／ `file-selector-button$pe ］疑似要素~用には， それ自身（ `normal$v ）に算出される。 ◎ For ::marker, ::placeholder, and ::file-selector-button, this computes to itself (normal).
- `~noneC@v
- 要素~用には、 `normal$v と同じに挙動する。 ◎ On elements, this behaves as normal. On elements, this inhibits the children of the element from being rendered as children of this element, as if the element was empty.
- `疑似要素$用には、 `display$p が `none^v にされていたかのように疑似要素の作成を妨げる。 ◎ On pseudo-elements it inhibits the creation of the pseudo-element as if it had display: none.
- いずれにせよ、 この値は，［ 要素／疑似要素 ］を`出自の要素$とする別の疑似要素を生成させなくすることはない。 ◎ In neither case does it prevent any pseudo-elements which have this element or pseudo-element as an originating element from being generated.
- `content-replacement@t
- 構文は `image$t に等しい。 ◎ Equal to: <image>
- ［ 要素／疑似要素 ］を指定された `image$t で埋められる`置換d要素$にする。 通常の内容は、 抑止され， `display$p が `none^v にされていたかのように~boxを生成しない。 ◎ Makes the element or pseudo-element a replaced element, filled with the specified <image>. Its normal contents are suppressed and do not generate boxes, as if they were display: none.
- `image$t は`無効な画像$を表現する場合、 代わりに［ `生来な横幅$, `生来な縦幅$ ］どちらも 0 の画像を表現しているものと扱って，`透明な黒$で埋めるモノトスル。 ◎ If the <image> represents an invalid image, then it must be treated as instead representing an image with zero natural width and height, filled with transparent black.
- 上の`無効な画像$の挙動は、 ~Chromeに見られる。 これでいいのか？ もっと良い挙動を利用できる／利用するべきでは？ ◎ The above invalid image behavior appears to be what Chrome is doing. Is this okay? Is there a better behavior we can/should use?
- 注記： `置換d要素$は、 通常の要素と異なる~layout規則を利用する（実質的に，~HTML `img$e 要素と等価になる）。 ◎ Note: Replaced elements use different layout rules than normal elements. (In effect, it becomes equivalent to an HTML img element.)
- 注記： `置換d要素$には［ `before$pe ／ `after$pe ］疑似要素は無いので、 `content$p ~propは，その内容~全体を置換する。 ◎ Note: Replaced elements do not have ::before or ::after pseudo-elements; the content property replaces their entire contents.
- この値は、［ `before$pe ／ `after$pe ］に対しては，歴史的に `content-list$t として扱われてきた。 これには~Web互換性の要件があると予め見做されるので、 これらの疑似要素には，例外が必要かもしれない。 `2889$issue ◎ This value has historically been treated as <content-list> on ::before and ::after. Presumably there’s a Web-compat requirement on this, so these pseudo-elements might need an exception. [Issue #2889]
- `content-list$t
- 要素の内容を［ 指定された 1 個~以上の各~値に対応する，指定された順序による`匿名$な`行内~box$たち ］に置換する。 通常の内容は、 `display$p が `none^v にされていたかのように抑止され，~boxを生成しなくなる。 ◎ Replaces the element’s contents with one or more anonymous inline boxes corresponding to the specified values, in the order specified. Its normal contents are suppressed and do not generate boxes, as if they were display: none.
- 各~値は、 行内~levelの`匿名$な~boxを要素の内容に供与する。 これは、 `image$t に対しては`置換d要素$になり，他に対しては`~text連列$になる。 ◎ Each value contributes an inline box to the element’s contents. For <image>, this is an inline anonymous replaced element; for the others, it’s an anonymous inline run of text.
-
`image$t は`無効な画像$を表現する場合、 ~UAは次のいずれかを行うモノトスル： ◎ If an <image> represents an invalid image, the user agent must do one of the following:
- `image$t を “飛ばして”，それ用には何も生成しない。 ◎ "Skip" the <image>, generating nothing for it.
- `image$t に代えて画像を表示できないこと指示する何かを表示する — “壊れた画像” ~iconなど。 ◎ Display some indication that the image can’t be displayed in place of the <image>, such as a "broken image" icon.
- この仕様は，［ ~UAは，どちらの挙動を利用するモノトスルか ］は 意図的に定義しないが、 ~UAは，一貫して片方のみを利用するモノトスル。 ◎ This specification intentionally does not define which behavior a user agent must use, but it must use one or the other consistently.
- 注記： `content-list$t 値を成す `image$t は 1 個だけの場合、 `content-replacement$t として解釈するモノトスル。 ◎ Note: If the value of <content-list> is a single <image>, it must instead be interpreted as a <content-replacement>.
- / [ `string$t | `counter$t | `attr()$t ]+
- 要素~用の “代替~text” を指定する。 詳細は `§ ~accessibilityを得るための代替~text＠#alt$ を見よ。 省略された場合、 要素には “代替~text” は無い。 ◎ Specifies the "alt text" for the element. See § 1.2 Alternative Text for Accessibility for details. If omitted, the element has no "alt text".
`contents$v ~keywordは `content$f に置換するベキか？ ◎ Should the contents keyword be replaced with content()?
1.1. 生成d内容の~accessibility
生成d内容は［ 探索-可能, 選択-可能, 支援技術に可用 ］になるベキである。 発話, 生成d内容に適用される `content$p ~propは、 発話~出力~用にも具現化されるモノトスル。 `CSS3-SPEECH$r ◎ Generated content should be searchable, selectable, and available to assistive technologies. The content property applies to speech and generated content must be rendered for speech output. [CSS3-SPEECH]
~CSS用の~AAMの作業を開始する。 ◎ Start work on an AAM for CSS.
1.2. ~accessibilityを得るための代替~text
視覚的な媒体~用に意図される内容は、 ときには，発話~出力~その他の視覚的でない媒体~用に代替~textを必要とする。 したがって `content$p ~propは、 `content-list$t の後に，~slash （ `/^css ）に続けて指定される代替~textも受容する。 そのような代替~textが供された場合、 発話~出力~用には代わりにそれを利用するモノトスル。 ◎ Content intended for visual media sometimes needs alternative text for speech output or other non-visual mediums. The content property thus accepts alternative text to be specified after a slash (/) after the last <content-list>. If such alternative text is provided, it must be used for speech output instead.
これは例えば、 次を作者に許容する：
- 純粋に装飾的な~textは、 発話~出力においては（代替~textに空~文字列を供して）省く。
- ［ 画像／~icon／~textに符号化された記号 ］にもっと読み易い代替を供する。
ここでは `content^p ~propは画像を与えるので、 代替~textを供するために代替~値が要求される。 ◎ Here the content property is an image, so the alt value is required to provide alternative text.
.new::before {
content: url(./img/star.png) / "New!";
/*
あるいは、
~DOMから局所的に得られる属性：
◎
or a localized attribute from the DOM:
attr("data-alt")
*/
}
疑似要素は純粋に装飾的で，その機能は他所が受持っている場合、 代替~値を空~文字列に設定することで，装飾的な要素が読上げられるのを避けれる。 ここでは、 ~ARIA属性が “畳まれています” などと発話されることになる。 空~文字列にされた代替~値を伴わない場合、 内容は “`black right-pointing pointer^en” として発話されることになる†。 ◎ If the pseudo-element is purely decorative and its function is covered elsewhere, setting alt to the empty string can avoid reading out the decorative element. Here the ARIA attribute will be spoken as "collapsed". Without the empty string alt value, the content would also be spoken as "Black right-pointing pointer".
.expandable::before {
content: "\25BA" / ""; /*
►（右向き三角）
◎
a.k.a. ►
*/
/*
すでに ~DOM内に `aria-expanded="false"^a があるので、
この疑似要素は装飾的。
◎
aria-expanded="false" already in DOM, so this pseudo-element is decorative
*/
}
【† “`black right-pointing pointer^en” は，~Unicodeに定義される "►" （ U+25BA ）の文字~名であり、 文字~名は おそらく英語~名しか正式に定義されていないので、 `内容~言語$が英語でない環境でも，このとおり発話されるかもしれない。 】
2. 生成d内容~値 `content-list^t 型
`content-list$t 値は、［ 画像, 文字列, ~counterの値, 要素の~text値 ］も含め， 1 個以上の`匿名$な`行内~box$で要素を埋めるために `content$p 内で利用される。 この節では、 これがとり得る値を種類別にとりあげる。 ◎ The <content-list> value is used in content to fill an element with one or more anonymous inline boxes, including images, strings, the values of counters, and the text value of elements. In this section we enumerate the possibilities.
`content-list$t の構文は、 次で定義される： ◎ The syntax of <content-list> is defined as:
`content-list@t = [ `string$t | `image$t | `attr()$t | `contents$v | `quote$t | `leader()$t | `target$t | `string()$t | `content()$t | `counter$t ]+
2.1. 基本的な文字列： `string^t 値, `attr()^t 値
- `string$t
- 指定された~textで埋められる`匿名$な`行内~box$を表現する。 ◎ Represents an anonymous inline box filled with the specified text.
- 注記： 文字列~内の`空白$は、 ~literal~text【通常の内容~内の~text】と同じに取扱われ， `CSS-TEXT-3$r や他所による~propにより制御される。 特に，`空白$並びは縮約され得る — `content$p の値において `"First " " Second"^v のように，複数の文字列にまたがっていようが、 既定では "First Second" （単語の合間に可視な~spaceは 1 個だけ）のように描画することになる。 ◎ Note: White space in the string is handled the same as in literal text, and controlled by the properties in [CSS-TEXT-3] and elsewhere. In particular, white space character can collapse, even across multiple strings, such as in content: "First " " Second";, which by default will render similar to "First Second" (with a single visible space between the two words).
- `attr()$t
- この関数-記法は、 属性に指定された値として格納された文字列を表現する。 その引数は、 在るならば，［ 当の属性の名前, 当の属性が属する名前空間 ］を表現している`~CSS有修飾~名$（ `qname$t ）である。 `CSS3-NAMESPACE$r を見よ。 ◎ The attr() functional notation represents the string stored as the specified attribute’s value. Its argument is a CSS qualified name (qname) representing the attribute name and namespace, if any. See [CSS3-NAMESPACE].
- 注記： `属性~選択子のとき＠~SELECTORS4#attrnmsp$と同じく、 明示的な名前空間を伴わない属性~名は，どの既定の名前空間にも結付けられない。 ◎ Note: As in attribute selectors, attribute names without an explicit namespace do not associate with any default namespace.
2.2. ~2D画像： `image$t 値
- `image$t
- 指定された画像で埋められる`匿名$な行内 `置換d要素$を表現する。 ◎ Represents an anonymous inline replaced element filled with the specified <image>.
- `image^t 値が`無効な画像$を表現する場合、 何も表現しない（ “飛ばされた” かのように，行内~内容は要素に追加されない）。 ◎ If the <image> represents an invalid image, this value instead represents nothing. (No inline content is added to the element, as if this value were "skipped".)
CSS2.1 は、 画像が妥当でない場合には “壊れた画像” ~iconで代用することを，明示的に~UAに許容していた。 しかしながら，これを行っている~browserは無いように見受けられる。 これは除去してもいいのでは？ ◎ CSS2.1 explicitly allowed the UA to substitute a broken image icon if the image was invalid. However, no browser appears to do this. Is this removal okay?
2.3. 要素の内容： `contents^v ~keyword
- `contents@v
-
要素の子孫を表現する。 これは、 要素ごとに一回しか利用できないので（例：~pluginや~form~controlである子は重複できない）、 次に従って取扱われる： ◎ The element’s descendants. Since this can only be used once per element (you can’t duplicate the children if, e.g., one is a plugin or form control), it is handled as follows:
- 要素に対し設定された場合 ⇒ 常に尊守される。 これが既定になることに注意 — `content$p の初期~値 `normal$v は、 要素に対しては `contents$v に算出されるので。 ◎ If set on the element: • Always honoured. Note that this is the default, since the initial value of content is normal and normal computes to contents on an element.
-
疑似要素に対し設定された場合 ⇒ “それまでの” 疑似要素に設定されていないことを次に挙げる深さの順序で検査する ⇒＃ `出自の要素$, `before$pe, `after$pe ◎ If set on one of the element’s other pseudo-elements: • Check to see that it is not set on a "previous" pseudo-element, in the following order, depth first: •• the element itself •• ::before •• ::after
これは、 疑似要素に対しては空~文字列として挙動するベキか？ ◎ Should this behave as an empty string on pseudo-elements?
すでに利用されていた場合、 何も表現しない（ `~noneC$v の様に）。 実際に生成される疑似要素のみ検査される。 ◎ If it is already used, then it evaluates to nothing (like none). Only pseudo-elements that are actually generated are checked.
次の事例では： ◎ In the following case:
foo { content: normal; } /*
初期~値
◎
this is the initial value
*/
foo::after { content: contents; }
要素の `content$p ~propは `contents$v に算出されるので、 `after^pe 疑似要素の内容は無く，現れないことになる（ `~noneC$v に等価）。 ◎ ...the element’s content property would compute to contents and the after pseudo element would have no contents (equivalent to none) and thus would not appear.
foo { content: none; }
foo::after { content: contents; }
一方，次の例では、 `after^pe 疑似要素は `foo^e 要素の内容を包含することになる。 ◎ But in this example, the ::after pseudo-element will contain the contents of the foo element.
要素の内容を抑止して，それを疑似要素~内で利用するような利用事例があれば、 歓迎する。 ◎ Use cases for suppressing the content on the element and using it in a pseudo-element would be welcome.
注記： 単独の `content$p ~prop内に `contents$v を重ねて含めても有用にならないが、 構文解析-~errorにはならない。 最初~以外の出現による効果は無い — すでに利用されているので。 `marker$pe 疑似要素に利用するのも構文解析-~errorではない — `~noneC$v の様に扱われるのは、 描画~段階の間に限られる。 ◎ Note: While it is useless to include contents twice in a single content property, that is not a parse error. The second occurrence simply has no effect, as it has already been used. It is also not a parse error to use it on a ::marker pseudo-element, it is only during the rendering stage that it gets treated like none.
`marker^pe 疑似要素についての言明は、 ここに必要なのか？ あるいは，これは この仕様の旧~versionからの旧来の~~記述なのか？ ◎ Do we need the statement about marker pseudo-elements here? Or is this legacy from the old version of the spec?
2.4. 引用符
`quotes$p ~prop （それは，要素の`引用符~system$を定義する） は、 `content$p ~prop （それは，対応する引用符を生成d内容として挿入する） 用の様々な `*-quote^v 値と併用して，［ 開き／閉じ ］引用符を （~HTML `q$e 要素~用などに） 自動的に挿入するために利用できる。 ◎ The quotes property, which defines the quotation mark system of an element, in conjunction with the various *-quote values of the content property, which insert corresponding quotation marks as generated content, can be used to automatically insert opening and closing quotation marks, such as for the HTML q element.
2.4.1. 引用符~system： `quotes^p ~prop
◎名 `quotes@p ◎値 `auto$v | `~noneQ$v | `match-parent$v | [ `string$t `string$t ]+ ◎初 `auto$v ◎適 すべての要素 ◎継 される ◎百 受容しない ◎算 指定された~keyword ／ ［ 文字列~値の~pair ］たちが成す~list ◎ the keyword none, the keyword auto or match-parent, or a list, each item a pair of string values ◎順 文法に従う ◎ア 離散的 ◎表終~UAには、 視覚的でないものも含め，どの媒体でもこの~propを~supportすることが期待される。 ◎ User agents are expected to support this property on all media, including non-visual ones.
この~propは、 当の要素~用に `引用符~system@ を指定する — それは、 `content$p ~prop用の値［ `open-quote$v, `close-quote$v ］が どう挙動するかを定義する。 `§ 引用符の挿入-法＠#quote-values$ を見よ。 各種~値の意味は： ◎ This property specifies the quotation mark system for the element, defining how the content property’s open-quote and close-quote values behave. See § 2.4.2 Inserting Quotation Marks: the *-quote keywords. Values have the following meanings:
- `~noneQ@v
- `content$p ~prop用の値［ `open-quote$v ／ `close-quote$v ］が［ `no-open-quote$v ／ `no-close-quote$v ］であったかのように，引用符を生産しない。 ◎ The open-quote and close-quote values of the content property produce no quotations marks, as if they were no-open-quote and no-close-quote respectively.
- `auto@v
- ~typographic的に適切な`引用符~system$は、 要素の親（親が無い場合は要素~自身）の`内容~言語$に基づいて， ~UAにより自動的に選ばれる。 ◎ A typographically appropriate quotation mark system is automatically chosen by the UA based on the content language of the parent (or, if there is no parent, of the element itself).
- 注記： ~typographic的に適切な引用符についての情報は、 `CLDR$r にて保守されている。 ~UAは、 他の情報~sourceも利用できる — 特に，~typographic選好は変わり得るので。 しかしながら，改善があれば、 ~software~ecosystem全体の便益になるよう，~Unicodeへ提出することが奨励される。 ◎ Note: The Unicode Common Locale Data Repository [CLDR] maintains information on typographically appropriate quotation marks. UAs can use other sources of information as well, particularly as typographic preferences can vary; however it is encouraged to submit any improvements to Unicode so that the entire software ecosystem can benefit.
- `match-parent@v
- 親と同じ`引用符~system$を指定する。 これは、 一般に，親の`算出d値$を継承することと等価になる — `auto$v `it^en【？】 は親が利用したものと同じ`内容~言語$を利用して解決されることを除いて。 ◎ Specifies the same quotation mark system as the the parent. In general this is equivalent to inheriting the parent’s computed value, except that auto it resolves using the same content language that the parent used.
-
ここではアリな~approachが 2 つあり，現時点では後者を仕様~化している：
- これを関連な文字列~値に算出して，そのとおりに継承する。
- 実質的に ( ~keyword, 言語~code ) が成す組を継承する — それは、 この言語を伴うことを除いて `auto$v と同じになることを意味する。
- [ `string$t `string$t ]+
- `引用符~system$は、 指定された［ ( 開き引用符, 閉じ引用符 ) が成す~pair ］たちが成す~listとして定義される。 1 個目の~pairは最外縁~levelの引用文を表現し， 2 個目の~pairは その~~子~levelの埋込みを表現する, 等々。 `content$p ~prop用の値［ `open-quote$v ／ `close-quote$v ］は、 ~listを成す ある~pairの中の［ 1 個目 ／ 2 個目 ］の `string$t を参照rする。 ◎ The quotation mark system is defined as the specified list of pairs of quotation marks (opening and closing). The first pair represents the outermost level of quotation, the second pair the next level of embedding, etc. Within a pair, the open-quote value refers to the first <string>, close-quote refers to the second.
2.4.2. 引用符の挿入-法： 各種 `*-quote^v ~keyword
`quote@t = `open-quote^v | `close-quote^v | `no-open-quote^v | `no-close-quote^v
- `open-quote@v
- `close-quote@v
- これらの値は、［ `quotes$p ~propにより定義される適切な文字列 ］により置換される。 加えて，`引用符-深さ$を［ 増やす／減らす ］（同順）。 【！for no-open-quote ／ no-close-quote 】 ◎ These values are replaced by the appropriate string as defined by the quotes property, and increments (for no-open-quote) or decrements (for no-close-quote) the level of nesting for quotes.
- `no-open-quote@v
- `no-close-quote@v
- 挿入されるものは（ `~noneC$v と同じく）無いが、 `引用符-深さ$を［ 増やす／減らす ］（同順）。 ◎ Inserts nothing (as in none), but increments (for no-open-quote) or decrements (for no-close-quote) the level of nesting for quotes.
引用符は、 文書~内の適切な箇所に`content$p ~propの［ `open-quote$v ／ `close-quote$v ］値を通して挿入できる。 各［ `open-quote^v ／ `close-quote^v ］の出現は、 `引用符-深さ$に基づいて，［ `quotes$p ~propに指定された`引用符~system$に定義されるとおりの引用符~文字列 ］に置換される。 ◎ Quotation marks can be inserted in appropriate places in a document with the open-quote and close-quote values of the content property. Each occurrence of open-quote or close-quote is replaced by a quotation mark string as defined by the quotation mark system specified by the quotes property, based on the depth of nesting.
どの引用符s~pairが利用されるかは、 `引用符-深さ@ — 引用符sの入子ng~level — に依存する。 それは、［ 現在の出現より前に生成された~textにおける `open-quote$v の出現~数 ］から［ 現在の出現までに生成された~textにおける `close-quote$v の出現~数 ］を引いた結果になる。 結果の深さ %深さ に応じて ( %深さ + 1 ) 個目の~pairが利用される。 %深さ が~pairたちの総数を超えた場合、 最後の~pairが繰返される。 ◎ Which pair of quotes is used depends on the nesting level of quotes (the quote depth): the number of occurrences of open-quote in all generated text before the current occurrence, minus the number of occurrences of close-quote in all generated text before and including the current occurence. If the depth is 0, the first pair is used, if the depth is 1, the second pair is used, etc. If the depth is greater than the number of pairs, the last pair is repeated.
注記： `引用符-深さ$は、［ ~source文書／整形~構造 ］の入子ngとは独立である。 それはまた、 `DOM$r の文脈においては — `CSS-LISTS-3$r `§ ~counterの継承-法＠~CSSLIST#inheriting-counters$ と同様に — “平坦~化された要素~tree” 【`参照＠~CSSSCOPING#flat-tree$】に対し演算する。 ◎ Note: Quote depth is independent of the nesting of the source document or the formatting structure. Also, like counter inheritance, it operates on the “flattened element tree” in the context of the [DOM].
［ `close-quote$v ／ `no-close-quote$v ］の`引用符-深さ$が負になる場合、 ~errorであり，（具現化~時点で）無視される — その深さは 0 であり続け，挿入される引用符は無い （それでも、 `content$p ~propの値を成す残りは挿入されるが）。 ◎ A close-quote or no-close-quote that would make the quote depth negative is in error and is ignored (at rendering time): the depth stays at 0 and no quote mark is inserted (although the rest of the content property’s value is still inserted).
一部の~typographic~styleでは、 引用文が何~段落かにわたる場合に，開き引用符は各~段落ごとに繰返す一方で，最後の段落のみ閉じ引用符で終端することが要求される。 ~CSSにおいては、 これは “見えない” 閉じ引用符sを挿入して達成できる。 ~keyword `no-close-quote$v は、 `引用符-深さ$を減らすが，引用符は挿入しない。 ◎ Some typographic styles require open quotation marks to be repeated before every paragraph of a quote spanning several paragraphs, but only the last paragraph ends with a closing quotation mark. In CSS, this can be achieved by inserting "phantom" closing quotes. The keyword no-close-quote decrements the quoting level, but does not insert a quotation mark.
次の~stylesheetは、 `blockquote^e 内の段落ごとに開き引用符を置きつつ，閉じ引用符は終端にのみ挿入する： ◎ The following style sheet puts opening quotation marks on every paragraph in a blockquote, and inserts a single closing quote at the end:
blockquote p::before { content: open-quote }
blockquote p::after { content: no-close-quote }
blockquote p:last-child::after { content: close-quote }
対称性を得るため， `no-open-quote$v ~keywordもあり、 何も挿入しないが，`引用符-深さ$を 1 だけ増やす。 ◎ For symmetry, there is also a no-open-quote keyword, which inserts nothing, but increments the quotation depth by one.
注記： 引用文と周囲の~textの言語が異なる場合、 引用文は，それ自身の言語ではなく周囲の~textの言語の引用符で括ることが慣習とされている。 ◎ Note: If a quotation is in a different language than the surrounding text, it is customary to quote the text with the quote marks of the language of the surrounding text, not the language of the quotation itself.
例えば、 ~Englishの内側に~Frenchがある場合： ◎ For example, French inside English:
The device of the order of the garter is “Honi soit qui mal y pense.”
~Frenchの内側に~Englishがある場合： ◎ English inside French:
Il disait: « Il faut mettre l’action en ‹ fast forward ›. »
次の様な~stylesheetは、［ `open-quote$v ／ `close-quote$v ］がすべての要素~上で正しく働くことになるよう， `quotes$p ~propを設定することになる。 これらの規則は，［ ~English, ~French ］以外は包含しない文書~用であり、 追加的な言語ごとに，それ用の規則が必要になる。 周囲の~textの言語に基づく引用符sを要素に設定するため、 子~結合子（ `>^css ）を利用していることに注意： ◎ A style sheet like the following will set the quotes property so that open-quote and close-quote will work correctly on all elements. These rules are for documents that contain only English, French, or both. One rule is needed for every additional language. Note the use of the child combinator (">") to set quotes on elements based on the language of the surrounding text:
:lang(fr) > * { quotes: "\00AB\2005" "\2005\00BB" "\2039\2005" "\2005\203A" }
:lang(en) > * { quotes: "\201C" "\201D" "\2018" "\2019" }
ここに示した引用符は、 ほぼ誰もが打込める~escaped形で記されている。 直に打込めるなら、 次の様な見かけになる： ◎ The quotation marks are shown here in a form that most people will be able to type. If you can type them directly, they will look like this:
:lang(fr) > * { quotes: "« " " »" "‹ " " ›" }
:lang(en) > * { quotes: "“" "”" "‘" "’" }
例えば，次の~stylesheetを適用した場合： ◎ For example, applying the following style sheet:
/* 2 つの言語における 2 つの~level用に， 2 つの引用符s~pairを指定する。 ◎ Specify pairs of quotes for two levels in two languages */ :lang(en) > q { quotes: '"' '"' "'" "'" } :lang(no) > q { quotes: "«" "»" "’" "’" } /* `q^e 要素の内容の前, 後に引用符sを挿入する ◎ Insert quotes before and after Q element content */ q::before { content: open-quote } q::after { content: close-quote }
次の~HTML片は： ◎ to the following HTML fragment:
<html lang="en"> <head> <title>Quotes</title> </head> <body> <p><q>Quote me!</q></p> </body> </html>
次を生産することを~UAに許容する： ◎ would allow a user agent to produce:
"Quote me!"
一方で、 次の~HTML片は： ◎ while this HTML fragment:
<html lang="no"> <head> <title>Quotes</title> </head> <body> <p><q>Trøndere gråter når <q>Vinsjan på kaia</q> blir deklamert.</q></p> </body> </html>
次を生産することになる： ◎ would produce:
«Trøndere gråter når ’Vinsjan på kaia’ blir deklamert.»
2.5. ~leader
~leader （ `leader^en ） — `tab leader^en ／ `dot leader^en と称されることもある — は、 横方向の空間にまたがって内容を視覚的に接続するために利用される~patternであり、 空間を埋める分に必要なだけ繰返される。 それらは、 目次における~titleと~page番号の合間に最も共通的に利用される。 `leader$f 関数は、 `content^p ~prop用の値としては，~CSS内に~leaderを作成するために利用される。 この関数は、 ~leader用に繰返される~patternを述べる文字列（~leader文字列）をとる。 ◎ A leader, sometimes known as a tab leader or a dot leader, is a repeating pattern used to visually connect content across horizontal spaces. They are most commonly used in tables of contents, between titles and page numbers. The leader() function, as a value for the content property, is used to create leaders in CSS. This function takes a string (the leader string), which describes the repeating pattern for the leader.
2.5.1. `leader^f 関数
- leader( `leader-type$t )
- `~leader＠#leaders$を挿入する。 ◎ Inserts a leader. See the section on leaders for more information.
`leader@f = leader( `leader-type$t ) `leader-type@t = `dotted^v | `solid^v | `space^v | `string$t
3 種の~keywordは、 共通的な文字列~用の略式~値である： ◎ Three keywords are shorthand values for common strings:
- `dotted@v
- `leader(".")^v に等価。 ◎ Equivalent to leader(".")
- `solid@v
- `leader("_")^v に等価。 ◎ Equivalent to leader("_")
- `space@v
- `leader(" ")^v に等価。 ◎ Equivalent to leader(" ")
- `string$t
- これを定義する必要がある。 ◎ Issue: Define this.
次の~CSS, ~HTMLが与えられた下では： ◎ This might result in:
ol.toc a::after {
content: leader('.') target-counter(attr(href), page);
}
<h1>Table of Contents</h1> <ol class="toc"> <li><a href="#chapter1">Loomings</a></li> <li><a href="#chapter2">The Carpet-Bag</a></li> <li><a href="#chapter3">The Spouter-Inn</a></li> </ol>
結果は、 次のようになるであろう： ◎
Table of Contents 1. Loomings.....................1 2. The Carpet-Bag...............9 3. The Spouter-Inn.............13
~leaderは、 より後にある内容は右寄せされる（終端に整列される）とする前提に依存するか？ ◎ Do leaders depend on the assumption that the content after the leader is right-aligned (end-aligned)?
2.5.2. ~leaderの描画
［ ~leaderより前にある内容（ “前~内容”）, ~leader自身, ~leaderより後にある内容（ “後~内容”） ］を包含する行lを考える。 ~leaderは、 次の規則を順守する： ◎ Consider a line which contains the content before the leader (the “before content”), the leader, and the content after the leader (the “after content”). Leaders obey the following rules:
- ~leader文字列は、 少なくとも一回は，全部的に現れるモノトスル。 ◎ The leader string must appear in full at least once.
- ~leaderは、 アリな限り長くされるベキである。 ◎ The leader should be as long as possible
- ~leader内の可視な文字は、 アリなときは，縦方向に互いに整列するベキである。 ◎ Visible characters in leaders should vertically align with each other when possible.
- ~leader文字列~内の改行~文字は、 無視するモノトスル。 ◎ Line break characters in the leader string must be ignored.
- ~leader文字列~内の空白は通常の~CSS規則に従う。 ◎ White space in the leader string follows normal CSS rules.
- ~leaderが現れるのは前~内容と後~内容の合間に限られる。 ◎ A leader only appears between the start content and the end content.
- 前~内容と後~内容が異なる行lにある場合でも、 ~leaderは単独の行lにのみ現れる。 ◎ A leader only appears on a single line, even if the before content and after content are on different lines.
- ~leaderのみで行l全体を占めることはできない。 ◎ A leader can’t be the only thing on a line.
2.5.3. ~leaderの描画~用の手続-
-
%前~内容 を終端する行lに達するまで~lay-outする。 ◎ Lay out the before content, until reaching the line where the before content ends.
前前前前前前前前前前 前前前
-
~leader文字列を現在の行lの終端~辺から始端~辺に達するまでアリな限り多く描く（各~leader文字列は、 1 個~以上の~glyphからなる`行内~box$を成し，~leaderはこれらの~boxが成す並びになる）。 ◎ The leader string consists of one or more glyphs, and is thus an inline box. A leader is a row of these boxes, drawn from the end edge to the start edge, where only those boxes not overlaid by the before or after content. On this line, draw the leader string, starting from the end edge, repeating as many times as possible until reaching the start edge.
前前前前前前前前前前 ・・・・・・・・・・
-
~leaderの上から %前~内容, %後~内容 を描く。 ~leader文字列~boxのうち，（それを成すある~glyphが）［ %前~内容 ／ %後~内容 ］に一部でも重合するものは、 前~段にて描かなかったかのように隠す。 ◎ Draw the before and after content on top of the leader. If any part of the before content or after content overlaps a glyph in a leader string box, that glyph is not displayed.
前前前前前前前前前前 前前前・・・・後後後
-
前~段の結果、 全部的に可視な~leader文字列が無くなる場合： ◎ If one full copy of the leader string is not visible:
前前前前前前前前前前 前前前後後後後後後後
%前~内容 の後に改行を挿入した上で、 前~段をやり直す。 ◎ Insert a line break after the before content, draw the leader on the next line, and draw the after content on top, and hide any leader strings that are not fully displayed.
前前前前前前前前前前 前前前 ・・・後後後後後後後
%後~内容 【と 1 個の~leader文字列との合計】が行l~boxより幅広な場合、 どうする？ ◎ what to do if after content is wider than the line box?
~table~layoutにおいては、 ~leaderは まったく働かない。 どうやればこれを修正できる？ ◎ Leaders don’t quite work in table layouts. How can we fix this?
【以下、ここに示されていた画像は，上の図式で十分なので省略する。】 ◎ Procedure for drawing leaders ◎ Procedure for drawing leaders when the content doesn’t fit on a single line
2.6. 相互-参照
多くの文書は、 内部的な参照を包含する — 例えば ⇒＃ 第 7 章を見よ… ／ 4.1 節にて… ／ 23 ~pageに… ◎ Many documents contain internal references: • See chapter 7 • in section 4.1 • on page 23
この種の相互-参照を自動的に作成するため、 `content^p ~prop用の新たな 3 種の値 — `target-counter$f, `target-counters$f, `target-text$f — が利用される。 それぞれ、 ~link先から得された情報を表示する。 ◎ Three new values for the content property are used to automatically create these types of cross-references: target-counter(), target-counters(), and target-text(). Each of these displays information obtained from the target end of a link.
`target@t = `target-counter()$t | `target-counters()$t | `target-text()$t
詳細は、 以下の各~節を見よ。 ◎ See sections below for details on each of these.
2.6.1. `target-counter^f 関数
`target-counter@f = target-counter( [ `string$t | `url$t ] , `custom-ident$t , `counter-style$t? )
`target-counter$f 関数は、 【~targetにされた要素の`~counter集合$内の】［ 所与の名前を伴う`最内縁$な`~counter$ ］の値を検索取得する。 引数には［ ~targetの~URL, ~counterの名前 ］が要求される。 省略可能な `counter-style^t 引数を利用すれば結果を整形できる。 ◎ The target-counter() function retrieves the value of the innermost counter with a given name. The required arguments are the url of the target and the name of the counter. An optional counter-style argument can be used to format the result.
この関数は、 現在の文書~内の所在を指している素片~URLのみをとる。 ［ 素片が無い／ 参照先の~IDがそこに無い／ ~URLは文書の外側を指している ］場合、 ~UAは~errorとして扱うモノトスル。 ◎ These functions only take a fragment URL which points to a location in the current document. If there’s no fragment, if the ID referenced isn’t there, or if the URL points to an outside document, the user agent must treat that as an error.
~errorの取扱いはどうあるベキか？ ◎ what should error handling be?
今の所、 構文上は局所的な参照に制約される。 ◎ restrict syntactically to local references for now.
~HTML： ◎ HTML:
…それについては、 <a href="#chapter4_sec2"></a> ~pageにて論じる。
~CSS: ◎ CSS:
a::after { content: target-counter(attr(href url), page) }
結果： ◎ Result:
…それについては、 137 ~pageにて論じる。
目次~内の~page番号は、 自動的に生成できる： ◎ Page numbers in tables of contents can be generated automatically:
~HTML： ◎ HTML:
<nav> <ol> <li class="frontmatter"><a href="#pref_01">Preface</a></li> <li class="frontmatter"><a href="#intr_01">Introduction</a></li> <li class="bodymatter"><a href="#chap_01">Chapter One</a></li> </ol> </nav>
~CSS： ◎ CSS:
.frontmatter a::after { content: leader('.') target-counter(attr(href url), page, lower-roman) }
.bodymatter a::after { content: leader('.') target-counter(attr(href url), page, decimal) }
結果： ◎ Result:
Preface.............vii Introduction.........xi Chapter One...........1
2.6.2. `target-counters^f 関数
この関数は、［ ~link先の【要素の`~counter集合$内の】~counterのうち，所与の名前を伴うもの ］すべての値を得た上で，それらの（入子な~counterの）値の合間に【 3 個目の引数に】所与の文字列を挿入することにより，整形する。 ◎ This functions fetches the value of all counters of a given name from the end of a link, and formats them by inserting a given string between the value of each nested counter.
`target-counters@f = target-counters( [ `string$t | `url$t ] , `custom-ident$t , `string$t , `counter-style$t? )
例を追加する。 ◎ I have not found a compelling example for target-counters() yet. ◎ found a compelling example, in CSS specs. Do something.
2.6.3. `target-text^f 関数
`target-text$f 関数は、 引数に与えた~URLが参照rしている要素の~text値を検索取得する。 省略可能な 2 個目の引数は、 上の `string-set$p ~propと同じ値を利用して，どの内容が検索取得されるかを指定する。 ◎ The target-text() function retrieves the text value of the element referred to by the URL. An optional second argument specifies what content is retrieved, using the same values as the string-set property above.
`target-text@f = target-text( [ `string$t | `url$t ] , [ `content^v | `before^v | `after^v | `first-letter^v ]? )
`fantasai^en 氏から， `もっと単純な構文が提案されている＠https://lists.w3.org/Archives/Public/www-style/2012Feb/0745.html$。 ◎ A simpler syntax has been proposed by fantasai: http://lists.w3.org/Archives/Public/www-style/2012Feb/0745.html
…それについては、 <a href="#chapter_h1_1">後述する</a>。
a::after { content: "（ " target-text(attr(href url)) " 章にて）" }
結果 ⇒ …それについては、 後述する（ Loomings 章にて）。 ◎ Result: …which will be discussed later, in the chapter entitled Loomings.
2.7. 有名~文字列
この節は、 `有名~文字列@ を導入する。 それは、 ~counterとは別個な名前空間に属する，~counterの~textな等価である。 有名~文字列は、 ~counterと同じ入子ng規則に従う†。 `string-set$p ~propは、 `content$p ~propに類似な値を受容する†† — ~counterの現在の値を抽出する値も含め。 ◎ This section introduces named strings, which are the textual equivalent of counters and which have a distinct namespace from counters. Named strings follow the same nesting rules as counters. The string-set property accepts values similar to the content property, including the extraction of the current value of counters.
【† どう入子にされるかは述べられていない。 その他、 この節には多数の不備が見られる。 】【†† その値を通して，要素に`有名~文字列$をアテガう — `string-set^p の “`set^en” は、 `counter-set$p と同様に “~~集合”ではなく “~~設定” を意味する。 】
`有名~文字列$は、 文書の他所から取り出した~metadataを，~headerや~footerの中へ挿入する簡便な仕方を与える。 例えば~HTMLにおいては、 文書 `head^e に包含される `meta^e 要素にて，有名~文字列の値を設定できる。 これを属性~選択子と併用すれば、 強力な仕組みになる： ◎ Named strings are a convenient way to pull metadata out of the document for insertion into headers and footers. In HTML, for example, META elements contained in the document HEAD can set the value of named strings. In conjunction with attribute selectors, this can be a powerful mechanism:
meta[author] { string-set: author attr(author); }
head > title { string-set: title contents; }
`page$at `left$ps {【！原文 @page の後のスペース抜け】
`top-center$at {【！@top】
text-align: left;
vertical-align: middle;
content: string(title);
}
}
`page$at `right$ps {
`top-center$at {
text-align: right;
vertical-align: middle;
content: string(author);
}
}
2.7.1. 文字列の命名-法： `string-set^p ~prop
◎名 `string-set@p ◎値 `~noneS$v | [ `custom-ident$t `string$t+ ]# ◎初 `none^v ◎適 すべての要素 — ただし疑似要素は除く。 ◎ all elements, but not pseudo-elements ◎継 されない ◎百 受容しない ◎算 ~keyword `none^v ／ ~list — ~listを成す各~itemは、［ 識別子, 文字列~値たちが成す~list ］が成す~pair ◎ the keyword none or a list, each item an identifier paired with a list of string values ◎順 文法に従う ◎ア 離散的 ◎表終~UAには、 視覚的でないものも含め，どの媒体でもこの~propを~supportすることが期待される。 ◎ User agents are expected to support this property on all media, including non-visual ones.
`string-set$p ~propは、 要素の~text内容を`有名~文字列$の中へ複製する変数として機能する。 この有名~文字列の~text内容は、 `string$f 関数を利用して検索取得できる。 これらの変数は，所与の~page上で変化し得る — そのため， `string$f 関数~用の省略可能な 2 個目の値は、 ~page上のどの値を利用するか選ぶことを，作者に許容する。 ◎ The string-set property copies the text content of an element into a named string, which functions as a variable. The text content of this named string can be retrieved using the string() function. Since these variables may change on a given page, an optional second value for the string() function allows authors to choose which value on a page is used.
- `~noneS@v
- 要素は、 どの`有名~文字列$も設定しない。 ◎ The element does not set any named strings.
- [ `custom-ident$t `string$t+ ]#
- 要素は、 ~list内の~commaで分離された各~itemごとに`有名~文字列$を確立する。 ◎ The element establishes one or more named strings, corresponding to each comma-separated entry in the list.
- 各~itemを成す `custom-ident$t は、 `有名~文字列$の名前を与える。 それに後続する 1 個~以上の `string$t 値は、 一緒に連結されて，有名~文字列の値を形成する。 【しかしながら、各種例は `string^t 以外の様々な構文も受容している（ `1829$issue ）】 ◎ For each entry, the <custom-ident> gives the name of the named string. It’s followed by one or more <string> values, which are concatenated together to form the value of the named string.
`string-set$p ~propは、 `~style封込め$がある要素のどの子孫にも，効果を発揮しないモノトスル。 ◎ If an element has style containment, the string-set property must have no effects on descendants of that element.
次の例は `h1^e 要素の内容を捕捉する — それは、 ある文書の章（ `chapter^v ）の名前を表現する。 ◎ The following example captures the contents of H1 elements, which represent chapter names in this hypothetical document.
h1【！H1】 { string-set: chapter `contents$v; }
`h1^e 要素に遭遇したときは、 `chapter^v 文字列は 要素の~textな内容に設定され， `chapter^v 用の以前の値は~~上書きされる。 ◎ When an H1 element is encountered, the chapter string is set to the element’s textual contents, and the previous value of chapter, if any, is overwritten.
2.7.2. 有名~文字列の挿入-法： `string^f 関数
`string@f = string( `custom-ident$t , [ `first^v | `start^v | `last^v | `first-except^v ]? )
`content$p ~propに対する `string$f 関数は、 `有名~文字列$の値を文書へ複製するために利用される。 この関数の引数には、 `有名~文字列$の名前が要求される。 有名~文字列の値は、 ~page上で何度も変化し得るので（文字列を【 `string-set$p により】定義している要素は複数個~現れ得る）、 省略可能な 2 個目の引数が，有名~文字列のどの値を利用するベキかを指示する。 ◎ The string() function is used to copy the value of a named string to the document, via the content property. This function requires one argument, the name of the named string. Since the value of a named string may change several times on a page (as multiple elements defining the string can appear) an optional second argument indicates which value of the named string should be used.
`string$f 関数の 2 個目の引数がとり得る各~keywordの意味は： ◎ The second argument of the string() function is one of the following keywords:
- `first@v
- ~page上で最初にアテガわれた値が利用される。 ~page上にアテガわれた値が無い場合、 `入口~値$が利用される。 2 個目の引数は供されていない場合、 これが既定の値になる。 ◎ The value of the first assignment on the page is used. If there is no assignment on the page, the entry value is used. If no second argument is provided, this is the default value.
- `start@v
- 要素は~page上の最初の要素である場合、 最初にアテガわれた値が利用される。 他の場合は`入口~値$が利用される。 `入口~値$は、 `有名~文字列$がまだ現れていない 【すなわち、どの要素も `string-set$p により名前の文字列を指定していない】 場合には空になる。 ◎ If the element is the first element on the page, the value of the first assignment is used. Otherwise the entry value is used. The entry value may be empty if the named string hasn’t yet appeared.
- `last@v
- `有名~文字列$の`出口~値$が利用される。 ◎ The exit value of the named string is used.
- `first-except@v
- これは、 `first$v に一致する — 値がアテガわれた所では空~文字列が~page上に利用されることを除いて。 ◎ This is identical to first, except that the empty string is used on the page where the value is assigned.
- 内容~文字列~全体を~killする必要もあり得る。 これは必要yなのか？ ◎ we may need to kill the entire content string. Is this necessary?
`有名~文字列$の内容~値は、 要素の内容~boxが最初に作成された時点（要素の `display^p 値が `none^v の場合は作成される時点）にアテガわれる。 現在の~page用の `入口~値@ は，前~pageの`出口~値$であり【前~pageが無いならば空~文字列】、 `出口~値@ は，当の~pageの終端にて効果を発揮する`有名~文字列$である。 ◎ The content values of named strings are assigned at the point when the content box of the element is first created (or would have been created if the element’s display value is none). The entry value for a page is the assignment in effect at the end of the previous page. The exit value for a page is the assignment in effect at the end of the current page.
~CSS： ◎ CSS:
`page$at {
size: 15cm 10cm;
margin: 1.5cm;
`top-left$at {
content: "first: " string(heading, first);
}
`top-center$at {
content: "start: " string(heading, start);
}
`top-right$at {
content: "last: " string(heading, last);
}
}
h2 { string-set: heading content() }
次の各図に、 様々な~page上での `heading^v （見出し）［ `first^v ／ `start^v ／ `last^v ］値にアテガわれる文字列を示す。 ◎ The following figures show the first, start, and last assignments of the “heading” string on various pages.
2.7.3. `content^f 関数
`content@f = content( [ `text^v | `before^v | `after^v | `first-letter^v | `marker^v ]? )
- 引数なし
- `text@v
- 要素の文字列~値。 `content$f 内に値が指定されていない場合、 `text$v が指定されていたかのように動作する。 ◎ The string value of the element. If no value is specified in content(), it acts as if text were specified.
- `before@v
- `before$pe 疑似要素の文字列~値。 ◎ The string value of the ::before pseudo-element.
- `after@v
- `after$pe 疑似要素の文字列~値。 ◎ The string value of the ::after pseudo-element.
- `first-letter@v
- `first-letter$pe 疑似要素~用に定義されるものと同じ，要素の最初の字l。 ◎ The first letter of the element, as defined for the ::first-letter pseudo-element
- `marker@v
- `marker$pe 疑似要素の文字列~値。 ◎ The string value of the ::marker pseudo-element.
~HTML： ◎ HTML:
<h1>Loomings</h1>
~CSS: ◎ CSS:
h1::before { content: 'Chapter ' counter(chapter); }
h1 { string-set: header content(before) ':' content(text); }
h1::after { content: '.'; }
`有名~文字列$ `header^v の値は、 `Chapter 1: loomings^l になる。 ◎ The value of the named string “header” will be “Chapter 1: Loomings”.
~HTML： ◎ HTML:
<section title="Loomings">
~CSS: ◎ CSS:
section { string-set: header attr(title) }
`header^v 文字列の値は `Loomings^l になる。 ◎ The value of the “header” string will be “Loomings”.
2.8. 自動的な~counterと付番
`CSS-LIST-3$r `§ ~counterによる自動的な付番＠~CSSLIST#auto-numbering$ を見よ。 ◎ See CSS Lists 3 § 4 Automatic Numbering With Counters.
これは、 この仕様に戻すべきか？ ◎ Now described in [CSS3LIST] ◎ Should this move back to CSS Content?
3. ~bookmark
一部の文書~形式 — とりわけ~PDF — は、 ~navi用の援助として `~bookmark@ の利用-を許容する。 文書~内の要素に指定された~bookmarkは、［ ~link, その~labelを成す~text, ~level値 ］の組を要素に供する。 各~bookmarkは、 3 個の~prop［ `bookmark-level$p, `bookmark-label$p, `bookmark-state$p ］からなる。 ◎ Some document formats, most notably PDF, allow the use of bookmarks as an aid to navigation. Bookmarks provide a list of links to document elements, as well as text to label the links and a level value. A bookmark has three properties: bookmark-level, bookmark-label, and bookmark-state.
利用者が~bookmarkを作動化したとき、 ~UAは，その参照-先を利用者の注目を引く地点へ持ってくるモノトスル — ちょうど、 素片~URLにより参照-先の要素へ~navigateしたかのように。 その結果、 `target$ps 疑似類にも合致することになる【要素に id が付与されていなくとも】。 ◎ When a user activates a bookmark, the user agent must bring that reference point to the user’s attention, exactly as if navigating to that element by fragment URL. This will also trigger matching the :target pseudo-class.
【 ~~暗黙の前提として、 指定された~bookmarkたちは，~UAの何らかの~UI（例：~menuや~side-bar）を通して呈示することが意図されていると見受けられるが、 どこにどう呈示するかは~UAに委ねられるようだ（言及されていない）。 】
［ `bookmark-level$p ／ `bookmark-label$p ／ `bookmark-state$p ］~propは、 `~style封込め$がある要素のどの子孫にも，効果を発揮しないモノトスル。 ◎ If an element has style containment, the bookmark-level, bookmark-label, and bookmark-state properties must have no effect on descendants of the element.
3.1. ~bookmarkの設定-法： `bookmark-level^p ~prop
`bookmark-level$p ~propは、 ~bookmarkを作成するかどうか，そうならばどの~levelにするかを決定する。 この~propが無い, または値 `~noneB$v にされている場合、［ `bookmark-label$p ／ `bookmark-state$p ］の値に関わらず，~bookmarkは生成されるベキでない。 ◎ The bookmark-level property determines if a bookmark is created, and at what level. If this property is absent, or has value none, no bookmark should be generated, regardless of the values of bookmark-label or bookmark-state.
◎名 `bookmark-level@p ◎値 `~noneB$v | `integer [1,∞]$t ◎初 `none^v ◎適 すべての要素 ◎継 されない ◎百 受容しない ◎算 ~keyword `none^v ／ 指定された整数 ◎ the keyword none or the specified integer ◎順 文法に従う ◎ア 算出d値の型による ◎表終- `integer [1,∞]$t
- ~bookmarkの~levelを定義する — ~top-levelは 1 とする（ 0 以下の値は妥当でない）。 ◎ defines the level of the bookmark, with the top level being 1 (negative and zero values are invalid).
- `~noneB$v
- ~bookmarkは生成されない。 ◎ no bookmark is generated.
section h1 { bookmark-level: 1; }
section section h1 { bookmark-level: 2; }
section section section h1 { bookmark-level: 3; }
注記： ~bookmarkは、 各~levelの厳密な階層を作成する必要は無い。 【！~levelが飛び飛びになっていても／~tree構造に合致していなくともよい。】 ◎ Note: Bookmarks do not need to create a strict hierarchy of levels.
`display^p が `none^v にされた要素~用にも~bookmarkは作成されるベキか？ ◎ Should a bookmark be created for elements with display: none?
3.2. ~bookmarkの~label法： `bookmark-label^p ~prop
◎名 `bookmark-label@p ◎値 `content-list$t ◎初content(`text$v)
◎適 すべての要素
◎継 されない
◎百 受容しない
◎算 指定された値
◎順 文法に従う
◎ア 離散的
◎表終
- `content-list$t
- ~bookmark~labelを成す~text内容を与える。 `content-list$t は、 上の `string-set$p ~propの節に定義される。 ◎ <content-list> is defined above, in the section on the string-set property. The value of <content-list> becomes the text content of the bookmark label.
~HTML： ◎ HTML:
<h1>Loomings</h1>
~CSS: ◎ CSS:
h1 {
bookmark-label: content(text);
bookmark-level: 1;
}
~bookmark~labelは `Loomings^l になる。 ◎ The bookmark label will be “Loomings”.
3.3. 初期~bookmark~toggle状態：`bookmark-state^p ~prop
`bookmark-state$p （ “~bookmark状態” ）は、 `open^v, `closed^v いずれかの状態をとる。 ~UAは、 利用者がこれらの状態を~toggle可能にするモノトスル。 ◎ The bookmark-state may be open or closed. The user must be able to toggle the bookmark state.
◎名 `bookmark-state@p ◎値 `open^v | `closed^v ◎初 `open^v ◎適 塊~levelの要素 ◎継 されない ◎百 受容しない ◎算 指定された~keyword ◎順 文法に従う ◎ア 離散的 ◎表終- `open@v
- 後続な~bookmarkのうち［ その `bookmark-level$p が所与の~bookmarkの~levelを超える，かつ 同じ~level以下の別の~bookmarkに達するまでのもの ］のうち， `closed$v により表示されないもの以外は【！If one of subsequent bookmark…】、 表示される。 ◎ Subsequent bookmarks with bookmark-level greater than the given bookmark are displayed, until reaching another bookmark of the same level or lower. If one of subsequent bookmark is closed, apply the same test to determine if its subsequent bookmarks should be displayed.
- `closed@v
- 後続な~bookmarkのうち，［ その `bookmark-level$p が所与の~bookmarkの~levelを超える，かつ 同じ~level以下の別の~bookmarkに達するまでのもの ］は、 表示されない。 ◎ Subsequent bookmarks of bookmark-level greater than the given bookmark are not displayed, until reaching another bookmark of the same level or lower.
初期~bookmark状態や~bookmark状態は、 ~UAにより適切に更新されるか？ ◎ Is the initial bookmark state, or the bookmark state updated by the UA as appropriate?
変更点
- `2016 年 6月 2日 作業草案＠~TR/2019/WD-css-content-3-20190802/$ からの有意な変更点 ◎ Significant changes since the 2 August 2019 Working Draft consist primarily of:
- `auto$v は、 要素~自身ではなく`親^emの`内容~言語$を参照するよう更新した。 （ `5478$issue ） ◎ Updated auto to reference the parent content language rather than the content language of the element itself. (Issue 5478)
- `quotes$p 用の値として `match-parent$v を追加した。 （ `5478$issue ） ◎ Added match-parent value to quotes. (Issue 5478)
- `CSS2$r と一貫するよう、 過剰な閉じ引用符sを無視することにより，負な`引用符-深さ$を防止した。 （ `2034$issue ） ◎ Prevent negative quote depth by ignoring excess closing quotes, consistent with [CSS2]. (Issue 2034)
- ［ `placeholder$pe ／ `file-selector-button$pe ］用に `content$p の算出d値を定義した。 （ `6124$issue ） ◎ Defined computed value of content: normal for ::placeholder and ::file-selector-button. (Issue 6124)
- 閉じ引用符sの`引用符-深さ$が 1 だけずれていた誤りを修正した （ `2506$issue ） ◎ Fixed an off-by-one error for the quote depth of closing quotes. (Issue 2506)
- `attr^f の定義を~inline化した — それは、 `CSS-VALUES-4$r から落とされたので。 ◎ Inlined the definition of attr(), since it has been dropped from [CSS-VALUES-4].
- 編集上の諸々の仕様~整理。 ◎ Miscellaneous editorial spec clean up.
`以前の変更点＠~TR/2019/WD-css-content-3-20190802/#changes$ も見よ。 ◎ See also previous changes.
謝辞
Stuart Ballard, David Baron, Bert Bos, Tantek Çelik, and James Craig provided invaluable suggestions used in this specification.
~privacyの考慮点
この仕様に対し報告された，新たな~privacyの考慮点は、 無い。 ◎ No new privacy considerations have been reported on this specification.
~securityの考慮点
この仕様に対し報告された，新たな~privacyの考慮点は、 無い。 ◎ No new security considerations have been reported on this specification.