2.1.61. 単行テキスト入力項目ウィジェット

単行テキスト入力項目ウィジェット は UI標準 UI部品 単行テキスト入力 の内容に準拠したテキストボックスを出力する。

2.1.61.1. コードサンプル

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

<field:text title="漢字氏名"
            hint="全角50文字以内で入力してください。"
            required="true"
            maxlength="50">
</field:text>

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

<field:text title="漢字氏名"
            required="true"
            maxlength="50"
            hint="全角50文字以内"
            name="W11AC02.users.kanjiName">
</field:text>

2.1.61.2. 仕様

このウィジェットは 入力項目ウィジェット共通テンプレート を用いて実装している。 入力項目ウィジェット共通テンプレート が実装する共通仕様についてはここでは記述しない。

ローカル動作時の挙動

入力画面では sample に指定した文字列を初期表示するテキストボックスを表示する。

確認画面では、 sample に指定した文字列をラベル表示する。

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

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

名称 内容 タイプ サーバ ローカル 備考
domain 項目のドメイン型 文字列 ○ ○  
readonly 編集可能かどうか 真偽値 ○ ○ デフォルトは ‘false’
disabled サーバに対する入力値の送信を 抑制するかどうか 真偽値 ○ ○ デフォルトは ‘false’
id HTMLのid属性値 (省略時はname属性と同じ 値を使用する) 文字列 ○ ○  
cssClass HTMLのclass属性値 文字列 ○ ○  
maxlength 入力文字数の上限 文字列 ○ ○  
example 具体的な入力例を表すテキスト (placeholderなどの形式で 表示する) 文字列 ○ ○  
nameAlias 一つのエラーメッセージに 対して複数の入力項目を ハイライト表示する場合に 指定する。 文字列 ○ ×  
valueFormat 出力する値のフォーマット指定 (確認画面用) 文字列 ○ ×  
sample ローカル動作時にテキスト ボックスに表示する文字列 文字列 × ○  
unit 入力欄の右側に表示する単位 文字列 ○ ○

確認画面の場合は、表示する値が空の場合単位は表示しない

補足

ローカル表示で本属性を使用する場合は name属性に値を設定すること。

name属性が未設定（ブランク）の場合、 確認画面では単位はブランク表示となる。
dataFrom 表示するデータの取得元 文字列 × × 画面項目定義に記載する、 「表示情報取得元」.「表示項目名」 の形式で設定する。
comment テキスト入力項目についての備考 文字列 × × 設計書の表示時に、 画面項目定義の項目定義一覧で、 「備考」に表示される。
formatSpec 編集仕様に関する説明 文字列 × × 設計書の表示時に、 画面項目定義の項目定義一覧で、 「編集仕様」に表示される。
initialValueDesc 初期表示内容に関する説明 文字列 × × 設計書の表示時に、 画面項目定義の項目定義一覧で、 「備考」に表示される。

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

部品一覧

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