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

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

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

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

    <!-- TODO : to be translated -->
    <para>
        Since setting the aggregating (attach) order on each call to <methodname>
        headTitle</methodname> can be cumbersome, you can set a default attach order
        by calling <methodname>setDefaultAttachOrder()</methodname> which is applied
        to all <methodname>headTitle()</methodname> calls unless you explicitly
        pass a different attach order as the second parameter.
    </para>

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

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

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