2.1.59. プルダウン入力項目ウィジェット¶
プルダウン入力項目ウィジェット は UI標準 UI部品 プルダウンリスト の内容に準拠したプルダウンのリストを出力する。
本部品には以下のバリエーションがあり、必要に応じて使い分けること。
- コード値プルダウン入力項目ウィジェット Nablarchコード定義の内容をもとにしたプルダウンのリストを表示する場合に使用する。
2.1.59.1. コードサンプル¶
設計成果物(ローカル動作)
<field:pulldown title="性別" sample="[男性]|女性"> </field:pulldown>
実装成果物(サーバ動作)
<field:pulldown title="性別" name="formdata.gender" cssClass="gender" readonly="false" listName="gender" elementLabelPattern="$LABEL$" elementLabelProperty="name" elementValueProperty="id" sample="[男性]|女性"> </field:pulldown>
2.1.59.2. 仕様¶
このウィジェットは 入力項目ウィジェット共通テンプレート を用いて実装している。 入力項目ウィジェット共通テンプレート が実装する共通仕様についてはここでは記述しない。
- ローカル動作時の挙動
入力画面では sample に指定した項目を選択候補とするプルダウンリストを表示する。
確認画面では、選択済み項目(“[]” で囲われた項目) のラベルの一覧を表示する。
属性値一覧 [◎ 必須属性 ○ 任意属性 × 無効(指定しても効果なし)]
(入力項目ウィジェット共通テンプレート の共通属性は省略)
名称 | 内容 | タイプ | サーバ | ローカル | 備考 |
---|---|---|---|---|---|
domain | 項目のドメイン型 | 文字列 | ○ | ○ | |
readonly | 編集可能かどうか | 真偽値 | ○ | ○ | デフォルトは ‘false’ |
disabled | サーバに対する入力値の送信を 抑制するかどうか | 真偽値 | ○ | ○ | デフォルトは ‘false’ |
id | HTMLのid属性値 (省略時はname属性と同じ 値を使用する) | 文字列 | ○ | ○ | |
cssClass | HTMLのclass属性値 | 文字列 | ○ | ○ | |
nameAlias | 一つのエラーメッセージに 対して複数の入力項目を ハイライト表示する場合に 指定する。 | 文字列 | ○ | × | |
listName | 選択項目のリストの属性名 | 文字列 | ◎ | × | |
elementLabelProperty | リスト要素から値を取得する ためのプロパティ名 | 文字列 | ◎ | × | |
elementValueProperty | リスト要素からラベルを取得 するためのプロパティ名 | 文字列 | ◎ | × | |
elementLabelPattern | ラベルを整形するための フォーマットパターン | 文字列 | ○ | × | デフォルトは ‘$LABEL$’ |
multiple | xhtmlのmultiple属性 | 真偽値 | ○ | ○ | |
size | xhtmlのsize属性 | 数値 | ○ | ○ | |
withNoneOption | リスト先頭に選択なしの オプションを追加するか 否か。 | 真偽値 | ○ | ○ | デフォルトは ‘false’ |
sample | ローカル動作時に表示する プルダウン項目のラベル | 文字列 | × | ○ | “|” 区切りで複数指定する。 “[]” で囲われた項目は選択状態 で表示される。 |
dataFrom | 表示するデータの取得元 | 文字列 | × | × | 画面項目定義に記載する、 「表示情報取得元」.「表示項目名」 の形式で設定する。 |
comment | プルダウンについての備考 | 文字列 | × | × | 設計書の表示時に、 画面項目定義の項目定義一覧で、 「備考」に表示される。 |
initialValueDesc | 初期表示内容に関する説明 | 文字列 | × | × | 設計書の表示時に、 画面項目定義の項目定義一覧で、 「備考」に表示される。 |
2.1.59.3. 内部構造・改修時の留意点¶
部品一覧
パス | 内容 |
---|---|
/WEB-INF/tags/widget/field/pulldown.tag | プルダウン入力項目ウィジェット |
/WEB-INF/tags/widget/field/base.tag | 入力項目ウィジェット共通テンプレート |
/js/jsp/taglib/nablarch.js | <n:select> のエミュレーション機能を実装する タグライブラリスタブJS |
/css/style/base.less | 基本HTMLの要素のスタイル定義。 プルダウンに関する定義もここに含まれる。 |