object &HTML_QuickForm::insertElementBefore (
object &$element
, string $nameAfter
)
新しい要素を、他の要素の直前に挿入します。
$element が既にフォームに追加されているかどうかを
調べる方法はありません。そのため、もし既存の要素を別の場所に移動させたいのなら
removeElement()
を以下のように使用する必要があります。
<?php
$form->insertElementBefore($form->removeElement('foo', false), 'bar');
?>
&$element挿入する要素 (HTML_QuickForm_element のインスタンス)。
$nameAfter直前に新しい要素を挿入することになる要素の名前。
挿入された要素への参照を返します。
| エラーコード | エラーメッセージ | 原因 | 対応 |
|---|---|---|---|
| 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() |
存在しない要素の前に挿入しようとしました。 | 要素名の綴りを調べます。 |
since 3.2.4
This function can not be called statically.