高度なカスタマイズ > Info*Engine ユーザーガイド > Display Webject リファレンス > HTML 用 Display Webject > Display-Selection
  
Display-Selection
説明
NAME、SIZE、および MULTIPLE の属性を持つ OPTION、SELECT などの HTML フォーム要素を生成し、ブラウザウィンドウにドロップダウンメニューやリストボックスのフォームの選択可能なリストを表示します。
* 
FORM 要素は Webject によって自動的に生成されません。リストを正しく表示するには、例に示すように <FORM> および </FORM> タグを含めます。
構文
<ie:webject name="Display-Selection" type="DSP">
  <ie:param name="ATTRIBUTE" data="attribute"/>
  <ie:param name="ATTRIBUTE_VALUE" data="attribute_value"/>
  <ie:param name="GROUP_IN" data="group_name"/>
  <ie:param name="LEADER" data="leader_char"/>
  <ie:param name="LIST_HEADER" data="addl_item"/>
  <ie:param name="LIST_HEADER_VALUE" data="addl_item_value"/>
  <ie:param name="MULTIPLE" data="[TRUE | FALSE]"/>
  <ie:param name="NAME" data="name"/>
  <ie:param name="SELECTED" data="preselected_value"/>
  <ie:param name="SIZE" data="display_height"/>
  <ie:param name="WIDTH" data="element_width"/>
</ie:webject>
パラメータ
必須
選択
オプション
LIST_HEADER
ATTRIBUTE
LIST_HEADER_VALUE
ATTRIBUTE_VALUE
MULTIPLE
GROUP_IN
SELECTED
LEADER
NAME
SIZE
WIDTH
ATTRIBUTE
生成する HTML OPTION 要素の値属性として使用されたり、表示する値として使用されたりする値を持つオブジェクト属性の名前を指定します。このオブジェクト属性の属性名は、生成する HTML SELECT 要素の名前値としても使用されます。
ATTRIBUTE_VALUE を指定すると、HTML SELECT 要素の名前値と HTML OPTION 要素の値属性がこのパラメータによって決まります。一方、HTML OPTION 要素によって表示される値は ATTRIBUTE によって指定される値を保持します。
このパラメータのデフォルトでは、すべての属性を使用して表示します。このパラメータには複数の値を指定できます。このパラメータはオプションです。
ATTRIBUTE_VALUE
生成する HTML OPTION 要素では値属性として使用され、生成する HTML SELECT 要素では名前値として使用される値を持つ Webject 属性の名前を指定します。表示される値は ATTRIBUTE パラメータの値を保持します。
ATTRIBUTE パラメータを指定していない場合、ATTRIBUTE_VALUE パラメータによって、生成する HTML SELECT 要素の名前値と生成する HTML OPTION 要素の値属性が決定されます。一方、表示される値は ATTRIBUTE パラメータのデフォルト値によって異なります。
このパラメータのデフォルトでは、サブミットする値と表示する値の両方に同じ属性が使用されます。このパラメータはオプションです。
GROUP_IN
入力ソースとして使用するグループの名前を識別します。このグループは VDB グループまたは Context グループです。このパラメータのデフォルトでは、VDB で最後に定義されたグループを使用します。このパラメータはオプションです。
グループの詳細については、Info*Engine データ管理を参照してください。
LEADER
複数の属性値間に配置する文字列値を指定します。width パラメータを指定しない場合は、LEADER 値が属性値間のセパレータになります。LEADER 値には 1 つまたは複数の文字が含まれます。幅を指定した場合、属性値が幅と等しくなるか、またはそれを超えるまで LEADER 値を使用して属性値を大きくします。このパラメータのデフォルトは "_" です。このパラメータはオプションです。
LIST_HEADER
ドロップダウンリストまたはリストボックスの最上部に表示する選択可能な追加アイテムを指定します。LIST_HEADER パラメータと LIST_HEADER_VALUE パラメータはペアとして処理されます。そのため、LIST_HEADER パラメータを指定する場合は、LIST_HEADER_VALUE パラメータも指定する必要があります。このパラメータには複数の値を指定できます。
LIST_HEADER_VALUE
LIST_HEADER パラメータのアイテムを選択した場合は、フォームをサブミットしたときに返される LIST_HEADER パラメータのアイテムの値を指定します。このパラメータの値を有効にするには LIST_HEADER パラメータを指定する必要があります。このパラメータには複数の値を指定できます。
MULTIPLE
フラグとして動作し、選択可能なリストから複数のオブジェクトを選択できるようにします。このパラメータのデフォルトは FALSE です。複数のオブジェクトを選択できるようにするには TRUE を指定します。また、SELECTED パラメータを使用してあらかじめリストの値をすべて選択できるようにするには、このパラメータを TRUE に設定する必要があります。
NAME
生成する HTML SELECT 要素の NAME 値を設定します。このパラメータのデフォルトでは、ATTRIBUTE パラメータによって指定された属性名を使用します。または、ATTRIBUTE_VALUE パラメータを指定している場合は、ATTRIBUTE_VALUE パラメータによって指定された属性名を使用します。ATTRIBUTE パラメータまたは ATTRIBUTE_VALUE パラメータのいずれも指定していない場合は、最初の属性の名前を使用します。このパラメータはオプションです。
SELECTED
ドロップダウンメニューまたはリストボックスでデフォルトとして使用する属性値を指定します。値を指定しない、属性値を 1 つ指定する、またはすべての値を指定できます。このパラメータのデフォルトは "" です。リストのすべての値をデフォルトに設定するには、このパラメータの値を "*" に設定します。すべての値をあらかじめ選択するには、MULTIPLE パラメータを有効にしておく必要があります。
SIZE
生成するリストボックスに一度に表示するオプションの数を設定します。値を指定しない場合は、このパラメータのデフォルトではアイテムを 1 つ表示します。デフォルトを使用する (アイテムを 1 つ指定する) 場合、ドロップダウンメニューが生成されます。アイテムを 2 つ以上指定すると、リストボックスが表示されます。SIZE パラメータで指定したアイテムの数よりも多くのアイテムが返された場合は、すべて表示できるようにスクロールバーが表示されます。このパラメータはオプションです。
WIDTH
ドロップダウンメニューまたはリストボックスの OPTION 要素の幅を設定します。このパラメータのデフォルトは属性のサイズです。複数の属性を指定する場合は、各属性に WIDTH パラメータを指定できます。WIDTH パラメータよりも指定した属性が多い場合は、最初の属性から順にこのパラメータと属性が 1 対 1 の関係で適用され、残りの属性にはデフォルト値が使用されます。このパラメータはオプションです。
以下の Display-Selection Webject の例では、入力グループに複数の要素が含まれており、それぞれに name、address、および email 属性値があると想定されています。
デフォルト表示
* 
SIZE パラメータのデフォルトがドロップダウンメニューに表示されます。
Webject
<form>
<ie:webject name="Display-Selection" type="DSP"/>
</form>
出力
生成された HTML
<form>
<select name='NAME'>
<option value='Sam Johnson'>Sam Johnson1234 Main
                             St.sjohnson@somewhere.com</option>
<option value='Harvy Anderson'>Harvy Anderson1234 Amber
                            St.handerson@somewhere.com</option>
<option value='James O'Connor'>James O'Connor775 Main
                                                   St.</option>
<option value='Harvey Hampton'>Harvey Hampton775 Main
                             St.hhampton@somewhere.com</option>
</select>
</form>
1 つの属性の表示
* 
SIZE パラメータに値 1 を指定するとドロップダウンメニューが表示されます。
Webject
<form>
<ie:webject name="Display-Selection" type="DSP">
  <ie:param name="ATTRIBUTE" data="NAME"/>
  <ie:param name="SIZE" data="1"/>
</ie:webject>
</form>
出力
生成された HTML
<form>
<select name='NAME' size=1>
<option value='Sam Johnson'>Sam Johnson</option>
<option value='Harvy Anderson'>Harvy Anderson</option>
<option value='James O'Connor'>James O'Connor</option>
<option value='Harvey Hampton'>Harvey Hampton</option>
</select>
</form>
オプションのタグ値が異なる 1 つの属性の表示
以下の例では、指定した ATTRIBUTE_VALUE パラメータが ATTRIBUTE パラメータで指定した属性と異なる場合に生成されるリストを表示します。この場合、リストボックスには NAME 属性が表示されます。一方、フォームをサブミットしたときに返される値は ADDRESS 属性になります。
Webject
<form>
<ie:webject name="Display-Selection" type="DSP">
  <ie:param name="ATTRIBUTE" data="NAME"/>
  <ie:param name="ATTRIBUTE_VALUE" data="ADDRESS"/>
</ie:webject>
</form>
出力
生成された HTML
<form>
<select name='ADDRESS'>
<option value='1234 Main St.'>Sam Johnson</option>
<option value='1234 Amber St.'>Harvy Anderson</option>
<option value='775 Main St.'>James O'Connor</option>
<option value='775 Main St.'>Harvey Hampton</option>
</select>
</form>
セパレータを使用した複数の属性の表示
Webject
<form>
<ie:webject name="Display-Selection" type="DSP">
  <ie:param name="ATTRIBUTE_VALUE" data="ADDRESS"/>
  <ie:param name="LEADER" data = ", "/>
  <ie:param name="SIZE" data="6"/>
</ie:webject>
</form>
出力
生成された HTML
<form>
<select name='ADDRESS' size=6>
<option value='1234 Main St.'>Sam Johnson, 1234 Main St.,
                                sjohnson@somewhere.com</option>
<option value='1234 Amber St.'>Harvy Anderson, 1234 Amber St.,
                               handerson@somewhere.com</option>
<option value='775 Main St.'>James O'Connor, 775 Main St.,
                                                      </option>
<option value='775 Main St.'>Harvey Hampton, 775 Main St.,
                                hhampton@somewhere.com</option>
</select>
</form>
セパレータと幅を使用した複数の属性の表示
Webject
<ie:webject name="Display-Selection" type="DSP">
  <ie:param name="ATTRIBUTE_VALUE" data="ADDRESS"/>
  <ie:param name="LEADER" data = "_"/>
  <ie:param name="WIDTH" data="20"/>
  <ie:param name="WIDTH" data="20"/>
  <ie:param name="WIDTH" data="20"/>
  <ie:param name="SIZE" data="6"/>
</ie:webject>
</form>
出力
* 
指定した WIDTH と等しくなるか、またはそれを超えるまで LEADER を使用して各属性を大きくします。
生成された HTML
<form>
<select name='ADDRESS' size=6>
<option value='1234 Main St.'>Sam Johnson_________1234 Main
                      St._______sjohnson@somewhere.com</option>
<option value='1234 Amber St.'>Harvy Anderson______1234 Amber
                      St.______handerson@somewhere.com</option>
<option value='775 Main St.'>James O'Connor______775 Main
                       St.____________________________</option>
<option value='775 Main St.'>Harvey Hampton______775 Main
                     St.________hhampton@somewhere.com</option>
</select>
</form>
定数値を含む 1 つの属性の表示
Webject
<form>
<ie:webject name="Display-Selection" type="DSP">
  <ie:param name="ATTRIBUTE" data="NAME"/>
  <ie:param name="ATTRIBUTE_VALUE" data="ADDRESS"/>
  <ie:param name="LIST_HEADER" data="All Employees"/>
  <ie:param name="LIST_HEADER_VALUE" data="*"/>
  <ie:param name="SIZE" data="6"/>
</ie:webject>
</form>
出力
生成された HTML
<form>
<select name='ADDRESS' size=6>
<option value='*'>All Employees</option>
<option value='1234 Main St.'>Sam Johnson</option>
<option value='1234 Amber St.'>Harvy Anderson</option>
<option value='775 Main St.'>James O'Connor</option>
<option value='775 Main St.'>Harvey Hampton</option>
</select>
</form>
複数の定数値を含む 1 つの属性の表示
Webject
<form>
<ie:webject name="Display-Selection" type="DSP">
  <ie:param name="ATTRIBUTE" data="NAME"/>
  <ie:param name="ATTRIBUTE_VALUE" data="ADDRESS"/>
  <ie:param name="LIST_HEADER" data="All Employees,No
                                         Employees" delim=","/>
  <ie:param name="LIST_HEADER_VALUE" data="*,-" delim=","/>
  <ie:param name="SIZE" data="6"/>
</ie:webject>
</form>
出力
生成された HTML
<form>
<select name='ADDRESS' size=6>
<option value='*'>All Employees</option>
<option value='-'>No Employees</option>
<option value='1234 Main St.'>Sam Johnson</option>
<option value='1234 Amber St.'>Harvy Anderson</option>
<option value='775 Main St.'>James O'Connor</option>
<option value='775 Main St.'>Harvey Hampton</option>
</select>
</form>
あらかじめ選択したオプションを含む 1 つの属性の表示
Webject
<form>
<ie:webject name="Display-Selection" type="DSP">
  <ie:param name="ATTRIBUTE" data="ADDRESS"/>
  <ie:param name="SIZE" data="6"/>
  <ie:param name="SELECTED" data="1234 Amber ST."/>
</ie:webject>
</form>
出力
生成された HTML
<form>
<select name='ADDRESS' size=6>
<option value='1234 Main St.'>1234 Main St.</option>
<option selected value='1234 Amber St.'>1234 Amber St.</option>
<option value='775 Main St.'>775 Main St.</option>
<option value='775 Main St.'>775 Main St.</option>
</select>
</form>
すべてのオプションがあらかじめ選択された 1 つの属性の表示
Webject
<form>
<ie:webject name="Display-Selection" type="DSP">
  <ie:param name="ATTRIBUTE" data="ADDRESS"/>
  <ie:param name="SIZE" data="6"/>
  <ie:param name="SELECTED" data="*"/>
  <ie:param name="MULTIPLE" data="TRUE"/>
</ie:webject>
</form>
出力
生成された HTML
<form>
<select name='ADDRESS' size=6 multiple>
<option selected value='1234 Main St.'>1234 Main St.</option>
<option selected value='1234 Amber St.'>1234 Amber St.</option>
<option selected value='775 Main St.'>775 Main St.</option>
<option selected value='775 Main St.'>775 Main St.</option>
</select>
</form>