smarty @Wiki

{section}

最終更新：2005年08月01日 15:12

匿名ユーザー

- view

だれでも歓迎！編集

{section},{sectionelse}

属性名	型?	必須	デフォルト	概要
name	string?	Yes	n/a	セクション名
loop	[$variable_name]	Yes	n/a	ループ回数を決定する変数の名前
start	integer?	No	0	ループを開始するインデックス位置。この値が負の場合は、配列の最後尾から開始位置が算出されます。例えばループ配列に7つの値があり、そしてstartが-2であるならば、開始インデックスは5になります。ループ配列の長さを超えるような無効な値は、自動的に最も近い値に切り捨てられます。
step	integer?	No	1	ループインデックスを進めるために使われるステップ値。例えばstep=2なら、インデックスは0, 2, 4をループします。stepの値が負の場合は、配列の前方に向かって進みます。
max	integer?	No	n/a	セクションがループする最大の回数
show	boolean?	No	true	このセクションを表示するかどうか

sectionは、データの配列をループするために使用されます。
全てのsectionと/sectionはペアである必要があります。必須のパラメータは、nameとloopです。
セクション名は英数字とアンダースコアを使って自由に命名できます。このタグはネスト可能で、その場合のセクション名はお互いにユニークである必要があります。
loop属性で指定されたループ変数(たいていは配列)は、セクションのループ回数を決定するためにのみ使用されます。
セクション内で値を表示するには、変数名の次にブランケット[]で囲んだセクション名を指定します。ループ変数に値が存在しない場合は、sectionelseが実行されます。

例 7-15. section

{* $custid配列の値を全て表示 *}
{section name=customer loop=$custid}
id: {$custid[customer]} 
{/section}

出力:

id: 1000 
id: 1001 
id: 1002

例 7-16. section ループ変数

{* ループ変数は、ループ回数を決定するためにのみ使用されます。

  セクション内ではあらゆるテンプレート変数にアクセス可能です。
  この例では、$custid, $name, $addressのそれぞれの配列には
  同じ個数の値が格納されているとします。 *}

{section name=customer loop=$custid}

id: {$custid[customer]}<br>
name: {$name[customer]}<br>
address: {$address[customer]}<br>
<p>

{/section}

出力:

id: 1000 
name: John Smith 
address: 253 N 45th 

id: 1001 
name: Jack Jones 
address: 417 Mulberry ln 

id: 1002 
name: Jane Munson 
address: 5605 apple st

例 7-17. セクション名

{* セクション名は自由に命名可能で、
 セクション内で配列を参照するために使われます。 *}
{section name=mydata loop=$custid}
id: {$custid[mydata]} 
name: {$name[mydata]} 
address: {$address[mydata]} 

{/section}

例 7-18. ネストしたセクション

{* セクションは無制限にネスト可能です。ネストしたセクションによって、

  多次元配列のような複雑なデータ構造にアクセスする事が可能です。この***例では、
  $contact_type[customer]は現在の顧客の連絡方法を格納した配列を示します。 *}

{section name=customer loop=$custid}

id: {$custid[customer]}<br>
name: {$name[customer]}<br>
address: {$address[customer]}<br>
{section name=contact loop=$contact_type[customer]}
    {$contact_type[customer][contact]}: {$contact_info[customer][contact]}<br>
{/section}
<p>

{/section}

出力:

id: 1000 
name: John Smith 
address: 253 N 45th 
home phone: 555-555-5555 
cell phone: 555-555-5555 
e-mail: john@mydomain.com 

id: 1001 
name: Jack Jones 
address: 417 Mulberry ln 
home phone: 555-555-5555 
cell phone: 555-555-5555 
e-mail: jack@mydomain.com 

id: 1002 
name: Jane Munson 
address: 5605 apple st 
home phone: 555-555-5555 
cell phone: 555-555-5555 
e-mail: jane@mydomain.com

例 7-19. セクションと連想配列

{* セクション内に連想配列の値を表示 *}
{section name=customer loop=$contacts}
name: {$contacts[customer].name} 
home: {$contacts[customer].home} 
cell: {$contacts[customer].cell} 
e-mail: {$contacts[customer].email}
{/section}

出力:

name: John Smith 
home: 555-555-5555 
cell: 555-555-5555 
e-mail: john@mydomain.com
name: Jack Jones 
home phone: 555-555-5555 
cell phone: 555-555-5555 
e-mail: jack@mydomain.com
name: Jane Munson 
home phone: 555-555-5555 
cell phone: 555-555-5555 
e-mail: jane@mydomain.com

例 7-20. sectionelse

{* sectionelseは、$custidに値が存在しない場合に実行されます *}
{section name=customer loop=$custid}
id: {$custid[customer]} 
{sectionelse}
there are no values in $custid.
{/section}

セクションには、セクションプロパティを操作するための自身の変数があります。
これらは、{$smarty.section.sectionname.varname}のように示されます。

注意: Smarty 1.5.0.から、セクションプロパティ変数の書式が{%sectionname.varname%}から{$smarty.section.sectionname.varname}に変更されました。古い書式はまだサポートされていますが、マニュアルの***例では新しい書式を使用しています

index

現在のループインデックスを表示します。0(又はstart属性の値)から始まり、1(又はstep属性の値)ずつ増加します。

テクニカルノート: step及びstart属性が変更されていない場合は、セクションプロパティのiterationと同じ動作をします。(1の代わりに0から始まる)

例 7-21. セクションプロパティ index

{section name=customer loop=$custid}
{$smarty.section.customer.index} id: {$custid[customer]} 
{/section}

出力:

0 id: 1000 
1 id: 1001 
2 id: 1002

index_prev

前回のループインデックスを表示します。最初のループでは-1がセットされます。

例 7-22. セクションプロパティ index_prev

{section name=customer loop=$custid}

{$smarty.section.customer.index} id: {$custid[customer]}<br>
{* 参考までに言うと、$custid[customer.index] と $custid[customer] は同じ意味です。 *}
{if $custid[customer.index_prev] ne $custid[customer.index]}
   	    The customer id changed<br>
{/if}

{/section}

出力:

0 id: 1000 
The customer id changed 
1 id: 1001 
The customer id changed 
2 id: 1002 
The customer id changed

index_next

次回のループインデックスを表示します。ループの最後でもやはり現在のインデックスの次回の値を返します。(step 属性の設定に従います)

例 7-23. セクションプロパティ index_next

{section name=customer loop=$custid}

{$smarty.section.customer.index} id: {$custid[customer]}<br>
{* 参考までに言うと、$custid[customer.index] と $custid[customer] は同じ意味です。 *}
{if $custid[customer.index_next] ne $custid[customer.index]}
      	    The customer id will change<br>
{/if}

{/section}

出力:

0 id: 1000 
The customer id will change 
1 id: 1001 
The customer id will change 
2 id: 1002 
The customer id will change

iteration

現在のループが反復された回数を表示します。

注意: indexセクションプロパティとは異なり、start, step, max属性に影響されません。また、0の代わりに1から始まります。rownumはiterationの別名で、全く同じ働きをします。

例 7-24. セクションプロパティ iteration

{section name=customer loop=$custid start=5 step=2}

current loop iteration: {$smarty.section.customer.iteration}<br>
{$smarty.section.customer.index} id: {$custid[customer]}<br>
{* 参考までに言うと、$custid[customer.index] と $custid[customer] は同じ意味です。 *}
{if $custid[customer.index_next] ne $custid[customer.index]}
   	The customer id will change<br>
{/if}

{/section}

出力:

current loop iteration: 1
5 id: 1000 
The customer id will change 
current loop iteration: 2
7 id: 1001 
The customer id will change 
current loop iteration: 3
9 id: 1002 
The customer id will change

first

現在のセクションの反復が一回目の場合にtrueがセットされます。

例 7-25. セクションプロパティ first

{section name=customer loop=$custid}

{if $smarty.section.customer.first}
   	<table>
{/if}
<tr><td>{$smarty.section.customer.index} id:
       	{$custid[customer]}</td></tr>
{if $smarty.section.customer.last}
   	</table>
{/if}

{/section}

出力:

<table>
<tr><td>0 id: 1000</td></tr>
<tr><td>1 id: 1001</td></tr>
<tr><td>2 id: 1002</td></tr>
</table>

last

現在のセクションの反復が最後の場合にtrueがセットされます。

例 7-26. セクションプロパティ last

{section name=customer loop=$custid}

{if $smarty.section.customer.first}
   	<table>
{/if}
<tr><td>{$smarty.section.customer.index} id:
       	{$custid[customer]}</td></tr>
{if $smarty.section.customer.last}
   	</table>
{/if}

{/section}

出力:

<table>
<tr><td>0 id: 1000</td></tr>
<tr><td>1 id: 1001</td></tr>
<tr><td>2 id: 1002</td></tr>
</table>

rownum

現在のループが反復された回数を表示します(1から開始)。rownumはiterationの別名で、それらは同じ働きをします。

例 7-27. セクションプロパティ rownum

{section name=customer loop=$custid}
{$smarty.section.customer.rownum} id: {$custid[customer]} 
{/section}

出力:

1 id: 1000 
2 id: 1001 
3 id: 1002

loop

セクションがループした最後のインデックスを表示します。これはセクションの外でも使う事ができます。

例 7-28. セクションプロパティ index

{section name=customer loop=$custid}
{$smarty.section.customer.index} id: {$custid[customer]} 
{/section}
There were {$smarty.section.customer.loop} customers shown above.

出力:

0 id: 1000 
1 id: 1001 
2 id: 1002 
There were 3 customers shown above.

show

セクションの表示/非表示を決定します。
show属性は、true/falseのboolean値です。これがfalseの場合はセクションは表示されません。{sectionelse}があれば、それが代わりに表示されます。

例 7-29. セクションの属性 show

{* $show_customer_infoは、このセクションの表示/非表示を決めるために
phpアプリケーションから渡された変数です *}
{section name=customer loop=$custid show=$show_customer_info}
{$smarty.section.customer.rownum} id: {$custid[customer]} 
{/section}
{if $smarty.section.customer.show}
the section was shown.
{else}
the section was not shown.
{/if}

出力:

1 id: 1000 
2 id: 1001 
3 id: 1002 
the section was shown.

total

セクションがループしたトータル回数を表示します。これはセクションの外でも使う事ができます。

例 7-30. セクションプロパティ total

{section name=customer loop=$custid step=2}
{$smarty.section.customer.index} id: {$custid[customer]} 
{/section}
There were {$smarty.section.customer.total} customers shown above.

出力:

0 id: 1000 
2 id: 1001 
4 id: 1002 
There were 3 customers shown above.

「{section}」をウィキ内検索

smarty @Wiki

記事メニュー

LINK

■Smarty本家(英語)
■Smarty日本語マニュアル

UPDATE

取得中です。

人気記事ランキング

最近更新されたページ

新規Wikiランキング

最近作成されたWikiのアクセスランキングです。見るだけでなく加筆してみよう！

人気Wikiランキング

atwikiでよく見られているWikiのランキングです。新しい情報を発見してみよう！

全体ページランキング

最近アクセスの多かったページランキングです。話題のページを見に行こう！

{section}

{section},{sectionelse}

例 7-15. section

例 7-16. section ループ変数

例 7-17. セクション名

例 7-18. ネストしたセクション

例 7-19. セクションと連想配列

例 7-20. sectionelse

index

例 7-21. セクションプロパティ index

index_prev

例 7-22. セクションプロパティ index_prev

index_next

例 7-23. セクションプロパティ index_next

iteration

例 7-24. セクションプロパティ iteration

first

例 7-25. セクションプロパティ first

last

例 7-26. セクションプロパティ last

rownum

例 7-27. セクションプロパティ rownum

loop

例 7-28. セクションプロパティ index

show

例 7-29. セクションの属性 show

total

例 7-30. セクションプロパティ total

MENU

LINK

UPDATE