r42utils_taglib_foreach - R42 Utilities Wiki - R42 Utilities

概要

<s:iterator>と同等の機能を提供しますが、ループ変数のスコープを<r:foreach>の内側に限定します。

また、ローカル変数スコープタグでもあります。

タグの属性

• var: ループ変数の名前。<s:iterator>のvarと同じです。
• value: ループ対象となる値(Collection, Map, 配列)。<s:iterator>のvalueと同じです。
• status: ループのステータスオブジェクトを保持する変数名。<s:iterator>のstatusと同じです。

タグのボディの扱い

タグのボディをJSPとしてレンダリングした結果をそのまま出力します。

サンプルコード

その1

 <%@ page pageEncoding="UTF-8"%>
 <%@ taglib uri="/struts-tags" prefix="s"%>
 <%@ taglib uri="/r42fw-tags" prefix="r"%>
 
 <r:foreach var="hoge" value="{1, 2, 3}">
 
     (hoge) = <s:property value="#hoge" />
 
     <%-- foreachローカル変数スコープタグでもある --%>
     <r:set-local var="moge" value="'abc'" />
 </r:foreach>
 
 (hoge) = <s:property value="(#hoge == null ? 'null' : #hoge)" />
 (moge) = <s:property value="(#moge == null ? 'null' : #moge)" />

実行結果

    (hoge) = 1
    (hoge) = 2
    (hoge) = 3

(hoge) = null
(moge) = null

その2

main.jsp

 <%@ page pageEncoding="UTF-8"%>
 <%@ taglib uri="/struts-tags" prefix="s"%>
 <%@ taglib uri="/r42fw-tags" prefix="r"%>
 
 <r:block>
     <r:set-local var="hoge" value="1" />
 
     (hoge in main.jsp) = <s:property value="#hoge" />
 
     <s:include src="./sub.jsp" />
 
     (hoge in main.jsp) = <s:property value="#hoge" />
 
 </r:block>

sub.jsp

 <%@ page pageEncoding="UTF-8"%>
 <%@ taglib uri="/struts-tags" prefix="s"%>
 <%@ taglib uri="/r42fw-tags" prefix="r"%>
 
 <r:foreach var="hoge" value="{1, 2, 3}">
 
     (hoge in sub.jsp) =<s:property value="#hoge" />
 
 </r:foreach>

main.jspの実行結果

(hoge in main.jsp) = 1

    (hoge in sub.jsp) = 1
    (hoge in sub.jsp) = 2
    (hoge in sub.jsp) = 3

(hoge in main.jsp) = 1

注意点

<r:foreach>はローカル変数スコープタグですが、 通常のプログラミング言語におけるforループとはブロックの扱いが異なることに注意する必要があります。

例えば、Javaのコードで言うところの

 for (...) {
     //ここではiはまだ「存在」していない
 
     int i = ...; //iを宣言する
 
     //これ以降、iは「存在」する
 }

このように記述したとき、変数iはループする度に毎回初期化されます。 一方で、<r:foreach>タグを使って次のように記述することは、

 <r:foreach ...>
     <r:set-local var="1" value="..." />
 </r:foreach>

Javascriptで言うところの (言語が入り混ってしまいすいません) このように記述することと同値です。

従ってローカル変数iは、ループする度に初期化されるわけではありません。

 (function() {
     for (...) {
         //JavascriptのスコープはJavaとは異なる。
         //2回目以降のループの場合、ここの時点でiは「存在」する。
 
         var i = ...; //iを宣言する
 
         ...
     }
 })();