HTML_QuickForm::insertElementBefore()
HTML_QuickForm::insertElementBefore() – 新しい要素を、他の要素の直前に挿入する
Synopsis
require_once 'HTML/QuickForm.php';
object &HTML_QuickForm::insertElementBefore (
object &$element
, string $nameAfter
)
Description
新しい要素を、他の要素の直前に挿入します。
$element が既にフォームに追加されているかどうかを 調べる方法はありません。そのため、もし既存の要素を別の場所に移動させたいのなら removeElement() を以下のように使用する必要があります。
<?php
$form->insertElementBefore($form->removeElement('foo', false), 'bar');
?>
Parameter
- object &$element
-
挿入する要素 (HTML_QuickForm_element のインスタンス)。
- string $nameAfter
-
直前に新しい要素を挿入することになる要素の名前。
Return value
挿入された要素への参照を返します。
Throws
| エラーコード | エラーメッセージ | 原因 | 対応 |
|---|---|---|---|
| QUICKFORM_INVALID_ELEMENT_NAME | Several elements named $nameAfter exist in HTML_QuickForm::insertElementBefore() | $nameAfter という名前の要素が、 フォーム内に複数存在します (例: ラジオボタン)。 このメソッドは、そのような場合に対応していません。 | 別の要素の前に挿入します。一意な名前を持つダミーの要素を追加することを 検討してください。 |
| QUICKFORM_INVALID_ELEMENT_NAME | Element '$elementName' already exists in HTML_QuickForm::insertElementBefore() | $element と同じ名前で、 型の違う要素が存在します。 | 挿入する要素に別の名前を指定します。 |
| QUICKFORM_NONEXIST_ELEMENT | Element $nameAfter does not exist in HTML_QuickForm::insertElementBefore() | 存在しない要素の前に挿入しようとしました。 | 要素名の綴りを調べます。 |
Note
since 3.2.4
This function can not be called statically.
忘却曲線を使ってこの知識を確実に記憶に残す
