アドバンスドチェックボックス型のフィールドのための HTML クラスです。 基本的に、これは「チェックボックスではひとつの値 (チェックされているチェックボックスの値) しか渡せない」 という HTML の問題点を解決するものです。 チェックボックスがチェックされていない場合にはその値を渡すことができません。 そのため、未チェック状態で送信すると、そのチェックボックスの値が 存在しないことになってしまいます。
ここでは、まず指定された名前の hidden フィールドおよび名前のないチェックボックスを作成します。 そしてチェックボックスの onclick で、javascript によって hidden フィールドの値を設定します。
HTML_Common
HTML_QuickForm_advcheckbox
HTML_QuickForm_advcheckbox が継承しているメソッド
表 47-1HTML_QuickForm_checkbox から継承したもの
| メソッド名 | 概要 |
|---|---|
| コンストラクタ HTML_QuickForm_checkbox::HTML_QuickForm_checkbox() | クラスのコンストラクタ |
| HTML_QuickForm_checkbox::exportValue() | チェックボックスがチェックされている場合に true、チェックされていない場合に null を返す (getValue() は false を返す) |
| HTML_QuickForm_checkbox::getChecked() | チェックボックスがチェックされているかどうかを返す |
| HTML_QuickForm_checkbox::getFrozenHtml() | HTML タグを含めずにフィールドの値を返す |
| HTML_QuickForm_checkbox::getText() | チェックボックスのテキストを返す |
| HTML_QuickForm_checkbox::getValue() | フォーム要素の値を返す |
| HTML_QuickForm_checkbox::onQuickFormEvent() | この要素上でイベントが発生した場合に HTML_QuickForm からコールされる |
| HTML_QuickForm_checkbox::setChecked() | チェックボックスがチェックされているかどうかを設定する |
| HTML_QuickForm_checkbox::setText() | チェックボックスのテキストを設定する |
| HTML_QuickForm_checkbox::setValue() | フォーム要素の値を設定する |
表 47-2HTML_QuickForm_input から継承したもの
| メソッド名 | 概要 |
|---|---|
| コンストラクタ HTML_QuickForm_input::HTML_QuickForm_input() | クラスのコンストラクタ |
| HTML_QuickForm_input::exportValue() | ボタン要素 (submit を除く) やファイル要素の値を取得する必要はない |
| HTML_QuickForm_input::getName() | 要素名を返す |
| HTML_QuickForm_input::getValue() | フォーム要素の値を返す |
| HTML_QuickForm_input::onQuickFormEvent() | この要素上でイベントが発生した場合に HTML_QuickForm からコールされる |
| HTML_QuickForm_input::setName() | 入力フィールドの名前を設定する |
| HTML_QuickForm_input::setType() | 要素の型を設定する |
| HTML_QuickForm_input::setValue() | フォーム要素の値を設定する |
表 47-3HTML_QuickForm_element から継承したもの
| メソッド名 | 概要 |
|---|---|
| コンストラクタ HTML_QuickForm_element::HTML_QuickForm_element() | クラスのコンストラクタ |
| HTML_QuickForm_element::accept() | レンダラを受け入れる |
| HTML_QuickForm_element::apiVersion() | 現在の API のバージョンを返す |
| HTML_QuickForm_element::exportValue() | '安全な' 要素の値を返す |
| HTML_QuickForm_element::freeze() | 要素を凍結し、その値のみを返す |
| HTML_QuickForm_element::getFrozenHtml() | HTML タグを含めずにフィールドの値を返す |
| HTML_QuickForm_element::getLabel() | 要素の表示テキストを返す |
| HTML_QuickForm_element::getName() | 要素名を返す |
| HTML_QuickForm_element::getType() | 要素の型を返す |
| HTML_QuickForm_element::getValue() | フォーム要素の値を返す |
| HTML_QuickForm_element::isFrozen() | 要素が凍結されているかどうかを返す |
| HTML_QuickForm_element::onQuickFormEvent() | この要素上でイベントが発生した場合に HTML_QuickForm からコールされる |
| HTML_QuickForm_element::setLabel() | 要素の表示テキストを設定する |
| HTML_QuickForm_element::setName() | 入力フィールドの名前を設定する |
| HTML_QuickForm_element::setPersistantFreeze() | 要素の値を、それが凍結されているかどうかにかかわらず hidden フィールドに保持し続けるかどうかを設定する |
| HTML_QuickForm_element::setValue() | フォーム要素の値を設定する |
| HTML_QuickForm_element::unfreeze() | フォーム要素の凍結を解除する |