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

<?xml version="1.0" encoding="UTF-8"?>
<!-- Reviewed: no -->
<!-- EN-Revision: 24249 -->
<sect3 id="zend.view.helpers.initial.cycle">

    <title>Cycle ヘルパー</title>

    <para>
        <classname>Cycle</classname>ヘルパーは 一組の値を交互に切り替えるために使われます。
    </para>

    <example id="zend.view.helpers.initial.cycle.basicusage">

        <title>Cycle ヘルパーの基本的な使用法</title>

        <para>
            循環する要素を追加するためには、コンストラクタで指定するか、
            <methodname>assign(array $data)</methodname>関数を使います。
        </para>

        <programlisting language="php"><![CDATA[
<?php foreach ($this->books as $book):?>
  <tr style="background-color:<?php echo $this->cycle(array("#F0F0F0",
                                                            "#FFFFFF"))
                                              ->next()?>">
  <td><?php echo $this->escape($book['author']) ?></td>
</tr>
<?php endforeach;?>

// 後方への移動は関数に指示して割り当てます。
$this->cycle()->assign(array("#F0F0F0","#FFFFFF"));
$this->cycle()->prev();
?>
]]></programlisting>

        <para>
            出力
        </para>

        <programlisting language="php"><![CDATA[
<tr style="background-color:'#F0F0F0'">
   <td>First</td>
</tr>
<tr style="background-color:'#FFFFFF'">
   <td>Second</td>
</tr>
]]></programlisting>

    </example>

    <example id="zend.view.helpers.initial.cycle.advanceusage">

        <title>２つ以上の繰り返しを利用する</title>

        <para>
            ２つ以上の繰り返しを利用する場合は、繰り返しの名前を指定しなければなりません。
            第２パラメータを cycle メソッドで設定してください。
            <command>$this->cycle(array("#F0F0F0","#FFFFFF"),'cycle2')</command>.
            setName($name)関数を使うこともできます。
        </para>

    </example>

    <programlisting language="php"><![CDATA[
<?php foreach ($this->books as $book):?>
  <tr style="background-color:<?php echo $this->cycle(array("#F0F0F0",
                                                            "#FFFFFF"))
                                              ->next()?>">
  <td><?php echo $this->cycle(array(1,2,3),'number')->next()?></td>
  <td><?php echo $this->escape($book['author'])?></td>
</tr>
<?php endforeach;?>
]]></programlisting>

</sect3>
<!--
vim:se ts=4 sw=4 et:
-->