`input$e 要素は、
型を有する~data欄を`表現-$する
— それは,通例的には、
~dataを編集することを利用者に許容するためとして,~form~controlに伴われる。
◎
The input element represents a typed data field, usually with a form control to allow the user to edit the data.
`type@a
属性は、
要素の~data型(および,要素が表現する~control)を制御する。
この属性は,`列挙d属性$であり、
次に挙げる~keyword, とり得る状態, それらの対応付けが定義される:
◎
The type attribute controls the data type (and associated control) of the element. It is an enumerated attribute with the following keywords and states:
【
この訳では、
状態~名を単に[
~keywordの最初の文字だけ大文字にした文字列
]で表す
(概ね,原文の状態~名と一致する)。
原文の状態~名には,もう少し説明的なものもあるが、
この訳では,対応関係を簡明にすることを優先する。
】
この属性の[
`欠落~値~用の既定の状態$/`妥当でない値~用の既定の状態$
]は、
`Text$st とする。
◎
The attribute's missing value default and invalid value default are both the Text state.
これらの特能の挙動は、
各節に定義されるとおり,
`適用される$かどうかに依存する
(
`§ 内容~属性@#common-input-element-attributes$ /
`§ ~API@#common-input-element-apis$ /
`§ ~event@#common-input-element-events$
を見よ)。
◎
The behavior of these features depends on whether they apply or not, as defined in their various sections (q.v. for content attributes, for APIs, for events).
次の規範的でない表tに,各~状態に対しどの[
内容~属性 / ~IDL~member / ~event
]が`適用される$かを要約する
(表t内の “・” は適用されない / 他は適用される):
◎
The following table is non-normative and summarizes which of those content attributes, IDL attributes, methods, and events apply to each state:
【
`dirname$a 属性は[
`Reset$st, `Button$st
]状態にも`適用される$べきでは?
(`自動~方向性を伴う~formに所有され得る要素$の定義と整合でない)。
】
一部の`状態$には、
`値の無毒化~algo@
が定義される。
◎
Some states of the type attribute define a value sanitization algorithm.
要素の`値は~dirtyか$feは、
利用者が~controlとヤリトリして`値$feを変更したときには,
~T に設定するモノトスル
(また、
値が~program的に変更された場合も ~T に設定される
— `value$m ~IDL属性の定義に述べるとおり)。
◎
An input element's dirty value flag must be set to true whenever the user interacts with the control in a way that changes the value. (It is also set to true when the value is programmatically changed, as described in the definition of the value IDL attribute.)
各 要素は、
`~check有りか$feを有する
— それは、
`checked$m ~IDL属性により公開される。
◎
Each input element has a checkedness, which is exposed by the checked IDL attribute.
`checked@a
内容~属性は、
要素の既定の`~check有りか$feを与える`真偽-属性$である。
~UAは、[
~controlの`~check有無は~dirtyか$ ~EQ ~F
]の下で,
`checked$a 内容~属性が[
追加-/除去-
]されたときは、
要素の`~check有りか$feを[
~T / ~F
]に設定するモノトスル。
◎
The checked content attribute is a boolean attribute that gives the default checkedness of the input element. When the checked content attribute is added, if the control does not have dirty checkedness, the user agent must set the checkedness of the element to true; when the checked content attribute is removed, if the control does not have dirty checkedness, the user agent must set the checkedness of the element to false.
`不能化され$feた要素は、
`変異-可能$feでなくなる。
◎
When an input element is disabled, it is not mutable.
注記:
一部の事例(例えば `Date$st 状態は該当するが, `Checkbox$st 状態は該当しない)では、
`readonly$a 属性も要素を`変異-可能$feでなくする。
◎
The readonly attribute can also in some cases (e.g. for the Date state, but not the Checkbox state) stop an input element from being mutable.
要素は、
`~pickerを~support@
し得る。
~picker( `picker^en )とは、
値を選ぶことを末端-利用者に許容する~UI【!~UI要素】である。
要素が~pickerを~supportするかどうかは、[
その`状態$, `実装定義$な挙動
]に依存する。
要素は、
`File$st `状態$にあるときは,
~pickerを~supportするモノトスル。
◎
The input element can support a picker. A picker is a user interface element that allows the end user to choose a value. Whether an input element supports a picker depends on the type attribute state and implementation-defined behavior. An input element must support a picker when its type attribute is in the File Upload state.
要素~用の`~clone時の手続き$は、
所与の
( %~node, %複製, … )
に対し
⇒
%複製 の
⇒#
`値$fe ~SET %~node の`値$fe,
`値は~dirtyか$fe ~SET %~node の`値は~dirtyか$fe,
`~check有りか$fe ~SET %~node の`~check有りか$fe,
`~check有無は~dirtyか$ ~SET %~node の`~check有無は~dirtyか$
◎
The cloning steps for input elements given node, copy, and subtree are to propagate the value, dirty value flag, checkedness, and dirty checkedness flag from node to copy.
注記:
要素~用の`作動化の挙動$は[
利用者が起動した作動化,
合成な作動化(例: `el.click()^c を介するそれ)
]どちらに対しても走る一方で、
~UAは,所与の~control用に[
この仕様では指定されない,真に利用者が起動した作動化に限り誘発される挙動
]も備えるかもしれない。
共通な~~選択は、
当の~control用に,`適用-可能なら~pickerを示す$ことである。
対照的に,`~input作動化の挙動$は、[
`File$st / `Color$st
]`状態$にあるときの特別な歴史的~事例に限り,~pickerを示す。
◎
Recall that an element's activation behavior runs for both user-initiated activations and for synthetic activations (e.g., via el.click()). User agents might also have behaviors for a given control — not specified here — that are triggered only by true user-initiated activations. A common choice is to show the picker, if applicable, for the control. In contrast, the input activation behavior only shows pickers for the special historical cases of the File Upload and Color states.
`dirName@m
~IDL属性は、
`dirname$a 内容~属性を`反映する$モノトスル。
◎
The dirName IDL attribute must reflect the dirname content attribute.\
`readOnly@m
~IDL属性は、
`readonly$a 内容~属性を`反映する$モノトスル。
◎
The readOnly IDL attribute must reflect the readonly content attribute.\
`defaultChecked@m
~IDL属性は、
`checked$a 内容~属性を`反映する$モノトスル。
◎
The defaultChecked IDL attribute must reflect the checked content attribute.\
`defaultValue@m
~IDL属性は、
`value$a 内容~属性を`反映する$モノトスル。
◎
The defaultValue IDL attribute must reflect the value content attribute.
`colorSpace@m
~IDL属性は、
`既知な値のみに制限され$る下で,
`colorspace$a 内容~属性を`反映する$モノトスル。
◎
The colorSpace IDL attribute must reflect the colorspace content attribute, limited to only known values.\
`type@m
~IDL属性は、
`既知な値のみに制限され$る下で,
`type$a 内容~属性を`反映する$モノトスル。
◎
The type IDL attribute must reflect the respective content attribute of the same name, limited to only known values.\
`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.
[
`width$m / `height$m
]設定子は、[
`width$a / `height$a
]内容~属性を`反映して$いるかのように動作するモノトスル。
◎
On setting, they must act as if they reflected the respective content attributes of the same name.
4.10.5.1. `type$a 属性の各種 状態
4.10.5.1.1. `Hidden^st 状態( `type=hidden^c )
`Hidden$st `状態$にある `input$e 要素に対しては、
この節の規則が適用される。
◎
When an input element's type attribute is in the Hidden state, the rules in this section apply.
要素は、
利用者により[
精査-/操作-
]されないものと意図される値を`表現-$する。
◎
The input element represents a value that is not intended to be examined or manipulated by the user.
拘束~検証
⇒
この`状態$にある要素は、
`拘束~検証の対象外$になる。
◎
Constraint validation: If an input element's type attribute is in the Hidden state, it is barred from constraint validation.
要素の `value$a 属性は、
要素が次を満たす場合には省略されなければナラナイ
⇒
`name$a 属性を有していて,その値は "`_charset_$v" に`~ASCII大小無視$で合致する
◎
If the name attribute is present and has a value that is an ASCII case-insensitive match for "_charset_", then the element's value attribute must be omitted.
`Hidden^bk
`value$m ~IDL属性は、
`既定~mode$iになる。
◎
The autocomplete and dirname content attributes apply to this element.
◎
The value IDL attribute applies to this element and is in mode default.
◎
The following content attributes must not be specified and do not apply to the element: accept, alpha, alt checked, colorspace, formaction, formenctype, formmethod, formnovalidate, formtarget, height, list, max, maxlength, min, minlength, multiple, pattern, placeholder, popovertarget, popovertargetaction, readonly, required, size, src, step, and width.
◎
The following IDL attributes and methods do not apply to the element: checked, files, list, selectionStart, selectionEnd, selectionDirection, valueAsDate, and valueAsNumber IDL attributes; select(), setRangeText(), setSelectionRange(), stepDown(), and stepUp() methods.
◎
The input and change events do not apply.
4.10.5.1.2. `Text^st 状態( `type=text^c), `Search^st 状態( `type=search^c )
[
`Text$st / `Search$st
]`状態$にある `input$e 要素に対しては、
この節の規則が適用される。
◎
When an input element's type attribute is in the Text state or the Search state, the rules in this section apply.
要素は、
その`値$feを編集するための,一行の素な~text~controlを`表現-$する。
◎
The input element represents a one line plain text edit control for the element's value.
注記:
`Text$st 状態と `Search$st 状態との主な相違は,~style上のものでしかない。
~search~controlと定例の~text~controlとが判別されるような~platform上では、
`Search$st ~controlの外観は,定例の~text~controlのそれではなく,~platformの~search~controlの外観に合わせられるかもしれない。
◎
The difference between the Text state and the Search state is primarily stylistic: on platforms where search controls are distinguished from regular text controls, the Search state might result in an appearance consistent with the platform's search controls rather than appearing like a regular text control.
要素が`変異-可能$feな場合、
~UAは:
◎
If the element is mutable,\
-
次を利用者に許容するベキである
⇒
`値$feを編集する
◎
its value should be editable by the user.\
-
次を利用者に許容しないモノトスル
⇒
`値$feの中へ`改行文字$を挿入する
◎
User agents must not allow users to insert U+000A LINE FEED (LF) or U+000D CARRIAGE RETURN (CR) characters into the element's value.
-
次を利用者に許容するベキである
⇒
要素の書字~方向を[
左横書き, 右横書き
]いずれかに変更する
◎
If the element is mutable, the user agent should allow the user to change the writing direction of the element, setting it either to a left-to-right writing direction or a right-to-left writing direction.\
利用者がそれを行った場合、
次の手続きを走らすモノトスル:
◎
If the user does so, the user agent must then run the following steps:
-
要素の `dir$a 属性 ~SET
利用者が選択した書字~方向に応じて[
左横書きならば `ltr$v /
右横書きならば `rtl$v
]
◎
Set the element's dir attribute to "ltr" if the user selected a left-to-right writing direction, and "rtl" if the user selected a right-to-left writing direction.
-
`要素~taskを~queueする$( `利用者~対話~task~source$, 要素, 次の手続き )
◎
Queue an element task on the user interaction task source given the element to\
手続きは
⇒
`入力~eventを発火する$( 要素, `input$et )
◎
fire an event named input at the element, with the bubbles and composed attributes initialized to true.
`value$a 属性に指定する値は、
`改行文字$を含んではナラナイ。
◎
The value attribute, if specified, must have a value that contains no U+000A LINE FEED (LF) or U+000D CARRIAGE RETURN (CR) characters.
`値の無毒化~algo$
⇒
要素の`値$fe ~SET `改行文字を剥ぐ$( 要素の`値$fe )
◎
The value sanitization algorithm is as follows: Strip newlines from the value.
`Text^bk
`value$m ~IDL属性は、
`値~mode$iになる。
◎
The following common input element content attributes, IDL attributes, and methods apply to the element: autocomplete, dirname, list, maxlength, minlength, pattern, placeholder, readonly, required, and size content attributes; list, selectionStart, selectionEnd, selectionDirection, and value IDL attributes; select(), setRangeText(), and setSelectionRange() methods.
◎
The value IDL attribute is in mode value.
◎
The input and change events apply.
◎
The following content attributes must not be specified and do not apply to the element: accept, alpha, alt, checked, colorspace, formaction, formenctype, formmethod, formnovalidate, formtarget, height, max, min, multiple, popovertarget, popovertargetaction, src, step, and width.
◎
The following IDL attributes and methods do not apply to the element: checked, files, valueAsDate, and valueAsNumber IDL attributes; stepDown() and stepUp() methods.
4.10.5.1.3. `Tel^st 状態( `type=tel^c )
`Tel$st `状態$にある `input$e 要素に対しては、
この節の規則が適用される。
◎
When an input element's type attribute is in the Telephone state, the rules in this section apply.
要素は、
その`値$feにて与えられる電話~番号を編集するための~controlを`表現-$する。
◎
The input element represents a control for editing a telephone number given in the element's value.
要素が`変異-可能$feな場合、
~UAは:
◎
If the element is mutable,\
-
次を利用者に許容するベキである
⇒
`値$feを編集する
◎
its value should be editable by the user.\
-
アキを変更してもヨイ。
【例: 市外局番と残りの部分の合間。】
◎
User agents may change the spacing and,\
-
利用者が手入力した`値$feを成す約物を
— ~careの下で —
変更してもヨイ。
◎
with care, the punctuation of values that the user enters.\
-
次を利用者に許容しないモノトスル
⇒
`値$feの中へ`改行文字$を挿入する
◎
User agents must not allow users to insert U+000A LINE FEED (LF) or U+000D CARRIAGE RETURN (CR) characters into the element's value.
`value$a 属性に指定する値は、
`改行文字$を含んではナラナイ。
◎
The value attribute, if specified, must have a value that contains no U+000A LINE FEED (LF) or U+000D CARRIAGE RETURN (CR) characters.
`値の無毒化~algo$
⇒
要素の`値$fe ~SET `改行文字を剥ぐ$( 要素の`値$fe )
◎
The value sanitization algorithm is as follows: Strip newlines from the value.
注記:
`Url$st / `Email$st
型と違って、
`Tel$st 型は,特定0の構文を施行しない。
これは意図的である。
妥当な電話~番号は多様なので、
実施においては,電話~番号~欄は自由形にされる傾向にある。
特定0の形式を施行する必要がある~systemでは、
`pattern$a 属性や `setCustomValidity()$m ~methodを利用して,~client側の中に検証の仕組みを~hookすることが奨励される。
◎
Unlike the URL and Email types, the Telephone type does not enforce a particular syntax. This is intentional; in practice, telephone number fields tend to be free-form fields, because there are a wide variety of valid phone numbers. Systems that need to enforce a particular format are encouraged to use the pattern attribute or the setCustomValidity() method to hook into the client-side validation mechanism.
`Tel^bk
`value$m ~IDL属性は、
`値~mode$iになる。
◎
The following common input element content attributes, IDL attributes, and methods apply to the element: autocomplete, dirname, list, maxlength, minlength, pattern, placeholder, readonly, required, and size content attributes; list, selectionStart, selectionEnd, selectionDirection, and value IDL attributes; select(), setRangeText(), and setSelectionRange() methods.
◎
The value IDL attribute is in mode value.
◎
The input and change events apply.
◎
The following content attributes must not be specified and do not apply to the element: accept, alpha, alt, checked, colorspace, formaction, formenctype, formmethod, formnovalidate, formtarget, height, max, min, multiple, popovertarget, popovertargetaction, src, step, and width.
◎
The following IDL attributes and methods do not apply to the element: checked, files, valueAsDate, and valueAsNumber IDL attributes; stepDown() and stepUp() methods.
4.10.5.1.4. `Url^st 状態( `type=url^c )
`Url$st `状態$にある `input$e 要素に対しては、
この節の規則が適用される。
◎
When an input element's type attribute is in the URL state, the rules in this section apply.
要素は、
その`値$feにて与えられる単独の`絶対~URL$を編集するための~controlを`表現-$する。
◎
The input element represents a control for editing a single absolute URL given in the element's value.
要素が`変異-可能$feな場合、
~UAは:
◎
If the element is mutable,\
-
次を利用者に許容するベキである
⇒
`値$feが表現する~URLを変更する
◎
the user agent should allow the user to change the URL represented by its value.\
-
次を利用者に許容してもヨイ
⇒
`値$feを[
`妥当$urlな`絶対~URL$
]でない文字列に設定する
◎
User agents may allow the user to set the value to a string that is not a valid absolute URL,\
利用者がそれを行った場合、
`値$feが常に`妥当$urlな`絶対~URL$になるよう,
利用者が手入力した文字を自動的に~escapeしてもヨイ
(それが~~実在しない~URLで,利用者が~UI内で編集している場合でも)。
◎
but may also or instead automatically escape characters entered by the user so that the value is always a valid absolute URL (even if that isn't the actual value seen and edited by the user in the interface).\
-
次を利用者に許容するベキである
⇒
`値$feを空~文字列に設定する
◎
User agents should allow the user to set the value to the empty string.\
-
次を利用者に許容しないモノトスル
⇒
`値$feの中へ`改行文字$を挿入する
◎
User agents must not allow users to insert U+000A LINE FEED (LF) or U+000D CARRIAGE RETURN (CR) characters into the value.
`value$a 属性に指定する値は、[
空~文字列 / `絶対~URL$を与える`前後~空白~可の妥当な~URL$
]でなければナラナイ。
◎
The value attribute, if specified and not empty, must have a value that is a valid URL potentially surrounded by spaces that is also an absolute URL.
`値の無毒化~algo$
⇒
要素の`値$fe ~SET `前後の~ASCII空白~列を剥ぐ$( `改行文字を剥ぐ$( 要素の`値$fe ) )
◎
The value sanitization algorithm is as follows: Strip newlines from the value, then strip leading and trailing ASCII whitespace from the value.
拘束~検証
⇒
要素が次を満たしている間は、
`型~不一致の難あり$になる
⇒
要素の`値$feは 空~文字列でも`妥当$urlな`絶対~URL$でもない。
◎
Constraint validation: While the value of the element is neither the empty string nor a valid absolute URL, the element is suffering from a type mismatch.
`Url^bk
`value$m ~IDL属性は、
`値~mode$iになる。
◎
The following common input element content attributes, IDL attributes, and methods apply to the element: autocomplete, dirname, list, maxlength, minlength, pattern, placeholder, readonly, required, and size content attributes; list, selectionStart, selectionEnd, selectionDirection, and value IDL attributes; select(), setRangeText(), and setSelectionRange() methods.
◎
The value IDL attribute is in mode value.
◎
The input and change events apply.
◎
The following content attributes must not be specified and do not apply to the element: accept, alpha, alt, checked, colorspace, formaction, formenctype, formmethod, formnovalidate, formtarget, height, max, min, multiple, popovertarget, popovertargetaction, src, step, and width.
◎
The following IDL attributes and methods do not apply to the element: checked, files, valueAsDate, and valueAsNumber IDL attributes; stepDown() and stepUp() methods.
文書が次の~markupを包含していて:
◎
If a document contained the following markup:
`Url-1^xCode
利用者が
"spec.w"
と打込んだとき、
~UAも利用者が近過去に
`https://url.spec.whatwg.org/#url-parsing^c,
`https://streams.spec.whatwg.org/^c
を訪問したことを見出した場合、
描画は次の様になるであろう:
◎
...and the user had typed "spec.w", and the user agent had also found that the user had visited https://url.spec.whatwg.org/#url-parsing and https://streams.spec.whatwg.org/ in the recent past, then the rendering might look like this:
この見本の最初の 4 個の~URLは、
作者が指定した~list内の~URLのうち,利用者が手入力した~textに合致するものからなり、
`実装定義$な何らかの方式で~sortされている(例えば,利用者が~URLを指す~~頻度に基づいて)。
~UAは、
自身の知識を利用して,利用者が~scheme~~成分を省略しても値が~URLになるよう,~domain名に対し~intelligentな照合を遂行していることに注意。
◎
The first four URLs in this sample consist of the four URLs in the author-specified list that match the text the user has entered, sorted in some implementation-defined manner (maybe by how frequently the user refers to those URLs). Note how the UA is using the knowledge that the values are URLs to allow the user to omit the scheme part and perform intelligent matching on the domain name.
最後の 2 個の~URL( ~scrollbarが指示するように,おそらくもっと多くの~URLも可用である)は、
~UAの~session履歴~dataに合致するものとして~~示されている。
この~dataは,~pageの~DOMからは可用にはされない。
この事例では、
~UAは,それらの値に供する~titleはない。
◎
The last two URLs (and probably many more, given the scrollbar's indications of more values being available) are the matches from the user agent's session history data. This data is not made available to the page DOM. In this particular case, the UA has no titles to provide for those values.
4.10.5.1.5. `Email^st 状態( `type=email^c )
`Email$st `状態$にある `input$e 要素に対しては、
この節の規則が適用される。
◎
When an input element's type attribute is in the Email state, the rules in this section apply.
`Email$st 状態が値をどう演算するかは、
`multiple$a 属性が指定されたかどうかに依存する。
◎
How the Email state operates depends on whether the multiple attribute is specified or not.
-
要素に `multiple$a 属性が指定されなかった場合:
◎
When the multiple attribute is not specified on the element
-
要素は、
その`値$feにて与えられる~email~addressを編集するための~controlを`表現-$する。
◎
The input element represents a control for editing an email address given in the element's value.
要素が`変異-可能$feな場合、
~UAは:
◎
If the element is mutable,\
-
次を利用者に許容するベキである
⇒
`値$feが表現する~email~addressを変更する
◎
the user agent should allow the user to change the email address represented by its value.\
-
次を利用者に許容してもヨイ
⇒
`値$feを[
`妥当な~email~address$でない文字列
]に設定する
◎
User agents may allow the user to set the value to a string that is not a valid email address.\
-
利用者は単独の~email~addressを供するものと期待するので、
それに沿う方式で動作するベキである。
◎
The user agent should act in a manner consistent with expecting the user to provide a single email address.\
-
次を利用者に許容するベキである
⇒
`値$feを空~文字列に設定する
◎
User agents should allow the user to set the value to the empty string.\
-
次を利用者に許容しないモノトスル
⇒
`値$feの中へ`改行文字$を挿入する
◎
User agents must not allow users to insert U+000A LINE FEED (LF) or U+000D CARRIAGE RETURN (CR) characters into the value.\
-
`値$feを[
表示-/編集-
]用に変形してもヨイ
— 特に、[
`値$feの~domain~label内の~punycode
]と[
表示における~IDN
]とを相互に変換するベキである。
◎
User agents may transform the value for display and editing; in particular, user agents should convert punycode in the domain labels of the value to IDN in the display and vice versa.
拘束~検証
⇒
要素が次を満たしている間は、
`不良~入力の難あり$になる
⇒
~UIが~punycodeに変換できない入力を表現している
◎
Constraint validation: While the user interface is representing input that the user agent cannot convert to punycode, the control is suffering from bad input.
`value$a 属性に指定する値は、
次のいずれかでなければナラナイ
⇒#
空~文字列/
`妥当な~email~address$
◎
The value attribute, if specified and not empty, must have a value that is a single valid email address.
`値の無毒化~algo$
⇒
要素の`値$fe ~SET `前後の~ASCII空白~列を剥ぐ$( `改行文字を剥ぐ$( 要素の`値$fe ) )
◎
The value sanitization algorithm is as follows: Strip newlines from the value, then strip leading and trailing ASCII whitespace from the value.
拘束~検証
⇒
要素が次を満たしている間は、
`型~不一致の難あり$になる
⇒
要素の`値$feは,次のいずれでもない
⇒#
空~文字列,
`妥当な~email~address$
◎
Constraint validation: While the value of the element is neither the empty string nor a single valid email address, the element is suffering from a type mismatch.
-
要素に `multiple$a 属性が指定された場合:
◎
When the multiple attribute is specified on the element
-
要素は、
その`値~群$feにて与えられる一連の~email~addressを[
追加-/除去-/編集-
]するための~controlを`表現-$する。
◎
The input element represents a control for adding, removing, and editing the email addresses given in the element's values.
要素が`変異-可能$feな場合、
~UAは:
◎
If the element is mutable,\
-
次を利用者に許容するベキである
⇒
`値~群$feが表現する~email~addressたちを[
追加-/除去-/編集-
]する
◎
the user agent should allow the user to add, remove, and edit the email addresses represented by its values.\
-
次を利用者に許容してもヨイ
⇒
`値$feたちが成す~list内の個々の値を[
`妥当な~email~address$でない文字列
]に設定する
◎
User agents may allow the user to set any individual value in the list of values to a string that is not a valid email address,\
-
次を利用者に許容しないモノトスル
⇒
`値$feたちが成す~list内の個々の値を[
文字 `002C^U `,^smb /
`改行文字$
]を包含する文字列に設定する
◎
but must not allow users to set any individual value to a string containing U+002C COMMA (,), U+000A LINE FEED (LF), or U+000D CARRIAGE RETURN (CR) characters.\
-
次を利用者に許容するベキである
⇒
要素の`値~群$feを成す~addressすべてを除去する
◎
User agents should allow the user to remove all the addresses in the element's values.\
-
`値~群$feを[
表示-/編集-
]用に変形してもヨイ
— 特に、[
`値$feを成す~domain~label内の~punycode
]と[
表示における~IDN
]とを相互に変換するベキである。
◎
User agents may transform the values for display and editing; in particular, user agents should convert punycode in the domain labels of the value to IDN in the display and vice versa.
拘束~検証
⇒
要素が次を満たしている間は、
`不良~入力の難あり$になる
⇒
~UI内のある~email~address値が[
`002C^U `,^smb を包含している/
~punycodeに変換できない入力を表現している
]
◎
Constraint validation: While the user interface describes a situation where an individual value contains a U+002C COMMA (,) or is representing input that the user agent cannot convert to punycode, the control is suffering from bad input.
~UAは、
利用者が要素の`値~群$fe【!`値$feたち】を変更する度に,次の手続きを走らすモノトスル:
◎
Whenever the user changes the element's values, the user agent must run the following steps:
-
%~token群 ~LET « »
◎
↓
-
要素の`値~群$fe【!`値$feたち】を成す
~EACH( %~token )
に対し
⇒
%~token群 に次の結果を`付加する$
⇒
`前後の~ASCII空白~列を剥ぐ$( %~token )
◎
Let latest values be a copy of the element's values.
◎
Strip leading and trailing ASCII whitespace from each value in latest values.
-
要素の`値$fe ~SET %~token群 を `002C^U `,^smb で`連結する$
◎
Let the element's value be the result of concatenating all the values in latest values, separating each value from the next by a single U+002C COMMA character (,), maintaining the list's order.
`value$a 属性に指定する値は、
`妥当な~email~address~list$でなければナラナイ。
◎
The value attribute, if specified, must have a value that is a valid email address list.
`値の無毒化~algo$
◎
The value sanitization algorithm is as follows:
-
%~token群 ~LET `~commaで分割する$( 要素の`値$fe )
◎
Split on commas the element's value,\
-
%~token群 内の
~EACH( %~token )
を次の結果に置換する
⇒
`前後の~ASCII空白~列を剥ぐ$( %~token )
◎
strip leading and trailing ASCII whitespace from each resulting token, if any, and\
-
要素の`値~群$fe ~SET %~token群
(場合によっては空になり,各~tokenも場合によっては空~文字列になる)
◎
let the element's values be the (possibly empty) resulting list of (possibly empty) tokens, maintaining the original order.
-
要素の`値$fe ~SET %~token群 を `002C^U `,^smb で`連結する$
◎
Let the element's value be the result of concatenating the element's values, separating each value from the next by a single U+002C COMMA character (,), maintaining the list's order.
拘束~検証
⇒
要素が次を満たしている間は、
`型~不一致の難あり$になる
⇒
要素の`値$feは`妥当な~email~address~list$でない
◎
Constraint validation: While the value of the element is not a valid email address list, the element is suffering from a type mismatch.
`multiple$a 属性が[
設定-/除去-
]されたときは、
~UAは,`値の無毒化~algo$を走らすモノトスル。
◎
When the multiple attribute is set or removed, the user agent must run the value sanitization algorithm.
`妥当な~email~address@
は、
次の~ABNFによる `email^P 生成規則に合致する文字列である。
この~ABNFの文字~集合は、
~Unicodeとする。
この~ABNFは、
RFC 1123 に述べられる拡張を実装する。
`ABNF$r
`RFC5322$r
`RFC1034$r
`RFC1123$r
◎
A valid email address is a string that matches the email production of the following ABNF, the character set for which is Unicode. This ABNF implements the extensions described in RFC 1123. [ABNF] [RFC5322] [RFC1034] [RFC1123]
email
= 1*( atext / "." ) "@" label *( "." label )
label
= let-dig [ [ ldh-str ] let-dig ]
ここで:
-
`label^P の長さは、
`RFC 1034 § 3.5@~RFCx/rfc1034#section-3.5$
により, 63 文字までに制限される。
-
`atext^P は、
`RFC 5322 § 3.2.3@~RFCx/rfc5322#section-3.2.3$
に定義される。
-
`let-dig^P, `ldh-str^P は、
`RFC 1034 § 3.5@~RFCx/rfc1034#section-3.5$
に定義される。
email = 1*( atext / "." ) "@" label *( "." label )
label = let-dig [ [ ldh-str ] let-dig ] ; limited to a length of 63 characters by RFC 1034 section 3.5
atext = < as defined in RFC 5322 section 3.2.3 >
let-dig = < as defined in RFC 1034 section 3.5 >
ldh-str = < as defined in RFC 1034 section 3.5 >
注記:
この要件は、
~email~addressの構文を定義している RFC 5322 に対する`故意的な違反$である。
それは厳密~過ぎると同時に(文字 `@^l より前の部分),曖昧~過ぎでもあり(文字 `@^l より後の部分)、
ここでの実用には甘~過ぎる
(ほとんどの利用者にとって馴染みのない方式で[
~comment / 空白~文字 / 引用符付き文字列
]が許容されている)。
◎
This requirement is a willful violation of RFC 5322, which defines a syntax for email addresses that is simultaneously too strict (before the "@" character), too vague (after the "@" character), and too lax (allowing comments, whitespace characters, and quoted strings in manners unfamiliar to most users) to be of practical use here.
注記:
次の[
~JS/~perl
]に互換な正規表現は、
上の定義の実装を与える:
◎
The following JavaScript- and Perl-compatible regular expression is an implementation of the above definition.
~RxpEmail
`妥当な~email~address~list@
は、
各~tokenが`妥当な~email~address$であるような,`~commaで分離された~token集合$である。
実装は、
`妥当な~email~address~list$から~tokenたちが成す~listを得するときは、
`~commaで分割-$するモノトスル。
◎
A valid email address list is a set of comma-separated tokens, where each token is itself a valid email address. To obtain the list of tokens from a valid email address list, an implementation must split the string on commas.
`Email^bk
`value$m ~IDL属性は、
`値~mode$iになる。
◎
The following common input element content attributes, IDL attributes, and methods apply to the element: autocomplete, dirname, list, maxlength, minlength, multiple, pattern, placeholder, readonly, required, and size content attributes; list and value IDL attributes; select() method.
◎
The value IDL attribute is in mode value.
◎
The input and change events apply.
◎
The following content attributes must not be specified and do not apply to the element: accept, alpha, alt, checked, colorspace, formaction, formenctype, formmethod, formnovalidate, formtarget, height, max, min, popovertarget, popovertargetaction, src, step, and width.
◎
The following IDL attributes and methods do not apply to the element: checked, files, selectionStart, selectionEnd, selectionDirection, valueAsDate, and valueAsNumber IDL attributes; setRangeText(), setSelectionRange(), stepDown() and stepUp() methods.
4.10.5.1.6. `Password^st 状態( `type=password^c )
`Password$st `状態$にある `input$e 要素に対しては、
この節の規則が適用される。
◎
When an input element's type attribute is in the Password state, the rules in this section apply.
要素は、
その`値$feを編集するための
一行の素な~text~controlを`表現-$する。
~UAは、
その値を[
利用者~以外の者が見れないよう遮る
]ベキである。
◎
The input element represents a one line plain text edit control for the element's value. The user agent should obscure the value so that people other than the user cannot see it.
要素が`変異-可能$feな場合、
~UAは:
◎
If the element is mutable,\
-
次を利用者に許容するベキである
⇒
`値$feを編集する
◎
its value should be editable by the user.\
-
次を利用者に許容しないモノトスル
⇒
`値$feの中へ`改行文字$を挿入する
◎
User agents must not allow users to insert U+000A LINE FEED (LF) or U+000D CARRIAGE RETURN (CR) characters into the value.
`value$a 属性に指定する値は、
`改行文字$を含んではナラナイ。
◎
The value attribute, if specified, must have a value that contains no U+000A LINE FEED (LF) or U+000D CARRIAGE RETURN (CR) characters.
`値の無毒化~algo$
⇒
要素の`値$fe ~SET `改行文字を剥ぐ$( 要素の`値$fe )
◎
The value sanitization algorithm is as follows: Strip newlines from the value.
`Password^bk
`value$m ~IDL属性は、
`値~mode$iになる。
◎
The following common input element content attributes, IDL attributes, and methods apply to the element: autocomplete, dirname, maxlength, minlength, pattern, placeholder, readonly, required, and size content attributes; selectionStart, selectionEnd, selectionDirection, and value IDL attributes; select(), setRangeText(), and setSelectionRange() methods.
◎
The value IDL attribute is in mode value.
◎
The input and change events apply.
◎
The following content attributes must not be specified and do not apply to the element: accept, alpha, alt, checked, colorspace, formaction, formenctype, formmethod, formnovalidate, formtarget, height, list, max, min, multiple, popovertarget, popovertargetaction, src, step, and width.
◎
The following IDL attributes and methods do not apply to the element: checked, files, list, valueAsDate, and valueAsNumber IDL attributes; stepDown() and stepUp() methods.
4.10.5.1.7. `Date^st 状態( `type=date^c )
`Date$st `状態$にある `input$e 要素に対しては、
この節の規則が適用される。
◎
When an input element's type attribute is in the Date state, the rules in this section apply.
要素は、
その`値$feを[
特定の`日付$を表現する文字列
]に設定するための~controlを`表現-$する。
◎
The input element represents a control for setting the element's value to a string representing a specific date.
要素が`変異-可能$feな場合、
~UAは:
◎
If the element is mutable,\
-
次を利用者に許容するベキである
⇒
`値$feが表現する`日付$
— 値に`日付~文字列を構文解析する$を適用して得されるそれ —
を変更する
◎
the user agent should allow the user to change the date represented by its value, as obtained by parsing a date from it.\
-
次を利用者に許容しないモノトスル
⇒
`値$feを[
空~文字列, `妥当な日付~文字列$
]以外に設定する
◎
User agents must not allow the user to set the value to a non-empty string that is not a valid date string.\
-
`日付$を選択するための~UIを供する場合は、
`値$feを[
利用者の選択を表現している`妥当な日付~文字列$
]に設定するモノトスル。
◎
If the user agent provides a user interface for selecting a date, then the value must be set to a valid date string representing the user's selection.\
-
次を利用者に許容するベキである
⇒
`値$feを空~文字列に設定する
◎
User agents should allow the user to set the value to the empty string.
拘束~検証
⇒
要素が次を満たしている間は、
`不良~入力の難あり$になる
⇒
~UI内の入力を`妥当な日付~文字列$に変換できない
◎
Constraint validation: While the user interface describes input that the user agent cannot convert to a valid date string, the control is suffering from bad input.
注記:
[
日付 / 時刻 / 実数
]用の~form~controlに対する,入力~形式と提出~形式との相違に関する論点は、
`§ 序論@~FORMSintro#input-author-notes$
を見よ。
また、
~form~controlの地域化に関しては,
`§ 実装~上の注記@#input-impl-notes$
を見よ。
◎
See the introduction section for a discussion of the difference between the input format and submission format for date, time, and number form controls, and the implementation notes regarding localization of form controls.
`value$a 属性に指定する値は、[
空~文字列 / `妥当な日付~文字列$
]でなければナラナイ。
◎
The value attribute, if specified and not empty, must have a value that is a valid date string.
`値の無毒化~algo$
⇒
~IF[
要素の`値$feは`妥当な日付~文字列$でない
]
⇒
要素の`値$fe ~SET 空~文字列
◎
The value sanitization algorithm is as follows: If the value of the element is not a valid date string, then set it to the empty string instead.
[
`min$a / `max$a
]属性に指定する値は、
`妥当な日付~文字列$でなければナラナイ。
◎
The min attribute, if specified, must have a value that is a valid date string. The max attribute, if specified, must have a value that is a valid date string.
`step$a 属性は日t数で表出される。
`~step倍率$は
86400000 = ( 24 × 60 × 60 × 1000 )
とする(これは、
他の~algoにて 日t数を~milli秒t数に変換するときに利用される)。
`既定の~step$は 1 日tとする。
◎
The step attribute is expressed in days. The step scale factor is 86,400,000 (which converts the days to milliseconds, as used in the other algorithms). The default step is 1 day.
要素が`~step不一致の難あり$のときは、
~UAは
⇒
そうならなくなるよう,要素の`値$feを最も近い`日付$に丸めてもヨイ。
◎
When the element is suffering from a step mismatch, the user agent may round the element's value to the nearest date for which the element would not suffer from a step mismatch.
`文字列から実数に変換する$
~algoは、
所与の
( 文字列 %入力 )
に対し:
◎
The algorithm to convert a string to a number, given a string input, is as follows:\
-
%日付 ~LET `日付~文字列を構文解析する$( %入力 )
◎
If parsing a date from input\
-
~IF[
%日付 ~EQ `失敗^i
]
⇒
~RET `~error^i
◎
results in an error, then return an error;\
-
~RET [
1970-01-01 ~UTC午前 0 時(値 `1970-01-01T00:00:00.0Z^l が表現する時刻)から %日付 における~UTC午前 0 時まで
]に経過した~milli秒t数
— 閏~秒tは無視して
◎
otherwise, return the number of milliseconds elapsed from midnight UTC on the morning of 1970-01-01 (the time represented by the value "1970-01-01T00:00:00.0Z") to midnight UTC on the morning of the parsed date, ignoring leap seconds.
`実数から文字列に変換する$
~algoは、
所与の
( 実数 %入力 )
に対し
⇒
~RET 次を表現する`妥当な日付~文字列$
⇒
[
1970-01-01 ~UTC午前 0 時( 値 `1970-01-01T00:00:00.0Z^l が表現する時刻 )
]から %入力 ~milli秒t後~現在の~UTC`日付$
◎
The algorithm to convert a number to a string, given a number input, is as follows: Return a valid date string that represents the date that, in UTC, is current input milliseconds after midnight UTC on the morning of 1970-01-01 (the time represented by the value "1970-01-01T00:00:00.0Z").
`文字列から~Date~objに変換する$
~algoは、
所与の
( 文字列 %入力 )
に対し:
◎
The algorithm to convert a string to a Date object, given a string input, is as follows:\
-
%日付 ~LET `日付~文字列を構文解析する$( %入力 )
◎
If parsing a date from input\
-
~IF[
%日付 ~EQ `失敗^i
]
⇒
~RET `~error^i
◎
results in an error, then return an error;\
-
~RET `新たな~Date~obj$( %日付 における~UTC午前 0 時 )
◎
otherwise, return a new Date object representing midnight UTC on the morning of the parsed date.
`~Date~objから文字列に変換する$
~algoは、
所与の
( `Date$I ~obj %入力 )
に対し
⇒
~RET 次を表現する`妥当な日付~文字列$
⇒
%入力 が表現する~UTC時間帯による時刻~現在の`日付$
◎
The algorithm to convert a Date object to a string, given a Date object input, is as follows: Return a valid date string that represents the date current at the time represented by input in the UTC time zone.
注記:
`Date$st 状態(および,後続な節にて述べる,日付/時刻に関係する他の状態)は、[
現今の暦に相対的な精確な日時t
]を確立できない値を手入力するために意図されるものではない。
例えば、
“ビッグバンの 1 ~milli秒t後”,
“ジュラ紀の~~早期”,
“紀元前 250 年~頃の冬”
などの時刻には不適切になる。
◎
The Date state (and other date- and time-related states described in subsequent sections) is not intended for the entry of values for which a precise date and time relative to the contemporary calendar cannot be established. For example, it would be inappropriate for the entry of times like "one millisecond after the big bang", "the early part of the Jurassic period", or "a winter around 250 BCE".
~Gregorian暦の導入~以前の日付の入力に対しては、
作者には、
`Date$st 状態(および,後続な節にて述べる,日時tに関係する他の状態)は利用しないことが奨励される。
~UAには、
日時tを,より早期から~Gregorian暦へ変換する~supportは要求されないので。
また、
利用者に手動で入れるよう請うのは,利用者にとって過度の負担になるので。
(これは、
~Gregorian暦が~~導入された時期が,国ごとに
— 16 世紀の途中から 20 世紀の初め頃までにわたり —
まちまちであるため、
複雑になる)。
作者は代わりに、
`select$e 要素と `Number$st 状態にある要素を利用して,きめ細やかな入力~controlを供することが奨励される。
◎
For the input of dates before the introduction of the Gregorian calendar, authors are encouraged to not use the Date state (and the other date- and time-related states described in subsequent sections), as user agents are not required to support converting dates and times from earlier periods to the Gregorian calendar, and asking users to do so manually puts an undue burden on users. (This is complicated by the manner in which the Gregorian calendar was phased in, which occurred at different times in different countries, ranging from partway through the 16th century all the way to early in the 20th.) Instead, authors are encouraged to provide fine-grained input controls using the select element and input elements with the Number state.
`Date^bk
【!*原文 files 抜け】
`value$m ~IDL属性は、
`値~mode$iになる。
◎
The following common input element content attributes, IDL attributes, and methods apply to the element: autocomplete, list, max, min, readonly, required, and step content attributes; list, value, valueAsDate, and valueAsNumber IDL attributes; select(), stepDown(), and stepUp() methods.
◎
The value IDL attribute is in mode value.
◎
The input and change events apply.
◎
The following content attributes must not be specified and do not apply to the element: accept, alpha, alt, checked, colorspace, dirname, formaction, formenctype, formmethod, formnovalidate, formtarget, height, maxlength, minlength, multiple, pattern, placeholder, popovertarget, popovertargetaction, size, src, and width.
◎
The following IDL attributes and methods do not apply to the element: checked, selectionStart, selectionEnd, and selectionDirection IDL attributes; setRangeText(), and setSelectionRange() methods.
4.10.5.1.8. `Month^st 状態( `type=month^c )
`Month$st `状態$にある `input$e 要素に対しては、
この節の規則が適用される。
◎
When an input element's type attribute is in the Month state, the rules in this section apply.
要素は、
その`値$feを[
特定の`年月t$を表現する文字列
]に設定するための~controlを`表現-$する。
◎
The input element represents a control for setting the element's value to a string representing a specific month.
要素が`変異-可能$feな場合、
~UAは:
◎
If the element is mutable,\
-
次を利用者に許容するベキである
⇒
`値$feが表現する`年月t$
— 値に`年月t文字列を構文解析する$を適用して得されるそれ —
を変更する
◎
the user agent should allow the user to change the month represented by its value, as obtained by parsing a month from it.\
-
次を利用者に許容しないモノトスル
⇒
`値$feを[
空~文字列, `妥当な年月t文字列$
]以外に設定する
◎
User agents must not allow the user to set the value to a non-empty string that is not a valid month string.\
-
`年月t$を選択するための~UIを供する場合は、
`値$feを[
利用者の選択を表現している`妥当な年月t文字列$
]に設定するモノトスル。
◎
If the user agent provides a user interface for selecting a month, then the value must be set to a valid month string representing the user's selection.\
-
次を利用者に許容するベキである
⇒
`値$feを空~文字列に設定する
◎
User agents should allow the user to set the value to the empty string.
拘束~検証
⇒
要素が次を満たしている間は、
`不良~入力の難あり$になる
⇒
~UI内の入力を`妥当な年月t文字列$に変換できない
◎
Constraint validation: While the user interface describes input that the user agent cannot convert to a valid month string, the control is suffering from bad input.
注記:
`Date^st 状態の注記も見よ。
◎
See the introduction section for a discussion of the difference between the input format and submission format for date, time, and number form controls, and the implementation notes regarding localization of form controls.
`value$a 属性に指定する値は、[
空~文字列 / `妥当な年月t文字列$
]でなければナラナイ。
◎
The value attribute, if specified and not empty, must have a value that is a valid month string.
`値の無毒化~algo$
⇒
~IF[
要素の`値$feは`妥当な年月t文字列$でない
]
⇒
要素の`値$fe ~SET 空~文字列
◎
The value sanitization algorithm is as follows: If the value of the element is not a valid month string, then set it to the empty string instead.
[
`min$a / `max$a
]属性に指定する値は、
`妥当な年月t文字列$でなければナラナイ。
◎
The min attribute, if specified, must have a value that is a valid month string. The max attribute, if specified, must have a value that is a valid month string.
`step$a 属性は月t数で表出される。
`~step倍率$は 1 とする(~algoは月t数を利用するので 変換は必要ない)。
`既定の~step$は 1 ヶ月tとする。
◎
The step attribute is expressed in months. The step scale factor is 1 (there is no conversion needed as the algorithms use months). The default step is 1 month.
要素が`~step不一致の難あり$のときは、
~UAは
⇒
そうならなくなるよう,要素の`値$feを最も近い`年月t$に丸めてもヨイ。
◎
When the element is suffering from a step mismatch, the user agent may round the element's value to the nearest month for which the element would not suffer from a step mismatch.
`文字列から実数に変換する$
~algoは、
所与の
( 文字列 %入力 )
に対し:
◎
The algorithm to convert a string to a number, given a string input, is as follows:\
-
%年月t ~LET `年月t文字列を構文解析する$( %入力 )
◎
If parsing a month from input\
-
~IF[
%年月t ~EQ `失敗^i
]
⇒
~RET `~error^i
◎
results in an error, then return an error;\
-
~RET [
1970 年 1 月 から %年月t まで
]の月t~数
◎
otherwise, return the number of months between January 1970 and the parsed month.
`実数から文字列に変換する$
~algoは、
所与の
( 実数 %入力 )
に対し
⇒
~RET 次を表現する`妥当な年月t文字列$
⇒
1970 年 1 月から %入力 月t~数だけ経過した`年月t$
◎
The algorithm to convert a number to a string, given a number input, is as follows: Return a valid month string that represents the month that has input months between it and January 1970.
`文字列から~Date~objに変換する$
~algoは、
所与の
( 文字列 %入力 )
に対し:
◎
The algorithm to convert a string to a Date object, given a string input, is as follows:\
-
%年月t ~LET `年月t文字列を構文解析する$( %入力 )
◎
If parsing a month from input\
-
~IF[
%年月t ~EQ `失敗^i
]
⇒
~RET `~error^i
◎
results in an error, then return an error;\
-
~RET `新たな~Date~obj$( %年月t における最初の日tの~UTC午前 0 時 )
◎
otherwise, return a new Date object representing midnight UTC on the morning of the first day of the parsed month.
`~Date~objから文字列に変換する$
~algoは、
所与の
( `Date$I ~obj %入力 )
に対し
⇒
~RET 次を表現する`妥当な年月t文字列$
⇒
%入力 が表現する~UTC時間帯による`年月t$現在
◎
The algorithm to convert a Date object to a string, given a Date object input, is as follows: Return a valid month string that represents the month current at the time represented by input in the UTC time zone.
`Month^bk
`value$m ~IDL属性は、
`値~mode$iになる。
◎
The following common input element content attributes, IDL attributes, and methods apply to the element: autocomplete, list, max, min, readonly, required, and step content attributes; list, value, valueAsDate, and valueAsNumber IDL attributes; select(), stepDown(), and stepUp() methods.
◎
The value IDL attribute is in mode value.
◎
The input and change events apply.
◎
The following content attributes must not be specified and do not apply to the element: accept, alpha, alt, checked, colorspace, dirname, formaction, formenctype, formmethod, formnovalidate, formtarget, height, maxlength, minlength, multiple, pattern, placeholder, popovertarget, popovertargetaction, size, src, and width.
◎
The following IDL attributes and methods do not apply to the element: checked, files, selectionStart, selectionEnd, and selectionDirection IDL attributes; setRangeText(), and setSelectionRange() methods.
4.10.5.1.9. `Week^st 状態( `type=week^c )
`Week$st `状態$にある `input$e 要素に対しては、
この節の規則が適用される。
◎
When an input element's type attribute is in the Week state, the rules in this section apply.
要素は、
その`値$feを[
特定の`年週t$を表現する文字列
]に設定するための~controlを`表現-$する。
◎
The input element represents a control for setting the element's value to a string representing a specific week.
要素が`変異-可能$feな場合、
~UAは:
◎
If the element is mutable,\
-
次を利用者に許容するベキである
⇒
`値$feが表現する`年週t$
— 値に`年週t文字列を構文解析する$を適用して得されるそれ —
を変更する
◎
the user agent should allow the user to change the week represented by its value, as obtained by parsing a week from it.\
-
次を利用者に許容しないモノトスル
⇒
`値$feを[
空~文字列, `妥当な年週t文字列$
]以外に設定する
◎
User agents must not allow the user to set the value to a non-empty string that is not a valid week string.\
-
`年週t$を選択するための~UIを供する場合は、
`値$feを[
利用者の選択を表現している`妥当な年週t文字列$
]に設定するモノトスル。
◎
If the user agent provides a user interface for selecting a week, then the value must be set to a valid week string representing the user's selection.\
-
次を利用者に許容するベキである
⇒
利用者が`値$feを空~文字列に設定する
◎
User agents should allow the user to set the value to the empty string.
拘束~検証
⇒
要素が次を満たしている間は、
`不良~入力の難あり$になる
⇒
~UI内の入力を`妥当な年週t文字列$に変換できない
◎
Constraint validation: While the user interface describes input that the user agent cannot convert to a valid week string, the control is suffering from bad input.
注記:
`Date^st 状態の注記も見よ。
◎
See the introduction section for a discussion of the difference between the input format and submission format for date, time, and number form controls, and the implementation notes regarding localization of form controls.
`value$a 属性に指定する値は、[
空~文字列 / `妥当な年週t文字列$
]でなければナラナイ。
◎
The value attribute, if specified and not empty, must have a value that is a valid week string.
`値の無毒化~algo$
⇒
~IF[
要素の`値$feは`妥当な年週t文字列$でない
]
⇒
要素の`値$fe ~SET 空~文字列
◎
The value sanitization algorithm is as follows: If the value of the element is not a valid week string, then set it to the empty string instead.
[
`min$a / `max$a
]属性に指定する値は、
`妥当な年週t文字列$でなければナラナイ。
◎
The min attribute, if specified, must have a value that is a valid week string. The max attribute, if specified, must have a value that is a valid week string.
`step$a 属性は週t数で表出される。
`~step倍率$は
604800000 = ( 7 × 24 × 60 × 60 × 1000 )
とする(これは、
他の~algoにて 週t数を~milli秒t数に変換するときに利用される)。
`既定の~step$は 1 週tとする。
`既定の~step基底$は
−259200000 = ( −1 × 72 × 60 × 60 × 1000 )
( 1970 週年tの第 1 週tの開始 = 1970 年の初頭から 72 ~~時間~前)とする。
◎
The step attribute is expressed in weeks. The step scale factor is 604,800,000 (which converts the weeks to milliseconds, as used in the other algorithms). The default step is 1 week. The default step base is −259,200,000 (the start of week 1970-W01).
要素が`~step不一致の難あり$のときは、
~UAは
⇒
そうならなくなるよう,要素の`値$feを最も近い`年週t$に丸めてもヨイ。
◎
When the element is suffering from a step mismatch, the user agent may round the element's value to the nearest week for which the element would not suffer from a step mismatch.
`文字列から実数に変換する$
~algoは、
所与の
( 文字列 %入力 )
に対し:
◎
The algorithm to convert a string to a number, given a string input, is as follows:\
-
%年週t ~LET `年週t文字列を構文解析する$( %入力 )
◎
If parsing a week string from input\
-
~IF[
%年週t ~EQ `失敗^i
]
⇒
~RET `~error^i
◎
results in an error, then return an error;\
-
~RET [
1970-01-01 ~UTC午前 0 時( 値 `1970-01-01T00:00:00.0Z^l が表現する時刻)から
%年週t における月曜の~UTC午前 0 時まで
]に経過した~milli秒数
— 閏~秒tは無視して
◎
otherwise, return the number of milliseconds elapsed from midnight UTC on the morning of 1970-01-01 (the time represented by the value "1970-01-01T00:00:00.0Z") to midnight UTC on the morning of the Monday of the parsed week, ignoring leap seconds.
`実数から文字列に変換する$
~algoは、
所与の
( 実数 %入力 )
に対し
⇒
~RET 次を表現する`妥当な年週t文字列$
⇒
1970-01-01 ~UTC午前 0 時(値 `1970-01-01T00:00:00.0Z^l が表現する時刻)から %入力 ~milli秒t後~現在の~UTC`年週t$
◎
The algorithm to convert a number to a string, given a number input, is as follows: Return a valid week string that represents the week that, in UTC, is current input milliseconds after midnight UTC on the morning of 1970-01-01 (the time represented by the value "1970-01-01T00:00:00.0Z").
`文字列から~Date~objに変換する$
~algoは、
所与の
( 文字列 %入力 )
に対し:
◎
The algorithm to convert a string to a Date object, given a string input, is as follows:\
-
%年週t ~LET `年週t文字列を構文解析する$( %入力 )
◎
If parsing a week from input\
-
~IF[
%年週t ~EQ `失敗^i
]
⇒
~RET `~error^i
◎
results in an error, then return an error;\
-
~RET `新たな~Date~obj$( %年週t における月曜の~UTC午前 0 時 )
◎
otherwise, return a new Date object representing midnight UTC on the morning of the Monday of the parsed week.
`~Date~objから文字列に変換する$
~algoは、
所与の
( `Date$I ~obj %入力 )
に対し
⇒
~RET 次を表現する`妥当な年週t文字列$
⇒
[
~UTC時間帯における%入力 現在
]の時刻が表現する`年週t$
◎
The algorithm to convert a Date object to a string, given a Date object input, is as follows: Return a valid week string that represents the week current at the time represented by input in the UTC time zone.
`Week^bk
`value$m ~IDL属性は、
`値~mode$iになる。
◎
The following common input element content attributes, IDL attributes, and methods apply to the element: autocomplete, list, max, min, readonly, required, and step content attributes; list, value, valueAsDate, and valueAsNumber IDL attributes; select(), stepDown(), and stepUp() methods.
◎
The value IDL attribute is in mode value.
◎
The input and change events apply.
◎
The following content attributes must not be specified and do not apply to the element: accept, alpha, alt, checked, colorspace, dirname, formaction, formenctype, formmethod, formnovalidate, formtarget, height, maxlength, minlength, multiple, pattern, placeholder, popovertarget, popovertargetaction, size, src, and width.
◎
The following IDL attributes and methods do not apply to the element: checked, files, selectionStart, selectionEnd, and selectionDirection IDL attributes; setRangeText(), and setSelectionRange() methods.
4.10.5.1.10. `Time^st 状態( `type=time^c )
`Time$st `状態$にある `input$e 要素に対しては、
この節の規則が適用される。
◎
When an input element's type attribute is in the Time state, the rules in this section apply.
要素は、
その`値$feを[
特定の`時刻$を表現する文字列
]に設定するための~controlを`表現-$する。
◎
The input element represents a control for setting the element's value to a string representing a specific time.
要素が`変異-可能$feな場合、
~UAは:
◎
If the element is mutable,\
-
次を利用者に許容するベキである
⇒
`値$feが表現する`時刻$
— 値に`時刻~文字列を構文解析する$を適用して得されるそれ —
を変更する
◎
the user agent should allow the user to change the time represented by its value, as obtained by parsing a time from it.\
-
次を利用者に許容しないモノトスル
⇒
`値$feを[
空~文字列, `妥当な時刻~文字列$
]以外に設定する
◎
User agents must not allow the user to set the value to a non-empty string that is not a valid time string.\
-
`時刻$を選択するための~UIを供する場合は、
`値$feを[
利用者の選択を表現している`妥当な時刻~文字列$
]に設定するモノトスル。
◎
If the user agent provides a user interface for selecting a time, then the value must be set to a valid time string representing the user's selection.\
-
次を利用者に許容するベキである
⇒
`値$feを空~文字列に設定する
◎
User agents should allow the user to set the value to the empty string.
拘束~検証
⇒
要素が次を満たしている間は、
`不良~入力の難あり$になる
⇒
~UI内の入力を`妥当な時刻~文字列$に変換できない
◎
Constraint validation: While the user interface describes input that the user agent cannot convert to a valid time string, the control is suffering from bad input.
注記:
`Date^st 状態の注記も見よ。
◎
See the introduction section for a discussion of the difference between the input format and submission format for date, time, and number form controls, and the implementation notes regarding localization of form controls.
`value$a 属性に指定する値は、[
空~文字列 / `妥当な時刻~文字列$
]でなければナラナイ。
◎
The value attribute, if specified and not empty, must have a value that is a valid time string.
`値の無毒化~algo$
⇒
~IF[
要素の`値$feは`妥当な時刻~文字列$でない
]
⇒
要素の`値$fe ~SET 空~文字列
◎
The value sanitization algorithm is as follows: If the value of the element is not a valid time string, then set it to the empty string instead.
~controlは`周期的範囲$になる。
◎
The form control has a periodic domain.
[
`min$a / `max$a
]属性に指定する値は、
`妥当な時刻~文字列$でなければナラナイ。
◎
The min attribute, if specified, must have a value that is a valid time string. The max attribute, if specified, must have a value that is a valid time string.
`step$a 属性は秒t数で表出される。
`~step倍率$は 1000 とする(これは、
他の~algoにて 秒t数を~milli秒t数に変換するときに利用される)。
`既定の~step$は 60 秒tとする。
◎
The step attribute is expressed in seconds. The step scale factor is 1000 (which converts the seconds to milliseconds, as used in the other algorithms). The default step is 60 seconds.
要素が`~step不一致の難あり$のときは、
~UAは
⇒
そうならなくなるよう,要素の`値$feを最も近い`時刻$に丸めてもヨイ。
◎
When the element is suffering from a step mismatch, the user agent may round the element's value to the nearest time for which the element would not suffer from a step mismatch.
`文字列から実数に変換する$
~algoは、
所与の
( 文字列 %入力 )
に対し:
◎
The algorithm to convert a string to a number, given a string input, is as follows:\
-
%時刻 ~LET `時刻~文字列を構文解析する$( %入力 )
◎
If parsing a time from input\
-
~IF[
%時刻 ~EQ `失敗^i
]
⇒
~RET `~error^i
◎
results in an error, then return an error;\
-
~RET 同じ日tの中で[
午前 0 時から %時刻 現在まで
]に経過した~milli秒t数
◎
otherwise, return the number of milliseconds elapsed from midnight to the parsed time on a day with no time changes.
`実数から文字列に変換する$
~algoは、
所与の
( 実数 %入力 )
に対し
⇒
~RET 次を表現する`妥当な時刻~文字列$
⇒
同じ日tの中で,午前 0 時から %入力 ~milli秒t経過した`時刻$
◎
The algorithm to convert a number to a string, given a number input, is as follows: Return a valid time string that represents the time that is input milliseconds after midnight on a day with no time changes.
`文字列から~Date~objに変換する$
~algoは、
所与の
( 文字列 %入力 )
に対し:
◎
The algorithm to convert a string to a Date object, given a string input, is as follows:\
-
%時刻 ~LET `時刻~文字列を構文解析する$( %入力 )
◎
If parsing a time from input\
-
~IF[
%時刻 ~EQ `失敗^i
]
⇒
~RET `~error^i
◎
results in an error, then return an error;\
-
~RET `新たな~Date~obj$( ~UTC 1970-01-01 における %時刻 現在 )
◎
otherwise, return a new Date object representing the parsed time in UTC on 1970-01-01.
`~Date~objから文字列に変換する$
~algoは、
所与の
( `Date$I ~obj %入力 )
に対し
⇒
~RET 次を表現する`妥当な時刻~文字列$
⇒
%入力 が表現する~UTC`時刻$ 成分
◎
The algorithm to convert a Date object to a string, given a Date object input, is as follows: Return a valid time string that represents the UTC time component that is represented by input.
`Time^bk
`value$m ~IDL属性は、
`値~mode$iになる。
◎
The following common input element content attributes, IDL attributes, and methods apply to the element: autocomplete, list, max, min, readonly, required, and step content attributes; list, value, valueAsDate, and valueAsNumber IDL attributes; select(), stepDown(), and stepUp() methods.
◎
The value IDL attribute is in mode value.
◎
The input and change events apply.
◎
The following content attributes must not be specified and do not apply to the element: accept, alpha, alt, checked, colorspace, dirname, formaction, formenctype, formmethod, formnovalidate, formtarget, height, maxlength, minlength, multiple, pattern, placeholder, popovertarget, popovertargetaction, size, src, and width.
◎
The following IDL attributes and methods do not apply to the element: checked, files, selectionStart, selectionEnd, and selectionDirection IDL attributes; setRangeText(), and setSelectionRange() methods.
4.10.5.1.11. `Datetime-local^st 状態( `type=datetime-local^c )
`Datetime-local$st `状態$にある `input$e 要素に対しては、
この節の規則が適用される。
◎
When an input element's type attribute is in the Local Date and Time state, the rules in this section apply.
要素は、
その`値$feを[
偏差~情報を伴わない`局所的~日時t$を表現する文字列
]に設定するための~controlを`表現-$する。
◎
The input element represents a control for setting the element's value to a string representing a local date and time, with no time-zone offset information.
要素が`変異-可能$feな場合、
~UAは:
◎
If the element is mutable,\
-
次を利用者に許容するベキである
⇒
`値$feが表現する`局所的~日時t$
— 値に`局所的~日時t文字列を構文解析する$を適用して得されるそれ —
を変更する
◎
the user agent should allow the user to change the date and time represented by its value, as obtained by parsing a date and time from it.\
-
次を利用者に許容しないモノトスル
⇒
`値$feを[
空~文字列, `妥当な正規化-済み局所的~日時t文字列$
]以外に設定する
◎
User agents must not allow the user to set the value to a non-empty string that is not a valid normalized local date and time string.\
-
`局所的~日時t$を選択するための~UIを供する場合は、
`値$feを[
利用者の選択を表現している`妥当な正規化-済み局所的~日時t文字列$
]に設定するモノトスル。
◎
If the user agent provides a user interface for selecting a local date and time, then the value must be set to a valid normalized local date and time string representing the user's selection.\
-
次を利用者に許容するベキである
⇒
`値$feを空~文字列に設定する
◎
User agents should allow the user to set the value to the empty string.
拘束~検証
⇒
要素が次を満たしている間は、
`不良~入力の難あり$になる
⇒
~UI内の入力を`妥当な正規化-済み局所的~日時t文字列$に変換できない
◎
Constraint validation: While the user interface describes input that the user agent cannot convert to a valid normalized local date and time string, the control is suffering from bad input.
注記:
この状態にも
`Date^st 状態の注記
が該当する。
◎
See the introduction section for a discussion of the difference between the input format and submission format for date, time, and number form controls, and the implementation notes regarding localization of form controls.
`value$a 属性に指定する値は、[
空~文字列 / `妥当な局所的~日時t文字列$
]でなければナラナイ。
◎
The value attribute, if specified and not empty, must have a value that is a valid local date and time string.
`値の無毒化~algo$:
-
~IF[
要素の`値$feは`妥当な局所的~日時t文字列$である
]
⇒
要素の`値$fe ~SET 同じ日時tを表現する`妥当な正規化-済み局所的~日時t文字列$
-
~ELSE
⇒
要素の`値$fe ~SET 空~文字列
◎
The value sanitization algorithm is as follows: If the value of the element is a valid local date and time string, then set it to a valid normalized local date and time string representing the same date and time; otherwise, set it to the empty string instead.
[
`min$a / `max$a
]属性に指定する値は、
`妥当な局所的~日時t文字列$でなければナラナイ。
◎
The min attribute, if specified, must have a value that is a valid local date and time string. The max attribute, if specified, must have a value that is a valid local date and time string.
`step$a 属性は秒t数で表出される。
`~step倍率$は 1000 とする(これは、
他の~algoにて 秒t数を~milli秒t数に変換するときに利用される)。
`既定の~step$ は 60 秒tとする。
◎
The step attribute is expressed in seconds. The step scale factor is 1000 (which converts the seconds to milliseconds, as used in the other algorithms). The default step is 60 seconds.
要素が`~step不一致の難あり$のときは、
~UAは
⇒
そうならなくなるよう,要素の`値$feを最も近い`局所的~日時t$に丸めてもヨイ。
◎
When the element is suffering from a step mismatch, the user agent may round the element's value to the nearest local date and time for which the element would not suffer from a step mismatch.
`文字列から実数に変換する$
~algoは、
所与の
( 文字列 %入力 )
に対し:
◎
The algorithm to convert a string to a number, given a string input, is as follows:\
-
%局所的~日時t ~LET `局所的~日時t文字列を構文解析する$( %入力 )
◎
If parsing a date and time from input\
-
~IF[
%局所的~日時t ~EQ `失敗^i
]
⇒
~RET `~error^i
◎
results in an error, then return an error;\
-
~RET [
1970-01-01 午前 0 時(値 `1970-01-01T00:00:00.0^l が表現する時刻)
から %局所的~日時t まで
]に経過した~milli秒t数
— 閏~秒tは無視して
◎
otherwise, return the number of milliseconds elapsed from midnight on the morning of 1970-01-01 (the time represented by the value "1970-01-01T00:00:00.0") to the parsed local date and time, ignoring leap seconds.
`実数から文字列に変換する$
~algoは、
所与の
( 実数 %入力 )
に対し
⇒
~RET 次を表現する,`妥当な正規化-済み局所的~日時t文字列$
⇒
[
1970-01-01 午前 0 時(値 `1970-01-01T00:00:00.0^l が表現する時刻)
]から %入力 ~milli秒 後の日時t
◎
The algorithm to convert a number to a string, given a number input, is as follows: Return a valid normalized local date and time string that represents the date and time that is input milliseconds after midnight on the morning of 1970-01-01 (the time represented by the value "1970-01-01T00:00:00.0").
注記:
§ `Date$st 状態の`歴史的な日付に関する注記@#only-contemporary-times$を見よ。
◎
See the note on historical dates in the Date state section.
`Datetime-local^bk
`value$m ~IDL属性は、
`値~mode$iになる。
◎
The following common input element content attributes, IDL attributes, and methods apply to the element: autocomplete, list, max, min, readonly, required, and step content attributes; list, value, and valueAsNumber IDL attributes; select(), stepDown(), and stepUp() methods.
◎
The value IDL attribute is in mode value.
◎
The input and change events apply.
◎
The following content attributes must not be specified and do not apply to the element: accept, alpha, alt, checked, colorspace, dirname, formaction, formenctype, formmethod, formnovalidate, formtarget, height, maxlength, minlength, multiple, pattern, placeholder, popovertarget, popovertargetaction, size, src, and width.
◎
The following IDL attributes and methods do not apply to the element: checked, files, selectionStart, selectionEnd, selectionDirection, and valueAsDate IDL attributes; setRangeText(), and setSelectionRange() methods.
次の例に、
航空便予約~appの一部を示す。
この~appは、
`Datetime-local$st `状態$にある要素を利用して,所与の日時tを 選択された空港の時間帯において解釈する。
◎
The following example shows part of a flight booking application. The application uses an input element with its type attribute set to datetime-local, and it then interprets the given date and time in the time zone of the selected airport.
`Datetime-local-1^xCode
4.10.5.1.12. `Number^st 状態 (`type=number^c )
`Number$st `状態$にある `input$e 要素に対しては、
この節の規則が適用される。
◎
When an input element's type attribute is in the Number state, the rules in this section apply.
要素は、
その`値$feを[
実数を表現する文字列
]に設定するための~controlを`表現-$する。
◎
The input element represents a control for setting the element's value to a string representing a number.
要素が`変異-可能$feな場合、
~UAは:
◎
If the element is mutable,\
-
次を利用者に許容するベキである
⇒
`値$feが表現する実数
— 値を`浮動小数点数として構文解析-$して得されるそれ —
を変更する
◎
the user agent should allow the user to change the number represented by its value, as obtained from applying the rules for parsing floating-point number values to it.\
-
次を利用者に許容しないモノトスル
⇒
`値$feを[
空~文字列, `妥当な浮動小数点数$
]以外に設定する
◎
User agents must not allow the user to set the value to a non-empty string that is not a valid floating-point number.\
-
数を選択するための~UIを供する場合は、
`値$feを[
利用者の選択に対する`浮動小数点数として最良な表現$
]に設定するモノトスル。
◎
If the user agent provides a user interface for selecting a number, then the value must be set to the best representation of the number representing the user's selection as a floating-point number.\
-
次を利用者に許容するベキである
⇒
`値$feを空~文字列に設定する
◎
User agents should allow the user to set the value to the empty string.
拘束~検証
⇒
要素が次を満たしている間は、
`不良~入力の難あり$になる
⇒
~UI内の入力を`妥当な浮動小数点数$に変換できない
◎
Constraint validation: While the user interface describes input that the user agent cannot convert to a valid floating-point number, the control is suffering from bad input.
注記:
この仕様は、
~UAが利用する~UIは定義しない。
~UA~vendorには、
利用者の必要性に応えるには何が最良になるか,考慮することが奨励される。
例えば、
~Persian/~Arabic 市場~向けの~UAは,
~Persian/~Arabic
による数量-入力を~supportすることもあろう。
【!Similarly, a user agent designed for Romans might display the value in Roman numerals rather than in decimal; or (more realistically) 】
あるいは~French市場向けに設計された~UAは、
3 桁ごとにピリオドで分離して,小数点に~commaを用いて
【!with apostrophes between thousands and commas before the decimals】
値を表示し,利用者がその方式で手入力することを許容し得る。
(いずれにせよ,内部的には、
上述した提出に要求される形式に変換しつつ。)
◎
This specification does not define what user interface user agents are to use; user agent vendors are encouraged to consider what would best serve their users' needs. For example, a user agent in Persian or Arabic markets might support Persian and Arabic numeric input (converting it to the format required for submission as described above). Similarly, a user agent designed for Romans might display the value in Roman numerals rather than in decimal; or (more realistically) a user agent designed for the French market might display the value with apostrophes between thousands and commas before the decimals, and allow the user to enter a value in that manner, internally converting it to the submission format described above.
`value$a 属性に指定する値は、[
空~文字列 / `妥当な浮動小数点数$
]でなければナラナイ。
◎
The value attribute, if specified and not empty, must have a value that is a valid floating-point number.
`値の無毒化~algo$
⇒
~IF[
要素の`値$feは`妥当な浮動小数点数$でない
]
⇒
要素の`値$fe ~SET 空~文字列
◎
The value sanitization algorithm is as follows: If the value of the element is not a valid floating-point number, then set it to the empty string instead.
[
`min$a / `max$a
]属性に指定する値は、
`妥当な浮動小数点数$でなければナラナイ。
◎
The min attribute, if specified, must have a value that is a valid floating-point number. The max attribute, if specified, must have a value that is a valid floating-point number.
`~step倍率$は 1 とする。
`既定の~step$は 1 とする( `~step基底$が整数であれば、
利用者が選択できるのは整数に限られることになる)。
◎
The step scale factor is 1. The default step is 1 (allowing only integers to be selected by the user, unless the step base has a non-integer value).
要素が`~step不一致の難あり$のときは、
~UAは
⇒
そうならなくなるよう,要素の`値$feを最も近い数に丸めてもヨイ。
そのような数が 2 個あるときには、
~UAには,正な無限大に近い方を選ぶことが奨励される。
◎
When the element is suffering from a step mismatch, the user agent may round the element's value to the nearest number for which the element would not suffer from a step mismatch. If there are two such numbers, user agents are encouraged to pick the one nearest positive infinity.
`文字列から実数に変換する$
~algoは、
所与の
( 文字列 %入力 )
に対し
⇒
~RET %入力 を`浮動小数点数として構文解析-$した結果 ~NEQ `失敗^i ならば その結果 /
~ELSE_ `~error^i
◎
The algorithm to convert a string to a number, given a string input, is as follows: If applying the rules for parsing floating-point number values to input results in an error, then return an error; otherwise, return the resulting number.
`実数から文字列に変換する$
~algoは、
所与の
( 実数 %入力 )
に対し
⇒
~RET %入力 を表現する`妥当な浮動小数点数$
◎
The algorithm to convert a number to a string, given a number input, is as follows: Return a valid floating-point number that represents input.
`Number^bk
`value$m ~IDL属性は、
`値~mode$iになる。
◎
The following common input element content attributes, IDL attributes, and methods apply to the element: autocomplete, list, max, min, placeholder, readonly, required, and step content attributes; list, value, and valueAsNumber IDL attributes; select(), stepDown(), and stepUp() methods.
◎
The value IDL attribute is in mode value.
◎
The input and change events apply.
◎
The following content attributes must not be specified and do not apply to the element: accept, alpha, alt, checked, colorspace, dirname, formaction, formenctype, formmethod, formnovalidate, formtarget, height, maxlength, minlength, multiple, pattern, popovertarget, popovertargetaction, size, src, and width.
◎
The following IDL attributes and methods do not apply to the element: checked, files, selectionStart, selectionEnd, selectionDirection, and valueAsDate IDL attributes; setRangeText(), and setSelectionRange() methods.
数量-入力~controlの用例:
◎
Here is an example of using a numeric input control:
`Number-1^xCode
上述したように、
~UAは,利用者の地域的~形式による数量-入力も~supportし得る
— 上述した,提出に要求される形式に変換しつつ。
これには次の取扱いも含まれ得る:
~group化~分離子( "872,000,000,000" など)/
各種 10 進~分離子( "3,99" vs "3.99" など) /
地域的な数字の利用( ~Arabic, ~Devanagari, ~Persian, ~Thai など)。
◎
As described above, a user agent might support numeric input in the user's local format, converting it to the format required for submission as described above. This might include handling grouping separators (as in "872,000,000,000") and various decimal separators (such as "3,99" vs "3.99") or using local digits (such as those in Arabic, Devanagari, Persian, and Thai).
注記:
`Number$st `状態$は,~~数字のみからなるが、
厳密には数とは言えない入力~用には,適切でない。
例えば、
~credit-card番号や US 郵便番号には不適切になる。
この`状態$を利用するかどうか決定する単純な仕方は、
その入力~controlが
例えば “増減~button” ~UIを備えることがイミを成すかどうか,考えることである。
~credit-card番号における誤りは、
最後の 1 桁であろうが,全桁が不正なときと同じく小さな間違いではない。
なので、
増減~buttonで~credit-card番号を選択することは,利用者にとってイミを成さない。
増減~button~UIが適切になるならば、
この`状態$は,おそらく正解になる(場合によっては `inputmode$a か `pattern$a 属性も伴わせて)。
◎
The type=number state is not appropriate for input that happens to only consist of numbers but isn't strictly speaking a number. For example, it would be inappropriate for credit card numbers or US postal codes. A simple way of determining whether to use type=number is to consider whether it would make sense for the input control to have a spinbox interface (e.g. with "up" and "down" arrows). Getting a credit card number wrong by 1 in the last digit isn't a minor mistake, it's as wrong as getting every digit incorrect. So it would not make sense for the user to select a credit card number using "up" and "down" buttons. When a spinbox interface is not appropriate, type=text is probably the right choice (possibly with an inputmode or pattern attribute).
4.10.5.1.13. `Range^st 状態( `type=range^c )
`Range$st `状態$にある `input$e 要素に対しては、
この節の規則が適用される。
◎
When an input element's type attribute is in the Range state, the rules in this section apply.
要素は、[
その`値$feを,実数を表現する文字列に設定する
]ための~controlを`表現-$する
— ただし、
その正確な値は重要でなく,~UAは `Number$st 状態のときより単純な~UIを供するものとされる。
◎
The input element represents a control for setting the element's value to a string representing a number, but with the caveat that the exact value is not important, letting UAs provide a simpler interface than they do for the Number state.
要素が`変異-可能$feな場合、
~UAは:
◎
If the element is mutable,\
-
次を利用者に許容するベキである
⇒
`値$feが表現する実数
— 値を`浮動小数点数として構文解析-$して得されるそれ —
を変更する
◎
the user agent should allow the user to change the number represented by its value, as obtained from applying the rules for parsing floating-point number values to it.\
-
次を利用者に許容しないモノトスル
⇒
`値$feを[
`妥当な浮動小数点数$でない文字列
]に設定する
◎
User agents must not allow the user to set the value to a string that is not a valid floating-point number.\
-
実数を選択するための~UIを供する場合は、
`値$feを`浮動小数点数として最良な表現$に設定するモノトスル。
◎
If the user agent provides a user interface for selecting a number, then the value must be set to a best representation of the number representing the user's selection as a floating-point number.\
-
次を利用者に許容しないモノトスル
⇒
`値$feを空~文字列に設定する
◎
User agents must not allow the user to set the value to the empty string.
拘束~検証
⇒
要素が次を満たしている間は、
`不良~入力の難あり$になる
⇒
~UI内の入力を`妥当な浮動小数点数$に変換できない
◎
Constraint validation: While the user interface describes input that the user agent cannot convert to a valid floating-point number, the control is suffering from bad input.
`value$a 属性に指定する値は、
`妥当な浮動小数点数$でなければナラナイ。
◎
The value attribute, if specified, must have a value that is a valid floating-point number.
`値の無毒化~algo$
⇒
~IF[
要素の`値$feは`妥当な浮動小数点数$でない
]
⇒
要素の`値$fe ~SET `既定~値$に対する`浮動小数点数として最良な表現$
◎
The value sanitization algorithm is as follows: If the value of the element is not a valid floating-point number, then set it to the best representation, as a floating-point number, of the default value.
`既定~値@
は、[
`最大$ ~LT `最小$ならば`最小$ /
~ELSE_ `最小$と`最大$の平均
]とする。
◎
The default value is the minimum plus half the difference between the minimum and the maximum, unless the maximum is less than the minimum, in which case the default value is the minimum.
【
`既定の最小$が定義されているので(下記)、
`最小$が −∞ になることはない。
`最大$についても同様。
】
~UAは、
要素の`値$feが:
◎
↓
-
`~underflowの難あり$のときは
⇒
`値$feを[
`最小$に対する`浮動小数点数として最良な表現$
]に設定するモノトスル。
◎
When the element is suffering from an underflow, the user agent must set the element's value to the best representation, as a floating-point number, of the minimum.
-
`~overflowの難あり$のときは
⇒
[
`最大$ ~GTE `最小$
]ならば,`値$feを[
`最大$を表現する`妥当な浮動小数点数$
]に設定するモノトスル。
◎
When the element is suffering from an overflow, if the maximum is not less than the minimum, the user agent must set the element's value to a valid floating-point number that represents the maximum.
-
`~step不一致の難あり$のときは
⇒
`値$feを[
そうならなくなるような実数 %V
]のうち[
%V ~GTE `最小$
]~AND[[
`最大$ ~LT `最小$
]~OR[
%V ~LTE `最大$
]]を満たすものがあるならば、
それらのうち[
`値$feに最も近い実数であって,そのような実数が 2 つあるときは正な無限大に近い方
]に丸めるモノトスル。
◎
When the element is suffering from a step mismatch, the user agent must round the element's value to the nearest number for which the element would not suffer from a step mismatch, and which is greater than or equal to the minimum, and, if the maximum is not less than the minimum, which is less than or equal to the maximum, if there is a number that matches these constraints. If two numbers match these constraints, then user agents must use the one nearest to positive infinity.
例えば、
~markup
`<input type="range" min=0 max=100 step=20 value=50>^c
による範囲~controlに対する結果の初期~値は 60 になる。
◎
For example, the markup <input type="range" min=0 max=100 step=20 value=50> results in a range control whose initial value is 60.
`list$a 属性による自動補完~listを利用する範囲~controlの例。
これは、
~controlの範囲~内に とりわけ重要な値がある場合に,有用になり得る
— ~~調製済みな光量~levelや,速度~controlとして利用されるときの代表的な速度~制限sなど。
次の~markup片に対し:
◎
Here is an example of a range control using an autocomplete list with the list attribute. This could be useful if there are values along the full range of the control that are especially important, such as preconfigured light levels or typical speed limits in a range control used as a speed control. The following markup fragment:
`Range-1^xCode
次の~stylesheetが適用されるとする:
◎
...with the following style sheet applied:
input {
writing-mode: vertical-lr;
height: 75px;
width: 49px;
background: #D5CCBB;
color: black;
}
描画は次に似たものになるであろう:
◎
...might render as:
~UAは、
~stylesheetで指定された `height^p, `width^p ~propの比から~controlの方位を決定することに注意。
色も類似に~stylesheetから導出される。
しかしながら,目盛りは、
~markupから導出される。
特に、
`step$a 属性は 目盛りの配置に影響していない
— ~UAは、
作者が各 `option^e に指定した値のみを利用して それを裁定して,それから
両端に長めの目盛りを追加する。
◎
Note how the UA determined the orientation of the control from the ratio of the style-sheet-specified height and width properties. The colors were similarly derived from the style sheet. The tick marks, however, were derived from the markup. In particular, the step attribute has not affected the placement of tick marks, the UA deciding to only use the author-specified completion values and then adding longer tick marks at the extremes.
妥当でない値 `++50^c は無視されることにも注意。
◎
Note also how the invalid value ++50 was ignored.
別の例として、
次の~markup片を考える:
◎
For another example, consider the following markup fragment:
`Range-2^xCode
~UAは、
種々の仕方で表示できる。
一例として:
◎
A user agent could display in a variety of ways, for instance:
あるいは:
◎
Or, alternatively, for instance:
~UAは、
~stylesheetに与えられた寸法に基づいて どれを表示するか選べる。
これは、[
横幅の相違にかかわらず,目盛りに対し同じ解像度を保守する
]ことを許容する。
◎
The user agent could pick which one to display based on the dimensions given in the style sheet. This would allow it to maintain the same resolution for the tick marks, despite the differences in width.
最後に、
~label付きの値を 2 つ伴う範囲~controlの例:
◎
Finally, here is an example of a range control with two labeled values:
`Range-3^xCode
~controlを縦方向に描く~styleであれば、
次に似た見かけになるであろう:
◎
With styles that make the control draw vertically, it might look as follows:
注記:
この状態においては、
利用者の入力中でも,範囲と~stepの拘束が施行されるので、
値を空~文字列に設定する仕方はない。
◎
In this state, the range and step constraints are enforced even during user input, and there is no way to set the value to the empty string.
`min$a 属性に指定する値は、
`妥当な浮動小数点数$でなければナラナイ。
`既定の最小$は 0 とする。
`max$a 属性に指定する値は、
`妥当な浮動小数点数$でなければナラナイ。
`既定の最大$は 100 とする。
◎
The min attribute, if specified, must have a value that is a valid floating-point number. The default minimum is 0. The max attribute, if specified, must have a value that is a valid floating-point number. The default maximum is 100.
`~step倍率$は 1 とする。
`既定の~step$は 1 とする( `min$a 属性が整数でない値にされない限り,許容される値は整数に限られるようになる)。
◎
The step scale factor is 1. The default step is 1 (allowing only integers, unless the min attribute has a non-integer value).
`文字列から実数に変換する$
~algoは、
所与の
( 文字列 %入力 )
に対し
⇒
~RET %入力 を`浮動小数点数として構文解析-$した結果 ~NEQ `失敗^i ならば その結果 /
~ELSE_ `~error^i
◎
The algorithm to convert a string to a number, given a string input, is as follows: If applying the rules for parsing floating-point number values to input results in an error, then return an error; otherwise, return the resulting number.
`実数から文字列に変換する$
~algoは、
所与の
( 実数 %入力 )
に対し
⇒
~RET %入力 に対する`浮動小数点数として最良な表現$
◎
The algorithm to convert a number to a string, given a number input, is as follows: Return the best representation, as a floating-point number, of input.
`Range^bk
`value$m ~IDL属性は、
`値~mode$iになる。
◎
The following common input element content attributes, IDL attributes, and methods apply to the element: autocomplete, list, max, min, and step content attributes; list, value, and valueAsNumber IDL attributes; stepDown() and stepUp() methods.
◎
The value IDL attribute is in mode value.
◎
The input and change events apply.
◎
The following content attributes must not be specified and do not apply to the element: accept, alpha, alt, checked, colorspace, dirname, formaction, formenctype, formmethod, formnovalidate, formtarget, height, maxlength, minlength, multiple, pattern, placeholder, popovertarget, popovertargetaction, readonly, required, size, src, and width.
◎
The following IDL attributes and methods do not apply to the element: checked, files, selectionStart, selectionEnd, selectionDirection, and valueAsDate IDL attributes; select(), setRangeText(), and setSelectionRange() methods.
4.10.5.1.14. `Color^st 状態( `type=color^c )
`Color$st `状態$にある `input$e 要素に対しては、
この節の規則が適用される。
◎
When an input element's type attribute is in the Color state, the rules in this section apply.
要素は、
その`値$feを[
~CSS色の直列化を表現する文字列
]に設定するための~color-well~control†を`表現-$する。
◎
The input element represents a color well control, for setting the element's value to a string representing the serialization of a CSS color.
【†
現在~選定された色のみが表示される小さな~boxで,
~click等により色~pickerが表示されるような類の~control。
】
注記:
この状態にあるときは,選ばれる~CSS色は常にあるので、
末端-利用者が値を空~文字列に設定する仕方はない。
◎
In this state, there is always a CSS color picked, and there is no way for the end user to set the value to the empty string.
`alpha@a
属性は,`真偽-属性$であり、
在るならば,次を指示する
⇒
末端-利用者は,当の~CSS色の~alpha成分を操作できるので、
当の色は全部的に不透明になるとは限らない。
◎
The alpha attribute is a boolean attribute. If present, it indicates the CSS color's alpha component can be manipulated by the end user and does not have to be fully opaque.
`colorspace@a
属性は、
直列化された~CSS色の色~空間を指示することに加え,
~CSS色の選定-用に欲される~UIを~hintする。
この属性は,`列挙d属性$であり、
次に挙げる~keyword, とり得る状態, それらの対応付けが定義される:
◎
The colorspace attribute indicates the color space of the serialized CSS color. It also hints at the desired user interface for selecting a CSS color. It is an enumerated attribute with the following keywords and states:
~keyword
| 状態
| 概略的な記述
|
`limited-srgb@v
| `制限された~sRGB@st
| 当の~CSS色は、
`srgb$v 色~空間へ変換され,
成分ごとに 8 ~bitに制限される
— 例: `#123456^v や `color(srgb 0 1 0 / 0.5)^v
|
`display-p3@v
| `~Display-P3@st
| 当の~CSS色は、
`display-p3@~CSSCOLOR#valdef-color-display-p3$v 色~空間へ変換される
— 例: `color(display-p3 1.84 -0.19 0.72 / 0.6)^v
|
◎
Keyword|State|Brief description
limited-srgb|Limited sRGB|The CSS color is converted to the 'srgb' color space and limited to 8-bits per component, e.g., "#123456" or "color(srgb 0 1 0 / 0.5)".
display-p3|Display P3|The CSS color is converted to the 'display-p3' color space, e.g., "color(display-p3 1.84 -0.19 0.72 / 0.6)".
この属性の[
`欠落~値~用の既定の状態$/`妥当でない値~用の既定の状態$
]は、
`制限された~sRGB$st とする。
◎
The attribute's missing value default and invalid value default are both the Limited sRGB state.
要素の[
`alpha$a / `colorspace$a
]属性が変更されたときは、
~UAは,次を走らすモノトスル
⇒
`~color-well~control色を更新する$( 当の要素 )
◎
Whenever the element's alpha or colorspace attributes are changed, the user agent must run update a color well control color given the element.
要素 %要素 が`変異-可能$feな場合、
~UAは:
◎
If the element is mutable,\
-
次を利用者に許容するベキである
⇒
%要素 の`値$feが表現する色を変更する
— 次で得されるとおりに
⇒
`~CSS色~値を構文解析する$( %要素 の`値$fe, %要素 )
◎
the user agent should allow the user to change the color represented by its value, as obtained from parsing it.\
-
次を利用者に許容しないモノトスル
⇒
%要素 の`値$feを[
次が満たされなくなる文字列
]に設定する
⇒
%要素 の`値$fe ~EQ `~color-well~control色を更新する$( %要素 )
◎
User agents must not allow the user to set the value to a string that running update a color well control color for the element would not set it to.\
-
~CSS色を選定するための~UIを供する場合は、
%要素 の`値$feを次の結果に設定するモノトスル
⇒
`~color-well~control色を直列化する$( %要素, 利用者が選定した色 )
◎
If the user agent provides a user interface for selecting a CSS color, then the value must be set to the result of serializing a color well control color given the element and the end user's selection.
そのような要素 %要素 用の`~input作動化の挙動$は
⇒
`適用-可能なら~pickerを示す$( %要素 )
◎
The input activation behavior for such an element element is to show the picker, if applicable, for element.
拘束~検証
⇒
要素 %要素 は、
その`値$fe %値 が次を満たしている間は,`不良~入力の難あり$になる
⇒
[
%値 ~NEQ 空~文字列
]~AND[
`~CSS色~値を構文解析する$( %値, %要素 ) ~EQ `失敗^i
]
◎
Constraint validation: While the element's value is not the empty string and parsing it returns failure, the control is suffering from bad input.
`value$a 属性に指定する値は、[
空~文字列/~CSS色
]でなければナラナイ。
◎
The value attribute, if specified and not the empty string, must have a value that is a CSS color.
`値の無毒化~algo$
⇒
`~color-well~control色を更新する$( 当の要素 )
◎
The value sanitization algorithm is as follows: Run update a color well control color for the element.
`~color-well~control色を更新する@
ときは、
所与の
( 要素 %要素 )
に対し:
◎
To update a color well control color, given an element element:
-
~Assert:
%要素 は `Color$st `状態$にある `input$e 要素である。
◎
Assert: element is an input element whose type attribute is in the Color state.
-
%色 ~LET `~CSS色~値を構文解析する$( %要素 の`値$fe, %要素 )
◎
Let color be the result of parsing element's value.
-
~IF[
%色 ~EQ `失敗^i
]
⇒
%色 ~SET `不透明な黒$
◎
If color is failure, then set color to opaque black.
-
%要素 の`値$fe ~SET `~color-well~control色を直列化する$( %要素, %色 )
◎
Set element's value to the result of serializing a color well control color given element and color.
`~color-well~control色を直列化する@
ときは、
所与の
( 要素 %要素, ~CSS色 %色 )
に対し:
◎
To serialize a color well control color, given an element element and a CSS color color:
-
~Assert:
%要素 は `Color$st `状態$にある `input$e 要素である。
◎
Assert: element is an input element whose type attribute is in the Color state.
◎
↓ Let htmlCompatible be false.
-
~IF[
%要素 は `alpha$a 属性を有さない
]
⇒
%色 の~alpha成分 ~SET 全部的に不透明
◎
If element's alpha attribute is not specified, then set color's alpha component to be fully opaque.
-
%要素 の `colorspace$a 属性の状態に応じて:
◎
↓
-
%色 ~SET %色 を `color()@~CSSCOLOR#color-function$v 関数~形へ変換した結果
【
原文は, `~Display-P3$st の場合にこれを適用していないが、
`display-p3^v 色~空間に属する色を直列化するためには,
必然的に `color()^v 関数を利用することになる。
】
◎
↑
-
~RET %色 を`直列化-@~CSSCOLOR#serializing-color-values$した結果
◎
Return the result of serializing color.\
↑ If htmlCompatible is true, then do so with HTML-compatible serialization requested.
`Color^bk
`value$m ~IDL属性は、
`値~mode$iになる。
◎
The following common input element content attributes and IDL attributes apply to the element: autocomplete and list content attributes; list and value IDL attributes; select() method.
◎
The value IDL attribute is in mode value.
◎
The input and change events apply.
◎
The following content attributes must not be specified and do not apply to the element: accept, alt, checked, dirname, formaction, formenctype, formmethod, formnovalidate, formtarget, height, max, maxlength, min, minlength, multiple, pattern, placeholder, popovertarget, popovertargetaction, readonly, required, size, src, step, and width.
◎
The following IDL attributes and methods do not apply to the element: checked, files, selectionStart, selectionEnd, selectionDirection, valueAsDate and, valueAsNumber IDL attributes; setRangeText(), setSelectionRange(), stepDown(), and stepUp() methods.
4.10.5.1.15. `Checkbox^st 状態( `type=checkbox^c )
`Checkbox$st `状態$にある `input$e 要素に対しては、
この節の規則が適用される。
◎
When an input element's type attribute is in the Checkbox state, the rules in this section apply.
要素は、
その`~check有りか$feを表現する
2 状態をとり得る~controlを`表現-$する。
~controlは、
要素の`~check有りか$feが[
~T ならば肯定的~選択 / ~F ならば否定的~選択
]を表現する。
要素の `indeterminate$m ~IDL属性 ~EQ ~T の場合、
~controlの選択は、
~controlが第三の不定な状態にあるかのように,遮られるベキである。
◎
The input element represents a two-state control that represents the element's checkedness state. If the element's checkedness state is true, the control represents a positive selection, and if it is false, a negative selection. If the element's indeterminate IDL attribute is set to true, then the control's selection should be obscured as if the control was in a third, indeterminate, state.
注記:
要素の `indeterminate$m ~IDL属性が ~T に設定されてようが,
~control自体は 決して真の 3 状態をとり得る~controlにはならない。
この~IDL属性は、
第三の状態があるかのような外観を与えるのみである。
◎
The control is never a true tri-state control, even if the element's indeterminate IDL attribute is set to true. The indeterminate IDL attribute only gives the appearance of a third state.
要素~用の`~input作動化の挙動$は、
次に従う:
◎
The input activation behavior is to run the following steps:
-
~IF[
要素は`接続されて$いない
]
⇒
~RET
◎
If the element is not connected, then return.
-
`入力~eventを発火する$( 要素, `input$et )
◎
Fire an event named input at the element with the bubbles and composed attributes initialized to true.
-
`入力~eventを発火する$( 要素, `change$et )
◎
Fire an event named change at the element with the bubbles attribute initialized to true.
拘束~検証
⇒
要素が次を満たしている間は、
`欠落である難あり$になる
⇒
[
`必須$である
]~AND[
`~check有りか$fe ~EQ ~F
]
◎
Constraint validation: If the element is required and its checkedness is false, then the element is suffering from being missing.
- %input.`indeterminate$m [ = %値 ]
-
被~設定-時には、
現在の値が可視でなくなるように,
`Checkbox$st ~controlの描画を上書きする。
◎
When set, overrides the rendering of checkbox controls so that the current value is not visible.
`Checkbox^bk
`value$m ~IDL属性は、
`既定か~on~mode$iになる。
◎
The value IDL attribute is in mode default/on.
◎
The following common input element content attributes and IDL attributes apply to the element: checked, and required content attributes; checked and value IDL attributes.
◎
The value IDL attribute is in mode default/on.
◎
The input and change events apply.
◎
The following content attributes must not be specified and do not apply to the element: accept, alpha, alt, autocomplete, colorspace, dirname, formaction, formenctype, formmethod, formnovalidate, formtarget, height, list, max, maxlength, min, minlength, multiple, pattern, placeholder, popovertarget, popovertargetaction, readonly, size, src, step, and width.
◎
The following IDL attributes and methods do not apply to the element: files, list, selectionStart, selectionEnd, selectionDirection, valueAsDate, and valueAsNumber IDL attributes; select(), setRangeText(), setSelectionRange(), stepDown(), and stepUp() methods.
4.10.5.1.16. `Radio^st 状態( `type=radio^c )
`Radio$st `状態$にある `input$e 要素に対しては、
この節の規則が適用される。
◎
When an input element's type attribute is in the Radio Button state, the rules in this section apply.
要素は、
`Radio$st 状態にある他の要素と一緒に `~radio~button~group$を形成し,[
それらのうち ただ一つのみが,`~check有りか$feが ~T に設定される
]ような~controlを`表現-$する。
~controlは、
要素の`~check有りか$feに応じて[
~T ならば この~group内で選択されている /
~F ならば選択されていない
]ことを表現する。
◎
The input element represents a control that, when used in conjunction with other input elements, forms a radio button group in which only one control can have its checkedness state set to true. If the element's checkedness state is true, the control represents the selected control in the group, and if it is false, it indicates a control in the group that is not selected.
要素が属する
`~radio~button~group@
は、
要素~自身, および要素と同じ~groupに属する要素の集合からなる
— ここで 2 つの要素が同じ~groupに属するとは、
~AND↓ が満たされることを意味する:
◎
The radio button group that contains an input element a also contains all the other input elements b that fulfill all of the following conditions:
-
どちらも `Radio$st `状態$にある
◎
The input element b's type attribute is in the Radio Button state.
-
互いの`~form所有者$は、
同じである(どちらも ~NULL の場合も含む)
◎
Either a and b have the same form owner, or they both have no form owner.
-
互いに同じ`~tree$内にある
◎
Both a and b are in the same tree.
-
どちらも `name$a 属性を有していて,それらの値は次を満たす
⇒
[
どちらも空でない
]~AND[
互いに等しい
]
◎
They both have a name attribute, their name attributes are not empty, and the value of a's name attribute equals the value of b's name attribute.
`~tree$内にある要素が属する`~radio~button~group$は,他にも別の要素を含んでいなければナラナイ。
◎
A tree must not contain an input element whose radio button group contains only that element.
要素に対し,次のいずれかが生じたときは、
その後の時点で[
要素の`~check有りか$fe ~EQ ~T
]ならば,[
その時点で要素が属する`~radio~button~group$
]内の他のすべての要素の`~check有りか$feは ~F になるモノトスル:
◎
When any of the following phenomena occur, if the element's checkedness state is true after the occurrence, the checkedness state of all the other elements in the same radio button group must be set to false:
要素~用の`~input作動化の挙動$は、
次に従う:
◎
The input activation behavior is to run the following steps:
-
~IF[
要素は`接続されて$いない
]
⇒
~RET
◎
If the element is not connected, then return.
-
`入力~eventを発火する$( 要素, `input$et )
◎
Fire an event named input at the element with the bubbles and composed attributes initialized to true.
-
`入力~eventを発火する$( 要素, `change$et )
◎
Fire an event named change at the element with the bubbles attribute initialized to true.
拘束~検証
⇒
要素が次を満たしている間は、
`欠落である難あり$になる
⇒
要素が属する`~radio~button~group$を %G とするとき
⇒
[
%G 内のある要素は`必須$である
]~AND[
%G 内のどの要素も,その`~check有りか$fe ~EQ ~F
]
◎
Constraint validation: If an element in the radio button group is required, and all of the input elements in the radio button group have a checkedness that is false, then the element is suffering from being missing.
次の例の "クロ" は、
何らかの理由で`必須$かつ`不能化され$feるように指定されている:
◎
The following example, for some reason, has specified that puppers are both required and disabled:
`Radio-1^xCode
利用者が "シロ" を選択しないまま この~formを提出しようとした場合、
両 `input$e 要素とも`欠落である難あり$になる
—
`~radio~button~group$内には`必須$な要素(すなわち,最初のもの)があり、
この~group内のどの要素も, その`~check有りか$feは ~F なので。
◎
If the user tries to submit this form without first selecting "Doggo", then both input elements will be suffering from being missing, since an element in the radio button group is required (viz. the first element), and both of the elements in the radio button group have a false checkedness.
他方、
利用者が "シロ" を選択してから~formを提出した場合、
両 `input$e 要素とも,`欠落である難あり$にはならない
— この~group内では、
他のものが`必須$にされているが, `~check有りか$feが ~F でないものもあるので。
◎
On the other hand, if the user selects "Doggo" and then submits the form, then neither input element will be suffering from being missing, since while one of them is required, not all of them have a false checkedness.
注記:
`~radio~button~group$ %G 内のどの~radio~buttonも~checkされていない場合、
~UIにおいても, %G 内のそれらは 初期時から~checkされないままになる
— %G 内のいずれかが(利用者または~scriptにより)~checkされるまでは。
◎
If none of the radio buttons in a radio button group are checked, then they will all be initially unchecked in the interface, until such time as one of them is checked (either by the user or by script).
`Radio^bk
`value$m ~IDL属性は、
`既定か~on~mode$iになる。
◎
The value IDL attribute is in mode default/on.
◎
The following common input element content attributes and IDL attributes apply to the element: checked and required content attributes; checked and value IDL attributes.
◎
The value IDL attribute is in mode default/on.
◎
The input and change events apply.
◎
The following content attributes must not be specified and do not apply to the element: accept, alpha, alt, autocomplete, colorspace, dirname, formaction, formenctype, formmethod, formnovalidate, formtarget, height, list, max, maxlength, min, minlength, multiple, pattern, placeholder, popovertarget, popovertargetaction, readonly, size, src, step, and width.
◎
The following IDL attributes and methods do not apply to the element: files, list, selectionStart, selectionEnd, selectionDirection, valueAsDate, and valueAsNumber IDL attributes; select(), setRangeText(), setSelectionRange(), stepDown(), and stepUp() methods.
4.10.5.1.17. `File^st 状態( `type=file^c )
`File$st `状態$にある `input$e 要素に対しては、
この節の規則が適用される。
◎
When an input element's type attribute is in the File Upload state, the rules in this section apply.
要素は、
`選択された~file~list@
を`表現-$する。
~list内の各~fileは,その[
~filename, 型, ~data内容
]からなる。
◎
The input element represents a list of selected files, each file consisting of a filename, a file type, and a file body (the contents of the file).
~filenameは,`~path成分$を包含しないようにするモノトスル
— 利用者が~directory階層~全体を選択しようが,複数の~directoryから同じ名前を伴う複数の~fileを選択しようが。
`File$st 状態の目的においては、
`~path成分@
は,~filename内の文字 `005C^U `\^smb で分離される部位である
【?】
。
◎
Filenames must not contain path components, even in the case that a user has selected an entire directory hierarchy or multiple files with the same name from different directories. Path components, for the purposes of the File Upload state, are those parts of filenames that are separated by U+005C REVERSE SOLIDUS character (\) characters.
`multiple$a 属性が設定されない限り,`選択された~file~list$内の~fileは 1 個までにするモノトスル。
◎
Unless the multiple attribute is set, there must be no more than one file in the list of selected files.
そのような要素 %要素 用の`~input作動化の挙動$は
⇒
`適用-可能なら~pickerを示す$( %要素 )
◎
The input activation behavior for such an element element is to show the picker, if applicable, for element.
要素が`変異-可能$feな場合、
~UAは:
-
次を利用者に許容するベキである
⇒
~list内の~fileを他の仕方で変更する
— 例:
~drag&~dropにより~fileたちを[
追加する/除去する
]など。
-
利用者がそれを行ったときは、
次を走らすモノトスル
⇒
要素~用に`~file選択を更新する$()
◎
If the element is mutable, the user agent should allow the user to change the files on the list in other ways also, e.g., adding or removing files by drag-and-drop.\
When the user does so, the user agent must update the file selection for the element.
要素が`変異-可能$feでない場合、
~UAは,次を利用者に許容しないモノトスル
⇒
`選択された~file~list$を変更する
◎
If the element is not mutable, the user agent must not allow the user to change the element's selection.
所与の要素 %要素 用に
`~file選択を更新する@
ときは
⇒
`要素~taskを~queueする$( `利用者~対話~task~source$, %要素, 次の手続き )
◎
To update the file selection for an element element:
• Queue an element task on the user interaction task source given element and\
手続きは:
◎
the following steps:
-
%要素 の`選択された~file~list$を,利用者の選択を表現するように更新する
◎
Update element's selected files so that it represents the user's selection.
-
`入力~eventを発火する$( %要素, `input$et )
◎
Fire an event named input at the input element, with the bubbles and composed attributes initialized to true.
-
`入力~eventを発火する$( %要素, `change$et )
◎
Fire an event named change at the input element, with the bubbles attribute initialized to true.
拘束~検証
⇒
要素が次を満たしている間は、
`欠落である難あり$になる
⇒
[
要素は`必須$である
]~AND[
`選択された~file~list$は空
]
◎
Constraint validation: If the element is required and the list of selected files is empty, then the element is suffering from being missing.
`accept@a
属性により、
どの~file型が受容されるかについての~hintを~UAに供せる。
◎
The accept attribute may be specified to provide user agents with a hint of what file types will be accepted.
この属性に指定する値は、
`~commaで分離された~token集合$であって,その各~tokenは`~ASCII大小無視$で次のいずれかに合致する文字列でなければナラナイ:
◎
If specified, the attribute must consist of a set of comma-separated tokens, each of which must be an ASCII case-insensitive match for one of the following:
-
`audio/*^l
◎
The string "audio/*"
-
音響~fileが受容されることを指示する。
◎
Indicates that sound files are accepted.
-
`video/*^l
◎
The string "video/*"
-
動画~fileが受容されることを指示する。
◎
Indicates that video files are accepted.
-
`image/*^l
◎
The string "image/*"
-
画像~fileが受容されることを指示する。
◎
Indicates that image files are accepted.
-
`~parameterを伴わない妥当な~MIME型~文字列$
◎
A valid MIME type string with no parameters
-
その型の~fileが受容されることを指示する。
◎
Indicates that files of the specified type are accepted.
-
最初の文字 ~EQ `002E^U `.^smb
◎
A string whose first character is a U+002E FULL STOP character (.)
-
その~file拡張子を伴う~fileが受容されることを指示する。
◎
Indicates that files with the specified file extension are accepted.
どの 2 つの~tokenも、
`~ASCII大小無視$で互いに合致してはナラナイ(すなわち,重複は許容されない)。
~UAは、
属性から~tokenたちが成す~listを得するときは,その値を`~commaで分割-$するモノトスル。
◎
The tokens must not be ASCII case-insensitive matches for any of the other tokens (i.e. duplicates are not allowed). To obtain the list of tokens from the attribute, the user agent must split the attribute value on commas.
~UAは、
この属性の値を[
汎用~file~pickerよりも適切な~UI
]を表示するために利用してもヨイ。
一例として、
次に挙げる選択肢を利用者に提供することもできる:
◎
User agents may use the value of this attribute to display a more appropriate user interface than a generic file picker. For instance,\
-
値 `image/*^l が与えられたなら、
局所的~cameraを利用したり,利用者に写真集から写真を選択してもらう。
◎
given the value image/*, a user agent could offer the user the option of using a local camera or selecting a photograph from their photo collection;\
-
値 `audio/*^l が与えられたなら、
~headset~microphoneを利用して~clipを録音する。
◎
given the value audio/*, a user agent could offer the user the option of recording a clip using a headset microphone.
~UAは、[
これらの~tokenのいずれかにより受容されない~file
]を利用者が選択するのを防止するベキである。
◎
User agents should prevent the user from selecting files that are not accepted by one (or more) of these tokens.
注記:
特定の形式による~dataを~~期待する作者には、[
~MIME型,それに対応する拡張子
]どちらも指定することが奨励される。
◎
Authors are encouraged to specify both any MIME types and any corresponding extensions when looking for data in a specific format.
例えば、
Microsoft Word 文書を Open Document Format ~fileに変換する~appを考える。
Microsoft Word 文書の ~MIME型や拡張子には多様なものがあるので、
~siteは次のように いくつかを~listできる:
◎
For example, consider an application that converts Microsoft Word documents to Open Document Format files. Since Microsoft Word documents are described with a wide variety of MIME types and extensions, the site can list several, as follows:
`File-1^xCode
[
~file拡張子のみを利用して~file型を述べる~platform
]においては、
ここに~listされた拡張子を利用して許容される文書を絞込みつつ、
~systemが~MIME型~登録~表t
— ~MIME型を~systemで利用している拡張子に対応付けるもの —
を備えているならば,それに基づいて他にも許容される拡張子を決定できる。
類似に,[
各~文書に~filenameや拡張子は付与しないが,内部的には~MIME型を付与する~system
]においては、
~MIME型を利用して許容される~fileを選びつつ、
~systemが拡張子~登録~表t
— 既知な拡張子を~systemで利用している~MIME型に対応付けるもの —
を備えているならば,~listされた拡張子を利用して他にも許容される~MIME型を決定できる。
◎
On platforms that only use file extensions to describe file types, the extensions listed here can be used to filter the allowed documents, while the MIME types can be used with the system's type registration table (mapping MIME types to extensions used by the system), if any, to determine any other extensions to allow. Similarly, on a system that does not have filenames or extensions but labels documents with MIME types internally, the MIME types can be used to pick the allowed files, while the extensions can be used if the system has an extension registration table that maps known extensions to MIME types used by the system.
拡張子は、
多義的になる傾向にある(例えば、
拡張子 `.dat^l を利用する形式は,いくつあるかわからず、
利用者は概して,~fileを
— それが Microsoft Word 文書でなくとも —
ごく容易に `.doc^l 拡張子に改称し得る)。
また、
~MIME型にも依拠できない傾向にある(例:
多くの形式は、
正式に型が登録されておらず,実施における~MIME型は何種類もある)。
作者は,そのことに留意して、
~clientから受取った~dataは,通例通り用心深く扱うベキである
— 利用者が敵対的でなかろうが,~UAが `accept$a 属性の要件を全部的に順守していようが、
期待される形式でないかもしれないので。
◎
Extensions tend to be ambiguous (e.g. there are an untold number of formats that use the ".dat" extension, and users can typically quite easily rename their files to have a ".doc" extension even if they are not Microsoft Word documents), and MIME types tend to be unreliable (e.g. many formats have no formally registered types, and many formats are in practice labeled using a number of different MIME types). Authors are reminded that, as usual, data received from a client should be treated with caution, as it may not be in an expected format even if the user is not hostile and the user agent fully obeyed the accept attribute's requirements.
歴史的な理由から、
`value$m ~IDL属性は,~filenameに文字列 `C:\fakepath\^l を接頭する。
一部の旧来の~UAは、
実際に全部的な~pathを含めていた(それは、
~securityの脆弱性であった)。
そのため、
`value$m ~IDL属性から~filenameを後方-互換な仕方で得することは,自明でない。
次の関数は、
~filenameを~~相応に互換な方式で抽出する:
◎
For historical reasons, the value IDL attribute prefixes the filename with the string "C:\fakepath\". Some legacy user agents actually included the full path (which was a security vulnerability). As a result of this, obtaining the filename from the value IDL attribute in a backwards-compatible way is non-trivial. The following function extracts the filename in a suitably compatible manner:
function extractFilename(%path) {
if (%path.substr(0, 12) == "C:\\fakepath\\")
return %path.substr(12); //
var %x;
%x = %path.lastIndexOf('/');
if (%x >= 0) //
return %path.substr(%x + 1);
%x = %path.lastIndexOf('\\');
if (%x >= 0) //
return %path.substr(%x + 1);
return %path; //
}
これは、
次のように利用できる:
◎
This can be used as follows:
<p><input type=filename=image onchange="updateFilename(this.value)"></p>
<p>あなたが選んだ~filenameは: <span id="filename">(none)</span></p>
<script>
function updateFilename(%path) {
var %name = extractFilename(%path);
document.getElementById('filename').textContent = %name;
}
</script>
`File^bk
`value$m ~IDL属性は、
`~filename~mode$iになる。
要素の `value$a 属性は、
省略されなければナラナイ。
◎
The following common input element content attributes and IDL attributes apply to the element: accept, multiple, and required content attributes; files and value IDL attributes; select() method.
◎
The value IDL attribute is in mode filename.
◎
The input and change events apply.
◎
The following content attributes must not be specified and do not apply to the element: alpha, alt, autocomplete, checked, colorspace, dirname, formaction, formenctype, formmethod, formnovalidate, formtarget, height, list, max, maxlength, min, minlength, pattern, popovertarget, popovertargetaction, placeholder, readonly, size, src, step, and width.
◎
The element's value attribute must be omitted.
◎
The following IDL attributes and methods do not apply to the element: checked, list, selectionStart, selectionEnd, selectionDirection, valueAsDate, and valueAsNumber IDL attributes; setRangeText(), setSelectionRange(), stepDown(), and stepUp() methods.
4.10.5.1.18. `Submit^st 状態( `type=submit^c )
`Submit$st `状態$にある `input$e 要素に対しては、
この節の規則が適用される。
◎
When an input element's type attribute is in the Submit Button state, the rules in this section apply.
◎追跡路
要素は、
作動化-時に~formを提出する~buttonを`表現-$する。
~buttonの~labelは、[
要素が `value$a 属性を有するならば その属性の値 /
~ELSE_ “提出する” に似た何かを意味する`実装定義$な文字列
]になるモノトスル。
要素は、
`~button$であり,また `提出-~button$でもある。
◎
(This is a tracking vector.)
The input element represents a button that, when activated, submits the form. If the element has a value attribute, the button's label must be the value of that attribute; otherwise, it must be an implementation-defined string that means "Submit" or some such. The element is a button, specifically a submit button.
注記:
~buttonの横幅は、
指紋収集し得るような少しばかりの情報を漏洩し得る
— 既定の~labelは`実装定義$であり、
~buttonの横幅は,概してその~labelに依存するので。
この情報は、[
~UA, 利用者の~locale
]の同一性に強く相関される見込みが高い。
◎
Since the default label is implementation-defined, and the width of the button typically depends on the button's label, the button's width can leak a few bits of fingerprintable information. These bits are likely to be strongly correlated to the identity of the user agent and the user's locale.
要素 %要素 用の`~input作動化の挙動$は、
所与の
( %~event )
に対し,次に従う:
◎
The element's input activation behavior given event is as follows:
-
~IF[
%要素 の`~form所有者$ ~EQ ~NULL
]~OR[
%要素 の`~node文書$は`全部的に作動中$でない
]
⇒
~RET
◎
If the element does not have a form owner, then return.
◎
If the element's node document is not fully active, then return.
-
%利用者-関与i ~LET `~event用の~naviに対する利用者-関与i$( %~event )
◎
↓
-
`~formを提出する$( %要素 の`~form所有者$, %要素, %利用者-関与i )
◎
Submit the element's form owner from the element with userInvolvement set to event's user navigation involvement.
次に挙げる属性は、
`~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.
`Submit^bk
`value$m ~IDL属性は、
`既定~mode$iになる。
◎
The following common input element content attributes and IDL attributes apply to the element: dirname, formaction, formenctype, formmethod, formnovalidate, formtarget, popovertarget, and popovertargetaction content attributes; value IDL attribute.
◎
The value IDL attribute is in mode default.
◎
The following content attributes must not be specified and do not apply to the element: accept, alpha, alt, autocomplete, checked, colorspace, height, list, max, maxlength, min, minlength, multiple, pattern, placeholder, readonly, required, size, src, step, and width.
◎
The following IDL attributes and methods do not apply to the element: checked, files, list, selectionStart, selectionEnd, selectionDirection, valueAsDate, and valueAsNumber IDL attributes; select(), setRangeText(), setSelectionRange(), stepDown(), and stepUp() methods.
◎
The input and change events do not apply.
4.10.5.1.19. `Image^st 状態( `type=image^c )
`Image$st `状態$にある `input$e 要素に対しては、
この節の規則が適用される。
◎
When an input element's type attribute is in the Image Button state, the rules in this section apply.
要素は、
それにより[
利用者が座標を選択して~formを提出できる画像 /
あるいは代替として 利用者が~formを提出できる~button
]を`表現-$する。
要素は`~button$であり,`提出-~button$でもある。
◎
The input element represents either an image from which a user can select a coordinate and submit the form, or alternatively a button from which the user can submit the form. The element is a button, specifically a submit button.
注記:
要素~用の座標を成す[
x / y
]成分は、
~controlの名前に[
`.x^l / `.y^l
]を付加して導出される 2 個の~entryとして,
`~form提出の間@~HTMLforms#constructing-the-form-data-set$に~serverへ送信される。
◎
The coordinate is sent to the server during form submission by sending two entries for the element, derived from the name of the control but with ".x" and ".y" appended to the name with the x and y components of the coordinate respectively.
画像は
`src@a
属性により与えられる。
この属性は、
指定されなければナラナイ
— 加えて、
指定する値は次を満たさなければナラナイ:
◎
The image is given by the src attribute. The src attribute must be present, and\
-
`前後~空白~可の妥当かつ空でない~URL$を包含する
◎
must contain a valid non-empty URL potentially surrounded by spaces\
-
対話的でない画像~資源を参照している
— ~animate化されていてもヨイが、
~pageをめくるような~UIを備えるもの, ~scriptで動かすものは除く。
◎
referencing a non-interactive, optionally animated, image resource that is neither paged nor scripted.
以下に
“除外される~UA”
を除き、
~UAは,
“必要が生じた時点”
で要素の
“画像を~fetchする”
モノトスル:
◎
When any of the these events occur
-
“必要が生じた時点”
とは、
次のいずれかが生じたときを意味する:
-
要素が `src$a 属性を有している下で,
要素の`状態$が `Image$st 以外から `Image$st に変化したとき
(要素の作成-時も含まれる)
-
要素が `Image$st `状態$にある下で,
要素の `src$a 属性が別の値に[
設定-/変更-
]されたとき
ただし、
~UAが同じ画像への~fetchをすでに試みていた場合は除く
— 具体的には
⇒
要素が過去のある時点で、
`Image$st `状態$にあって,そのときの `src$a 属性の値が,前項のいずれかが生じた後のそれと同じである場合
◎
the input element's type attribute is first set to the Image Button state (possibly when the element is first created), and the src attribute is present
◎
the input element's type attribute is changed back to the Image Button state, and the src attribute is present, and its value has changed since the last time the type attribute was in the Image Button state
◎
the input element's type attribute is in the Image Button state, and the src attribute is set or changed
-
“除外される~UA”
とは、
次のいずれかを意味する:
-
画像を~supportしていない
-
画像の~supportは不能化されている
-
画像をその場( `on demand^en )で~fetchすることにしている
【
“その場” とは,[
画像が実際の呈示に必要になることが判明する時点まで画像の~fetch時機を遅らせる
]ことを意味すると思われるが、
その挙動は,ここには述べられていない。
】
◎
then unless the user agent cannot support images, or its support for images has been disabled, or the user agent only fetches images on demand,\
-
“画像を~fetchする” ための手続きは:
◎
↑↓ or the src attribute's value is the empty string, run these steps:
-
%要素 ~LET 当の `input$e 要素
◎
↓
-
%文書 ~LET %要素 の`~node文書$
◎
↓
-
(次に従って画像~URLを検査する):
-
%src ~LET %要素 の `src$a 属性の値
-
~IF [
%src ~EQ 空~文字列
]
⇒
~RET
-
%~URL ~LET `~URLを符号化法の下で相対的に構文解析する$( %src, %文書 )
-
~IF[
%~URL ~EQ `失敗^i
]
⇒
~RET
◎
Let url be the result of encoding-parsing a URL given the src attribute's value, relative to the element's node document.
◎
If url is failure, then return.
-
%要請 ~LET 新たな`要請$
— その
⇒#
`~URL$rq ~SET %~URL,
`~client$rq ~SET %文書 に`関連な設定群~obj$,
`行先$rq ~SET `image^l,
`起動元~種別$rq ~SET `input^l,
`資格証~mode$rq ~SET `include^l,
`~URL資格証を利用するか$rq ~SET ~T
◎
Let request be a new request whose URL is url, client is the element's node document's relevant settings object, destination is "image", initiator type is "input", credentials mode is "include", and whose use-URL-credentials flag is set.
-
%要請 を`~fetchする$
— 次を与える下で:
◎
Fetch request, with\
画像の~fetchingは、[
上で【!defined below】 %要請 を~fetchする間に
【`~fetch~taskを~queueする$手続きにより】
`~network用~task~source$から`~queueされ$る`~task$
]を走らすときまで,
当の要素の`~node文書$の`~load~eventを遅延-$するモノトスル。
◎
Fetching the image must delay the load event of the element's node document until the task that is queued by the networking task source once the resource has been fetched (defined below) has been run.
画像は ~AND↓ を満たすならば
`可用@
であるとされる:
-
~network~errorを伴わずに得された
-
画像の型は、
~UAが~supportする型である
-
その型の妥当な画像である
◎
If the image was successfully obtained, with no network errors, and the image's type is a supported image type, and the image is a valid image of that type, then the image is said to be available.\
画像が完全に~downloadされる前にこれが満たされる場合、[
画像を~fetchする間に`~network用~task~source$から`~queueされ$た各`~task$
]は、
画像の呈示を適切に更新するモノトスル。
◎
If this is true before the image is completely downloaded, each task that is queued by the networking task source while the image is being fetched must update the presentation of the image appropriately.
【
したがって、
画像の描画-可能な~dataが一部でも得られていれば,`可用$とされ得ることになる。
その場合でも,定義に従えば、
~network~errorにより~downloadが中断された時点で`可用$でないとされることになる(?)が、
その場合の `load^et / `error^et ~eventの取扱いがはっきしりない
(両者とも発火するのか? ~UAが`可用$かそうでないかを確定させた時点で片方だけ発火するのか?)。
】
~UAは、
画像の型を決定するときには,[
公式の型【!official type】として,画像に結付けられた`~Content-Type~metadata$( `Content-Type^h ~header )
]を与える下で,`画像を特定的に~sniffするための規則$を適用するベキである。
これらの規則が適用されない場合、
画像の`~Content-Type~metadata$が画像の型を与えるモノトスル。
◎
The user agent should apply the image sniffing rules to determine the type of the image, with the image's associated Content-Type headers giving the official type. If these rules are not applied, then the type of the image must be the type given by the image's associated Content-Type headers.
~UAは、
要素の資源に対しては:
◎
↓
-
画像でないものを~supportしないモノトスル。
◎
User agents must not support non-image resources with the input element.\
-
埋込まれている実行-可能~codeを走らせないモノトスル。
◎
User agents must not run executable code embedded in the image resource.\
-
複数~pageからなる場合は、
最初の~pageのみを表示するモノトスル。
◎
User agents must only display the first page of a multipage resource.\
-
対話的に動作させないモノトスル。
◎
User agents must not allow the resource to act in an interactive fashion, but\
-
~animationがあれば尊守するベキである。
◎
should honor any animation in the resource.
`alt@a
属性は、
画像を利用できない利用者や~UA用に,~textな~labelを~button用に供する。
要素は、
この属性を有してなければナラナイ。
その値は、
画像を可用にできない場合に等価な~buttonになるような,空でない適切な~labelを与える文字列でなければナラナイ。
◎
The alt attribute provides the textual label for the button for users and user agents who cannot use the image. The alt attribute must be present, and must contain a non-empty string giving the label that would be appropriate for an equivalent button if the image was unavailable.
要素は、
`寸法~属性$を~supportする。
◎
The input element supports dimension attributes.
要素は、
次のいずれかを`表現-$する:
◎
↓
-
次が満たされるならば、
`src$a 属性が指定する画像から`座標を選定する$ための~control
⇒
[
要素は `src$a 属性を有する
]~AND[
画像は`可用$であって,~UAは その画像を表示するように環境設定されている
]
◎
If the src attribute is set, and the image is available and the user agent is configured to display that image, then the element represents a control for selecting a coordinate from the image specified by the src attribute.\
加えて,要素が`変異-可能$feならば、
~UAは,次を利用者に許容するベキである
⇒
この`座標を選定する$
◎
In that case, if the element is mutable, the user agent should allow the user to select this coordinate.
-
他の場合、
`alt$a 属性が与える~labelを伴う提出-~button。
◎
Otherwise, the element represents a submit button whose label is given by the value of the alt attribute.
要素~用の`~input作動化の挙動$は、
所与の
( %~event )
に対し,次に従う:
◎
The element's input activation behavior is as follows:
-
~IF[
要素の`~form所有者$ ~EQ ~NULL
]
⇒
~RET
◎
If the element does not have a form owner, then return.
-
~IF[
要素の`~node文書$は`全部的に作動中$でない
]
⇒
~RET
◎
If the element's node document is not fully active, then return.
-
~IF[
利用者は、
座標を明示的に選択しながら,~controlを作動化した
]
⇒
要素の`選定された座標$ ~SET その座標
◎
If the user activated the control while explicitly selecting a coordinate, then set the element's selected coordinate to that coordinate.
注記:
これがアリになるのは、
上で要旨した条件
— 要素が座標を選択する~controlを`表現-$するとき —
の下に限られる。
そうであっても、
利用者は,座標を明示的に選択することなく~controlを作動化するかもしれない。
◎
This is only possible under the conditions outlined above, when the element represents a control for selecting such a coordinate. Even then, the user might activate the control without explicitly selecting a coordinate.
-
%利用者-関与i ~LET `~event用の~naviに対する利用者-関与i$( %~event )
◎
↓
-
`~formを提出する$( 要素の`~form所有者$, 要素, %利用者-関与i )
◎
Submit the element's form owner from the element with userInvolvement set to event's user navigation involvement.
要素の
`選定された座標@
は、
~AND↓ を満たす実数 ( %x, %y ) を表現する 2 個の`妥当な整数$からなり,
初期~時は ( 0, 0 ) になるとする:
◎
The element's selected coordinate consists of an x-component and a y-component. It is initially (0, 0).\
-
( %x, %y ) は、
要素の画像の座標~空間における位置を表現する。
◎
The coordinates represent the position relative to the edge of the element's image,\
-
座標~空間は、
画像の左上隅を~~原点とし,
( %x, %y ) の正な方向は ( 右方, 下方 ) とする。
◎
with the coordinate space having the positive x direction to the right, and the positive y direction downwards.
-
− ( 左端~border幅 + 左端~padding幅 )
~LTE %x ~LTE
( 横幅 + 右端~border幅 + 右端~padding幅 )
◎
The x-component must be a valid integer representing a number x in the range −(borderleft+paddingleft) ≤ x ≤ width+borderright+paddingright, where width is the rendered width of the image, borderleft is the width of the border on the left of the image, paddingleft is the width of the padding on the left of the image, borderright is the width of the border on the right of the image, and paddingright is the width of the padding on the right of the image, with all dimensions given in CSS pixels.
-
− ( 上端~border幅 + 上端~padding幅 )
~LTE %y ~LTE
( 縦幅 + 下端~border幅 + 下端~padding幅 )
◎
The y-component must be a valid integer representing a number y in the range −(bordertop+paddingtop) ≤ y ≤ height+borderbottom+paddingbottom, where height is the rendered height of the image, bordertop is the width of the border above the image, paddingtop is the width of the padding above the image, borderbottom is the width of the border below the image, and paddingbottom is the width of the padding below the image, with all dimensions given in CSS pixels.
ここで,すべての寸法(〜幅)は、
実際に描画された画像の `~CSS~pixel$数による寸法を表すとする。
◎
Where a border or padding is missing, its width is zero CSS pixels.
次に挙げる属性は、
`~form提出用の属性$である
⇒
`formaction$a,
`formenctype$a,
`formmethod$a,
`formnovalidate$a,
`formtarget$a
◎
The formaction, formenctype, formmethod, formnovalidate, and formtarget attributes are attributes for form submission.
- %image.`width$m [ = %value ]
- %image.`height$m [ = %value ]
-
これらの属性は、[
実際に描画された画像の寸法が既知であれば それ /
他の場合は 0
]を返す。
◎
These attributes return the actual rendered dimensions of the image, or 0 if the dimensions are not known.
-
いずれも、
設定して,対応する内容~属性を変更できる。
◎
They can be set, to change the corresponding content attributes.
`Image^bk
`value$m ~IDL属性は、
`既定~mode$iになる。
要素の `value$a 属性は、
省略されなければナラナイ。
◎
The following common input element content attributes and IDL attributes apply to the element: alt, formaction, formenctype, formmethod, formnovalidate, formtarget, height, popovertarget, popovertargetaction, src, and width content attributes; value IDL attribute.
◎
The value IDL attribute is in mode default.
◎
The following content attributes must not be specified and do not apply to the element: accept, alpha, autocomplete, checked, colorspace, dirname, list, max, maxlength, min, minlength, multiple, pattern, placeholder, readonly, required, size, and step.
◎
The element's value attribute must be omitted.
◎
The following IDL attributes and methods do not apply to the element: checked, files, list, selectionStart, selectionEnd, selectionDirection, valueAsDate, and valueAsNumber IDL attributes; select(), setRangeText(), setSelectionRange(), stepDown(), and stepUp() methods.
◎
The input and change events do not apply.
注記:
この状態の挙動を成す多くの側面は、
`img$e 要素の挙動に類似する。
読者には、
その節も読むことが奨励される。
同じ要件の多くが,より詳細に述べられているので。
◎
Many aspects of this state's behavior are similar to the behavior of the img element. Readers are encouraged to read that section, where many of the same requirements are described in more detail.
次の~formがあるとする:
◎
Take the following form:
`Image-1^xCode
利用者が画像の 座標 ( 127,40 ) を~clickした場合、
~formを提出するときに利用される~URLは,
`process.cgi?where.x=127&where.y=40^l になる。
◎
If the user clicked on the image at coordinate (127,40) then the URL used to submit the form would be "process.cgi?where.x=127&where.y=40".
(この例では、
利用者が,~mapではなく "所在~listを示す" と~labelされた~buttonを見ていて,それを~clickした場合には、
~mapから選ぶ代わりに,~serverに所在たちが成す~listを示すようにして、
そこからから選ぶものと見做されている。)
◎
(In this example, it's assumed that for users who don't see the map, and who instead just see a button labeled "Show location list", clicking the button will cause the server to show a list of locations to pick from instead of the map.)