!++++
Ver.6 [ 機能を見る ] [ 機能設定を見る ]
※Ver5のサンプルは用意しておりません。
!----
1. はじめに
本サンプルでは、区切り文字で連結して1つのテキスト項目に保持する複数の値を、画面上では個別の入力欄として編集する方法を紹介します。
電話番号やメールアドレスなど、登録件数が一定でない複数の値を1つの項目で管理する場合を想定しています。
登録済みの値を区切り文字で分割して表示し、入力欄の追加・削除によって編集できます。
編集した値は、項目ごとに指定した区切り文字で連結して元のテキスト項目に反映し、TALONの標準確定処理によって保存します。
2. 動作上の注意点
- 区切り文字を含む値は入力できません。入力された区切り文字は自動的に除去されます。
空欄の入力欄は、値の連結対象から除外されます。
複数の値を区切り文字で連結して1つの項目に保存するため、保存先のデータベース列には、連結後の文字列を格納できる十分な長さを確保する必要があります。
3. サンプル機能の内容と確認ポイント
本サンプルでは、Client-side JavaScriptを使用して、単票ブロックの「担当者名」「電話番号」「メールアドレス」を複数の入力欄で編集できるようにします。
適用対象の指定には、項目情報の「STYLE CLASS」を使用します。設定したクラス名に応じて、値の分割・連結に使用する区切り文字を切り替えます。
また、編集用の入力欄とは別に、登録済みのデータを確認するための表示項目を配置しています。
これにより、区切り文字で連結されたデータの保存形式を画面上で確認できます。
STYLE CLASSと区切り文字の対応
- multi-input-pipe:パイプ(
|)区切り(担当者名) - multi-input-comma:カンマ(
,)区切り(電話番号) - multi-input-semicolon:セミコロン(
;)区切り(メールアドレス)
設定の内容は次の通りです。
-
事前準備(単票ブロックの準備)
複数の値を保持するテキスト項目を作成し、「項目情報 > STYLE CLASS」に、使用する区切り文字に対応したクラス名を設定します。
登録済みのデータを確認するため、保存先と同じデータベース列をSELECT式で別名を付けて取得し、更新対象外の表示項目として配置します。
-
CSSの設定
STYLE CLASSを設定したセル内の、元のテキスト入力欄を非表示にするスタイルを定義します。
-
Client-side JavaScriptの設定
STYLE CLASSのクラス名と区切り文字の対応関係を、設定用の配列に定義します。
対象項目に保持されている値を区切り文字で分割し、それぞれの値に対応する入力欄と追加・削除ボタンを動的に生成します。
入力内容が変更された場合は、各入力欄の値を区切り文字で連結し、元のテキスト項目に反映します。
TALONの
resizeContents_end()から初期化処理を実行し、対象項目に複数入力欄の機能を適用します。
🔍 確認いただけるポイント
- 登録済みの値が項目ごとの区切り文字で分割され、複数の入力欄として表示されること
- 「+ 追加」で入力欄を追加して確定すると、項目ごとの区切り文字で連結して保存され、登録データに表示されること
- 「削除」で入力欄を削除して確定すると、削除した値を除いて保存されること
- 入力欄に入力した区切り文字が取り除かれること
- STYLE CLASSを設定した「担当者名」「電話番号」「メールアドレス」の3項目に、同じ処理を適用していること
4. 画面イメージ
!++++
使用したコード一覧
!----