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

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

    <para>
        <classname>Action</classname> ビューヘルパーは、
        ビュースクリプトから指定したコントローラのアクションを実行し、
        その結果のレスポンスオブジェクトを返します。
        これは、特定のアクションが再利用可能なコンテンツを返す場合や、
        いわゆる "ウィジェット風" のコンテンツを返す場合に便利です。
    </para>

    <para>
        最終的に <methodname>_forward()</methodname> されたりリダイレクトされたりするアクションは使えず、
        空の文字列を返します。
    </para>

    <para>
        <classname>Action</classname> ビューヘルパーの <acronym>API</acronym>
        はコントローラアクションを起動する大半の <acronym>MVC</acronym>
        コンポーネントと同じで、<command>action($action,
            $controller, $module = null, array $params = array())</command>
        のようになります。<varname>$action</varname> と <varname>$controller</varname>
        は必須です。モジュールを省略した場合はデフォルトのモジュールを使用します。
    </para>

    <example id="zend.view.helpers.initial.action.usage">
        <title>Action ビューヘルパーの基本的な使用法</title>

        <para>
            たとえば <classname>CommentController</classname> に
            <methodname>listAction()</methodname> というメソッドがあったとしましょう。
            コメント一覧を取得するために現在のリクエストからこのメソッドを起動するには、
            次のようにします。
        </para>

        <programlisting language="php"><![CDATA[
<div id="sidebar right">
    <div class="item">
        <?php echo $this->action('list',
                                 'comment',
                                 null,
                                 array('count' => 10)); ?>
    </div>
</div>
]]></programlisting>
    </example>
</sect3>
<!--
vim:se ts=4 sw=4 et:
-->