嵌套字段

规格

标签	值
版本	1.2.0（更新于2025-01-10）
开发者	Labii Inc.
类型	列
支持配置	是
支持只读视图	是
支持编辑视图	是
支持表单视图	是
支持默认值	是
支持导入	是
允许多个	是

概述

Labii 的 嵌套字段 功能允许用户使用自定义定义的字段来跟踪和管理多个相关项目，为数据组织提供灵活性和精确性。通过嵌套字段，您可以定义一个项目列表，并为每个项目关联特定的属性，例如通过设置“书籍”和“订购数量”的字段来跟踪订购的书籍数量。此功能通过让用户直接在应用程序中存储详细、层次化的信息，简化了复杂的数据跟踪需求。

使用场景

1. 使用此小插件记录不同的社交账号及其用于联系的 ID。
2. 使用此小插件跟踪产品及其订购数量。
3. 使用此小插件显示特定 ID 与某些组件的关联。

配置

该小插件无需额外设置即可正常工作，但您可以使用配置来自定义按钮。

• 模式 - 嵌套字段的模式。使用来自 https://react-jsonschema-form.readthedocs.io/en/latest/ 的属性。使用 'order' 来对属性内的字段进行排序。
  • 要处理一个项目列表：设置 type=array
  • 要处理一个单独项目：设置 type=object
• 显示 - 如何显示嵌套字段。
  • 逗号分隔的键值对
  • 换行分隔的键值对
  • 逗号分隔的值
  • 换行分隔的值
  • 破折号分隔的值
  • 无分隔符的值

示例：

{
    "schema": { # use the propterties from https://react-jsonschema-form.readthedocs.io/en/latest/
      "properties": { # (required)
        "book": {
          "type": "string",
          "title": "Book",
          "description": "Select a book.",
          "enum": ["Book 1", "Book 2"],
          "enumNames": ["Book 1", "Book 2"],
          "widget": "MaterialFormSelect",
          "default": "Book 1",
          "order": 1
        },
        "quantity": {
          "type": "number",
          "title": "Quantity",
          "description": "The quantity book to order.",
          "widget": "MaterialFormNumber",
          "min": 1,
          "default": 1,
          "order": 2
        }
      },
      "minItems": 1, # number of nested fields to load on default
      "items": [], # (optional), if provided, it will overwrite the properties
      "required": [
        "test",
        "quantity"
      ]
    }
}

视图

在以下视图中查看小插件的界面。

只读视图

只读视图显示列的值。

编辑视图

编辑视图是允许您修改值的界面。

表单视图

表单视图是集成到添加表单中的字段，用于在创建新记录时收集值。

表单视图与编辑视图相同。

数据

Labii 中的每个小插件都以独特的方式存储数据；请参阅以下内容以了解此小插件的数据存储方式。

数据格式

JSON

{
    "field_1": "xxx",
    "field_2": "xxx"
}

默认值

列中的默认值字段允许您在创建记录时指定默认值。

默认值应为 JSON。

导入值

导入值是您需要在 Excel 表格中包含的值，以便将其导入 Labii。

导入值应为 JSON。