addBlock()
addBlock() – ブロックをテンプレートに追加する
Synopsis
require_once 'HTML/Template/Sigma.php';
mixed HTML_Template_Sigma::addBlock (
string $placeholder
, string $block
, string $template
)
Description
ブロックをテンプレートに追加し、変数プレースホルダをブロックプレースホルダに変更します。 つまり、新しいブロックが、テンプレート内で変数プレースホルダがあった位置に統合されるということです。 変数プレースホルダは削除され、新しいブロックが、 まるでもとのテンプレートの中にあるかのように振舞います。
ブロックの中身は <!-- BEGIN blockname --> で始まってはならず、また <!-- END blockname --> で終わってもいけません。 そのような場合はエラーがスローされます。
Parameter
- string $placeholder
-
変数プレースホルダの名前。テンプレート内で一意である必要があります。
- string $block
-
追加するブロックの名前。
- string $template
-
ブロックの内容。
Return value
成功した場合に SIGMA_OK、 失敗した場合にエラーオブジェクトを返します。
See
HTML_Template_Sigma::addBlockfile() も参照ください。
Throws
| エラーコード | エラーメッセージ | 原因 | 対応 |
|---|---|---|---|
| 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) | テンプレート関数のパラメータが間違っています | テンプレート関数の定義を修正します。 クォートのしかた に注意してください |
Note
This function can not be called statically.
忘却曲線を使ってこの知識を確実に記憶に残す
