arc:enum

​

參數

• item：要對其屬性進行迭代的物件的名稱。
• attr：指定迭代哪些屬性的匹配運算式。例如，“arc:*”。也可以使用該參數來迭代多值屬性的值。
• prefix：列舉物件基於的字首。
• expand：布林值，指定當遇到多值屬性時，arc:enum 如何執行。如果 expand 設定為 true，arc:enum 的主體會將屬性中的每個值都執行一次。如果為 false，所有值將會串聯在一個字串值裡，只執行單次迭代。預設情況下，arc:enum 不會展開所有值。
• sep[arator]：如果 expand 參數為 false，則用來連線多值屬性值的分隔符號。除此之外，如果未定義清單分隔符號，則使用分隔符號對清單中的值進行標記。預設值為換行字元“\n”。
• list：要列舉的分隔值清單。例如，如果清單為 “violet，indigo，blue，green，yellow，orange，red” 且分隔符號為 “,”，那麼對每個顏色都將會執行 arc:enum 的範圍。
• range：以升序或降序列舉時字母或字元的範圍；例如，“a..z”，“Z..A”。

​

控制屬性

• _attr: 被迭代的屬性名稱。當對多值屬性進行迭代時，屬性名稱將相同，只是會包含索引作為名稱的一部分。使用雜湊符號（#）將名稱和索引分隔開。例如，name#1，name#2等。
• _index：屬性出現在物件中的索引或當前列舉元素在清單中的位置。
• _value：被迭代的屬性的值。對於一個多值屬性，expand 和 separator 參數設定決定了 _value 是對一個屬性值的引用還是對所有屬性值的引用。
• _count：在一個屬性或一個清單中值的數量。
• _separator：清單中用來分隔值的分隔符號。

​

範例

<arc:set item="input" attr="Greeting" value="Hello" />
<arc:set item="input" attr="Goodbye" value="See ya" />
<arc:enum item="input">
  [_attr] is [_value]
  <br/>
</arc:enum> 

goodbye is See ya greeting is Hello

<arc:set attr="colors" value="violet, indigo, blue, green, yellow, orange, red"/>
<arc:enum list="[colors]" separator=",">
  [_value] 
</arc:enum>

<arc:enum range="a..z">
  [_value] 
</arc:enum>
<arc:enum range="Z..A">
  [_value] 
</arc:enum>
<arc:enum range="1..25">
  [_value] 
</arc:enum>

<arc:set attr="foo.email#1" value="joe@mycompany.com"/>
<arc:set attr="foo.email#2" value="john@mycompany.com"/>
<arc:enum attr="foo.email" expand="true">
    ([_index]) [_attr] -> [_value]
</arc:enum>

(1) email#1 -> joe@mycompany.com (2) email#2 -> john@mycompany.com

​

另請參閱

• arc:break：中斷 arc:call 或 arc:enum 迭代。
• arc:continue：跳過本次 arc:call 或 arc:enum 迭代。
• arc:first：為第一次迭代提供特殊的處理。
• arc:last：為最後一次迭代提供特殊的處理。