repo_zf1/documentation/manual/ja/module_specs/Zend_View-Helpers-HeadTitle.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- Reviewed: no -->
<!-- EN-Revision: 14978 -->
<sect3 id="zend.view.helpers.initial.headtitle">
    <title>HeadTitle ヘルパー</title>

    <para>
        HTML の <code>&lt;title&gt;</code> 要素を使用して、
        HTML ドキュメントのタイトルを設定します。
        <code>HeadTitle</code> ヘルパーは、
        プログラム上で作成したタイトルを保存しておいて、
        後で出力の際にそれを取得するためのものです。
    </para>

    <para>
        <code>HeadTitle</code> ヘルパーは、
        <link linkend="zend.view.helpers.initial.placeholder">Placeholder
        ヘルパー</link> の具象実装です。
        <code>toString()</code> メソッドをオーバーライドして
        <code>&lt;title&gt;</code> 要素を生成するようにしており、
        <code>headTitle()</code> メソッドによって title
        要素の設定や集約を簡単にできるようになっています。
        このメソッドのシグネチャは
        <code>headTitle($title, $setType = 'APPEND')</code>
        です。デフォルトでは、値はスタック (title 部の内容を集約したもの)
        の最後に追加されます。しかしこれを 'PREPEND' (スタックの先頭に追加する)
        や 'SET' (スタック全体を上書きする) にすることもできます。
    </para>

    <example id="zend.view.helpers.initial.headtitle.basicusage">
        <title>HeadTitle ヘルパーの基本的な使用法</title>

        <para>
            title タグは、いつでも好きなときに指定することができます。
            一般的な使用法としては、アプリケーション内での階層、
            つまりサイト、コントローラ、アクションその他のリソースについての情報を示すことがあります。
        </para>

        <programlisting role="php"><![CDATA[
// コントローラとアクションの名前を title 部に設定します
$request = Zend_Controller_Front::getInstance()->getRequest();
$this->headTitle($request->getActionName())
     ->headTitle($request->getControllerName());

// サイト名を title に設定します。これはレイアウトスクリプトで行うことになるでしょう
$this->headTitle('Zend Framework');

// 各部分を区切る文字列を設定します
$this->headTitle()->setSeparator(' / ');
]]>
        </programlisting>

        <para>
            最後に、レイアウトスクリプト内でタイトルをレンダリングする際にそれを出力するだけです。
        </para>

        <programlisting role="php"><![CDATA[
<!-- <アクション名> / <コントローラ名> / Zend Framework と出力されます -->
<?php echo $this->headTitle() ?>
]]>
        </programlisting>
    </example>
</sect3>
<!--
vim:se ts=4 sw=4 et:
-->