置換定義式における複数の戻り値
置換定義式の要素セレクタまたは値セレクタに (*) を使用すると、複数の値を含む文字列を返すことができます。文字列には以下の値が含まれます。
• 要素と属性の 1 つのペアからの複数の属性値
• 1 つの属性に対応する複数の要素からの属性値
これらの組み合わせが文字列内でどのように表現されるかを理解するために、tbl という名前のグループを以下のように図で表して考えてみます。
1 つの要素からの複数の属性値
要素 1 (A および A1) からの Y 属性値をすべて含む文字列を返すには、以下のデータ属性を含めます。
data="$(tbl[0]Y[*])"
返される文字列は以下のとおりです。
"A,A1"
コンマによって値が区切られていることに注意してください。
ほかのセパレータを指定するには、valueSeparator 属性を含める必要があります。たとえば、コロン区切りのリストを返すには、以下の属性を使用します。
data="$(tbl[0]Y[*])" valueSeparator=":"
返される文字列は以下のとおりです。
"A:A1"
各エレメントからの最初の属性値
各要素 (56 および 77) からの最初の Z 属性値を含む文字列を返すには、以下のデータ属性を含めます。
data="$(tbl[*]Z[0])"
デフォルトでは、返される文字列は以下のようになります。
"56;77;"
セミコロンによって他のセルの値と区切られており、第 3 の要素の値がないことに注意してください。
ほかのセパレータを指定するには、elementSeparator 属性を含める必要があります。たとえば、パーセント記号区切りのリストを返すには、以下の属性を使用します。
data="$(tbl[*]Y[0])" elementSeparator="%"
返される文字列は以下のとおりです。
"56%77%"
すべての要素からの複数の属性値
すべての要素 (A、A1、B、B1、および C) からの Y 属性値をすべて含む文字列を返すには、以下のデータ属性を含めます。
data="$(tbl[*]Y[*])"
デフォルトでは、返される文字列は以下のようになります。
"A,A1;B,B1;C"
1 つのセル内の値はコンマで区切られており、異なるセルの値はセミコロンで区切られていることに注意してください。
ほかのセパレータを指定するには、valueSeparator および elementSeparator 属性を含める必要があります。たとえば、コロンとパーセント記号をセパレータとして使用する文字列を返すには、以下の属性を含めます。
data="$(tbl[*]Y[*])" valueSeparator=":" elementSeparator="%"
返される文字列は以下のとおりです。
"A:A1%B:B1%C"
