视图

视图组件用于在页面中嵌入一个已有的视图列表，直接复用其数据列表、查询条件、功能按钮等配置，是搭建列表页的核心组件。

概述

将「视图」拖入画布后，在属性抽屉中选择一个已配置好的视图列表，即可在页面中渲染该视图的完整列表能力。

• 组件不复制视图的配置，而是引用视图列表资源；视图列表本身在 视图列表 模块中维护。
• 视图在移动端与 PC 端会自适应渲染（移动端使用视图的移动端渲染）。
• 未选择视图时，组件在画布中显示「待配置」占位提示。

配置项

配置项	说明
视图	选择一个视图列表；必填，支持按名称搜索

视图引用与数据传递

• 组件只声明所引用的视图 ID（MetaViewId），运行态会把该 ID 作为 metaViewId 透传给视图页面，由视图列表自身负责数据查询、分页与行操作。
• 组件会继承页面上下文（如当前应用 appId、数据 ID、父级数据等），因此视图内的行操作、跳转、下钻能够与所在页面正常联动。
• 视图列表属于跨应用共享的资源，选择后页面与该视图保持引用关系：修改视图配置会同步影响所有引用它的页面。

使用建议

1. 先在各应用下完成视图列表的配置，再到页面中通过本组件引用，避免在页面内重复配置列表。
2. 若需要用页面模板中的**视图模板（MetaView 分类）**承载移动端渲染，可在对应视图上启用移动端渲染并复用本组件。

下一步

• 表单 - 数据录入与编辑组件
• 数据详情 - 单条数据展示组件
• 页面 - 返回平台页面总览

属性明细

以下内容面向技术实现与 AI 检索。组件所有 meta 值均以字符串形式存储在 WidgetItem.meta 中。

组件属性（meta）

属性名	类型	含义	取值/存储值
MetaViewId	string(GUID)	引用的视图列表 ID，必填	视图列表主键，取自 POST /api/DataSource/GetMetaViewDataSource；无默认值

组件固定 uid：01460a3d-b6c3-45ca-9c5c-ed80416ac1af（GetSidebarItemMeta 返回，存库用于判断组件是否已被使用过）。引用关系由 meta.MetaViewId 决定：运行态若存在该值，则将其作为 metaViewId 传入视图页面；否则渲染骨架 / 空态。

存储示例

完整 WidgetItem：

{
  "id": "6f3a1c2e-7b4d-4a91-9f0e-2c5b8d1a7e34",
  "uid": "01460a3d-b6c3-45ca-9c5c-ed80416ac1af",
  "dragType": "Widget",
  "originalType": "Widget",
  "widgetType": "MetaView",
  "widgetTypeName": "视图",
  "meta": {
    "MetaViewId": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e"
  },
  "children": []
}

嵌套在「基础容器（Row）> 布局列组件（Column）」中的完整位置示例：

{
  "id": "3f9c1a2b-4d5e-4f60-8a71-9b2c3d4e5f60",
  "uid": "5a0f3c1e-9b8d-4f6a-9c2e-7d1b4a8e6f3d",
  "dragType": "Row",
  "originalType": "Row",
  "widgetType": "Row",
  "widgetTypeName": "基础容器",
  "meta": { "ColumnSpace": "5" },
  "children": [
    {
      "id": "7c1d2e3f-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
      "uid": "7b9a905e-83d4-452b-83c8-694a3e0935e3",
      "dragType": "Column",
      "originalType": "Column",
      "widgetType": "Column",
      "widgetTypeName": "布局列组件",
      "meta": { "LayoutType": "vertical", "Align": "default", "ItemSpace": "5" },
      "children": [
        {
          "id": "6f3a1c2e-7b4d-4a91-9f0e-2c5b8d1a7e34",
          "uid": "01460a3d-b6c3-45ca-9c5c-ed80416ac1af",
          "dragType": "Widget",
          "originalType": "Widget",
          "widgetType": "MetaView",
          "widgetTypeName": "视图",
          "meta": { "MetaViewId": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e" },
          "children": []
        }
      ]
    }
  ]
}

相关接口

接口	说明
POST /api/DataSource/GetMetaViewDataSource	获取可选择的视图列表选项，支持按关键字（keyWords）搜索