NaifyView

NaifyViewとは

HTMLの構造を崩さない制御構文で、IDEのシンタックスハイライトや補完がそのまま動きます。

<nf-if> や <nf-for-each> はHTMLタグとして書くため、テンプレートを通常のHTMLファイルとして扱えます。テンプレートはPHPにコンパイルして実行されるため、実行速度も確保できます。

Extension を追加すれば、Smarty や Twig などのテンプレート構文を後付けすることも可能で、既存資産の移行にも使いやすいです。

基本構文

制御構文はHTMLタグとして書きます。変数は {{ }} で展開し、条件やループはタグ属性で渡します。

タグごとの書き方を確認したい場合は、NaifyView Native 構文リファレンス に早見表をまとめています。

<!-- 変数展開 -->
{{ title }}
{{ user.name }}
{{ price.number_format() }}

<!-- 条件分岐 -->
<nf-if test="user.isAdmin()">
  <p>管理者メニュー</p>
<nf-else />
  <p>一般メニュー</p>
</nf-if>

<!-- 繰り返し -->
<nf-for-each exp="item in items">
  <li>{{ item.name }}</li>
</nf-for-each>

レイアウト継承

レイアウトと子テンプレートの関係を nf-layout と nf-slot で定義します。

<!-- _layout.html: レイアウト定義 -->
<nf-layout define="page">
<!doctype html>
<html>
<head><title><nf-slot name="page_title"></nf-slot></title></head>
<body>
  <nf-slot name="page_body"></nf-slot>
</body>
</html>
</nf-layout>

<!-- page.html: 子テンプレート -->
<nf-layout use="page" src="./_layout.html">
  <nf-slot name="page_title">タイトル</nf-slot>
  <nf-slot name="page_body">本文</nf-slot>
</nf-layout>

最初の入口

NaifyViewは、Configurator で設定を組み立て、NaifyView::create() でインスタンスを生成します。

use NaifyView\NaifyView;

NaifyView::boot();

$view = NaifyView::create(
    NaifyView::configure(__DIR__ . '/views')
        ->setCacheDir(__DIR__ . '/_cache')
);

$view->assign('title', 'Hello, NaifyView!');
$view->assign('items', $items);
$view->setTemplate('index.html');
echo $view->render();

Extension

構文を後付けで追加できる仕組みを持ちます。NaifyViewExtensionInterface を実装した Extension を Configurator に渡します。

use NaifyView\NaifyView;
use NaifyView\Extension\NaifyViewExtensionRegistry;
use NaifyView\Extension\NaifyViewExtensionInterface;

NaifyView::boot();

$view = NaifyView::create(
    NaifyView::configure(__DIR__ . '/views')
        ->addExtension(new class implements NaifyViewExtensionInterface {
            public function extend(NaifyViewExtensionRegistry $registry): void
            {
                $registry->addFilterHandler([
                    'upper' => static fn(mixed $v): string => strtoupper((string) $v),
                ]);
            }
        })
);

どこまで含むか / 含まないか

主要クラス

Parser → Compiler → Renderer のパイプライン構造で、どこで何が起きているか追いやすい設計になっています。

APIリファレンス

NaifyView のクラスやメソッド、引数・戻り値の詳細を確認できます。