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

Possible PEAR_Error values
エラーコード エラーメッセージ 原因 対応
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.

コンストラクタ (Previous) ファイルに含まれるブロックをテンプレートに追加する (Next)
Last updated: Sat, 30 Aug 2014 — Download Documentation
Do you think that something on this page is wrong? Please file a bug report or add a note.
View this page in:

User Notes:

There are no user contributed notes for this page.