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

<?xml version="1.0" encoding="UTF-8"?>
<!-- Reviewed: no -->
<!-- EN-Revision: 24717 -->
<sect3 id="zend.view.helpers.initial.headlink">
    <title>HeadLink ヘルパー</title>
    <!-- Skip-EN-Revisions: 19438 -->
    <para>注意：このドキュメントでは、英語版のリビジョン 19438 の更新内容をスキップしています。</para>
    <para>
        <acronym>HTML</acronym> の <code>&lt;link&gt;</code> 要素は複数使用することができ、
        スタイルシートやフィード、favicon、トラックバック
        などのさまざまなリソースへのリンクを表します。
        <code>HeadLink</code> ヘルパーは、
        シンプルなインターフェイスでこれらの要素を作成し、
        後でそれを取得してレイアウトスクリプトで出力することができます。
    </para>

    <para>
        <code>HeadLink</code> ヘルパーには、
        スタイルシートへのリンクをスタックに追加するメソッドがあります。
    </para>

    <itemizedlist>
        <listitem><para><code>appendStylesheet($href, $media,
                    $conditionalStylesheet, $extras)</code></para></listitem>
        <listitem><para><code>offsetSetStylesheet($index, $href, $media,
                    $conditionalStylesheet, $extras)</code></para></listitem>
        <listitem><para><code>prependStylesheet($href, $media,
                    $conditionalStylesheet, $extras)</code></para></listitem>
        <listitem><para><code>setStylesheet($href, $media,
                    $conditionalStylesheet, $extras)</code></para></listitem>
    </itemizedlist>

    <para>
        <varname>$media</varname> のデフォルトは 'screen' ですが、
        有効な media 形式なら何にでもすることができます。
        <varname>$conditionalStylesheet</varname> は文字列あるいは <constant>FALSE</constant> で、
        レンダリング時に使用します。
        特定のプラットフォームでスタイルシートの読み込みをやめたい場合などに、
        特別なコメントを使用できるようになります。
        <varname>$extras</varname> は、そのタグに追加したい特別な値の配列です。
    </para>

    <para>
        さらに、<code>HeadLink</code>
        ヘルパーには、スタックに 'alternate' リンクを追加するメソッドもあります。
    </para>

    <itemizedlist>
        <listitem><para><code>appendAlternate($href, $type,
                    $title, $extras)</code></para></listitem>
        <listitem><para><code>offsetSetAlternate($index, $href, $type,
                    $title, $extras)</code></para></listitem>
        <listitem><para><code>prependAlternate($href, $type,
                    $title, $extras)</code></para></listitem>
        <listitem><para><code>setAlternate($href, $type,
                    $title, $extras)</code></para></listitem>
    </itemizedlist>

    <para>
        <methodname>headLink()</methodname> ヘルパーメソッドは、
        <code>&lt;link&gt;</code> 要素に必要なすべての属性を指定することができ、
        その位置も指定することができます。
        たとえば、新たな要素がこれまでのものを上書きする、
        あるいはスタックの先頭に追加する、スタックの末尾に追加するなどを指定します。
    </para>

    <para>
        <code>HeadLink</code> ヘルパーは、
        <link linkend="zend.view.helpers.initial.placeholder">Placeholder
        ヘルパー</link> の具象実装です。
    </para>

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

        <para>
            <code>headLink</code> は、いつでも指定することができます。
            一般的には、グローバルなリンクはレイアウトスクリプトで指定して、
            アプリケーション固有のリンクはアプリケーションのビュースクリプトで指定することになります。
            レイアウトスクリプトでは、&lt;head&gt;
            セクションの中でヘルパーを出力することになります。
        </para>

        <programlisting language="php"><![CDATA[
<?php // ビュースクリプトのリンクを設定します
$this->headLink()->appendStylesheet('/styles/basic.css')
                 ->headLink(array('rel' => 'icon',
                                  'href' => '/img/favicon.ico'),
                                  'PREPEND')
                 ->prependStylesheet('/styles/moz.css',
                                     'screen',
                                     true,
                                     array('id' => 'my_stylesheet'));
?>
<?php // リンクをレンダリングします ?>
<?php echo $this->headLink() ?>
]]></programlisting>
    </example>
</sect3>
<!--
vim:se ts=4 sw=4 et:
-->