HTML — フォーム用の要素

【この訳に特有な表記規約】

4.10.1. 序論

【 この節の内容は、 `別~page＠HTML-forms-intro-ja.html#introduction-4$にて。 】

4.10.2. 分類

この節における各種~要素は、 `~flow内容$, `句ng内容$, `対話的~内容$などの通例の分類に加えて，いくつかの重なり合う（が、微妙に異なる）分類に仕分けられる — その重なりは、 ほぼ歴史的な理由によるものであるが。 ◎ Mostly for historical reasons, elements in this section fall into several overlapping (but subtly different) categories in addition to the usual ones like flow content, phrasing content, and interactive content.

次に挙げる要素は、 `~formに所有され得る要素@ とされ，ある~formに`所有され$得ることを意味する ⇒＃ `button$e, `fieldset$e, `input$e, `object$e, `output$e, `select$e, `textarea$e, `img$e, `~formに所有され得る~custom要素$ ◎ A number of the elements are form-associated elements, which means they can have a form owner. • buttonfieldsetinputobjectoutputselecttextareaimgform-associated custom elements

`~formに所有され得る要素$は、 更にいくつかに分類される： ◎ The form-associated elements fall into several subcategories:

`~listされる@ 要素 ◎ Listed elements

次に挙げる要素は、［ `form.elements$m ／ `fieldset.elements$m ］~API内に~listされる。 これらの要素には、 作者が`~form所有者$を明示的に指定できるようにする，［ `form$a 内容~属性と対応する `form$m ~IDL属性 ］がある ⇒＃ `button$e, `fieldset$e, `input$e, `object$e, `output$e, `select$e, `textarea$e, `~formに所有され得る~custom要素$ ◎ Denotes elements that are listed in the form.elements and fieldset.elements APIs. These elements also have a form content attribute, and a matching form IDL attribute, that allow authors to specify an explicit form owner. • buttonfieldsetinputobjectoutputselecttextareaform-associated custom elements

`提出-可能@ な要素 ◎ Submittable elements

次に挙げる要素は、 `form$e 要素を`提出する＠~HTMLforms#concept-form-submit$ために`~entry~listを構築する$ときに利用され得る ⇒＃ `button$e, `input$e, `select$e, `textarea$e, `~formに所有され得る~custom要素$ ◎ Denotes elements that can be used for constructing the entry list when a form element is submitted. • buttoninputselecttextareaform-associated custom elements

`提出-可能$な要素には、 その属性に依存して `~button@ になるものもある。 要素がいつ~buttonになるかは、 関連な節の注釈文にて定義される。 ~buttonには、 特定的に `提出-~button@ になるものもある。 ◎ Some submittable elements can be, depending on their attributes, buttons. The prose below defines when an element is a button. Some buttons are specifically submit buttons.

`再設定-可能@ な要素 ◎ Resettable elements

次に挙げる要素は、 `form$e 要素が`再設定される$ときに影響され得る ⇒＃ `input$e, `output$e, `select$e, `textarea$e, `~formに所有され得る~custom要素$ ◎ Denotes elements that can be affected when a form element is reset. • inputoutputselecttextareaform-associated custom elements

`自動頭字化-と自動訂正-を継承-@ する要素 ◎ Autocapitalize-and-autocorrect-inheriting elements

次に挙げる要素は、 `~form所有者$から［ `autocapitalize$a, `autocorrect$a ］属性を継承する ⇒＃ `button$e, `fieldset$e, `input$e, `output$e, `select$e, `textarea$e ◎ Denotes elements that inherit the autocapitalize and autocorrect attributes from their form owner. • buttonfieldsetinputoutputselecttextarea

`~formに所有され得る要素$に限らず，一部の要素は、 `~label可能@ な要素に分類される。 これらは、 `label$e 要素に結び付け得る要素である ⇒＃ `button$e, `input$e （ `type$a 属性が `Hidden$st 状態`でないもの^emに限る） `meter$e, `output$e, `progress$e, `select$e, `textarea$e, `~formに所有され得る~custom要素$ ◎ Some elements, not all of them form-associated, are categorized as labelable elements. These are elements that can be associated with a label element. • buttoninput (if the type attribute is not in the Hidden state)meteroutputprogressselecttextareaform-associated custom elements

4.10.3. ``form^e 要素

`分類$

`~flow内容$ ／ `可触~内容$ ◎ Flow content. ◎ Palpable content.

`この要素を利用できる文脈$

`~flow内容$が期待される所。 ◎ Where flow content is expected.

`内容~model$

`~flow内容$ — ただし，子孫に `form$e 要素は無いとする。 ◎ Flow content, but with no form element descendants.

`text/html における~tag省略$

両~tagとも省略不可。 ◎ Neither tag is omissible.

`内容~属性$

`大域~属性$。 ◎ Global attributes

``accept-charset$a — `~form提出$用に利用する文字~符号化法。 ◎ accept-charset — Character encodings to use for form submission

`action$a — `~form提出$用に利用する`~URL$ ◎ action — URL to use for form submission

``autocomplete$a — この~form内の各~controlにおける既定の~autofill特能を設定する。 ◎ autocomplete — Default setting for autofill feature for controls in the form

`enctype$a — `~form提出$用に利用する`~entry~list$用の符号化法の種別。 ◎ enctype — Entry list encoding type to use for form submission

`method$a — `~form提出$用に利用する~method（等）。 ◎ method — Variant to use for form submission

``name$a — `document.forms$m ~APIにおいて利用する~formの名前。 ◎ name — Name of form to use in the document.forms API

`novalidate$a — `~form提出$に際し，~form~control検証を迂回する。 ◎ novalidate — Bypass form control validation for form submission

`target$a — `~form提出$用の 【それにより~navigateされる】 `~navigable$。 ◎ target — Navigable for form submission

``rel$a — 【何も述べられていない】

`~accessibilityの考慮点$

`form$AA ◎ For authors. For implementers.

`~DOM~interface$

[Exposed=Window,
 `LegacyOverrideBuiltIns$,
 `LegacyUnenumerableNamedProperties$]
interface `HTMLFormElement@I : `HTMLElement$I {
  [`HTMLConstructor$] constructor();

  [`CEReactions$] attribute DOMString ``acceptCharset$m;
  [`CEReactions$] attribute USVString `action$m;
  [`CEReactions$] attribute DOMString ``autocomplete$m;
  [`CEReactions$] attribute DOMString `enctype$m;
  [`CEReactions$] attribute DOMString `encoding$m;
  [`CEReactions$] attribute DOMString `method$m;
  [`CEReactions$] attribute DOMString ``name$m;
  [`CEReactions$] attribute boolean `noValidate$m;
  [`CEReactions$] attribute DOMString `target$m;
  [`CEReactions$] attribute DOMString ``rel$m;
  [SameObject, PutForwards=`value$m] readonly attribute DOMTokenList ``relList$m;

  [SameObject] readonly attribute `HTMLFormControlsCollection$I ``elements$m;
  readonly attribute unsigned long ``length$m;
  ``getter$m `Element$I (unsigned long %index);
  ``~getterN$m (`RadioNodeList$I or `Element$I) (DOMString %name);

  undefined ``submit$m();
  undefined ``requestSubmit$m(optional `HTMLElement$I? %submitter = null);
  [`CEReactions$] undefined ``reset$m();
  boolean ``checkValidity$m();
  boolean ``reportValidity$m();
};

`form$e 要素は、［ `~formに所有され得る要素$たちからなる~collection ］を通して操作できる`~hyperlink$を`表現-$する — その中に、 編集-可能な値を表現し，処理~用に~serverへ提出され得るものも含ませ得るような。 ◎ The form element represents a hyperlink that can be manipulated through a collection of form-associated elements, some of which can represent editable values that can be submitted to a server for processing.

``accept-charset@a 属性は、 提出に利用されることになる文字~符号化法を与える。 この属性に指定する値は、 `~ASCII大小無視$で `UTF-8^l に合致しなければナラナイ。 `ENCODING$r ◎ The accept-charset attribute gives the character encodings that are to be used for the submission. If specified, the value must be an ASCII case-insensitive match for "UTF-8". [ENCODING]

``name@a 属性は、 `forms$m ~collectionの中における当の `form$e 要素の名前を表現する。 この属性に指定する値は、［ `forms$m ~collection内の `form$e 要素たちの間で一意, かつ空でない文字列 ］でなければナラナイ。 ◎ The name attribute represents the form's name within the forms collection. The value must not be the empty string, and the value must be unique amongst the form elements in the forms collection that it is in, if any.

``autocomplete@a 属性は，`列挙d属性$であり、 次に挙げる~keyword, とり得る状態, それらの対応付けが定義される： ◎ The autocomplete attribute is an enumerated attribute with the following keywords and states:

この属性の［ `欠落~値~用の既定の状態$／`妥当でない値~用の既定の状態$ ］は、 `on$st とする。 ◎ The attribute's missing value default and invalid value default are both the on state.

`~form提出用の属性$として、［ `action$a, `enctype$a, `method$a, `novalidate$a, `target$a ］属性もある。 ◎ The action, enctype, method, novalidate, and target attributes are attributes for form submission.

`form$e 要素の ``rel@a 属性は、 要素が作成する~linkの種類を制御する。 属性の値は、 `~space等で分離された~token集合$（一意）でなければナラナイ。 許容される~keyword, それらの意味は、 `§ ~HTML~link型$に定義される。 ◎ The rel attribute on form elements controls what kinds of links the elements create. The attribute's value must be a unordered set of unique space-separated tokens. The allowed keywords and their meanings are defined in an earlier section.

``rel$a が`~supportする~token集合$tLは、 `§ ~HTML~link型$に定義される~keywordのうち［ `form$e 要素~上に許容される，かつ 処理~modelに影響iする，かつ ~UAが~supportする ］ものである。 この~token集合にアリな~keywordは，［ `noreferrer$v, `noopener$v, `opener$v ］であり、 ``rel$a が`~supportする~token集合$tLは，［ これらの~tokenのうち，~UAが それ用の処理~modelを実装するもの ］のみを含むモノトスル。 ◎ rel's supported tokens are the keywords defined in HTML link types which are allowed on form elements, impact the processing model, and are supported by the user agent. The possible supported tokens are noreferrer, noopener, and opener. rel's supported tokens must only include the tokens from this list that the user agent implements the processing model for.

%form.``elements$m

この~form内の~form~controlたちからなる `HTMLFormControlsCollection$I を返す。 （ただし、 歴史的な理由から，画像~buttonは除外される）。 ◎ Returns an HTMLFormControlsCollection of the form controls in the form (excluding image buttons for historical reasons).

%form.``length$m

この~form内の~form~controlの個数を返す（ただし、 歴史的な理由から，画像~buttonは除外される）。 ◎ Returns the number of form controls in the form (excluding image buttons for historical reasons).

%form[%index]

この~form内の %~index 番の要素を返す（ただし、 歴史的な理由から，画像~buttonは除外される）。 ◎ Returns the indexth element in the form (excluding image buttons for historical reasons).

%form[%name]

この~form内の所与の `~ID$ または `name$a を伴う ~form~controlを返す — ただし：

• 複数ある場合、 それらの~form~controlからなる `RadioNodeList$I を返す。
• 歴史的な理由から、 画像~buttonは除外される。
• 該当するものが無い場合、 所与の~IDを有する `img$e 要素を返す。

◎ Returns the form control (or, if there are several, a RadioNodeList of the form controls) in the form with the given ID or name (excluding image buttons for historical reasons); or, if there are none, returns the img element with the given ID.

要素が 特定0の名前を利用して 一度でも参照されたなら、 その名前は，この~methodにて その要素を参照する仕方として 可用であり続けることになる — 要素の実際［ `~ID$ ／ `name$a ］が変化しても，要素が同じ`~tree$内にあり続ける限り。 ◎ Once an element has been referenced using a particular name, that name will continue being available as a way to reference that element in this method, even if the element's actual ID or name changes, for as long as the element remains in the tree.

合致する~itemが複数のある場合、 それらの要素すべてを包含する `RadioNodeList$I ~objが返される。 ◎ If there are multiple matching items, then a RadioNodeList object containing all those elements is returned.

%form.``submit()$m

この~formを提出する — が、 次はしない ⇒ `拘束を対話的に検証する$／ `submit$et ~eventを発火する ◎ Submits the form, bypassing interactive constraint validation and without firing a submit event.

%form.``requestSubmit( [ submitter ] )$m

この~formを提出するよう要請する。 ``submit()$m と違って、 この~methodは［ `拘束を対話的に検証する$ ／ `submit$et ~eventを発火する ］ことも含む — どちらも提出を取消せる。 ◎ Requests to submit the form. Unlike submit(), this method includes interactive constraint validation and firing a submit event, either of which can cancel submission.

%submitter 引数を利用して特定の`提出-~button$を指せる — その［ `formaction$a ／ `formenctype$a ／ `formmethod$a ／ `formnovalidate$a ／ `formtarget$a ］属性は、 提出に影響iし得る。 加えて、 %submitter は，提出~用に`~entry~listを構築する$ときに含まれることになるが、 通常は，~buttonは除外される。 ◎ The submitter argument can be used to point to a specific submit button, whose formaction, formenctype, formmethod, formnovalidate, and formtarget attributes can impact submission. Additionally, the submitter will be included when constructing the entry list for submission; normally, buttons are excluded.

%form.``reset()$m

この~formを再設定する。 ◎ Resets the form.

%form.``checkValidity()$m

この~formに属する~controlがすべて妥当~ならば ~T を返す。 他の場合は ~F を返す。 ◎ Returns true if the form's controls are all valid; otherwise, returns false.

%form.``reportValidity()$m

この~formに属する~controlがすべて妥当~ならば ~T を返す。 他の場合は ~F を返すことに加え，そのことを利用者に伝える。 ◎ Returns true if the form's controls are all valid; otherwise, returns false and informs the user.

``autocomplete@m ~IDL属性は、 `既知な値のみに制限され$る下で， ``autocomplete$a 内容~属性を`反映する$モノトスル。 ◎ The autocomplete IDL attribute must reflect the content attribute of the same name, limited to only known values.

``acceptCharset@m ~IDL属性は、 ``accept-charset$a 内容~属性を`反映する$モノトスル。 ◎ The acceptCharset IDL attribute must reflect the accept-charset content attribute.

``relList@m ~IDL属性は、 ``rel$a 内容~属性を`反映する$モノトスル。 ◎ The relList IDL attribute must reflect the rel content attribute.

``getter@m における`有index~prop取得子$の挙動は、 コレの ``elements$m ~collection %C に基づく： ◎ ↓

• コレが`~supportする~prop~index$は、 常に， %C のそれと同じとする。 ◎ The supported property indices at any instant are the indices supported by the object returned by the elements attribute at that instant.
• コレ用の`有index~propの値を決定する手続き$は、 所与の ( %index ) に対し［ %C の `item$m ~methodが引数 %index に対し返す値 ］を返すモノトスル。 ◎ To determine the value of an indexed property for a form element, the user agent must return the value returned by the item method on the elements collection, when invoked with the given index as its argument.

``~getterN@m における`有名~prop取得子$の挙動は、 以下に与える `form$e 要素~用の［ ~supportする~prop名／ 有名~propの値を決定する手続き ］に従う。 ◎ ↓

各 `form$e 要素は、 名前をある要素に対応付ける `過去~名~map@ を有する。 それは、 各~controlの名前を，その名前が変更されても持続するために利用される。 ◎ Each form element has a mapping of names to elements called the past names map. It is used to persist names of controls even when they change names.

`form$e 要素の`過去~名~map$ %~map を成すどの %~entry に対しても ⇒ %~entry の要素の`~form所有者$が変化したときは、 %~map から %~entry を除去するモノトスル。 ◎ If an element listed in a form element's past names map changes form owner, then its entries must be removed from that map.

4.10.4. ``label^e 要素

`分類$

`~flow内容$ ／`句ng内容$ ／ `対話的~内容$ ／ `可触~内容$ ◎ Flow content. ◎ Phrasing content. ◎ Interactive content. ◎ Palpable content.

`この要素を利用できる文脈$

`句ng内容$が期待される所。 ◎ Where phrasing content is expected.

`内容~model$

`句ng内容$ — ただし，子孫に次に挙げるものは無いとする ⇒＃ この要素の`~label先~control$以外の`~label可能$な要素／ `label$e 要素 ◎ Phrasing content, but with no descendant labelable elements unless it is the element's labeled control, and no descendant label elements.

`text/html における~tag省略$

両~tagとも省略不可。 ◎ Neither tag is omissible.

`内容~属性$

`大域~属性$ ◎ Global attributes

``for$a — この~labelを~form~controlに結付ける。 ◎ for — Associate the label with form control

`~accessibilityの考慮点$

`label$AA ◎ For authors. For implementers.

`~DOM~interface$

[Exposed=Window]
interface `HTMLLabelElement@I : `HTMLElement$I {
  [`HTMLConstructor$] constructor();

  readonly attribute `HTMLFormElement$I? ``form$m;
  [`CEReactions$] attribute DOMString ``htmlFor$m;
  readonly attribute `HTMLElement$I? ``control$m;
};

`label$e 要素の正確な［ 既定の呈示, 既定の挙動 ］ — 特に，その`作動化の挙動$ — は、 当の~platformに~label用の挙動があるならば，それに合致するベキである。 `label$e 要素の`作動化の挙動$は、［ その子孫である`対話的~内容$ %C, および %C の子孫 ］を~targetにする~eventに対しては，何もしないモノトスル。 ◎ The label element's exact default presentation and behavior, in particular what its activation behavior might be, if anything, should match the platform's label behavior. The activation behavior of a label element for events targeted at interactive content descendants of a label element, and any descendants of those interactive content descendants, must be to do nothing.

注記： `~formに所有され得る~custom要素$は，`~label可能$な要素なので、 ~UAにとっては，［ `label$e 要素の`作動化の挙動$が`~label先~control$に影響iする所 ］では［ 組込みの要素, ~custom要素 ］どちらも影響iされることになる。 ◎ Form-associated custom elements are labelable elements, so for user agents where the label element's activation behavior impacts the labeled control, both built-in and custom elements will be impacted.

%label.``control$m

この要素の`~label先~control$を返す。 ◎ Returns the form control that is associated with this element.

%label.``form$m

この要素の`~label先~control$が［ 在るならば その `~form所有者$ ／ 無いならば ~NULL ］を返す。 ◎ Returns the form owner of the form control that is associated with this element. ◎ Returns null if there isn't one.

``htmlFor@m ~IDL属性は、 ``for$a 内容~属性を`反映する$モノトスル。 ◎ The htmlFor IDL attribute must reflect the for content attribute.

%control.`labels$m

この~form~controlを`~label先~control$にしている `label$e 要素すべてからなる `NodeList$I を返す。 ◎ Returns a NodeList of all the label elements that the form control is associated with.

各［ `~label可能$な要素 ／ `input$e 要素 ］には、 `NodeList$I ~objが結付けられる — それは、［ 当の要素を`~label先~control$とする `label$e 要素たち ］からなる，`~tree順序$による~listを表現し，次のいずれかの~IDL属性に公開される： ◎ Labelable elements and all input elements have a live NodeList object associated with them that represents the list of label elements, in tree order, whose labeled control is the element in question.＼

• 当の要素が`~formに所有され得る~custom要素$でない場合、 要素が実装する~interfaceの `labels@m 属性 — その取得子~手続きは：

  1. ~IF［ コレは `input$e 要素であって, その `type$a ~属性は `Hidden$st 状態にある ］ ⇒ ~RET ~NULL
  2. ~RET コレに結付けられた `NodeList$I ~obj — これは、 常に同じ~objを返すモノトスル
  ◎ The labels IDL attribute of labelable elements that are not form-associated custom elements, and the labels IDL attribute of input elements,＼ on getting, must return that NodeList object, and that same value must always be returned, unless this element is an input element whose type attribute is in the Hidden state, in which case it must instead return null.

• 当の要素が`~formに所有され得る~custom要素$である場合、 `ElementInternals$I の `labels@eI 属性 — その取得子~手続きは：

  1. %要素 ~LET コレの`~target要素$iN
  2. ~IF［ %要素 は`~formに所有され得る~custom要素$でない ］ ⇒ ~THROW `NotSupportedError$E
  3. ~RET %要素 に結付けられた `NodeList$I ~obj — これは、 常に同じ~objを返すモノトスル
  ◎ Form-associated custom elements don't have a labels IDL attribute. Instead, their ElementInternals object has a labels IDL attribute.＼ On getting, it must throw a "NotSupportedError" DOMException if the target element is not a form-associated custom element. Otherwise, it must return that NodeList object, and that same value must always be returned.

<!doctype html>
<p><label><input></label></p>
<script>
 const %input = document.querySelector('input');
 const %labels = %input.labels;
 console.assert(%labels.length === 1);

 %input.type = 'hidden';
 console.assert(%labels.length === 0); /* 
%input はもはや %label の`~label先~control$でない
◎
the input is no longer the label's labeled control
 */
 console.assert(%input.%labels === null);

 %input.type = 'checkbox';
 console.assert(%labels.length === 1); /* 
%input は再び %label の`~label先~control$になる
◎
the input is once again the label's labeled control
 */
 console.assert(%input.labels === %labels); /* 
元と同じ値が返される
◎
same value as returned originally
 */
</script>

4.10.5. ``input^e 要素

【 この節の内容は、 `別~page＠HTML-input-ja.html$にて。 】

4.10.6. ``button^e 要素

`分類$

`~flow内容$ ／`句ng内容$ ／ `対話的~内容$ ／ `可触~内容$ ／ ◎ Flow content. ◎ Phrasing content. ◎ Interactive content. ◎ Listed, labelable, submittable, and autocapitalize-and-autocorrect inheriting form-associated element. ◎ Palpable content.

`~formに所有され得る要素$のうち［ `~listされる$ ／ `~label可能$な ／ `提出-可能$な ／ `自動頭字化-と自動訂正-を継承-$する ］もの ◎ ↑

`この要素を利用できる文脈$

`句ng内容$が期待される所。 ◎ Where phrasing content is expected.

`内容~model$

`句ng内容$ — ただし、 子孫に［ `対話的~内容$ ／ `tabindex$a 属性が指定された要素 ］があってはならない。 ◎ Phrasing content, but there must be no interactive content descendant and no descendant with the tabindex attribute specified.

`text/html における~tag省略$

両~tagとも省略不可。 ◎ Neither tag is omissible.

`内容~属性$

`大域~属性$ ◎ Global attributes

`disabled$a — この~form~controlは不能化されるかどうか。 ◎ disabled — Whether the form control is disabled

`form$a — この要素の所有者にする `form$e 要素を与える。 ◎ form — Associates the element with a form element

`formaction$a — `~form提出$用に利用する`~URL$ ◎ formaction — URL to use for form submission

`formenctype$a — `~form提出$用に利用する`~entry~list$用の符号化法の種別。 ◎ formenctype — Entry list encoding type to use for form submission

`formmethod$a — `~form提出$用に利用する~method（等） ◎ formmethod — Variant to use for form submission

`formnovalidate$a — `~form提出$に際し，~form~control検証を迂回する。 ◎ formnovalidate — Bypass form control validation for form submission

`formtarget$a — `~form提出$用の 【それにより~navigateされる】 `~navigable$。 ◎ formtarget — Navigable for form submission

`name$a — ［ `~form提出$用に ／ `form.elements$m ~APIにおいて ］利用する，この要素の名前。 ◎ name — Name of the element to use for form submission and in the form.elements API

`popovertarget$a — ［ ~toggleする／示す／隠す ］~targetになる`~popover要素$を指示する。 ◎ popovertarget — Targets a popover element to toggle, show, or hide

`popovertargetaction$a — ~targetにされた`~popover要素$に対し［ ~toggleする／示す／隠す ］のうちどれを行うかを指示する。 ◎ popovertargetaction — Indicates whether a targeted popover element is to be toggled, shown, or hidden

``type$a — ~buttonの型 ◎ type — Type of button

``value$a — `~form提出$用に利用される値。 ◎ value — Value to be used for form submission

`~accessibilityの考慮点$

`button$AA ◎ For authors. For implementers.

`~DOM~interface$

[Exposed=Window]
interface `HTMLButtonElement@I : `HTMLElement$I {
  [`HTMLConstructor$] constructor();

  [`CEReactions$] attribute boolean `disabled$m;
  readonly attribute `HTMLFormElement$I? `form$m;
  [`CEReactions$] attribute USVString `formAction$m;
  [`CEReactions$] attribute DOMString `formEnctype$m;
  [`CEReactions$] attribute DOMString `formMethod$m;
  [`CEReactions$] attribute boolean `formNoValidate$m;
  [`CEReactions$] attribute DOMString `formTarget$m;
  [`CEReactions$] attribute DOMString `name$m;
  [`CEReactions$] attribute DOMString ``type$m;
  [`CEReactions$] attribute DOMString ``value$m;

  readonly attribute boolean `willValidate$m;
  readonly attribute `ValidityState$I `validity$m;
  readonly attribute DOMString `validationMessage$m;
  boolean `checkValidity$m();
  boolean `reportValidity$m();
  undefined `setCustomValidity$m(DOMString %error);

  readonly attribute `NodeList$I `labels$m;
};

`HTMLButtonElement$I includes `PopoverInvokerElement$I;

`button$e 要素は、 その内容で~labelされた~buttonを`表現-$する。 ◎ The button element represents a button labeled by its contents.

要素は`~button$になる。 ◎ The element is a button.

``type@a 属性は、 ~buttonが作動化されたときの挙動を制御する。 この属性は，`列挙d属性$であり、 次に挙げる~keyword, とり得る状態, それらの対応付けが定義される： ◎ The type attribute controls the behavior of the button when it is activated. It is an enumerated attribute with the following keywords and states:

この属性の［ `欠落~値~用の既定の状態$／`妥当でない値~用の既定の状態$ ］は、 `Submit$st とする。 ◎ The attribute's missing value default and invalid value default are both the Submit Button state.

要素は、 その ``type$a 属性が `Submit$st 状態にあるときは，特定的に`提出-~button$になる。 ◎ If the type attribute is in the Submit Button state, the element is specifically a submit button.

拘束~検証 ⇒ 要素が次を満たしている間は、 `拘束~検証の対象外$になる ⇒ ``type$a 属性の状態 ~IN { `Reset$st, `Button$st } ◎ Constraint validation: If the type attribute is in the Reset Button state or the Button state, the element is barred from constraint validation.

`button$e 要素の： ◎ ↓

• `form$a 属性は、 要素を ある`~form所有者$に明示的に所有させるために利用される。 ◎ The form attribute is used to explicitly associate the button element with its form owner.＼
• `name$a 属性は、 要素の名前を表現する。 ◎ The name attribute represents the element's name.＼ ◎
• `disabled$a 属性は、 ~controlを対話的でなくして，その値は提出されないようにするために利用される。 ◎ The disabled attribute is used to make the control non-interactive and to prevent its value from being submitted.＼
• 次に挙げる属性は、 `~form提出用の属性$である ⇒＃ `formaction$a, `formenctype$a, `formmethod$a, `formnovalidate$a, `formtarget$a ◎ The formaction, formenctype, formmethod, formnovalidate, and formtarget attributes are attributes for form submission.

注記： `formnovalidate$a 属性は、 提出-~buttonが拘束~検証を誘発しないようにするために利用できる。 ◎ The formnovalidate attribute can be used to make submit buttons that do not trigger the constraint validation.

上に挙げた`~form提出用の属性$は、 要素の ``type$a 属性が `Submit$st 状態にある場合を除いて，指定されてはナラナイ。 ◎ The formaction, formenctype, formmethod, formnovalidate, and formtarget must not be specified if the element's type attribute is not in the Submit Button state.

``value@a 属性は、 ~form提出の目的における要素の値を与える。 要素の`値$feは［ 要素が ``value$a 属性を有するならば その値 ／ ~ELSE_ 空~文字列 ］になる。 ◎ The value attribute gives the element's value for the purposes of form submission. The element's value is the value of the element's value attribute, if there is one, or the empty string otherwise.

注記： ~button（および その値）は、 ~form提出を起動するために利用されたときに限り，~form提出に含まれる。 ◎ A button (and its value) is only included in the form submission if the button itself was used to initiate the form submission.

``value@m ~IDL属性は、 ``value$a 内容~属性を`反映する$モノトスル。 ◎ The value IDL attribute must reflect the content attribute of the same name.

``type@m ~IDL属性は、 `既知な値のみに制限され$る下で， ``type$a 内容~属性を`反映する$モノトスル。 ◎ The type IDL attribute must reflect the content attribute of the same name, limited to only known values.

`button$e 要素には、 次に挙げる~IDL~memberもある： ◎ ↓

• 次に挙げるものは、 `拘束~検証~API$の一部を成す ⇒＃ `willValidate$m, `validity$m, `validationMessage$m, `checkValidity()$m, `reportValidity()$m, `setCustomValidity()$m ◎ The willValidate, validity, and validationMessage IDL attributes, and the checkValidity(), reportValidity(), and setCustomValidity() methods, are part of the constraint validation API.＼
• `labels$m は、 要素を指している `label$e からなる~listを供する。 ◎ The labels IDL attribute provides a list of the element's labels.＼
• 次に挙げるものは、 要素の~form~APIの一部を成す ⇒＃ `disabled$m, `form$m, `name$m ◎ The disabled, form, and name IDL attributes are part of the element's forms API.

4.10.7. ``select^e 要素

`分類$

`~flow内容$ ／`句ng内容$ ／ `対話的~内容$ ／ `可触~内容$ ／ ◎ Flow content. ◎ Phrasing content. ◎ Interactive content. ◎ Listed, labelable, submittable, resettable, and autocapitalize-and-autocorrect inheriting form-associated element. ◎ Palpable content.

`~formに所有され得る要素$のうち［ `~listされる$ ／ `提出-可能$な ／ `再設定-可能$な ／ `自動頭字化-と自動訂正-を継承-$する ］もの ◎ ↑

`この要素を利用できる文脈$

`句ng内容$が期待される所。 ◎ Where phrasing content is expected.

`内容~model$

0 個~以上の［ 次のいずれかに該当する要素 ］ ⇒＃ `option$e ／ `optgroup$e ／ `hr$e ／ `~scriptを~supportする要素$ ◎ Zero or more option, optgroup, hr, and script-supporting elements. Zero or more option, optgroup, and script-supporting elements.

`text/html における~tag省略$

両~tagとも省略不可。 ◎ Neither tag is omissible.

`内容~属性$

`大域~属性$ ◎ Global attributes

`autocomplete$a — ~formの~autofill特能~用の~hint。 ◎ autocomplete — Hint for form autofill feature

`disabled$a — この~form~controlは不能化されるかどうか。 ◎ disabled — Whether the form control is disabled

`form$a — この要素の所有者にする `form$e 要素を与える。 ◎ form — Associates the element with a form element

``multiple$a — 複数個の値を許容するかどうか。 ◎ multiple — Whether to allow multiple values

`name$a — ［ `~form提出$用に ／ `form.elements$m ~APIにおいて ］利用する，この要素の名前。 ◎ name — Name of the element to use for form submission and in the form.elements API

``required$a — この~controlは`~form提出$用に必須とされるかどうか。 ◎ required — Whether the control is required for form submission

``size$a — ~controlの~size。 ◎ size — Size of the control

`~accessibilityの考慮点$

［ 要素は ``multiple$a 属性を有する ］~OR［ 要素は ``size$a 属性を有していて，その値 ~GT 1 ］ならば ⇒ `作者~向け＠~HTMLARIA#el-select-multiple-or-size-greater-1$／ `実装者~向け＠~HTMLAAM#el-select-listbox$ ◎ If the element has a multiple attribute or a size attribute with a value > 1: for authors; for implementers.

他の場合 ⇒ `作者~向け＠~HTMLARIA#el-select$／ `実装者~向け＠~HTMLAAM#el-select-combobox$ ◎ Otherwise: for authors; for implementers.

`~DOM~interface$

[Exposed=Window]
interface `HTMLSelectElement@I : `HTMLElement$I {
  [`HTMLConstructor$] constructor();

  [`CEReactions$] attribute DOMString `autocomplete$m;
  [`CEReactions$] attribute boolean `disabled$m;
  readonly attribute `HTMLFormElement$I? `form$m;
  [`CEReactions$] attribute boolean ``multiple$m;
  [`CEReactions$] attribute DOMString `name$m;
  [`CEReactions$] attribute boolean ``required$m;
  [`CEReactions$] attribute unsigned long ``size$m;

  readonly attribute DOMString ``type$m;

  [SameObject] readonly attribute `HTMLOptionsCollection$I ``options$m;
  [`CEReactions$] attribute unsigned long ``length$m;
  getter `HTMLOptionElement$I? ``item$m(unsigned long %index);
  `HTMLOptionElement$I? ``namedItem$m(DOMString %name);
  [`CEReactions$] undefined ``add$m((`HTMLOptionElement$I or `HTMLOptGroupElement$I) %element, optional (`HTMLElement$I or long)? %before = null);
  [`CEReactions$] undefined ``remove$m(); // ChildNode overload
  [`CEReactions$] undefined ``remove$m(long %index);
  [`CEReactions$] ``setter$m undefined (unsigned long %index, `HTMLOptionElement$I? %option);

  [SameObject] readonly attribute `HTMLCollection$I ``selectedOptions$m;
  attribute long ``selectedIndex$m;
  attribute DOMString ``value$m;

  readonly attribute boolean `willValidate$m;
  readonly attribute `ValidityState$I `validity$m;
  readonly attribute DOMString `validationMessage$m;
  boolean `checkValidity$m();
  boolean `reportValidity$m();
  undefined `setCustomValidity$m(DOMString %error);

  undefined ``showPicker$m();

  readonly attribute `NodeList$I `labels$m;
};

`select$e 要素は、 選択肢（ option ）の集合から いくつかを選択するための~controlを表現する。 ◎ The select element represents a control for selecting amongst a set of options.

``multiple@a 属性は、 `真偽-属性$である。 `select$e 要素は、 この属性を［ 有する ／ 有さない ］ならば，要素の``選択肢~list$から［ 0 個~以上の選択肢 ／ 単独の選択肢 ］を選択するための~controlを`表現-$する。 ◎ The multiple attribute is a boolean attribute. If the attribute is present, then the select element represents a control for selecting zero or more options from the list of options. If the attribute is absent, then the select element represents a control for selecting a single option from the list of options.

``size@a 属性は、 利用者に示す選択肢の個数を与える。 この属性に指定する値は、 1 以上の`妥当な負でない整数$でなければナラナイ。 ◎ The size attribute gives the number of options to show to the user. The size attribute, if specified, must have a value that is a valid non-negative integer greater than zero.

``required@a 属性は、 `真偽-属性$である。 指定されたときは、 利用者には，~formを提出する前に値を選択することが 要求されることになる。 ◎ The required attribute is a boolean attribute. When specified, the user will be required to select a value before submitting the form.

`select$e 要素は、 上の手続きの `条件 (A)^i を満たすならば，その`仮入力~label選択肢$ ~EQ ε になってはナラナイ。 【これは、作者~向け要件。】 ◎ If a select element has a required attribute specified, does not have a multiple attribute specified, and has a display size of 1, then the select element must have a placeholder label option.

注記： 実施においては、 上の段落に言明した要件が適用され得るのは，当の `select$e 要素が［ 値 ~GT 1 にされた ``size$a 属性 ］を有さないときに限られている。 ◎ In practice, the requirement stated in the paragraph above can only apply when a select element does not have a size attribute with a value greater than 1.

拘束~検証 ⇒ `select$e 要素 %select は、 次を満たしている間は，`欠落である難あり$になる ⇒ ［ %select は ``required$a 属性を有する ］~AND［ %select の``選択肢~list$内に次を満たす `option$e 要素 %option は無い ］ ⇒ ［ %option の`選択状態$opt ~EQ ~T ］~AND［ %option ~NEQ %select の`仮入力~label選択肢$ ］ ◎ Constraint validation: If the element has its required attribute specified, and either none of the option elements in the select element's list of options have their selectedness set to true, or the only option element in the select element's list of options with its selectedness set to true is the placeholder label option, then the element is suffering from being missing.

`select$e 要素 %select が ``multiple$a 属性を有さない下では — 以下、 %L は %select の``選択肢~list$を表すとする — ~UAは： ◎ ↓

• %select は`不能化されて$feいない場合、 利用者が［ %L 内の `option$e 要素のうち，`不能化されて$optいない任意のもの ］を選べるようにするベキである。 ◎ If the multiple attribute is absent, and the element is not disabled, then the user agent should allow the user to pick an option element in its list of options that is itself not disabled.＼

  そのような `option$e 要素 %option が，利用者から ``選ばれ@ たときは（ ~click ／ その値を変更してから %select への~focusを他へ移して ／ `~menu~command$ ／ その他の仕組み を通して）、［ 関連な利用者~対話~event（例： `click$et ~event）が~queueされる前 ］に，次を走らすモノトスル：

  1. %option の`選択状態$opt ~SET ~T
  2. %option の`~dirtyか$opt ~SET ~T
  3. `選択-更新の通知を送信する$( %select )

  ◎ Upon this option element being picked (either through a click, or through unfocusing the element after changing its value, or through a menu command, or through any other mechanism), and before the relevant user interaction event is queued (e.g. before the click event), the user agent must set the selectedness of the picked option element to true, set its dirtiness to true, and then send select update notifications.

• ある `option$e 要素 %option に対し，次のいずれかが生じたときは：

  • %option が %L 内にある下で， %option の `選択状態$opt が ~T に設定されたとき
  • %option の`選択状態$opt ~EQ ~T の下で， %option が %L に追加されたとき

  %L 内の %option 以外の `option$e 要素すべてに対し，その`選択状態$optを ~F に設定するモノトスル。

  ◎ If the multiple attribute is absent, whenever an option element in the select element's list of options has its selectedness set to true, and whenever an option element with its selectedness set to true is added to the select element's list of options, the user agent must set the selectedness of all the other option elements in its list of options to false.

• ［ %select の``表示~size$ ~GT 1 ］の下では、 利用者が［ %L 内の `option$e 要素のうち［ `選択状態$opt ~EQ ~T ］なる任意のもの ］を未選択にできるようにするベキである。 ◎ If the multiple attribute is absent and the element's display size is greater than 1, then the user agent should also allow the user to request that the option whose selectedness is true, if any, be unselected.＼

  そのような `option$e 要素 %option が，利用者から未選択にするよう要請されたときは、［ 関連な利用者~対話~event（例： `click$et ~event）が~queueされる前 ］に，次を走らすモノトスル：

  1. %option の`選択状態$opt ~SET ~F
  2. %option の`~dirtyか$opt ~SET ~T
  3. `選択-更新の通知を送信する$( %select )

  ◎ Upon this request being conveyed to the user agent, and before the relevant user interaction event is queued (e.g. before the click event), the user agent must set the selectedness of that option element to false, set its dirtiness to true, and then send select update notifications.

`select$e 要素 %select が［ `不能化されて$feいない ］~AND［ ``multiple$a 属性を有する ］ならば、 ~UAは， %select の``選択肢~list$を成す各［ `不能化されて$optいない `option$e 要素 ］ %option に対し： ◎ If the multiple attribute is present, and the element is not disabled, then the user agent＼

• %option の`選択状態$optを ``~toggle@ することを利用者に許容するベキである。 ◎ should allow the user to toggle the selectedness of the option elements in its list of options that are themselves not disabled.＼

• 利用者が %option を （~clickや`~menu~command$, その他の仕組みを通して） ``~toggle$したときは、［ 関連な利用者~対話~event（例： `click$et ~event）が~queueされる前 ］に，次を走らすモノトスル： ◎ Upon such an element being toggled (either through a click, or through a menu command, or any other mechanism), and before the relevant user interaction event is queued (e.g. before a related click event),＼

  1. %option の`選択状態$opt ~SET ~IS［ %option の`選択状態$opt ~EQ ~F ］ ◎ the selectedness of the option element must be changed (from true to false or false to true),＼
  2. %option の`~dirtyか$opt ~SET ~T ◎ the dirtiness of the element must be set to true, and＼
  3. `選択-更新の通知を送信する$( %select ) ◎ the user agent must send select update notifications.

`select$e 要素の： ◎ ↓

• `form$a 属性は、 要素を ある`~form所有者$に明示的に所有させるために利用される。 ◎ The form attribute is used to explicitly associate the select element with its form owner.＼
• `name$a 属性は、 要素の名前を表現する。 ◎ The name attribute represents the element's name.＼
• `disabled$a 属性は、 ~controlを対話的でなくして，その値は提出されないようにするために利用される。 ◎ The disabled attribute is used to make the control non-interactive and to prevent its value from being submitted.＼
• `autocomplete$a 属性は、 ~UAが~autofillの挙動をどう供するかを制御する。 ◎ The autocomplete attribute controls how the user agent provides autofill behavior.

`不能化されて$feいない `select$e 要素は、 `変異-可能$feとする。 ◎ A select element that is not disabled is mutable.

%select.``type$m

要素が ``multiple$a 属性を［ 有するならば `select-multiple^l ／ 有さないならば `select-one^l ］を返す。 ◎ Returns "select-multiple" if the element has a multiple attribute, and "select-one" otherwise.

%select.``options$m

``選択肢~list$ を表現する `HTMLOptionsCollection$I を返す。 ◎ Returns an HTMLOptionsCollection of the list of options.

%select.``length$m [ = %value ]

``選択肢~list$を成す要素の個数を返す。 ◎ Returns the number of elements in the list of options.

より少ない数に設定された場合、 `select$e 内の `option$e 要素たちを，その個数になるよう切落す。 ◎ When set to a smaller number, truncates the number of option elements in the select.

より多い数に設定された場合、 新たな空欄の `option$e 要素を `select$e に追加する。 ◎ When set to a greater number, adds new blank option elements to the select.

%element = %select.``item$m(%index)

%select[%index]

``選択肢~list$内の %~index 番の~itemを返す。 ◎ Returns the item with index index from the list of options. The items are sorted in tree order.

%element = %select.``namedItem$m(%name)

``選択肢~list$内に次を満たす~itemが［ 在るならば それらのうち最初のもの ／ 無いならば ~NULL ］返す ⇒ ［ %name ~EQ `~ID$ ］~OR［ %name ~EQ `name＠#attr-option-name$a ］ ◎ Returns the first item with ID or name name from the list of options. ◎ Returns null if no element with that ID could be found.

%select.``add$m(%element [, %before ])

%before にて与えられた~nodeの前に， %element を挿入する。 ◎ Inserts element before the node given by before.

%before 引数は、 ``選択肢~list$を成す要素の他に，数もとり得る。 数の場合、 %before は``選択肢~list$内の %before 番の~itemとして解釈される。 ◎ The before argument can be a number, in which case element is inserted before the item with that number, or an element from the list of options, in which case element is inserted before that element.

%before が［ 省略されている ／ ~NULL ／ 範囲外の数 ］の場合、 %element は ~listの末尾に追加されることになる。 ◎ If before is omitted, null, or a number out of range, then element will be added at the end of the list.

%element が %select の先祖である場合、 `HierarchyRequestError$E 例外が投出される。 ◎ This method will throw a "HierarchyRequestError" DOMException if element is an ancestor of the element into which it is to be inserted.

%select.``selectedOptions$m

``選択肢~list$内の選択されているものからなる `HTMLCollection$I を返す。 ◎ Returns an HTMLCollection of the list of options that are selected.

%select.``selectedIndex$m [ = %value ]

選択されている~itemが［ 在るならば それらのうち最初のものの~index ／ 無いならば −1 ］を返す。 ◎ Returns the index of the first selected item, if any, or −1 if there is no selected item.

設定して，選択を変更できる。 ◎ Can be set, to change the selection.

%select.``value$m [ = %value ]

選択されている~itemが［ 在るならば それらのうち最初のものの`値$opt ／ 無いならば 空~文字列 ］を返す。 ◎ Returns the value of the first selected item, if any, or the empty string if there is no selected item.

設定して，選択を変更できる。 ◎ Can be set, to change the selection.

%select.``showPicker()$m

%select 用に適用-可能な~pickerがあれば、 利用者が値を選択できるよう，それを示す。 ◎ Shows any applicable picker UI for select, so that the user can select a value.

%select が`変異-可能$feでない場合、 `InvalidStateError$E 例外が投出される。 ◎ Throws an "InvalidStateError" DOMException if select is not mutable.

`一過な作動化を有して$いない間に~callされた場合、 `NotAllowedError$E 例外が投出される。 ◎ Throws a "NotAllowedError" DOMException if called without transient user activation.

%select が非同一-生成元 `iframe$e の内側にある場合、 `SecurityError$E 例外が投出される。 ◎ Throws a "SecurityError" DOMException if select is inside a cross-origin iframe.

%select が`具現化されて$いない場合、 `NotSupportedError$E 例外が投出される。 ◎ Throws a "NotSupportedError" DOMException if select is not being rendered.

`HTMLSelectElement$I ~objは、 その ``options$m 取得子~手続きが返す~obj — 以下では、 ~objの `~option群@ と称される — を そのまま映し出す。 それが`~supportする~prop~index$は、 常に，`~option群$のそれと同じとする。 ◎ The options collection is also mirrored on the HTMLSelectElement object. The supported property indices at any instant are the indices supported by the object returned by the options attribute at that instant.

``setter@m 用の［ `新たな有index~propの値を設定する手続き$／ `既存の有index~propの値を設定する手続き$ ］は、 代わりに，コレの`~option群$の`対応する~algo＠~HTMLcdom#dom-htmloptionscollection-setter$を走らすモノトスル。 ◎ When the user agent is to set the value of a new indexed property or set the value of an existing indexed property for a select element, it must instead run the corresponding algorithm on the select element's options collection.

注記： 歴史的な理由から、 ``size$m ~IDL属性の値の既定の値は，利用されている実際の~sizeを返さない。 ``size$a 内容~属性が無い場合、 それは， ``multiple$a 属性が［ 在るならば 4 ／ 無いならば 1 ］になる。 ◎ For historical reasons, the default value of the size IDL attribute does not return the actual size used, which, in the absence of the size content attribute, is either 1 or 4 depending on the presence of the multiple attribute.

`select$e 要素には、 次に挙げる~IDL~memberもある： ◎ ↓

• 次に挙げるものは、 `拘束~検証~API$の一部を成す ⇒＃ `willValidate$m, `validity$m, `validationMessage$m, `checkValidity()$m, `reportValidity()$m, `setCustomValidity()$m ◎ The willValidate, validity, and validationMessage IDL attributes, and the checkValidity(), reportValidity(), and setCustomValidity() methods, are part of the constraint validation API.＼
• `labels$m は、 要素を指している `label$e からなる~listを供する。 ◎ The labels IDL attribute provides a list of the element's labels.＼
• 次に挙げるものは、 要素の~form~APIの一部を成す ⇒＃ `disabled$m, `form$m, `name$m ◎ The disabled, form, and name IDL attributes are part of the element's forms API.

4.10.8. ``datalist^e 要素

`分類$

`~flow内容$ ／ `句ng内容$ ◎ Flow content. ◎ Phrasing content.

`この要素を利用できる文脈$

`句ng内容$が期待される所。 ◎ Where phrasing content is expected.

`内容~model$

次のいずれか一方：

• `句ng内容$
• 0 個~以上の［ 次のいずれかに該当する要素 ］ ⇒＃ `option$e, `~scriptを~supportする要素$

◎ Either: phrasing content. ◎ Or: Zero or more option and script-supporting elements.

`text/html における~tag省略$

両~tagとも省略不可。 ◎ Neither tag is omissible.

`内容~属性$

`大域~属性$ ◎ Global attributes

`~accessibilityの考慮点$

`datalist$AA ◎ For authors. For implementers.

`~DOM~interface$

[Exposed=Window]
interface `HTMLDataListElement@I : `HTMLElement$I {
  [`HTMLConstructor$] constructor();

  [SameObject] readonly attribute `HTMLCollection$I ``options$m;
};

`datalist$e 要素は、［［ 他の~control用の定義済み選択肢 ］を表現する［ `option$e 要素の集合 ］］を表現する。 描画においては、 `datalist$e 要素は，何も`表現-$しない — それらの子も含め，隠されるベキである。 ◎ The datalist element represents a set of option elements that represent predefined options for other controls. In the rendering, the datalist element represents nothing and it, along with its children, should be hidden.

`datalist$e 要素は、 2 つの仕方で利用できる： ◎ ↓

• 最も単純な事例では、 要素は単に いくつかの `option$e 要素を子に有する。 ◎ The datalist element can be used in two ways. In the simplest case, the datalist element has just option element children.

  `datalist-1^xCode

• より手の込んだ事例では、 `datalist$e 要素は，それを~supportしない~client用に表示される内容を与えれる。 この事例では、 各 `option$e 要素は， `datalist$e 要素の内側にある `select$e 要素の内側に供されている。 ◎ In the more elaborate case, the datalist element can be given contents that are to be displayed for down-level clients that don't support datalist. In this case, the option elements are provided inside a select element inside the datalist element.

  `datalist-2^xCode

`datalist$e 要素は、 `input$e 要素に，その `list$a 属性を通して結び付けられる。 ◎ The datalist element is hooked up to an input element using the list attribute on the input element.

`datalist$e 要素の子孫である `option$e 要素のうち，次を満たすものは、 示唆を表現し，［ `値$opt, `~label$opt ］を有する ⇒ ［ `不能化されて$optいない ］~AND［ `値$optは空でない文字列である ］ ◎ Each option element that is a descendant of the datalist element, that is not disabled, and whose value is a string that isn't the empty string, represents a suggestion. Each suggestion has a value and a label.

%datalist.``options$m

`datalist$e 要素の `option$e 要素からなる `HTMLCollection$I を返す。 ◎ Returns an HTMLCollection of the option elements of the datalist element.

拘束~検証 ⇒ 要素が次を満たしている間は、 `拘束~検証の対象外$になる ⇒ 要素の先祖に `datalist$e 要素がある ◎ Constraint validation: If an element has a datalist element ancestor, it is barred from constraint validation.

4.10.9. ``optgroup^e 要素

`分類$

なし。 ◎ None.

`この要素を利用できる文脈$

`select$e 要素の子として。 ◎ As a child of a select element.

`内容~model$

0 個~以上の［ 次のいずれかに該当する要素 ］ ⇒＃ `option$e, `~scriptを~supportする要素$ ◎ Zero or more option and script-supporting elements.

`text/html における~tag省略$

`optgroup$e 要素の`終了~tag$は、 次が満たされるならば，省略できる ⇒ ［ 直後に［ 別の `optgroup$e ／ `hr$e ］要素が来る ］~OR［ 親~要素~内に後続する内容は無い ］ ◎ An optgroup element's end tag can be omitted if the optgroup element is immediately followed by another optgroup element, if it is immediately followed by an hr element, or if there is no more content in the parent element.

`内容~属性$

`大域~属性$ ◎ Global attributes

``disabled$a — この~form~controlは不能化されるかどうか。 ◎ disabled — Whether the form control is disabled

``label$a — 利用者から可視な~label。 ◎ label — User-visible label

`~accessibilityの考慮点$

`optgroup$AA ◎ For authors. For implementers.

`~DOM~interface$

[Exposed=Window]
interface `HTMLOptGroupElement@I : `HTMLElement$I {
  [`HTMLConstructor$] constructor();

  [`CEReactions$] attribute boolean ``disabled$m;
  [`CEReactions$] attribute DOMString ``label$m;
};

`optgroup$e 要素は、 共通な~labelを伴う `option$e 要素たちが成す~groupを`表現-$する。 ◎ The optgroup element represents a group of option elements with a common label.

この~groupは、 `optgroup$e 要素の子である `option$e 要素たちからなる。 ◎ The element's group of option elements consists of the option elements that are children of the optgroup element.

~UAは、 そのような~groupを `select$e 要素~内に示すときは， ~groupを成す `option$e 要素たちを — それらが互いに関係しているように — 他の `option$e 要素から分離して示すベキである。 ◎ When showing option elements in select elements, user agents should show the option elements of such groups as being related to each other and separate from other option elements.

``disabled@a 属性は、 `真偽-属性$である — それは、 ~groupを成す `option$e 要素たちを まとめて`不能化する＠#concept-option-disabled$ことに利用できる。 ◎ The disabled attribute is a boolean attribute and can be used to disable a group of option elements together.

``label@a 属性は、 指定されなければナラナイ。 その値は、 ~groupの名前を与える。 ~UIの目的においては、 ~UAは，この属性の値を利用して `select$e 要素~内の `option$e 要素~groupに~labelを与えるベキである。 ◎ The label attribute must be specified. Its value gives the name of the group, for the purposes of the user interface. User agents should use this attribute's value when labeling the group of option elements in a select element.

注記： `optgroup$e 要素を選択する仕方は無い。 選択できるのは `option$e 要素に限られる。 `optgroup$e 要素は、 単に`option$e 要素~groupに~labelを供するに過ぎない。 ◎ There is no way to select an optgroup element. Only option elements can be selected. An optgroup element merely provides a label for a group of option elements.

4.10.10. ``option^e 要素

`分類$

なし。 ◎ None.

`この要素を利用できる文脈$

`select$e 要素の子として。 ◎ As a child of a select element.

`datalist$e 要素の子として。 ◎ As a child of a datalist element.

`optgroup$e 要素の子として。 ◎ As a child of an optgroup element.

`内容~model$

要素は［ ``label$a 属性を有する ］~AND［ ``value$a 属性を有する ］場合に限り ⇒ `なし$。 ◎ If the element has a label attribute and a value attribute: Nothing.

要素は［ ``label$a 属性を有する ］~AND［ ``value$a 属性を有さない ］場合に限り ⇒ `~text$。 ◎ If the element has a label attribute but no value attribute: Text.

要素は［ ``label$a 属性を有さない ］~AND［ `datalist$e 要素の子でない ］場合に限り ⇒ `要素間~空白$でない`~text$。 ◎ If the element has no label attribute and is not a child of a datalist element: Text that is not inter-element whitespace.

要素は［ ``label$a 属性を有する ］~AND［ `datalist$e 要素の子である ］場合に限り ⇒ `~text$。 ◎ If the element has no label attribute and is a child of a datalist element: Text.

`text/html における~tag省略$

`option$e 要素の`終了~tag$は、 次が満たされるならば，省略できる ⇒ ［ 直後に［ 別の `option$e ／ `optgroup$e ／ `hr$e ］要素が来る ］~OR［ 親~要素~内に後続する内容は無い ］ ◎ An option element's end tag can be omitted if the option element is immediately followed by another option element, if it is immediately followed by an optgroup element, if it is immediately followed by an hr element, or if there is no more content in the parent element.

`内容~属性$

`大域~属性$ ◎ Global attributes

``disabled$a — この~form~controlは不能化されるかどうか。 ◎ disabled — Whether the form control is disabled

``label$a — 利用者から可視な~label。 ◎ label — User-visible label

``selected$a — この選択肢が既定ので選択されるかどうか。 ◎ selected — Whether the option is selected by default

``value$a — `~form提出$用に利用される値。 ◎ value — Value to be used for form submission

`~accessibilityの考慮点$

`option$AA ◎ For authors. For implementers.

`~DOM~interface$

[Exposed=Window,
 `LegacyFactoryFunction$=``Option$m(optional DOMString %text = "", optional DOMString %value, optional boolean %defaultSelected = false, optional boolean %selected = false)]
interface `HTMLOptionElement@I : `HTMLElement$I {
  [`HTMLConstructor$] constructor();

  [`CEReactions$] attribute boolean ``disabled$m;
  readonly attribute `HTMLFormElement$I? ``form$m;
  [`CEReactions$] attribute DOMString ``label$m;
  [`CEReactions$] attribute boolean ``defaultSelected$m;
  attribute boolean ``selected$m;
  [`CEReactions$] attribute DOMString ``value$m;

  [`CEReactions$] attribute DOMString ``text$m;
  readonly attribute long ``index$m;
};

`option$e 要素は、［ `select$e 要素~内の選択肢 ］, または［ `datalist$e 要素~内の示唆~listの一部 ］を`表現-$する。 ◎ The option element represents an option in a select element or as part of a list of suggestions in a datalist element.

`select$e 要素の定義にて述べた一定の状況下では、 `option$e 要素は `select$e 要素の`仮入力~label選択肢$になり得る。 `仮入力~label選択肢$は、 実際の選択肢を表現しない代わりに `select$e ~controlの~labelを表現する。 ◎ In certain circumstances described in the definition of the select element, an option element can be a select element's placeholder label option. A placeholder label option does not represent an actual option, but instead represents a label for the select control.

【！＊？#attr-option-disabled】 `option$e 要素が`不能化されて$optいる間は、 `利用者~対話~task~source$から`~queueされ＠~WAPI#queue-a-task$る どの `click$et ~eventも，要素に配送しないモノトスル。 ◎ An option element that is disabled must prevent any click events that are queued on the user interaction task source from being dispatched on the element.

``label@a 属性は、 要素の~labelを供する。 `option$e 要素の `~label@opt は、［［ 要素は ``label$a 内容~属性を有していて，その値 ~NEQ 空~文字列 ］ならば その値 ／ ~ELSE_ 要素の``text$m ~IDL属性の値 ］になる。 ◎ The label attribute provides a label for element. The label of an option element is the value of the label content attribute, if there is one and its value is not the empty string, or, otherwise, the value of the element's text IDL attribute.

``label$a 内容~属性に指定する値は、 空であってはナラナイ。 ◎ The label content attribute, if specified, must not be empty.

``value@a 属性は、 要素の値を供する。 `option$e 要素の `値@opt は、［ 要素は ``value$a 内容~属性を有するならば その値 ／ ~ELSE_ 要素の ``text$m ~IDL属性の値 ］になる。 ◎ The value attribute provides a value for element. The value of an option element is the value of the value content attribute, if there is one, or, if there is not, the value of the element's text IDL attribute.

``selected@a 属性は、 `真偽-属性$である。 それは、 要素の既定の`選択状態$optを表現する。 ◎ The selected attribute is a boolean attribute. It represents the default selectedness of the element.

`option$e 要素の `~dirtyか@opt は、 真偽-状態であり，初期~時には ~F とする。 それは ``selected$a 内容~属性を［ 追加する／除去する ］ことが効果を及ぼすかどうかを制御する。 ◎ The dirtiness of an option element is a boolean state, initially false. It controls whether adding or removing the selected content attribute has any effect.

`option$e 要素の `選択状態@opt は、 真偽-状態であり，初期~時には ~F とする。 他が指定されない限り，要素の作成-時には、 要素の`選択状態$optは，［ 要素が ``selected$a 属性を有する ］ならば ~T に設定されるモノトスル。 ［ `~dirtyか$opt ~EQ ~F ］の下では、 ``selected$a 属性が `option$e 要素［ に追加される ／ から`除去される^em ］度に、 その`選択状態$optは，［ ~T ／ ~F ］に設定されるモノトスル。 ◎ The selectedness of an option element is a boolean state, initially false. Except where otherwise specified, when the element is created, its selectedness must be set to true if the element has a selected attribute. Whenever an option element's selected attribute is added, if its dirtiness is false, its selectedness must be set to true. Whenever an option element's selected attribute is removed, if its dirtiness is false, its selectedness must be set to false.

注記： ``Option()$m 構築子は、 3 個~以下の引数で~callされたときは、 `選択状態$optの初期~状態を上書きして — ［ 3 個目の引数 ~EQ ~T ］の場合（ ``selected$a 属性は設定されることを含意する）であっても — 状態は 常に ~F になるようにする。 4 個目の引数を利用すれば、 初期の`選択状態$opt状態を明示的に設定できる。 ◎ The Option() constructor, when called with three or fewer arguments, overrides the initial state of the selectedness state to always be false even if the third argument is true (implying that a selected attribute is to be set). The fourth argument can be used to explicitly set the initial selectedness state when using the constructor.

`select$e 要素が `multiple＠#attr-select-multiple$a 属性を有さない場合、 その子孫に［ ``selected$a 属性を有する ］ような `option$e 要素が複数~在ってはナラナイ。 ◎ A select element whose multiple attribute is not specified must not have more than one descendant option element with its selected attribute set.

`option$e 要素 %option の `~index@opt は、［ %option が ある`選択肢~list$内に含まれるならば その~list内で %option より前に来る `option$e 要素の個数 ／ ~ELSE_ 0 † ］とする。 【† ~listの先頭にあるときと区別がつかないことになる。】 ◎ An option element's index is the number of option elements that are in the same list of options but that come before it in tree order. If the option element is not in a list of options, then the option element's index is zero.

%option.``selected$m

要素が選択されているならば ~T を返す。 他の場合は ~F を返す。 ◎ Returns true if the element is selected, and false otherwise.

設定して，この要素の現在の状態を上書きできる。 ◎ Can be set, to override the current state of the element.

%option.``index$m

`select$e 要素の`~option群$における要素の~indexを返す。 【！`options＠#dom-select-options$m ~list】 ◎ Returns the index of the element in its select element's options list.

%option.``form$m

要素が属する `form$e 要素が［ 在るならば それ ／ 無いならば ~NULL ］を返す。 ◎ Returns the element's form element, if any, or null otherwise.

%option.``text$m

~ASCII空白は縮約され， `script$e 要素は飛ばされることを除いて、 `textContent$m と同じ。 ◎ Same as textContent, except that spaces are collapsed and script elements are skipped.

%option = new ``Option( [ text [, value [, defaultSelected [, selected ] ] ] ] )$m

新たな `option$e 要素を返す。 ◎ Returns a new option element.

%text 引数は、 要素の内容を設定する。 ◎ The text argument sets the contents of the element.

%value 引数は ``value$a 属性を設定する。 ◎ The value argument sets the value attribute.

%defaultSelected 引数は ``selected$a 属性を設定する。 ◎ The defaultSelected argument sets the selected attribute.

%selected 引数は、 要素が選択されるかどうかを設定する。 省略された場合、［ %defaultSelected 引数 ~EQ ~T ］であっても，要素は選択されない。 ◎ The selected argument sets whether or not the element is selected. If it is omitted, even if the defaultSelected argument is true, the element is not selected.

``disabled@m ~IDL属性は、 ``disabled$a 内容~属性を`反映する$モノトスル。 ◎ The disabled IDL attribute must reflect the content attribute of the same name.＼

``defaultSelected@m ~IDL属性は、 ``selected$a 内容~属性を`反映する$モノトスル。 ◎ The defaultSelected IDL attribute must reflect the selected content attribute.

4.10.11. ``textarea^e 要素

`分類$

`~flow内容$ ／`句ng内容$ ／ `対話的~内容$ ／ `可触~内容$ ／ ◎ Flow content. ◎ Phrasing content. ◎ Interactive content. ◎ Listed, labelable, submittable, resettable, and autocapitalize-and-autocorrect inheriting form-associated element. ◎ Palpable content.

`~formに所有され得る要素$のうち［ `~listされる$ ／ `提出-可能$な ／ `再設定-可能$な ／ `自動頭字化-と自動訂正-を継承-$する ］もの ◎ ↑

`この要素を利用できる文脈$

`句ng内容$が期待される所。 ◎ Where phrasing content is expected.

`内容~model$

`~text$。 ◎ Text.

`text/html における~tag省略$

両~tagとも省略不可。 ◎ Neither tag is omissible.

`内容~属性$

`大域~属性$ ◎ Global attributes

`autocomplete$a — ~formの~autofill特能~用の~hint。 ◎ autocomplete — Hint for form autofill feature

``cols$a — 行あたりの最大~文字~数 ◎ cols — Maximum number of characters per line

`dirname$a — `~form提出$時に要素の`方向性$を送信するために利用される，~form~controlの名前。 ◎ dirname — Name of form control to use for sending the element's directionality in form submission

`disabled$a — この~form~controlは不能化されるかどうか。 ◎ disabled — Whether the form control is disabled

`form$a — この要素の所有者にする `form$e 要素を与える。 ◎ form — Associates the element with a form element

``maxlength$a — 値の最大`長さ$。 ◎ maxlength — Maximum length of value

``minlength$a — 値の最小`長さ$。 ◎ minlength — Minimum length of value

`name$a — ［ `~form提出$用に ／ `form.elements$m ~APIにおいて ］利用する，この要素の名前。 ◎ name — Name of the element to use for form submission and in the form.elements API

``placeholder$a — この~form~controlに配置され，利用者から可視になる~label。 ◎ placeholder — User-visible label to be placed within the form control

``readonly$a — 利用者が値を編集できなくするかどうか ◎ readonly — Whether to allow the value to be edited by the user

``required$a — この~controlは`~form提出$用に必須とされるかどうか。 ◎ required — Whether the control is required for form submission

``rows$a — 示す行l数 ◎ rows — Number of lines to show

``wrap$a — `~form提出$時に，~form~controlの値はどう折返されるか ◎ wrap — How the value of the form control is to be wrapped for form submission

`~accessibilityの考慮点$

`textarea$AA ◎ For authors. For implementers.

`~DOM~interface$

[Exposed=Window]
interface `HTMLTextAreaElement@I : `HTMLElement$I {
  [`HTMLConstructor$] constructor();

  [`CEReactions$] attribute DOMString `autocomplete$m;
  [`CEReactions$] attribute unsigned long ``cols$m;
  [`CEReactions$] attribute DOMString ``dirName$m;
  [`CEReactions$] attribute boolean `disabled$m;
  readonly attribute `HTMLFormElement$I? `form$m;
  [`CEReactions$] attribute long ``maxLength$m;
  [`CEReactions$] attribute long ``minLength$m;
  [`CEReactions$] attribute DOMString `name$m;
  [`CEReactions$] attribute DOMString ``placeholder$m;
  [`CEReactions$] attribute boolean ``readOnly$m;
  [`CEReactions$] attribute boolean ``required$m;
  [`CEReactions$] attribute unsigned long ``rows$m;
  [`CEReactions$] attribute DOMString ``wrap$m;

  readonly attribute DOMString ``type$m;
  [`CEReactions$] attribute DOMString ``defaultValue$m;
  attribute [`LegacyNullToEmptyString$] DOMString ``value$m;
  readonly attribute unsigned long ``textLength$m;

  readonly attribute boolean `willValidate$m;
  readonly attribute `ValidityState$I `validity$m;
  readonly attribute DOMString `validationMessage$m;
  boolean `checkValidity$m();
  boolean `reportValidity$m();
  undefined `setCustomValidity$m(DOMString %error);

  readonly attribute `NodeList$I `labels$m;

  undefined `select$m();
  attribute unsigned long `selectionStart$m;
  attribute unsigned long `selectionEnd$m;
  attribute DOMString `selectionDirection$m;
  undefined `setRangeText$m(DOMString %replacement);
  undefined `setRangeText$m(DOMString %replacement, unsigned long %start, unsigned long %end, optional `SelectionMode$I %selectionMode = "preserve");
  undefined `setSelectionRange$m(unsigned long %start, unsigned long %end, optional DOMString %direction);
};

この節においては ⇒＃ `LF^i は 文字 `000A^U `LINE FEED^cn ／ `CR^i は 文字 `000D^U `CARRIAGE RETURN^cn ◎終 を表すとする。

`textarea$e 要素は、［ 要素の ``生の値@ を与える，複数行からなる素な~text ］用の編集~controlを`表現-$する。 この~controlの内容は、 ~controlの既定の値を表現する。 ◎ The textarea element represents a multiline plain text edit control for the element's raw value. The contents of the control represent the control's default value.

`textarea$e ~controlの``生の値$は、 初期~時には空~文字列になるモノトスル。 ◎ The raw value of a textarea control must be initially the empty string.

注記： この要素には、 `双方向-~algoを孕む描画~要件がある＠~HTMLdom#bidireq$。 ◎ This element has rendering requirements involving the bidirectional algorithm.

``readonly@a 属性は、 `真偽-属性$であり，利用者が~textを編集できなくするかどうかを制御するために利用される。 ◎ The readonly attribute is a boolean attribute used to control whether the text can be edited by the user or not.

拘束~検証 ⇒ 要素が次を満たしている間は、 `拘束~検証の対象外$になる ⇒ `textarea$e 要素は ``readonly$a 属性を有する ◎ Constraint validation: If the readonly attribute is specified on a textarea element, the element is barred from constraint validation.

`textarea$e 要素は、［ `不能化されて$feいない ］~AND［ ``readonly$a 属性を有さない ］ならば，`変異-可能$feとする。 ◎ A textarea element is mutable if it is neither disabled nor has a readonly attribute specified.

`textarea$e 要素 %要素 が`変異-可能$feである下では、 ~UAは： ◎ When a textarea is mutable,＼

• 利用者が %要素 の``生の値$を編集できるようにするベキである — ~textを［ 編集- ／ 挿入- ／ 除去- ］できるようにして。 ◎ its raw value should be editable by the user: the user agent should allow the user to edit, insert, and remove text, and＼
• 利用者が 改行を `LF^i の形で［ 挿入- ／ 除去- ］できるようにするベキである。 ◎ to insert and remove line breaks in the form of U+000A LINE FEED (LF) characters.＼

• どの時点であれ，利用者が %要素 の``生の値$を変更したときは、 次を行うモノトスル ⇒ `要素~taskを~queueする$( `利用者~対話~task~source$, %要素, 次の手続き ) ◎ Any time the user causes the element's raw value to change, the user agent must queue an element task on the user interaction task source given the textarea element to＼

  手続きは ⇒ `入力~eventを発火する$( %要素, `input$et ) ◎ fire an event named input at the textarea element, with the bubbles and composed attributes initialized to true.＼
• 前項の~taskを~queueする前に，利用者とのヤリトリに相応しい間 待機してヨイ — 例えば、［ 各~keystrokeごとに~eventを発火し続けずに，利用者が手を止めたときに限り 発火する ］ように，［ 100 ~milli秒~間 ~UIkeyが叩かれずにいるとき ］まで待機することもできる。 ◎ User agents may wait for a suitable break in the user's interaction before queuing the task; for example, a user agent could wait for the user to have not hit a key for 100ms, so as to only fire the event when the user pauses, instead of continuously for each keystroke.

`textarea$e 要素の`値は~dirtyか$feは、［ 利用者が~controlとヤリトリして その``生の値$を変更する ］度に， ~T に設定されるモノトスル。 ◎ A textarea element's dirty value flag must be set to true whenever the user interacts with the control in a way that changes the raw value.

`textarea$e 要素~用の`~clone時の手続き$は、 要素の［ ``生の値$, `値は~dirtyか$fe ］も~clone先の~nodeに複製するモノトスル。 ◎ The cloning steps for textarea elements must propagate the raw value and dirty value flag from the node being cloned to the copy.

``cols@a 属性は、 `一行分の字数$ — 期待される，行あたりの最大~文字~数 — を指定する。 この属性に指定する値は、 1 以上の`妥当な負でない整数$でなければナラナイ。 ◎ The cols attribute specifies the expected maximum number of characters per line. If the cols attribute is specified, its value must be a valid non-negative integer greater than zero.＼

~UAは、 `一行分の字数$を［ ~serverが選好する 各~行lごとの文字~数を表す，利用者への~hint ］として利用してヨイ（例： 視覚的な~UAにおいては、 ~controlの横幅を その文字~数にするなど）。 視覚的な描画においては、 ~UAは，描画~時に 各~行lが この文字~数を超えないように 利用者の入力を折返すベキである。 ◎ The user agent may use the textarea element's character width as a hint to the user as to how many characters the server prefers per line (e.g. for visual user agents by making the width of the control be that many characters). In visual renderings, the user agent should wrap the user's input in the rendering so that each line is no wider than this number of characters.

【 `一行分の字数$は、 原文では “`character width^en” と称されている （そのまま訳すと “文字横幅” になり，紛らわしい）。 下の “`行数$（ `character height^en ）” も同様。 】【 各~文字の~~字幅の違い（全角と半角など）を どう取扱うかについては、 この仕様には述べられていない。 】

``rows@a 属性は、 `行数$ — 利用者に示す行l数 — を指定する。 この属性に指定する値は、 1 以上の`妥当な負でない整数$でなければナラナイ。 ◎ The rows attribute specifies the number of lines to show. If the rows attribute is specified, its value must be a valid non-negative integer greater than zero.＼

視覚的な~UAは、 ~controlの縦幅を`行数$で与えられる行l数に設定するベキである。 ◎ Visual user agents should set the height of the control to the number of lines given by character height.

``wrap@a 属性は，`列挙d属性$であり、 次に挙げる~keyword, とり得る状態, それらの対応付けが定義される： ◎ The wrap attribute is an enumerated attribute with the following keywords and states:

この属性の［ `欠落~値~用の既定の状態$／`妥当でない値~用の既定の状態$ ］は、 `Soft$st とする。 ◎ The attribute's missing value default and invalid value default are both the Soft state.

要素は、 `Hard$st 状態にある場合は， ``cols$a 属性も指定されなければナラナイ。 ◎ If the element's wrap attribute is in the Hard state, the cols attribute must be specified.

歴史的な理由から、 要素の値は，それぞれ目的が異なる 3 通りの仕方で正規化される： ◎ For historical reasons, the element's value is normalized in three different ways for three different purposes.＼

• ``生の値$は、 元々設定された値を表す。 それは正規化されない。 ◎ The raw value is the value as it was originally set. It is not normalized.＼
• `~API値$feは［ ``value$m, ``textLength$m ~IDL属性, および `maxlength$a, `minlength$a 内容~属性 ］に利用される値を表す。 それは、 改行には常に `LF^i を利用するよう正規化される。 ◎ The API value is the value used in the value IDL attribute, textLength IDL attribute, and by the maxlength and minlength content attributes. It is normalized so that line breaks use U+000A LINE FEED (LF) characters.＼
• 最後に，［ ~form提出／この仕様における他の処理~model ］に利用される`値$feがある。 それは、 `~API値$feと同じように正規化される。 加えて、 要素が ``wrap$a 属性を有する下では，必要yなら、 ~textを所与の字数で折返すために，追加的な改行も挿入される。 ◎ Finally, there is the value, as used in form submission and other processing models in this specification. It is normalized as for the API value, and in addition, if necessary given the element's wrap attribute, additional line breaks are inserted to wrap the text at the given width.

``maxlength@a 属性は、 ~form~control `maxlength^a 属性 である。 ◎ The maxlength attribute is a form control maxlength attribute.

［ `textarea$e 要素の`値に許容される最大~長さ$ ~NEQ ε ］の場合、 要素の子たちは，次を満たすようにするモノトスル ⇒ 次の結果の`長さ$ ~LTE 要素の`値に許容される最大~長さ$ ⇒ `改行文字を正規化する$( 要素の`子孫~text内容$ ) ◎ If the textarea element has a maximum allowed value length, then the element's children must be such that the length of the value of the element's descendant text content with newlines normalized is less than or equal to the element's maximum allowed value length.

``minlength@a 属性は、 ~form~control `minlength^a 属性 である。 ◎ The minlength attribute is a form control minlength attribute.

``required@a 属性は、 `真偽-属性$である。 指定されたときは、 利用者には，~formを提出する前に値を手入力することが 要求されることになる。 ◎ The required attribute is a boolean attribute. When specified, the user will be required to enter a value before submitting the form.

拘束~検証 ⇒ 要素が次を満たしている間は、 `欠落である難あり$になる ⇒ ［ 要素は ``required$a を有する ］~AND［ 要素は`変異-可能$feである ］~AND［ 要素の`値$fe ~EQ 空~文字列 ］ ◎ Constraint validation: If the element has its required attribute specified, and the element is mutable, and the element's value is the empty string, then the element is suffering from being missing.

``placeholder@a 属性は、 `短い^em~hint（または単語や短い句）を表現する。 この属性は、 ~controlが値を有さないとき，利用者を援助する~dataを与えることが意図される。 この~hintは、 見本の値や，期待される形式についての概略的な記述にすることもできる。 ◎ The placeholder attribute represents a short hint (a word or short phrase) intended to aid the user with data entry when the control has no value. A hint could be a sample value or a brief description of the expected format.

``placeholder$a 属性は `label$e の代替として利用されるベキでない。 より長い~hintや他の助言的~textには、 `title$a 属性がより適切になる。 ◎ The placeholder attribute should not be used as an alternative to a label. For a longer hint or other advisory text, the title attribute is more appropriate.

~UAは、 要素の`値$feが空~文字列で ~controlが`~focusされ$ていないときには、 この~hintを（当の~controlの内側に表示するなどして）利用者に呈示するベキである。 ~hintの描画-時には，~hint内の各［ ［ `CR^i, `LF^i ］並び, および他の `CR^i, `LF^i ］は，改行として扱うモノトスル。 ◎ User agents should present this hint to the user when the element's value is the empty string and the control is not focused (e.g. by displaying it inside a blank unfocused control). All U+000D CARRIAGE RETURN U+000A LINE FEED character pairs (CRLF) in the hint, as well as all other U+000D CARRIAGE RETURN (CR) and U+000A LINE FEED (LF) characters in the hint, must be treated as line breaks when rendering the hint.

~UAは、［ 当の~controlが`~focusされ$たとき、 通常は，この~hintを利用者に示さない ］場合でも，［ `autofocus$a 属性の結果として~focusされた場合には、 ~control用の~hintを示す ］ベキである — その事例では、 利用者が~focusする前に~controlを精査する機会は，無いので。 ◎ If a user agent normally doesn't show this hint to the user when the control is focused, then the user agent should nonetheless show the hint for the control if it was focused as a result of the autofocus attribute, since in that case the user will not have had an opportunity to examine the control before focusing it.

`textarea$e 要素の： ◎ ↓

• `name$a 属性は、 要素の名前を表現する。 ◎ The name attribute represents the element's name.＼
• `dirname$a 属性は、 要素の`方向性$がどう提出されるかを制御する。 ◎ The dirname attribute controls how the element's directionality is submitted.＼
• `disabled$a 属性は、 ~controlを対話的でなくして，その値は提出されないようにするために利用される。 ◎ The disabled attribute is used to make the control non-interactive and to prevent its value from being submitted.＼
• `form$a 属性は、 要素を ある`~form所有者$に明示的に所有させるために利用される。 ◎ The form attribute is used to explicitly associate the textarea element with its form owner.＼
• `autocomplete$a は、 ~UAが~autofillの挙動をどう供するかを制御する。 ◎ The autocomplete attribute controls how the user agent provides autofill behavior.

%textarea.``type$m

文字列 `textarea^l を返す。 ◎ Returns the string "textarea".

%textarea.``value$m

この要素の現在の値を返す。 ◎ Returns the current value of the element.

設定して値を変更できる。 ◎ Can be set, to change the value.

``dirName@m ~IDL属性は、 `dirname$a 内容~属性を`反映する$モノトスル。 ◎ The dirName IDL attribute must reflect the dirname content attribute.＼

``maxLength@m ~IDL属性は、 `負でない整数のみに制限され$る下で， ``maxlength$a 内容~属性を`反映する$モノトスル。 ◎ The maxLength IDL attribute must reflect the maxlength content attribute, limited to only non-negative numbers.＼

``minLength@m ~IDL属性は、 `負でない整数のみに制限され$る下で， ``minlength$a 内容~属性を`反映する$モノトスル。 ◎ The minLength IDL attribute must reflect the minlength content attribute, limited to only non-negative numbers.＼

``readOnly@m ~IDL属性は、 ``readonly$a 内容~属性を`反映する$モノトスル。 ◎ The readOnly IDL attribute must reflect the readonly content attribute.

`textarea$e 要素には、 次に挙げる~IDL~memberもある： ◎ ↓

• 次に挙げるものは、 `拘束~検証~API$の一部を成す ⇒＃ `willValidate$m, `validity$m, `validationMessage$m, `checkValidity()$m, `reportValidity()$m, `setCustomValidity()$m ◎ The willValidate, validity, and validationMessage IDL attributes, and the checkValidity(), reportValidity(), and setCustomValidity() methods, are part of the constraint validation API.＼
• `labels$m は、 要素を指している `label$e からなる~listを供する。 ◎ The labels IDL attribute provides a list of the element's labels.＼
• ［ `select()$m ／ `selectionStart$m ／ `selectionEnd$m ／ `selectionDirection$m ／ `setRangeText()$m ／ `setSelectionRange()$m ］は、 要素の~text選択を公開する。 ◎ The select(), selectionStart, selectionEnd, selectionDirection, setRangeText(), and setSelectionRange() methods and IDL attributes expose the element's text selection.＼
• 次に挙げるものは、 要素の~form~APIの一部を成す ⇒＃ `disabled$m, `form$m, `name$m ◎ The disabled, form, and name IDL attributes are part of the element's forms API.

4.10.12. ``output^e 要素

`分類$

`~flow内容$ ／ `句ng内容$ ／ `可触~内容$ ／ ◎ Flow content. ◎ Phrasing content. ◎ Listed, labelable, resettable, and autocapitalize-and-autocorrect inheriting form-associated element. ◎ Palpable content.

`~formに所有され得る要素$のうち［ `~listされる$ ／ `~label可能$な ／ `再設定-可能$な ／ `自動頭字化-と自動訂正-を継承-$する ］もの ◎ ↑

`この要素を利用できる文脈$

`句ng内容$が期待される所。 ◎ Where phrasing content is expected.

`内容~model$

`句ng内容$。 ◎ Phrasing content.

`text/html における~tag省略$

両~tagとも省略不可。 ◎ Neither tag is omissible.

`内容~属性$

`大域~属性$ ◎ Global attributes

``for$a — この出力を計算させた~controlを指定する。 ◎ for — Specifies controls from which the output was calculated

`form$a — この要素の所有者にする `form$e 要素を与える。 ◎ form — Associates the element with a form element

`name$a — `form.elements$m ~APIにおいて利用する，この要素の名前。 ◎ name — Name of the element to use in the form.elements API.

`~accessibilityの考慮点$

`output$AA ◎ For authors. For implementers.

`~DOM~interface$

[Exposed=Window]
interface `HTMLOutputElement@I : `HTMLElement$I {
  [`HTMLConstructor$] constructor();

  [SameObject, PutForwards=`value$m] readonly attribute `DOMTokenList$I ``htmlFor$m;
  readonly attribute `HTMLFormElement$I? `form$m;
  [`CEReactions$] attribute DOMString `name$m;

  readonly attribute DOMString ``type$m;
  [`CEReactions$] attribute DOMString ``defaultValue$m;
  [`CEReactions$] attribute DOMString ``value$m;

  readonly attribute boolean `willValidate$m;
  readonly attribute `ValidityState$I `validity$m;
  readonly attribute DOMString `validationMessage$m;
  boolean `checkValidity$m();
  boolean `reportValidity$m();
  undefined `setCustomValidity$m(DOMString %error);

  readonly attribute `NodeList$I `labels$m;
};

`output$e 要素は、［ ~appにより遂行された計算の結果 ／ 利用者~動作の結果 ］を`表現-$する。 ◎ The output element represents the result of a calculation performed by the application, or the result of a user action.

注記： この要素は、 `samp$e 要素と対照をなす — それは、 以前に走らせた他の~programの出力を引用するときに，適切な要素になる。 ◎ This element can be contrasted with the samp element, which is the appropriate element for quoting the output of other programs run previously.

``for@a 内容~属性は、 計算の結果と［ 計算に［ 取り込まれた／波及した ］値を表現する要素 ］との間に，明示的な関係性を与えれるようにする。 この属性に指定する値は、 `~space等で分離された~token集合$（一意）であって，その各~tokenは［ 同じ`~tree$内に在る，ある要素 ］の`~ID$の値を与えていなければナラナイ。 ◎ The for content attribute allows an explicit relationship to be made between the result of a calculation and the elements that represent the values that went into the calculation or that otherwise influenced the calculation. The for attribute, if specified, must contain a string consisting of an unordered set of unique space-separated tokens, none of which are identical to another token and each of which must have the value of an ID of an element in the same tree.

`output$e 要素の： ◎ ↓

• `form$a 属性は、 `output$e 要素を ある`~form所有者$に明示的に所有させるために利用される。 ◎ The form attribute is used to explicitly associate the output element with its form owner.＼
• `name$a 属性は、 要素の名前を表現する。 ◎ The name attribute represents the element's name.＼

各 `output$e 要素には、 ~form~controlの~event~handlerから容易に`参照-$できるように，~formに所有され得るが、 この要素の値が，~formの提出-時に提出されることはない。 ◎ The output element is associated with a form so that it can be easily referenced from the event handlers of form controls; the element's value itself is not submitted when the form is submitted.

各 `output$e 要素は、 ``上書き既定~値@ を有する — それは，文字列または ~NULL であり、 初期~時には ~NULL になるモノトスル。 ◎ The element has a default value override (null or a string). Initially it must be null.

各 `output$e 要素の ``既定~値@ は、 次を返す ⇒＃ 要素の``上書き既定~値$ ~NEQ ~NULL ならば それ ／ ~ELSE_ 要素の`子孫~text内容$ ◎ The element's default value is determined by the following steps: • If this element's default value override is non-null, then return it. • Return this element's descendant text content.

%output.``value$m [ = %value ]

この要素の現在の値を返す。 ◎ Returns the element's current value.

設定して，値を変更できる。 ◎ Can be set, to change the value.

%output.``defaultValue$m [ = %value ]

この要素の現在の既定の値を返す。 ◎ Returns the element's current default value.

設定して，既定の値を変更できる。 ◎ Can be set, to change the default value.

%output.``type$m

文字列 `output^l を返す。 ◎ Returns the string "output".

``htmlFor@m ~IDL属性は、 ``for$a 内容~属性を`反映する$モノトスル。 ◎ The htmlFor IDL attribute must reflect the for content attribute.

`output$e 要素には、 次に挙げる~IDL~memberもある： ◎ ↓

• 次に挙げるものは、 `拘束~検証~API$の一部を成す ⇒＃ `willValidate$m, `validity$m, `validationMessage$m, `checkValidity()$m, `reportValidity()$m, `setCustomValidity()$m ◎ The willValidate, validity, and validationMessage IDL attributes, and the checkValidity(), reportValidity(), and setCustomValidity() methods, are part of the constraint validation API.＼
• `labels$m は、 要素を指している `label$e からなる~listを供する。 ◎ The labels IDL attribute provides a list of the element's labels.＼
• 次に挙げるものは、 要素の~form~APIの一部を成す ⇒＃ `form$m, `name$m ◎ The form and name IDL attributes are part of the element's forms API.

4.10.13. ``progress^e 要素

`分類$

`~flow内容$ ／ `句ng内容$ ／ `可触~内容$ ／ `~label可能$な要素 ◎ Flow content. ◎ Phrasing content. ◎ Labelable element. ◎ Palpable content.

`この要素を利用できる文脈$

`句ng内容$が期待される所。 ◎ Where phrasing content is expected.

`内容~model$

`句ng内容$ — ただし、 子孫に `progress$e 要素が在ってはならない。 ◎ Phrasing content, but there must be no progress element descendants.

`text/html における~tag省略$

両~tagとも省略不可。 ◎ Neither tag is omissible.

`内容~属性$

`大域~属性$ ◎ Global attributes

``value$a — 要素の現在の値 ◎ value — Current value of the element

``max$a — 範囲の上界 ◎ max — Upper bound of range

`~accessibilityの考慮点$

`progress$AA ◎ For authors. For implementers.

`~DOM~interface$

[Exposed=Window]
interface `HTMLProgressElement@I : `HTMLElement$I {
  [`HTMLConstructor$] constructor();

  [`CEReactions$] attribute double ``value$m;
  [`CEReactions$] attribute double ``max$m;
  readonly attribute double ``position$m;
  readonly attribute `NodeList$I `labels$m;
};

`progress$e 要素は、 ~taskの完了~進捗を`表現-$する。 進捗は、［ `不定^i, `確定的^i ］のいずれかになる。 前者は、 進捗は ~taskが完了するまで どの程度~作業が残っているか明らかでないことを指示する（例：~taskは~remote~hostからの応答を待機しているなど）。 後者は、 それまでに完了した作業の進捗~率を { 0 〜 ある最大 } の範囲に入る数として与える。 ◎ The progress element represents the completion progress of a task. The progress is either indeterminate, indicating that progress is being made but that it is not clear how much more work remains to be done before the task is complete (e.g. because the task is waiting for a remote host to respond), or the progress is a number in the range zero to a maximum, giving the fraction of work that has so far been completed.

要素により表現される現在の~task完了を決定する 2 個の属性がある： ◎ There are two attributes that determine the current task completion represented by the element.＼

• ``value@a 属性は、 完了した~task量を指定する。 ◎ The value attribute specifies how much of the task has been completed, and＼
• ``max@a 属性は、 ~taskが要する作業の総量を指定する。 ◎ the max attribute specifies how much work the task requires in total.＼
• 両~属性とも、 単位は任意であり，指定されない。 ◎ The units are arbitrary and not specified.

注記： 進捗~barを `確定的^i にするためには、 ``value$a 属性に現在の進捗（ 0.0 〜 ``最大~値$ に入る数）を伴わせて追加する。 進捗~barを `不定^i にするためには、 ``value$a 属性を除去する。 ◎ To make a determinate progress bar, add a value attribute with the current progress (either a number from 0.0 to 1.0, or, if the max attribute is specified, a number from 0 to the value of the max attribute). To make an indeterminate progress bar, remove the value attribute.

作者には、 進捗が旧来の~UAの利用者からも可用になるよう，要素の内側に 現在の値と最大~値を~textとして~inlineに含めることも奨励される。 ◎ Authors are encouraged to also include the current value and the maximum value inline as text inside the element, so that the progress is made available to users of legacy user agents.

注記： `progress$e 要素を［ ~task進捗でない，単なる計器などの何か ］に利用するのは間違いである。 一例として、 `progress$e を利用して~disk消費量を指示するのは適切でない。 その種の事例には、 `meter$e 要素が用意されている。 ◎ The progress element is the wrong element to use for something that is just a gauge, as opposed to task progress. For instance, indicating disk space usage using progress would be inappropriate. Instead, the meter element is available for such use cases.

~UA要件 ⇒ 進捗~barは、［ ``value$a 属性が省略されたならば `不定^i ／ ~ELSE_ `確定的^i ］にする。 ◎ User agent requirements: If the value attribute is omitted, then the progress bar is an indeterminate progress bar. Otherwise, it is a determinate progress bar.

進捗~barが `確定的^i であるならば、 ~UAは，当の要素 %要素 の： ◎ ↓

• ``最大~値@ を次に従って得るモノトスル：

  1. %属性~値 ~LET %要素 は ``max$a 属性を［ 有するならば その値／ 有さないならば ε ］
  2. ~IF［ %属性~値 ~EQ ε ］ ⇒ ~RET 1.0
  3. %最大 ~LET `浮動小数点数として構文解析する$( %属性~値 )
  4. ~IF［ %最大 ~EQ `失敗^i ］ ⇒ ~RET 1.0
  5. ~IF［ %最大 ~LTE 0 ］ ⇒ ~RET 1.0
  6. ~RET %最大
  ◎ If the progress bar is a determinate progress bar and the element has a max attribute, the user agent must parse the max attribute's value according to the rules for parsing floating-point number values. If this does not result in an error, and if the parsed value is greater than zero, then the maximum value of the progress bar is that value. Otherwise, if the element has no max attribute, or if it has one but parsing it resulted in an error, or if the parsed value was less than or equal to zero, then the maximum value of the progress bar is 1.0.

• ``値@ を次に従って得るモノトスル：

  1. ~Assert： %要素 は ``value$a 属性を有する
  2. %値 ~LET `浮動小数点数として構文解析する$( %要素 の ``value$a 属性の値 )
  3. ~IF［ %値 ~NEQ `失敗^i ］~AND［ %値 ~GT 0 ］ ⇒ ~RET %値
  4. ~RET 0
  ◎ If the progress bar is a determinate progress bar, user agents must parse the value attribute's value according to the rules for parsing floating-point number values. If this does not result in an error and the parsed value is greater than zero, then the value of the progress bar is that parsed value. Otherwise, if parsing the value attribute's value resulted in an error or a number less than or equal to zero, then the value of the progress bar is zero.

• ``現在の値@ を次に従って得るモノトスル：

  1. %値 ~LET %要素 の``値$
  2. %最大~値 ~LET %要素 の``最大~値$
  3. ~IF［ %値 ~LTE %最大~値 ］ ⇒ ~RET %値
  4. ~RET %最大~値
  ◎ If the progress bar is a determinate progress bar, then the current value is the maximum value, if value is greater than the maximum value, and value otherwise.

%progress.``position$m

`確定的^i な進捗~bar（現在の最大~値が既知であるもの）に対しては［ 現在の値 ÷ 最大~値 ］を返す。 ◎ For a determinate progress bar (one with known current and maximum values), returns the result of dividing the current value by the maximum value.

`不定^i な進捗~barに対しては −1 を返す。 ◎ For an indeterminate progress bar, returns −1.

``max@m ~IDL属性は、 `正な数のみに制限され$る, かつ`既定の値$は 1.0 とする下で， ``max$a 内容~属性を`反映する$モノトスル。 ◎ The max IDL attribute must reflect the content attribute of the same name, limited to only positive numbers. The default value for max is 1.0.

`progress$e 要素には、 次に挙げる~IDL~memberもある ⇒ `labels$m は、 要素を指している `label$e からなる~listを供する。 ◎ The labels IDL attribute provides a list of the element's labels.

4.10.14. ``meter^e 要素

`分類$

`~flow内容$ ／ `句ng内容$ ／ `可触~内容$ ／ `~label可能$な要素 ◎ Flow content. ◎ Phrasing content. ◎ Labelable element. ◎ Palpable content.

`この要素を利用できる文脈$

`句ng内容$が期待される所。 ◎ Where phrasing content is expected.

`内容~model$

`句ng内容$ — ただし、 子孫に `meter$e 要素が在ってはならない。 ◎ Phrasing content, but there must be no meter element descendants.

`text/html における~tag省略$

両~tagとも省略不可。 ◎ Neither tag is omissible.

`内容~属性$

`大域~属性$ ◎ Global attributes

``value$a — 要素の現在の値 ◎ value — Current value of the element

``min$a — 範囲の下界 ◎ min — Lower bound of range

``max$a — 範囲の上界 ◎ max — Upper bound of range

``low$a — 低域の上限 ◎ low — High limit of low range

``high$a — 高域の下限 ◎ high — Low limit of high range

``optimum$a — 計器における最適~値 ◎ optimum — Optimum value in gauge

`~accessibilityの考慮点$

`meter$AA ◎ For authors. For implementers.

`~DOM~interface$

[Exposed=Window]
interface `HTMLMeterElement@I : `HTMLElement$I {
  [`HTMLConstructor$] constructor();

  [`CEReactions$] attribute double ``value$m;
  [`CEReactions$] attribute double ``min$m;
  [`CEReactions$] attribute double ``max$m;
  [`CEReactions$] attribute double ``low$m;
  [`CEReactions$] attribute double ``high$m;
  [`CEReactions$] attribute double ``optimum$m;
  readonly attribute `NodeList$I `labels$m;
};

`meter$e 要素は、［ ある有界な範囲の中の一次元の測定／割合~値 ］を`表現-$する。 例えば： ~disk消費量 ／ ~query結果の関連度 ／ 特定候補に対する投票割合 ◎ The meter element represents a scalar measurement within a known range, or a fractional value; for example disk usage, the relevance of a query result, or the fraction of a voting population to have selected a particular candidate.

これは、 計器（ `gauge^en ）とも呼ばれる。 ◎ This is also known as a gauge.

`meter$e 要素は、 （進捗~barのような）進捗を指示するために利用されるベキでない。 その役割には、 `progress$e 要素が別途~用意されている。 ◎ The meter element should not be used to indicate progress (as in a progress bar). For that role, HTML provides a separate progress element.

注記： `meter$e 要素は、 有界でない範囲の一次元の値は表現しない — 既知な最大~値がない限り、 例えばこれを，体重や身長を報告するために利用するのは間違いである。 ◎ The meter element also does not represent a scalar value of arbitrary range — for example, it would be wrong to use this to report a weight, or height, unless there is a known maximum value.

要素により表現される計器の意味論を決定する 6 個の属性がある： ◎ There are six attributes that determine the semantics of the gauge represented by the element.

他の 3 個の属性は、 計器の範囲を［ “低域”, “中域”, “高域” ］に区分し，計器のどの域が “最適な域” になるかを指示するために利用できる： ◎ The other three attributes can be used to segment the gauge's range into "low", "medium", and "high" parts, and to indicate which part of the gauge is the "optimum" part.＼

• ［ ``low@a ／ ``high@a ］属性は、［ “低域” ／ “高域” ］と見なされる範囲を指定する。 ◎ The low attribute specifies the range that is considered to be the "low" part, and the high attribute specifies the range that is considered to be the "high" part.＼
• ``optimum@a 属性は、 “最適とされる位置” を与える — それが［ 低域 ／ 中域 ／ 高域 ］に入る場合、 値は［ 低いほど良い ／ 高過ぎても低過ぎても良くない ／ 高いほど良い ］ことを指示する。 ◎ The optimum attribute gives the position that is "optimum"; if that is higher than the "high" value then this indicates that the higher the value, the better; if it's lower than the "low" mark then it indicates that lower values are better, and naturally if it is in between then it indicates that neither high nor low values are good.

著作~要件： ◎ Authoring requirements:＼

• ``value$a 属性は、 指定されなければナラナイ。 ◎ The value attribute must be specified.＼
• 次に挙げる属性に指定する値は、 `妥当な浮動小数点数$でなければナラナイ ⇒ ``value$a, ``min$a, ``low$a, ``high$a, ``max$a, ``optimum$a ◎ The value, min, low, high, max, and optimum attributes, when present, must have values that are valid floating-point numbers.

• ［ ``value$a ／ ``low$a ／ ``high$a ／ ``optimum$a ］属性に指定する値が表現する実数は、 次に与える %最小 以上, %最大 以下でなければナラナイ：

  • %最小 は［ 要素は ``min$a 属性を有するならば その値が表現する実数 ／ ~ELSE_ 0 ］
  • %最大 は［ 要素は ``max$a 属性を有するならば その値が表現する実数 ／ ~ELSE_ 1.0 ］
  ◎ In addition, the attributes' values are further constrained: ◎ Let value be the value attribute's number. ◎ If the min attribute is specified, then let minimum be that attribute's value; otherwise, let it be zero. ◎ If the max attribute is specified, then let maximum be that attribute's value; otherwise, let it be 1.0. ◎ The following inequalities must hold, as applicable: • minimum ≤ value ≤ maximum • minimum ≤ low ≤ maximum (if low is specified) • minimum ≤ high ≤ maximum (if high is specified) • minimum ≤ optimum ≤ maximum (if optimum is specified)
• ［ ``low$a, ``high$a ］両~属性に値を指定する場合、［ ``low$a が表現する実数 ~LT ``high$a が表現する実数 ］でなければナラナイ ◎ • low ≤ high (if both low and high are specified)

注記： 最小も最大も指定されない場合の範囲は， 0 以上 1 以下と見做されるので、 値は，その範囲に入る必要がある。 ◎ If no minimum or maximum is specified, then the range is assumed to be 0..1, and the value thus has to be within that range.

作者には、 `meter$e 要素を~supportしない~UAの利用者~用に，計器の状態の~textな表現を要素の内容に含めることが奨励される。 ◎ Authors are encouraged to include a textual representation of the gauge's state in the element's contents, for users of user agents that do not support the meter element.

`meter$e 要素の ``value$a 属性は、 `~microdata$と併用されるときは， 要素の機械読取可能な値を供する。 ◎ When used with microdata, the meter element's value attribute provides the element's machine-readable value.

`meter$e 要素に明示的に単位を指定する仕方は無いが、 単位は `title$a 属性~内に自由-形な~textとして指定してもヨイ。 ◎ There is no explicit way to specify units in the meter element, but the units may be specified in the title attribute in free-form text.

~UA要件は、 以下に与えられる。 ◎ User agent requirements:＼

~UAは、 次に挙げる属性の値を`浮動小数点数として構文解析する$モノトスル ⇒＃ ``min$a, ``max$a, ``value$a, ``low$a, ``high$a, ``optimum$a ◎ User agents must parse the min, max, value, low, high, and optimum attributes using the rules for parsing floating-point number values.

~UAは、 これらすべての実数を利用して，次に従って，計器~上の 6 点pを与える値を得するモノトスル（評価される順序は重要になる — 一部の値は、 先に得られた結果に基づくので）： ◎ User agents must then use all these numbers to obtain values for six points on the gauge, as follows. (The order in which these are evaluated is important, as some of the values refer to earlier ones.)

1. 以下においては：

   • `N^op( %属性, %既定~値 ) という表記は、 次の結果を表すとする：

     1. %属性~値 ~LET 要素は %属性 を［ 有するならば その値／ 有さないならば ε ］

     2. ~IF［ %属性~値 ~NEQ ε ］：

        1. %結果 ~LET `浮動小数点数として構文解析する$( %属性~値 )
        2. ~IF［ %結果 ~NEQ `失敗^i ］ ⇒ ~RET %結果
     3. ~RET %既定~値
   • `min^op(…), `max^op(…) は、 順に，所与の引数たちの最小, 最大をとる関数とする。
   ◎ ↓
2. ``最小~値@ は、 次で与えられる ⇒ `N^op( ``min$a, 0 ) ◎ The minimum value ◎ If the min attribute is specified and a value could be parsed out of it, then the minimum value is that value. Otherwise, the minimum value is zero.
3. ``最大~値@ は、 次で与えられる ⇒ `max^op ( ``最小~値$, `N^op( ``max$a, 1.0 ) ) ◎ The maximum value ◎ If the max attribute is specified and a value could be parsed out of it, then the candidate maximum value is that value. Otherwise, the candidate maximum value is 1.0. ◎ If the candidate maximum value is greater than or equal to the minimum value, then the maximum value is the candidate maximum value. Otherwise, the maximum value is the same as the minimum value.
4. ``実際の値@ は、 次で与えられる ⇒ `min^op( `max^op( ``最小~値$, `N^op( ``value$a, 0 ) ), ``最大~値$ ) ◎ The actual value ◎ If the value attribute is specified and a value could be parsed out of it, then that value is the candidate actual value. Otherwise, the candidate actual value is zero. ◎ If the candidate actual value is less than the minimum value, then the actual value is the minimum value. ◎ Otherwise, if the candidate actual value is greater than the maximum value, then the actual value is the maximum value. ◎ Otherwise, the actual value is the candidate actual value.
5. ``下界@ は、 次で与えられる ⇒ `min^op( `max^op( ``最小~値$, `N^op( ``low$a, ``最小~値$ ) ), ``最大~値$ ) ◎ The low boundary ◎ If the low attribute is specified and a value could be parsed out of it, then the candidate low boundary is that value. Otherwise, the candidate low boundary is the same as the minimum value. ◎ If the candidate low boundary is less than the minimum value, then the low boundary is the minimum value. ◎ Otherwise, if the candidate low boundary is greater than the maximum value, then the low boundary is the maximum value. ◎ Otherwise, the low boundary is the candidate low boundary.
6. ``上界@ は、 次で与えられる ⇒ `min^op( `max^op( ``下界$, `N^op( ``value$a, ``最大~値$ ) ), ``最大~値$ ) ◎ The high boundary ◎ If the high attribute is specified and a value could be parsed out of it, then the candidate high boundary is that value. Otherwise, the candidate high boundary is the same as the maximum value. ◎ If the candidate high boundary is less than the low boundary, then the high boundary is the low boundary. ◎ Otherwise, if the candidate high boundary is greater than the maximum value, then the high boundary is the maximum value. ◎ Otherwise, the high boundary is the candidate high boundary.
7. ``最適~点p@ は、 次で与えられる ⇒ `min^op( `max^op( ``最小~値$, %N ) ), ``最大~値$ ) — ここで ⇒ %N ~EQ `N^op( ``optimum$a, ( ( ``最小~値$ + ``最大~値$ ) ÷ 2 ) ) ◎ The optimum point ◎ If the optimum attribute is specified and a value could be parsed out of it, then the candidate optimum point is that value. Otherwise, the candidate optimum point is the midpoint between the minimum value and the maximum value. ◎ If the candidate optimum point is less than the minimum value, then the optimum point is the minimum value. ◎ Otherwise, if the candidate optimum point is greater than the maximum value, then the optimum point is the maximum value. ◎ Otherwise, the optimum point is the candidate optimum point.

これらすべての結果は、 次の不等式を満たす： ◎ All of which will result in the following inequalities all being true:

• 最小~値 ~LTE 実際の値 ~LTE 最大~値 ◎ minimum value ≤ actual value ≤ maximum value
• 最小~値 ~LTE 下界 ~LTE 上界 ~LTE 最大~値 ◎ minimum value ≤ low boundary ≤ high boundary ≤ maximum value
• 最小~値 ~LTE 最適~点p ~LTE 最大~値 ◎ minimum value ≤ optimum point ≤ maximum value

計器の各~域に対する~UA要件： ◎ UA requirements for regions of the gauge:＼

• ［ ``下界$ ~LTE 最適~点p ~LTE ``上界$ ］の場合、 計器の { ``下界$ 〜 ``上界$ } 域を，最適~域として扱うモノトスル。 ◎ If the optimum point is equal to the low boundary or the high boundary, or anywhere in between them, then the region between the low and high boundaries of the gauge must be treated as the optimum region, and the low and high parts, if any, must be treated as suboptimal.＼
• ［ 最適~点p ~LT ``下界$ ］の場合、 { ``最小~値$ 〜 ``下界$ } 域を，最適~域として扱うモノトスル。 ◎ Otherwise, if the optimum point is less than the low boundary, then the region between the minimum value and the low boundary must be treated as the optimum region, the region from the low boundary up to the high boundary must be treated as a suboptimal region, and the remaining region must be treated as an even less good region.＼
• ［ 最適~点p ~GT ``上界$ ］の場合、 { ``上界$ 〜 ``最大~値$ } 域を，最適~域として扱うモノトスル。 ◎ Finally, if the optimum point is higher than the high boundary, then the situation is reversed; the region between the high boundary and the maximum value must be treated as the optimum region, the region from the high boundary down to the low boundary must be treated as a suboptimal region, and the remaining region must be treated as an even less good region.
• いずれの場合も、 他の域は，最適とされる域から遠いほど 最適でないものと扱うモノトスル。 ◎ ↑

計器を示すときの~UA要件 ⇒ `meter$e 要素を利用者~向けに表現するときは、 ~UAは，［ 最小／最大 ］値から相対的な実際の値の位置, および 実際の値と計器の 3 域との関係性を指示するベキである。 ◎ UA requirements for showing the gauge: When representing a meter element to the user, the UA should indicate the relative position of the actual value to the minimum and maximum values, and the relationship between the actual value and the three regions of the gauge.

~UAは、 `title$a 属性や他の属性の値を組合せて，文脈に応じた~helpや実際の値の詳細を~~述べる~textを~inlineに供してヨイ。 ◎ User agents may combine the value of the title attribute and the other attributes to provide context-sensitive help or inline text detailing the actual values.

`meter$e 要素には、 次に挙げる~IDL~memberもある ⇒ `labels$m は、 要素を指している `label$e からなる~listを供する。 ◎ The labels IDL attribute provides a list of the element's labels.

4.10.15. ``fieldset^e 要素

`分類$

`~flow内容$ ／ `可触~内容$ ◎ Flow content. ◎ Listed and autocapitalize-and-autocorrect inheriting form-associated element. ◎ Palpable content.

`~formに所有され得る要素$のうち［ `~listされる$ ／ `自動頭字化-と自動訂正-を継承-$する ］もの ◎ ↑

`この要素を利用できる文脈$

`~flow内容$が期待される所。 ◎ Where flow content is expected.

`内容~model$

［［ 0 〜 1 個の `legend$e 要素 ］, `~flow内容$ ］の並び。 ◎ Optionally a legend element, followed by flow content.

`text/html における~tag省略$

両~tagとも省略不可。 ◎ Neither tag is omissible.

`内容~属性$

`大域~属性$ ◎ Global attributes

``disabled$a — この~form~controlの子孫のうち［ `legend$e の内側にあるもの以外のもの ］は不能化される。 ◎ disabled — Whether the descendant form controls, except any inside legend, are disabled

`form$a — この要素の所有者にする `form$e 要素を与える。 ◎ form — Associates the element with a form element

`name$a — `form.elements$m ~APIにおいて利用する，この要素の名前。 ◎ name — Name of the element to use in the form.elements API.

`~accessibilityの考慮点$

`fieldset$AA ◎ For authors. For implementers.

`~DOM~interface$

[Exposed=Window]
interface `HTMLFieldSetElement@I : `HTMLElement$I {
  [`HTMLConstructor$] constructor();

  [`CEReactions$] attribute boolean ``disabled$m;
  readonly attribute `HTMLFormElement$I? `form$m;
  [`CEReactions$] attribute DOMString `name$m;

  readonly attribute DOMString ``type$m;

  [SameObject] readonly attribute `HTMLCollection$I ``elements$m;

  readonly attribute boolean `willValidate$m;
  [SameObject] readonly attribute `ValidityState$I `validity$m;
  readonly attribute DOMString `validationMessage$m;
  boolean `checkValidity$m();
  boolean `reportValidity$m();
  undefined `setCustomValidity$m(DOMString %error);
};

`fieldset$e 要素が ``disabled@a 属性を有する場合、 要素の`~legend$を除く，要素~内のすべての~form~controlを`不能化する＠~HTMLforms#concept-fe-disabled$。 ◎ The disabled attribute, when specified, causes all the form control descendants of the fieldset element, excluding those that are descendants of the fieldset element's first legend element child, if any, to be disabled.

`fieldset$e 要素は、 ~OR↓ を満たすとき ``不能化されて@ いるとされる： ◎ A fieldset element is a disabled fieldset if it matches any of the following conditions:

• ``disabled$a 属性を有する ◎ Its disabled attribute is specified

• ~AND↓ を満たす，別の `fieldset$e %F が在る：

  • ``disabled$a 属性を有する
  • 要素 ~IN { %F の子孫 }
  • 要素 ~NIN { %F の`~legend$の子孫 }
  ◎ It is a descendant of another fieldset element whose disabled attribute is specified, and is not a descendant of that fieldset element's first legend element child, if any.

`fieldset$e 要素の： ◎ ↓

• `form$a 属性は、 要素を ある`~form所有者$に明示的に所有させるために利用される。 ◎ The form attribute is used to explicitly associate the fieldset element with its form owner.＼
• `name$a 属性は、 要素の名前を表現する。 ◎ The name attribute represents the element's name.

%fieldset.``type$m

文字列 `fieldset^l を返す。 ◎ Returns the string "fieldset".

%fieldset.``elements$m

この要素~内にある~form~controlからなる `HTMLCollection$I を返す。 ◎ Returns an HTMLCollection of the form controls in the element.

``disabled@m ~IDL属性は、 ``disabled$a 内容~属性を`反映する$モノトスル。 ◎ The disabled IDL attribute must reflect the content attribute of the same name.

`fieldset$e 要素には、 次に挙げる~IDL~memberもある： ◎ ↓

• 次に挙げるものは、 `拘束~検証~API$の一部を成す ⇒＃ `willValidate$m, `validity$m, `validationMessage$m, `checkValidity()$m, `reportValidity()$m, `setCustomValidity()$m ◎ The willValidate, validity, and validationMessage attributes, and the checkValidity(), reportValidity(), and setCustomValidity() methods, are part of the constraint validation API.＼
• 次に挙げるものは、 要素の~form~APIの一部を成す ⇒＃ `form$m, `name$m ◎ The form and name IDL attributes are part of the element's forms API.

4.10.16. ``legend^e 要素

`分類$

なし。 ◎ None.

`この要素を利用できる文脈$

`fieldset$e 要素の`最初の子$として。 ◎ As the first child of a fieldset element.

`内容~model$

`句ng内容$。 加えて，`見出し内容$が~~混在していてもよい。 ◎ Phrasing content, optionally intermixed with heading content.

`text/html における~tag省略$

両~tagとも省略不可。 ◎ Neither tag is omissible.

`内容~属性$

`大域~属性$ ◎ Global attributes

`~accessibilityの考慮点$

`legend$AA ◎ For authors. For implementers.

`~DOM~interface$

[Exposed=Window]
interface `HTMLLegendElement@I : `HTMLElement$I {
  [`HTMLConstructor$] constructor();

  readonly attribute `HTMLFormElement$I? ``form$m;

  // `HTMLLegendElement$obsMb
};

`legend$e 要素は、 親が `fieldset$e 要素ならば，［ 自身以外の，親の内容 ］用の~captionを`表現-$する。 ◎ The legend element represents a caption for the rest of the contents of the legend element's parent fieldset element, if any.

%legend.``form$m

要素が属する `form$e 要素が［ 在るならば それ ／ 無いならば ~NULL ］を返す。 ◎ Returns the element's form element, if any, or null otherwise.