clickgo 5.1.1 → 5.2.0

package/doc/clickgo-rag.md

@@ -2409,7 +2409,7 @@ ECharts 配置选项。
 ## grid
 ---
 
-栅格布局容器，用于实现灵活的页面布局。
+栅格布局容器，用于实现基于列的网格布局，支持响应式列数切换。
 
 ### 参数
 
@@ -2417,59 +2417,78 @@ ECharts 配置选项。
 
 `'h'` | `'v'`
 
-布局方向，`h` 为水平，`v` 为垂直，默认 `h`。
+布局方向，`h` 为水平，`v` 为垂直，默认 `'h'`。此属性决定单元格内容的默认轴向及对齐规则。
 
 #### gutter
 
 `number` | `string`
 
-子元素之间的间距，默认 0。
+单元格之间的间距（px），默认 `0`。
 
 #### itemGutter
 
 `number` | `string`
 
-子元素内部的间距，默认 0。
+子单元格内部的默认间距（px），默认 `0`。若子单元格未指定 `gutter` 则使用此值。
 
 #### alignH
 
 `string` | `undefined`
 
-所有子元素的水平对齐方式。
+全部子单元格的全局水平对齐方式，可被子单元格自身的 `alignH` 覆盖。
 
 #### alignV
 
 `string` | `undefined`
 
-所有子元素的垂直对齐方式。
+全部子单元格的全局垂直对齐方式，可被子单元格自身的 `alignV` 覆盖。
 
-#### dense
+#### sizeM
 
-`boolean`
+`number` | `string`
+
+中等宽度（>= 600px 且 < 1000px）时的列数，默认 `2`。
+
+#### sizeL
+
+`number` | `string`
+
+大宽度（>= 1000px）时的列数，默认 `4`。
+
+### 事件
 
-是否紧凑布局，默认 true。
+无
+
+### 方法
+
+无
+
+### 插槽
+
+无
 
 ### 样式
 
-使用 CSS Grid 布局，支持水平和垂直两种排列方向。子元素通过 grid-cell 组件定义，按照 span 值分配宽度。
+容器采用 `display: grid` 布局，通过 `grid-template-columns` 属性动态控制网格列数。系统自动监听容器宽度，并在 600px 和 1000px 阈值处进行响应式断点切换。
 
-支持设置统一的间距和对齐方式。紧凑模式下子元素会自动填充空白区域。
+单元格间距通过 CSS 的 `gap` 属性实现，其值直接绑定到 `gutter` 参数。无论布局处于何种响应式状态，单元格之间的间距都能保持精确的一致性。
 
-栅格系统基于 24 列，每个 grid-cell 可指定占据的列数。
+该组件作为结构性容器，不包含任何装饰性样式。它支持多层嵌套，能够稳定承载复杂的 `grid-cell` 布局，是构建工业级管理面板和响应式门户的核心底座。
 
 ### 示例
 
 ```xml
-<grid :gutter="10">
-    <grid-cell :span="6">Cell 1</grid-cell>
-    <grid-cell :span="6">Cell 2</grid-cell>
+<grid :gutter="10" :size-m="3" :size-l="6">
+    <grid-cell>Cell 1</grid-cell>
+    <grid-cell :span="2">Cell 2</grid-cell>
 </grid>
 ```
 
+
 ## grid-cell
 ---
 
-栅格布局的子单元，需配合 `grid` 组件使用。
+栅格布局子单元格，必须放在 `grid` 容器中使用，支持灵活的跨列配置。
 
 ### 参数
 
@@ -2477,46 +2496,71 @@ ECharts 配置选项。
 
 `'h'` | `'v'` | `undefined`
 
-布局方向，覆盖父级设置。
+单元格轴向布局方向。默认继承父级 `grid` 的 `direction` 设置。
 
 #### gutter
 
 `number` | `string`
 
-间距，覆盖父级设置，默认 0。
+单元格内部间距（px）。若设置，则覆盖父级 `grid` 的 `itemGutter` 参数。默认 `0`。
 
 #### alignH
 
 `string` | `undefined`
 
-水平对齐方式，覆盖父级设置。
+内容水平对齐方式。若设置，则覆盖父级全局对齐配置。
 
 #### alignV
 
 `string` | `undefined`
 
-垂直对齐方式，覆盖父级设置。
+内容垂直对齐方式。若设置，则覆盖父级全局对齐配置。
 
 #### span
 
-`number` | `string` | `undefined`
+`number` | `string`
 
-横跨列数。`-1` 代表横跨所有列，`-2` 代表跨剩余列。
+基础跨列数。在 `m` 或 `l` 尺寸下，若未单独设置 `sizeM` 或 `sizeL`，则应用此值。默认 `0`。
+
+#### sizeM
+
+`number` | `string`
+
+中等宽度下（600px - 1000px）的跨列数。设置为 `-1` 时强制跨 `1` 列。默认 `0`。
+
+#### sizeL
+
+`number` | `string`
+
+大宽度下（>= 1000px）的跨列数。设置为 `-1` 时强制跨 `1` 列。默认 `0`。
+
+### 事件
+
+无
+
+### 方法
+
+无
+
+### 插槽
+
+无
 
 ### 样式
 
-使用 flex 布局，作为 grid 的子单元参与栅格布局。支持设置跨列数来控制占据的宽度比例。
+内部采用 flex 弹性布局，默认继承父容器的方向特性。通过 `align-items` 和 `justify-content` 属性，配合 `direction` 的状态，实现单元格内容的精准对齐与分布。
 
-可独立设置布局方向、对齐方式和间距，覆盖父级 grid 的统一设置。
+通过 CSS 的 `grid-column` 属性实现横跨多列功能。跨列逻辑会自动响应父容器的宽度状态：在小尺寸（s）模式下强制为单列堆叠，而在较高尺寸下则计算跨列偏移。
 
-单元格默认填满分配的空间，内容区域支持通过 slot 自定义。
+样式表现高度抽象，无背景、边框或强制的外边距。这使得单元格能够完美融合于各种设计风格中，开发者可以根据需要为其添加背景色或内阴影等视觉装饰。
 
 ### 示例
 
 ```xml
-<grid-cell :span="12">Full Width</grid-cell>
+<grid-cell :span="2">Cell Content</grid-cell>
 ```
 
+
 ## group
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clickgo",
-  "version": "5.1.1",
+  "version": "5.2.0",
   "description": "Background interface, software interface, mobile phone APP interface operation library.",
   "type": "module",
   "keywords": [