マスタデータ¶
selectやcheckboxを使用する場合は、必ず、マスタデータを準備してください。
注釈
JSON Schemaには、enumで指定可能な項目を設定できますが、 国際化に対応できないため、マスタデータを使用してください。
マスタデータ構造¶
マスタはJSON形式で指定します。マスタを使用するwidgets(表示部品)によって構造が異なります。
基本構造:
{
"yourMasterName": [
{ "key": "inputKind_01", "value": "01" },
{ "key": "inputKind_02", "value": "02" }
]
}
「key」は選択項目の名称になりますが、国際化するためにメッセージデータで定義した項目名を指定します。
上記設定例に対応したメッセージデータの定義例:
{
"message": {
…
"userRegist": {
"inputKind_01": "選択項目1",
"inputKind_02": "選択項目2"
}
…
},
}
selectボックスで選択した時に対応するinputにヒントを出したい場合、 [example]プロパティを追加します。上記と同様にメッセージデータで定義した項目名を指定します。
ヒント機能を使う場合の定義例:
{
"yourMasterName": [
{ "key": "inputKind_01", "value": "01", "example": "example_01" },
{ "key": "inputKind_02", "value": "02", "example": "example_02" }
]
}
radioboxの各項目に注釈を表示する場合、 [note]プロパティを追加します。上記と同様にメッセージデータで定義した項目名を指定します。
ノート機能を使う場合の定義例:
{
"yourMasterName": [
{ "key": "inputKind_01", "value": "01", "note": "note_01" },
{ "key": "inputKind_02", "value": "02", "note": "note_02" }
]
}
選択項目をグルーピングしたい場合、[group]プロパティでデータを分割定義します。
選択項目をグルーピングした定義例:
{
"yourMasterName": { "group": [
{ "title": "group_01", "items": [
{ "key": "target_01", "value": "01", "example": "target_example_01" },
{ "key": "target_02", "value": "02", "example": "target_example_02" },
{ "key": "target_03", "value": "03", "example": "target_example_03" }
]
},
{ "title": "group_02", "items": [
{ "key": "target_04", "value": "04", "example": "target_example_04" },
{ "key": "target_05", "value": "05", "example": "target_example_05" }
]
}
]
}