list¶

flamingo IDEでは、変数コレクションの使用を容易にするために、list キーワードを使用します。list キーワードは、true または false を値に持つことが可能です。デフォルト値は false です。各々の値を持つlistキーワードの使用方法について以下に例示します。

false¶

これはデフォルト値です。list キーワードが false に設定されている場合、以下の例示のように、全ての実測値を含む文字列を取得します。そのような状況における使用例を以下に例示します。

デスクトップサイトのページコード

<html>
    <body>
        <img src="image1.jpg" />
        <img src="image2.jpg" />
        <img src="image3.jpg" />
    </body>
</html>

list キーワードが false に設定されているパラメータコレクション内のコード

image: {
    xpath: '//img',
    get:   '@src'
}

テンプレートの中で image パラメータを使用すると、文字列“image1.jpgimage2.jpgimage3.jpg”が返されます。

true¶

以下の例示のように、list キーワードをtrueに設定すると、全ての実測値の配列を取得し、それらと共に機能するループを使用することができます。そのような状況における使用例を以下に例示します。

デスクトップサイトのページコード

<html>
    <body>
        <img src="image1.jpg" />
        <img src="image2.jpg" />
        <img src="image3.jpg" />
    </body>
</html>

list キーワードが true に設定されているパラメータコレクション内のコード

imageList: {
    xpath: '//img',
    get:   '@src',
    list:  true
}

テンプレート内で imageList パラメータを使用すると、配列 [‘image1.jpg’, ‘image2.jpg’, ‘image3.jpg’] が返されます。

この配列と共に機能する FOREACH文を使用可能です。

<!--{foreach $.imageList as item }-->
<img src="<!--{= item }-->">
<!--{/foreach}-->

結果として、デスクトップサイトのページ上で利用可能な三つの画像が返されます。

注釈

ループを用いてデスクトップページ上の複数の要素の存在をチェックしたい場合、list キーワードが true に設定されていると空の配列が返されるため、チェックは正しく実行されません。これを避けるためには、以下の例示のように配列の長さを定義する必要があります。

<!--{= $.imageList.length }-->

参考