2.1.48. コード値チェックボックス入力項目ウィジェット¶

コード値チェックボックス入力項目ウィジェット は チェックボックス入力項目ウィジェット について Nablarchのコード管理機能で取得したラベル、値をもとにしたチェックボックスを出力できるように改修したものである。

表示仕様など、上記以外の仕様については チェックボックス入力項目ウィジェット と同じである。

2.1.48.1. コードサンプル¶

設計成果物(ローカル動作)

<field:code_checkbox
  title            = "ユーザIDロック"
  listFormat       = "ul">
</field:code_checkbox>

実装成果物(サーバ動作)

<field:code_checkbox
  title            = "ユーザIDロック"
  name             = "11AC_W11AC01.userIdLocked"
  codeId           = "C0000001"
  pattern          = "PATTERN01"
  optionColumnName = "OPTION01"
  labelPattern     = "$OPTIONALNAME$"
  listFormat       = "ul">
</field:code_checkbox>

2.1.48.2. 仕様¶

本ウィジェットの仕様は チェックボックス入力項目ウィジェット とほぼ同じである。以下では差分となる内容について述べる。

ローカル動作時の挙動

チェックボックス入力項目ウィジェット と同様、 sample に指定したラベル分だけチェックボックスとラベルを表示する。ただし、codeId 属性にコードIDを指定した場合、下記のファイル内のエントリーから、該当するコードの名称を取得し、表示する。 pattern 属性によるパターン指定や optionColumnName 属性によるオプション名称指定も利用できる。 (codeId と sample を両方指定した場合は sample の値を優先する。)

パス: /js/devtool/resource/コード値定義.js

属性値一覧 [◎ 必須属性 ○ 任意属性 × 無効(指定しても効果なし)]

(入力項目ウィジェット共通テンプレート との共通属性は省略)

名称	内容	タイプ	サーバ	ローカル	備考
domain	項目のドメイン型	文字列	○	○
readonly	編集可能かどうか	真偽値	○	○	デフォルトは ‘false’
disabled	サーバに対する入力値の送信を抑制するかどうか	真偽値	○	○	デフォルトは ‘false’
cssClass	HTMLのclass属性値	文字列	○	○
nameAlias	一つのエラーメッセージに対して複数の入力項目をハイライト表示する場合にそのname属性をカンマ区切りで指定する。	文字列	○	×
sample	ローカル動作時に表示するチェックボックスのラベル	文字列	×	○	“\|” 区切りで複数指定する。 “[]” で囲われた項目は選択状態で表示される。
codeId	コード定義ID	文字列	◎	○
pattern	使用するコードパターンのカラム名	文字列	○	○	デフォルトは ‘PATTERN01’
optionColumnName	取得するオプション名称のカラム名	文字列	○	○	デフォルトは ‘OPTION01’
labelPattern	ラベル表示書式	文字列	○	○	ラベルを整形するパターン。プレースホルダを下記に示す。 $NAME$: コード値に対応するコード名称 $SHORTNAME$: コード値に対応するコードの略称 $OPTIONALNAME$: コード値に対応するコードのオプション名称 $OPTIONALNAME$を使用する場合は optionColumnName属性の指定が必須となる。 $VALUE$: コード値デフォルトは”$NAME$”。
listFormat	リスト表示時に使用するフォーマット	文字列	○	○	デフォルトは ‘span’
dataFrom	表示するデータの取得元	文字列	×	×	画面項目定義に記載する、「表示情報取得元」.「表示項目名」の形式で設定する。
comment	チェックボックスについての備考	文字列	×	×	設計書の表示時に、画面項目定義の項目定義一覧で、「備考」に表示される。
initialValueDesc	初期表示内容に関する説明	文字列	×	×	設計書の表示時に、画面項目定義の項目定義一覧で、「備考」に表示される。

2.1.48.3. 内部構造・改修時の留意点¶

部品一覧

パス	内容
/WEB-INF/tags/widget/field/code_checkbox.tag	コード値チェックボックス入力項目ウィジェット
/WEB-INF/tags/widget/field/base.tag	入力項目ウィジェット共通テンプレート
/js/jsp/taglib/nablarch.js	<n:codeCheckboxes> のエミュレーション機能を実装するタグライブラリスタブJS
/css/style/base.less	基本HTMLの要素のスタイル定義。チェックボックスに関する定義もここに含まれる。