mixed HTML_Template_Sigma::addBlock (
string $placeholder
, string $block
, string $template
)
ブロックをテンプレートに追加し、変数プレースホルダをブロックプレースホルダに変更します。 つまり、新しいブロックが、テンプレート内で変数プレースホルダがあった位置に統合されるということです。 変数プレースホルダは削除され、新しいブロックが、 まるでもとのテンプレートの中にあるかのように振舞います。
ブロックの中身は
<!-- BEGIN blockname -->
で始まってはならず、また
<!-- END blockname -->
で終わってもいけません。
そのような場合はエラーがスローされます。
$placeholder
変数プレースホルダの名前。テンプレート内で一意である必要があります。
$block
追加するブロックの名前。
$template
ブロックの内容。
成功した場合に SIGMA_OK、 失敗した場合にエラーオブジェクトを返します。
HTML_Template_Sigma::addBlockfile() も参照ください。
エラーコード | エラーメッセージ | 原因 | 対応 |
---|---|---|---|
SIGMA_BLOCK_EXISTS | Block '$block ' already exists |
テンプレート内にすでに存在する名前でブロックを追加しようとしました | 新しいブロックの名前に別のものを使用してください |
SIGMA_PLACEHOLDER_NOT_FOUND | Variable placeholder '$placeholder ' not found |
テンプレート内に、新しいブロックをいれるプレースホルダがありません | プレースホルダ名を調べます |
SIGMA_PLACEHOLDER_DUPLICATE | Placeholder '$placeholder ' should be unique, found in multiple blocks |
新しいブロックをいれるプレースホルダは、一箇所だけでなければなりません | プレースホルダ名を調べ、異なるプレースホルダを使用します |
SIGMA_BLOCK_DUPLICATE | The name of a block must be unique within a template. Block 'blockname' found twice. | 追加するブロックがサブブロックを含んでおり、それが既存の名前と重複しています | $template を調べ、ブロック名を別のものに変更します |
SIGMA_CALLBACK_SYNTAX_ERROR | Cannot parse template function: (error description) | テンプレート関数のパラメータが間違っています | テンプレート関数の定義を修正します。 クォートのしかた に注意してください |
This function can not be called statically.