input (type="image")NN 6 IE 4 DOM 1

イメージタイプの input オブジェクトは、まずボタンに似たフォームコントロール要素といえますが、img 要素の特性もいくつか備えています。デフォルトのビヘイビアは送信タイプのボタンと同じです。イメージの矩形領域内でマウスクリックした位置を表す座標値はフォームの送信時にフォームデータとして elemName.x=65&elemName.y=44 のフォーマットで送信されます。ただし、他のタイプの入力要素の場合と異なり、初期のブラウザはこのタイプの入力要素を含むスクリプトには対応できません。Windows 版 IE では、同時に送信されるフォームからのこの要素への参照は認識されない可能性があります。ただし、ID によるフォームへのアクセスは確実に行われます。

 
相当する HTML コード
 
<input type="image">
 
オブジェクト参照
 
[window.]document.formName.elementName
[window.]document.forms[i].elements[i]
[window.]document.getElementById("elementID")
 
オブジェクト固有のプロパティ
 
altcompletedynsrcformheight
hspacelooplowsrcnamesrc
starttypeuseMapvspacewidth
 
オブジェクト固有のメソッド
 
handleEvent()
 
オブジェクト固有のイベントハンドラープロパティ
 
ハンドラーNNIEDOM
onblurなし4なし
onclick232
onfocusなし4なし
onmousedown442
onmousemove642
onmouseout642
onmouseover642
onmouseup442
altNN 6 IE 4 DOM 1

読み書き

ブラウザがグラフィックをダウンロードしない場合やイメージのダウンロード完了を待っている間にイメージタイプの input 要素の代わりに表示する (または読み上げる) テキストを示します。詳細については、img オブジェクトの alt プロパティを参照してください。

completeNN なし IE 4 DOM なし

読み取り専用

イメージタイプの input 要素の src または lowsrc のイメージファイルの読み込みが完了したかどうかを報告します。詳細については、img オブジェクトの complete プロパティを参照してください。

dynsrcNN なし IE 4 DOM なし

読み書き

イメージタイプの input 要素を使って表示するビデオクリップの URL を示します。詳細については、img オブジェクトの dynsrc プロパティを参照してください。

formNN 6 IE 4 DOM 1

読み取り専用

現在の要素が入っている form 要素への参照を返します。この要素からイベントを処理する場合は、イベントハンドラー関数がイベントオブジェクトの target または srcElement プロパティとして input 要素に自動的にアクセスします。form プロパティを読み取ることにより、スクリプトで同じフォーム内の他のコントロールに簡単にアクセスできるようになります。

 
 
var theForm = evt.srcElement.form;
 

form 要素オブジェクトへの参照

 
既定値

なし

height、widthNN なし IE 4 DOM なし

読み書き

input 要素に表示されるイメージの高さと幅をピクセル数で示します。詳細については、img オブジェクトの height プロパティと width プロパティを参照してください。

hspace、vspaceNN なし IE 4 DOM なし

読み書き

イメージタイプの input オブジェクトの周りの横マージンと縦マージンをピクセル数で示します。詳細については、img オブジェクトの hspace プロパティと vspace プロパティを参照してください。

loopNN なし IE 4 DOM なし

読み書き

dynsrc 属性でビデオクリップを指定した場合、loop プロパティでクリップの再生回数を制御します。詳細については、img オブジェクトの loop プロパティを参照してください。

lowsrcNN なし IE 4 DOM なし

読み書き

src 属性で指定されたイメージのダウンロードに時間がかかる場合に代わりに読み込む、低解像度イメージまたは代替イメージの URL を示します。詳細については、img オブジェクトの lowsrc プロパティを参照してください。

nameNN 2 IE 3 DOM 1

読み書き

フォームコントロールに関連付けられた識別子です。このプロパティの値は、イメージの矩形領域内のクリック位置を表す座標値と合わせて、フォームの送信時に elemName.x=65&elemName.y=44 のフォーマットで送信されます。これらの座標値は他のタイプの input 要素の value の属性とプロパティの代わりになります。最近の規格では id 属性の方が推奨されていますが、多くのブラウザでは現在も、コントロールの値を送信するために、フォームコントロールに name 属性を設定する必要があります。

 
 
document.orderForm.myButton.name = "Win32";
 

識別子の命名規則に従った文字列。大文字と小文字は区別されます。識別子には空白スペースは使用できず、1 文字目に数字は使用できません。アンダースコア以外の句読点の使用は避けてください。

 
既定値

なし

srcNN 6 IE 4 DOM 1

読み書き

イメージタイプの input 要素に現在読み込まれている、またはこれから読み込まれるイメージファイルの絶対 URL または相対 URL を示します。詳細については、img オブジェクトの src プロパティを参照してください。

startNN なし IE 4 DOM なし

読み書き

dynsrc 属性でビデオクリップを設定した場合、start プロパティでクリップの再生を開始するアクションを制御します。詳細については、img オブジェクトの start プロパティを参照してください。

typeNN 6 IE 4 DOM 1

読み取り専用

フォームコントロール要素のタイプを返します。値はすべて小文字で返されます。行う処理によっては、特定のタイプを検索するためにすべてのフォーム要素を調べる必要があります。たとえば、"text" タイプのフォームコントロールをすべてクリアにし、他のタイプのコントロールはそのままにする場合などがこれに該当します。

 
 
if (document.forms[0].elements[3].type == "image") {
    // process image input type here
}
 

buttoncheckboxfilehiddenimagepasswordradioresetselect-multipleselect-onesubmittexttextarea のいずれかの定数を示す文字列

 
既定値

image

useMapNN 6 IE 4 DOM 1

読み書き

イメージに適用されるクライアント側のイメージマップのホットエリアとリンクが含まれているドキュメントにある map 要素の URL を示します。詳細については、img オブジェクトの useMap プロパティを参照してください。

vspace

hspace を参照してください。

width

height を参照してください。

handleEvent[]NN |4| IE なし DOM なし

handleEvent(event)

メソッドへのパラメータとして指定されたイベントを受け入れ、処理するようにオブジェクトに指示します。指定のイベントを処理するには、オブジェクトが適切なタイプのイベントハンドラーを持っている必要があります。Navigator 4 にのみ実装されています。

 
パラメータ
 
  • Navigator 4 で有効な event オブジェクト
 
戻り値

なし