form
要素、 input
要素 accept
属性 (HTML)[1] HTML の form
要素・
input
要素の
accept
属性は、
フォーム処理エージェントが正しく扱うことのできる媒体型を指定します。
form
、
input
type
file
、
(form
)accept
(accept
(承認) より、 HTTP の
Accept:
頭欄と同じ)[5] 仕様書:
[10]
HTML 4 DTD 注釈 (参考) には
list of MIME types for file upload
(ファイルうp用 MIME 型の並び)
と説明があります。
[2] この属性の値は %ContentTypes
です。
%ContentType
を読点で分離して複数指定できます。
SGML 的には CDATA
です。 HTML 4 17.3
例によって、実際には、読点の前後に空白を挿入できます。
[21] Web Forms 2.0 では、属性値の構文は、 次のように定義されています WF2 2.15:
- accept := space* range [ space* "," space* range]* space*
- range := "*/*" | type "/*" | type "/" subtype
- space := U+0020 | U+000A
- type := defined in RFC2045 [RFC2045]
- subtype := defined in RFC2045 [RFC2045]
SPACE
と
LINE FEED
だけのようです。*/*
や text/*
のような媒体型の範囲で指定して構いません。
WF2 2.15[4] この属性は省略可能です。 HTML 4
[28] 継承
form
要素の
accept
属性は、
そのフォームに属するすべての file
制御子の既定値となります。file
の
accept
属性が与えられていれば、
その制御子の属するフォームの
accept
属性は無視されます。file
の
accept
属性が与えれれていても、
非妥当なら、 */*
が指定されたものとみなします。WF2 2.15
[6] UA は、 accept
情報を利用して、
ファイル選択制御子 (input
type
file
) で選択できるファイルの種類を限定しても構いません
HTML 4 17.3。
[25] ファイル一覧
利用者エージェントは、利用者にファイルを一覧から選ぶ手段を提供していて、
ファイルの種類による濾過を行っているなら、
その構築のために accept
属性の情報を利用するべきです。
WF2 2.15
[26] ファイル作成
利用者エージェントは、利用者がファイルを作成し、
そのファイルをうpする手段を提供しているなら、
そのファイルを作成するために使用する応用を選択するために
accept
属性の情報を利用するべきです。
WF2 2.15
[27]
少なくても1つのファイルが accept
で指定された条件を満足しないなら、
typeMismatch
旗が使われます。
利用者エージェントは、
ファイルが誤った媒体型として札付けされているときに、
これを上書きする手段を利用者に提供して構いません。
WF2 2.15
[32] 誤り処理
非妥当な値が与えられていた場合、 DOM
ではそのままの値を使用しなければなりませんが、
比較時 (>>25 や提出時など) には
*/*
として処理しなければなりません。
WF2 2.18
[3] この属性の値は働きとしては HTTP の
Accept:
頭欄とよく似ていますが、
q
値を指定することはできません。
[7] フォームの提出に使う媒体型の指定は、 accept
属性ではなく enctype
属性により行います。
accept-charset
属性は名前や HTTP の頭欄から類推すると
accept
属性とセットのように思えますが、
実際には enctype
属性と組になっています。
[8] HTML 4 では form
要素と input
要素に指定できますが、両方に指定した場合の相互作用については規定がありません。
[9] form
要素の accept
属性は、
HTML 4 で追加されました。 HTML 4.0 では仕様書本文内の DTD
素片や各種 DTD 本体で accept
属性の属性定義が欠落しており、
仕様書本文の規定だけが存在していました。 HTML 4.01
で DTD に追加されました HTML 4 A.1.1.12。
[31]
Web Forms 2.0 で、
属性値の構文が拡張され、更に
*
が使えるようになりました。
[29] WF2 2.15
<input type="file" name="avatar" accept="image/*"/>
この例では、 image/png
(PNG)、
image/jpeg
(JPEG JFIF)、
image/svg+xml
(SVG)
などをうpできます。
[30] 音声日記の執筆フォームの例 WF2 2.15
<form action="/weblog/submit" method="post" enctype="multipart/form-data"> <label> Attach your audio-blog sound file: <input type="file" name="blog" accept="audio/*"/> </label> <input type="submit" value="Blog!"/> </form>
利用者エージェントは、ファイルを選択するための参照
ボタンの代わりに、
または一緒に、
録音
ボタンを提供することができます。
録音
ボタンを押すと、
録音のための応用が起動します。
[33] [WF2] HTMLFormElement.accept vs. function accept(){} (Simon Pieters 著, 版) http://lists.w3.org/Archives/Public/public-html/2008Feb/0315.html (名無しさん)
textarea
要素 accept
属性 (HTML)[11] HTML の textarea
要素の
accept
属性は、
期待される内容の媒体型を示します。
[13] 仕様書:
textarea
element
IW:WF2:"#extensions"[15] 属性値 属性値は、テキスト系媒体型名としなければなりません。 引数があっても構いません。 WF2 2.14
[16] 既定値
この属性が省略された場合や利用者エージェントが認識できない値の場合の既定値は、
text/plain
としなければなりません。
WF2 2.14
[14] 利用者エージェントは、 この属性を、より適切な編集器、 構文着色、綴り検査器等を提供するために使用して構いません。 WF2 2.14
[17]
form
要素や
input
要素の同名の
accept
属性は、
ファイル・アップロード制御子のためのもので、
意味も構文も異なっています。
WF2 2.14
[18] WF2 2.14
accept="text/plain"
[19] WF2 2.14
accept="message/news"
[20] WF2 2.14
accept="image/svg+xml"
app:accept
要素[34] AtomPub の app:accept
要素は、
集成に POST
することができる表現の媒体範囲を表します
AtomPub。
仕様書: RFC 5023 - The Atom Publishing Protocol ( 版) http://tools.ietf.org/html/rfc5023#[41] [42] section-8.3.4
[35] この要素の値は RFC 2616 で定義されている媒体範囲です。
この要素は HTTP の Accept:
頭欄と似ています。
媒体型引数を指定することもできます。しかし、
優先度はなく、 RFC 2616 で規定されている accept-params
(q
引数など) は意味を持ちません。
AtomPub
[36] 媒体範囲の周りには XMLの空白を含めることができますが、 意味を持たず、無視しなければなりません AtomPub。
[37] 媒体範囲には application/atom+xml;type=entry
を含めることができます。この値は Atomエントリー文書を表します。
AtomPub
[38] この要素が指定されなかった場合、クライアントは
application/atom+xml;type=entry
が指定されたのと等価に扱うべきです。
[44] Web Applications 1.0 r7057 Introduce extensions in accept=.]] ( ( 版)) http://html5.org/tools/web-apps-tracker?from=7056&to=7057
[45] Issue 3311016: Support accept attribute for an <input type=file> element.... - Code Review ( 版) https://codereview.chromium.org/3311016
[46] Release Notes for Safari Technology Preview 38 | WebKit () https://webkit.org/blog/7877/release-notes-for-safari-technology-preview-38/
[47] Editorial: update usage of the MIME Sniffing Standard (domenic著, ) https://github.com/whatwg/html/commit/fc82f4f8774a2e7e80f6c9477bd881f6c783b186
[48] Editorial: update usage of the MIME Sniffing Standard by domenic · Pull Request #3455 · whatwg/html () https://github.com/whatwg/html/pull/3455
[49] Make <input type="file"> reject dropped file(s) that don't match "accept" attribute · Issue #4216 · whatwg/html · GitHub () https://github.com/whatwg/html/issues/4216