For AI agents: the complete documentation index is available at https://a3s-lab.github.io/UI/llms.txt, the full documentation bundle is available at https://a3s-lab.github.io/UI/llms-full.txt, and this page is available as Markdown at https://a3s-lab.github.io/UI/harness/grid-view.md.

Grid View

Grid View 是没有标签栏和面板拖放的二维可调整网格。它适合结构由产品决定、用户只需要调整区域大小的分析台、监控台和画布;如果用户需要动态增加、关闭或重新停靠面板,应使用 Dock 工作区。

实时预览
二维可调整网格拖动分隔条调整区域大小

框架用法

React useGridview 返回 api、ready 和稳定的 onReady;Vue composable 返回 api shallow ref 与 onReady。它们只管理实例就绪状态,所有布局操作继续使用原生 GridviewApi。

选择原则

需求选择
一条轴上的连续分栏Split View
固定二维网格,不需要标签和拖放Grid View
可折叠工具区Pane View
用户可自由增加、关闭、拖放与弹出面板Dock 工作区

API 与状态

  • addPanel()、removePanel()、movePanel() 和方向定位负责结构变化。
  • 面板 API 负责尺寸约束、活动状态与可见性;宿主负责面板内数据。
  • proportionalLayout 适合需要随容器同比缩放的区域;固定工具宽度应使用显式尺寸与最小值。
  • 原生入口必须在首次增加面板前调用 layout(width, height),并在容器尺寸变化后再次布局。

无障碍

分隔条必须可辨认,面板内容保持正常文档或应用语义。不要把只靠空间位置才能理解的标签移出面板,也不要让相邻面板同时拥有页面滚动。