| Checkbox | Checkbox.checked | Checkbox.defaultChecked |
| Checkbox.onclick | Checkbox.value | ClearTimeout() |
| close() | closed | confirm() |
| Crypto | Crypto.random() | Crypto.signText() |
|
Checkbox要素 ・・・ チェックボックス 対応バージョンクライアントサイドJavaScript 1.0、JavaScript 1.1で機能拡張継承元Input、HTMLElementコーディング形式一意の名前を持つ単一のCheckbox要素は、次のようにして参照されます。form.checkbox_name form.elements[i] 同じ名前で複数のチェックボックスがある場合は、配列で参照します。 form.checkbox_name[j] formcheckbox_name..length プロパティCheckbox要素は、InputオブジェクトとHTMLElementオブジェクトのプロパティを継承し、次のプロパティを定義または上書きしています。
メソッドCheckbox要素は、InputオブジェクトとHTMLElementオブジェクトのメソッドを継承します。イベントハンドラCheckbox要素は、InputオブジェクトとHTMLElementオブジェクトのイベントハンドラを継承し、次のイベントハンドラを定義または上書きしています。onclick チェックボックスがクリックされたときに呼び出されます。 HTML構文HTMLの<INPUT>タグでCheckbox要素を生成します。onClick属性にイベントハンドラを設定します。複数のCheckbox要素を生成する場合に、同じNAME属性を持つ複数の<INPUT>タグを指定してグループ化していることがよくあります。<FORM> ... <INPUT TYPE="checkbox" 型をチェックボックスと指定する。 [ NAME="name" ] このチェックボックスあるいはこれと同じ名前の チェックボックスグループをまとめて参照するときに 使用する名前。nameプロパティと同じ。 [ VALUE="value" ] チェックボックスが選択されたときに返す値。 valueプロパティと同じ。 [ CHECKED ] チェックボックスの初期状態。 defaultCheckedプロパティと同じ。 [ onClick="handler" ] チェックボックスがクリックされたときに 呼び出されるJavaScript文。 > label チェックボックスの隣りに表示するHTMLテキスト。 ... </FORM> 解説Checkbox要素は、HTMLのフォーム中のチェックボックスに対応するものです。チェックボックスの隣りに表示する文字テキストは、Checkbox要素自身ではないので、<INPUT>タグの外側に指定することに注意してください。onClickイベントハンドラには、Checkboxがチェックされたか、またはチェックをはずされたときに実行するJavaScriptコードを指定します。 checkedプロパティを調べてCheckboxの状態を判定できます。またcheckedプロパティに値を設定してCheckboxをチェックしたり、チェックをはずしたりすることもできます。ただし、checkedを設定すると、Checkboxの外観は変わりますが、onClickイベントハンドラは呼び出されないことに注意してください。 一般に、Checkbox要素にNAME属性を設定することはよいプログラミングスタイルです。Webサーバで実行されるCGIスクリプトにデータを送るフォームの一部にチェックボックスが含まれる場合は、必ずNAME属性を設定しなければなりません。NAME属性に設定した名前がnameプロパティにも設定されるので、フォームのelements配列のメンバとしてではなく直接名前でJavaScriptコードからCheckboxを参照できるようになります。これにより、コードのモジュール性と移植性が向上します。 例えば、フォームfのチェックボックスのNAME属性に"opts"を設定すると、f.optsでCheckbox要素を参照できます。しかし、一般には複数のCheckbox要素を１つのグループにまとめることが多く、そのグループの個々のメンバは同じNAME属性を持ちます（同じ名前でグループの各メンバを定義します）。このような場合、JavaScriptはCheckbox要素を配列に格納し、その配列にNAME属性で指定した名前を付けます。例えば、フォームfのCheckbox要素グループのNAME属性に"opts"を設定すると、f.optsはCheckbox要素の配列、f.opts.lengthは配列内の要素の個数をそれぞれ示します。 ただし、Navigator 2の場合、Checkbox要素グループを配列に割り当てる方法にバグがあります。詳細は以下の「バグ情報」を参照してください。 Checkbox要素のVALUE属性あるいはvalueプロパティを設定することで、フォームの送信時にチェックボックスがチェックされたかどうかを示す文字列を指定できます。チェックボックスが１つだけの場合は、デフォルト値「on」で十分です。同じ名前を持つ複数のチェックボックスを使用する場合は、個々のチェックボックスを識別できる値を指定して、どのチェックボックスが選択されたのかわかるようにします。 使用上のヒントと注意Checkbox要素を使用すると、１つまたは複数のオプションをユーザに提示できます。この要素は、選択肢の中から複数選択できるような場合に使えます。選択肢の中から１つしか選べないようなオプションの場合にはRadio要素を使います。バグ情報Checkbox要素のグループが同じNAME属性を共有する場合、JavaScriptは指定した名前の配列を生成して各要素を格納します。しかし、Navigator 2にはバグがあるので要注意です。onClick属性にイベントハンドラが指定されていなかった場合、Checkbox要素は逆順で配列に格納されます。これはまったく直観に反します。また、このバグが修正されたNavigator 3との間に非互換性が生じます。Checkbox要素にイベントハンドラ（ダミーでもかまいません）を必ず指定すれば、この問題を回避できます。例えば、それぞれのCheckbox要素の<INPUT>タグにonClick="0"を指定すればよいのです。このようにすれば、配列に格納される要素の順序がNavigator 2と3で同じであることを保証できます。 関連項目Form、HTMLElement、Input、Radio
Checkbox.checkedプロパティ ・・・ チェックボックスがチェックされているかどうかを表す論理値 対応バージョンクライアントサイドJavaScript 1.0コーディング形式checkbox.checked解説checkedはCheckboxオブジェクトのプロパティです。読み書きが可能な論理値で、Checkboxがチェックされているときに、checkedプロパティの値はtrueになります。Checkboxがチェックされていないときには、checkedプロパティの値はfalseです。checkedプロパティにtrueを設定すると、Checkboxはチェックされて表示されます。checkedプロパティにfalseを設定すると、Checkboxはチェックされていない状態で表示されます。checkedプロパティに値を設定しても、CheckboxのonClickイベントハンドラは呼び出されないことに注意してください。
Checkbox.defaultCheckedプロパティ ・・・ チェックボックスの初期状態 対応バージョンクライアントサイドJavaScript 1.0コーディング形式checkbox.defaultChecked解説defaultCheckedはCheckboxオブジェクトのプロパティです。読み出し専用の論理値で、HTMLの<INPUT>タグにCHECKED属性がある場合、Checkboxの初期状態はtrueです。この属性がない場合、Checkboxの初期状態は、チェックされていない状態なのでfalseになります。
Checkbox.onclickハンドラ ・・・ チェックボックス選択時に呼び出される 対応バージョンクライアントサイドJavaScript 1.0コーディング形式<INPUT TYPE="checkbox" onClick="handler">checkbox.onclick 解説onclickは、ユーザがCheckboxをクリックしたときに呼び出されるイベントハンドラです。詳細はHTMLElement.onclickを参照してください。しかし、HTMLElement.onclickハンドラと違ってCheckbox.onclickハンドラはJavaScript 1.0からサポートされていることに注意してください。関連項目HTMLElement.onclick、15章
Checkbox.valueプロパティ ・・・ フォームの送信時に返される値 対応バージョンクライアントサイドJavaScript 1.0コーディング形式checkbox.value解説valueはCheckboxオブジェクトのプロパティです。読み書き可能な文字列で、フォームを送るときに、Checkboxがチェックされていることを示す文字列を保持します。HTMLの<INPUT>タグのVALUE属性で初期値を設定します。VALUE属性を指定しなかった場合、valueのデフォルト値は"on"です。valueフィールドは、Checkboxが選択されたかどうかは示しません。checkedプロパティがCheckboxの現在の状態を示します。 同じ名前を共有する複数のチェックボックスをまとめてグループとして定義する場合は、個々のチェックボックスを識別できるようにvalue属性を設定します。
clearTimeout()メソッド ・・・ Window.clearTimeout()を参照
close()メソッド ・・・ Window.close()を参照
closedプロパティ ・・・ Window.closedを参照
confirm()メソッド ・・・ Window.confirm()を参照
Cryptoオブジェクト ・・・ 暗号化のためのオブジェクト 対応バージョンクライアントサイドNavigator 4.04以降コーディング形式crypto関数crypto.ramdom() ランダムなバイト列を生成します。 crypto.signText() ユーザの電子署名を任意のテキストに付けてもよいか尋ねます。 解説CryptoオブジェクトはNavigator 4.04以降のブラウザに追加されたオブジェクトです。このオブジェクトは、各Windowオブジェクトのcryptoプロパティから参照されます。signText()メソッドは、ユーザの電子署名を任意のテキストに付けてもよいか尋ねるのに使います。random()メソッドはランダムなバイト列を返します。
Crypto.random()メソッド ・・・ ランダムなバイト列の生成 対応バージョンクライアントサイドNavigator 4.04以降コーディング形式crypto.random(numbytes)
解説Crypto.random()メソッドは、暗号化アプリケーションに適した疑似乱数の作成に使われます。Math.random()関数のようにランダムな数を返すのではなく、ランダムなバイト列を返します。関連項目Math.random()
Crypto.signText()メソッド ・・・ 電子署名をするかユーザに尋ねる 対応バージョンクライアントサイドNavigator 4.04以降コーディング形式crypto.signText(text, CASelection, allowedCA, ...)
解説signText()メソッドはtextを含んだダイアログボックスを表示し、そのテキストに署名するか尋ねます。ダイアログボックスの「OK」ボタンをクリックすると署名し、「キャンセル」ボタンをクリックすると署名を拒否するようにできます。CASelection引数が「ask」なら、ユーザが署名を作成できる証明書の一覧をダイアログボックスに表示します。CASelection引数が「auto」の場合は、signText()関数は自動的に証明書を探して選びます。 3番目以降の引数は、信用できる0個以上の証明書発行人の名前になります。これらの引数は、電子署名を作成する場合にどの証明書を使うかを指定します。作成された電子署名は、署名の照合を行うと有効なものになります。 エラーが起きなかった場合、signText()関数はバイナリデータをbase64エンコーディングした文字列を返します。この文字列はフォームに格納され、サーバへ送られます。そして、サーバでデコードされて署名の照合が行われます。
|