90 lines
3.3 KiB
Markdown
90 lines
3.3 KiB
Markdown
# Maron テンプレートの仕組み
|
|
Maron は Little Beast のカスタム HTML テンプレートエンジンです。
|
|
|
|
## 構文
|
|
|
|
構文は以下の通りです：
|
|
|
|
```
|
|
{@ include(common/header.maron) @} // これは別の Maron ファイルを含めます。
|
|
// シングルクォートやダブルクォートを
|
|
// 追加しないで下さい！
|
|
|
|
{@ kys($var) @} // これは変数を読み易い形式で出力し、
|
|
// その後テンプレートの残りの実行を終了します。
|
|
|
|
{@ if (true) @}
|
|
// 何かを実行
|
|
{@ elif (null) @}
|
|
// 別の事を実行
|
|
{@ else @}
|
|
// その他を実行
|
|
{@ endif @}
|
|
|
|
{@ foreach ($array as $value) @}
|
|
{{ $value }}<br />
|
|
{@ endforeach @}
|
|
|
|
{@ foreach ($array as $key => $value) @}
|
|
{{ $key }}: {{ $value }}<br />
|
|
{@ endforeach @}
|
|
|
|
{@ for ($i = 0; $i < 10; $i++) @}
|
|
{{ $i }}<br />
|
|
{@ endfor @}
|
|
|
|
{# This is a comment #}
|
|
{{ $var }} // これは特殊文字をエスケープして変数を出力します
|
|
{{{ $var }}} // これは変数をそのままの形で出力します
|
|
{$ $var = 200 $} // これは $var を 200 として定義します
|
|
{! echo "hello world"; !} // これは生の PHP コードをそのまま実行します
|
|
```
|
|
|
|
## コントローラー機能
|
|
更に、Little Beast では Maron テンプレート内で使用出来る
|
|
コントローラー用の機能も提供しています。
|
|
多言語ウェブサイトを使用する場合、
|
|
`new Template()` の後にその言語のルートディレクトリを指定出来ます。
|
|
但し、これには `/view` ディレクトリ内にそれらのルートディレクトリも
|
|
設定する必要があります。
|
|
例えば、構造が `/view/en/index.maron` の場合、
|
|
`new Template('/en')` と定義します。
|
|
然し構造が `/view/index.maron` の場合は、
|
|
単に `new Template()` とします。
|
|
|
|
### assign()
|
|
`->assign()` メソッドを使用すると、
|
|
Maron テンプレートで使用したい変数を割り当てます。
|
|
|
|
例：
|
|
```
|
|
$tmpl = new Template();
|
|
|
|
$sum = 1 + 1;
|
|
$tmpl->assign('total', $sum);
|
|
```
|
|
|
|
この場合、Maron テンプレートで `{{ $total }}` を
|
|
使用して `2` を出力します。
|
|
|
|
### addCss()
|
|
デフォルトでは、 `style.css` は常に含まれています。
|
|
但し、全てのページ又は大部分のページで使用する
|
|
予定の物だけを `style.css` に入れ、
|
|
特定のページでのみ使用する予定の全ての物は、
|
|
`style-` の接頭辞を付けた独自のファイルに入れる事をお勧めします。
|
|
例えば、お問い合わせページがあり、
|
|
そのページでのみ使用する CSS がある場合は、
|
|
`/public/static` に新しい `style-contact.css` ファイルを作成し、
|
|
`render` メソッドの前に `$tmpl->addCss('contact');` を追加します。
|
|
|
|
### render()
|
|
`render()` メソッドは Maron テンプレートの内容を取得し
|
|
、ウェブブラウザが理解出来る有効な HTML と PHP に全てを変換します。
|
|
Maron ファイルが `/view/index.maron` の場合、
|
|
`$tmpl->render('index');` を実行しますが、
|
|
`/view/en/index.maron` の場合、
|
|
`$tmpl = new Template('/en');` に続いて `$tmpl->render('index');` か、
|
|
`$tmpl = new Template();` に続いて `$tmpl->render('en/index');` の
|
|
いずれかを実行出来ます。
|