マスタデータ

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" }
      ]
    }
  ]
}