input要素
w3cのhtml4.01strictより要素を抜き出しています。日本語訳ではありません。
補足は独自意見ですので参考程度でご覧ください。
input
form要素内のコントロールとされるが組み込みイベントとしてform要素外でも使用される(空要素)。
- 開始タグ
- 省略不可
- 終了タグ
- 不許可
- 包含要素
- なし(EMPTY)
- 属性
- %attrs;とname,value,checked,disabled,readonly,size,maxlength,src,alt,usemap,ismap,tabindex,accesskey,
onfocus,onblur,onselect,onchange,accept - 補足
- type="image"の時はaltは必須です。
<!ENTITY % InputType
"(TEXT | PASSWORD | CHECKBOX |
RADIO | SUBMIT | RESET |
FILE | HIDDEN | IMAGE | BUTTON)"
>
<!-- attribute name required for all but submit and reset -->
<!ELEMENT INPUT - O EMPTY -- form control -->
<!ATTLIST INPUT
%attrs; -- %coreattrs, %i18n, %events --
type %InputType; TEXT -- what kind of widget is needed --
name CDATA #IMPLIED -- submit as part of form --
value CDATA #IMPLIED -- Specify for radio buttons and checkboxes --
checked (checked) #IMPLIED -- for radio buttons and check boxes --
disabled (disabled) #IMPLIED -- unavailable in this context --
readonly (readonly) #IMPLIED -- for text and passwd --
size CDATA #IMPLIED -- specific to each type of field --
maxlength NUMBER #IMPLIED -- max chars for text fields --
src %URI; #IMPLIED -- for fields with images --
alt CDATA #IMPLIED -- short description --
usemap %URI; #IMPLIED -- use client-side image map --
ismap (ismap) #IMPLIED -- use server-side image map --
tabindex NUMBER #IMPLIED -- position in tabbing order --
accesskey %Character; #IMPLIED -- accessibility key character --
onfocus %Script; #IMPLIED -- the element got the focus --
onblur %Script; #IMPLIED -- the element lost the focus --
onselect %Script; #IMPLIED -- some text was selected --
onchange %Script; #IMPLIED -- the element value was changed --
accept %ContentTypes; #IMPLIED -- list of MIME types for file upload --
>
type = text|password|checkbox|radio|submit|reset|file|hidden|image|button [CI](大文字と小文字は同じものとして解釈する)
コントロールの種類を指定します。初期値はtext。
<p><input></p>
name = cdata [CI](大文字と小文字は同じものとして解釈する)
コントロール名を割り当てます。PHPでデータを取得する際連想配列のキーになります。
value = cdata [CA](その要素か属性値自体に大文字小文字かが定義されている。)
初期値を指定する。type属性が"radio"か"checkbox"以外の場合は省略可能。
checked [CI](大文字と小文字は同じものとして解釈する)
type属性が"radio"または"checkbox"の場合は選択されたものとする。これ以外のtype属性に指定された場合は無視される。
disabled [CI](大文字と小文字は同じものとして解釈する)
ユーザーの入力を受け付けないようにする。
readonly [CI](大文字と小文字は同じものとして解釈する)
変更の禁止
size = cdata [CN]
初期値を指定する。単位はピクセルであるがtype属性が"text"か"password"の場合は、文字数を示す整数値とする。
maxlength = number [CN]
type 属性値が"text"か"password"の場合、ユーザーの入力文字の最大数を指定します。指定したsizeを超えることも可能です。この属性の初期値は無制限です。
src = uri [CT](データの形式による。uriは大文字と小文字は識別すると思われます。-要出典-)
type属性が"image"の時、submitのボタンをグラフィカルに装飾するソースの場所を指定する。
alt = text [CS](大文字と小文字は異なるものとして解釈する)
代替テキスト。type属性が"image"の時画像(フォーム、アプレットを含む)を表示できないユーザエージェント用に代替テキストを指定すると思われる。input要素の必須属性ではない。
usemap = uri [CT](データの形式による。uriは大文字と小文字は識別すると思われます。-要出典-)
イメージマップ使用時指定する。map要素のname属性と一致させる。type属性が"image"の時に利用されると思われる。
ismap
サーバーサイドイメージマップ。a要素と共に使用しサーバーにクリックされたx座標とy座標が送信される。type属性が"image"の時に利用されると思われる。
<P><A href="http://www.acme.com/cgi-bin/competition">
<IMG src="game.gif" ismap alt="target"></A>
この例で、ユーザがx=10でy=27の地点をクリックしたときURIは「http://www.acme.com/cgi-bin/competition?10,27」である。P要素の終了タグがないのが気になるが
tabindex
キーボードからの入力によりフォーカスされる順序を指定。0から32767までの数値で指定し頭の0(001などの0)は無視する。小さい数値の方から大きい数値にに移動する。
accesskey= character [CN]
アクセスキー。1文字で記述。accesskey属性をサポートする要素はa,area,button,input,label,legend,textareaでありa要素に設定されている場合は一般的にリンクする。[CN]は入力モードにかかわらないと思われる。アクセスキーがAならば小文字のaでも日本語入力時のあであろうと同じという意味だと思われる。ただし、OSやブラウザによりAltキーなどと同時打鍵が必要な場合もあり。アクセスキー確認用ホームページ作成(a)Alt+アクセスキー(Enter)
onfocus = script [CT]
タブかポインティングディバイスでフォーカスを得たときに発生するイベント補足用。a要素、area要素、label要素、input要素、select要素、textarea要素、button要素で使用できる
onblur = script [CT]
タブかポインティングディバイスでフォーカスを失ったときに発生するイベント補足用。a要素、area要素、label要素、input要素、select要素、textarea要素、button要素で使用できる
onselect = script [CT]
ユーザーがテキストフィールドのテキストを選択した際のイベント補足用。input要素、textarea要素で使用できる
onchange = script [CT]
フォーカスを失った時フォーカスを得た時と値が変化していた時に発生するイベント補足用。input要素、select要素、textarea要素で使用できる
accept = content-type-list [CI](大文字と小文字は同じものとして解釈する)
このフォームを正確に処理するであろうサーバーのcontent typesをカンマ区切りのリストを指定する。
おそらく、type属性が"file"の時にサーバーが受け入れるファイルタイプ(MIMEタイプ)を限定する場合に使われるが実装しているブラウザはあまりないと思われる。
<input type="file" accept="image/gif,image/jpeg,image/png" name="upimage">
input要素のコントロール(type属性の種類)
text
1行入力
password
textと同じであるがアスタリスクなどで表示される。
checkbox
チェックボックスを作成する
radio
ラジオボタンを作成する
submit
サブミットボタンを作成する
image
グラフィカルなサブミットボタンを作成する。src属性で画像のURIを指定する。alt属性は必須。ポインティングディバイスでクリックした場合サブミットともに画像の左上からのクリック地点の座標位置がピクセル単位で送信される。x座標はx、y座標はyというnameで送信される。type="image"![]()
reset
リセットボタンを作成する
button
プッシュボタンを作成する
hidden
隠れコントロールを作成する
file
ファイル選択コントロールを作成する