# RCollapseGrid 适合有多个条件的搜索表单。底层用 `NGrid` 渲染,子项必须是 `NGridItem`。使用 `cols`、`responsive`、`collapsedRows`、`xGap` 和 `yGap` 配置网格;未指定间距时回退到 12,传 `0` 保留零间距。 ## 交互示例 ::: details 查看示例源码 <<< @/examples/CollapseGridDemo.vue ::: | 属性 | 默认 | 说明 | | -------------------- | ------------------ | ---------------------------------------------------------- | | `open` | `false` | 展开状态,`true` 表示展开,`false` 表示收起。 | | `actionSpan` | `1` | 操作区占用的网格列数。 | | `actionAlign` | `'end'` | 操作区 CSS 对齐值,可用 `auto`、`end`、`center`、`start`。 | | `collapseToggleText` | `['展开', '收起']` | 两个位置依次对应收起时和展开时显示的按钮文案。 | | `bordered` | `true` | 外层卡片边框。 | `default` 渲染筛选项,`action` 渲染查询按钮,`collapse(collapsed)` 可替换展开按钮。自定义折叠插槽只收到布尔值,需要自行绑定按钮并修改 `open`。 ::: tip 受控状态与更新事件 `onUpdateOpen` 和 `onUpdate:open` 回传展开状态,可直接绑定 `v-model:open`。旧版接入中为修正事件反向而添加的取反处理应删除。两个监听器同时绑定会各调用一次。默认切换按钮支持键盘,并通过 `aria-expanded` 表示当前状态。 ::: ```tsx import { RCollapseGrid } from '@/components' import { NButton, NGridItem, NInput } from 'naive-ui' import { defineComponent, ref } from 'vue' export default defineComponent({ setup() { const open = ref(false) return () => ( { open.value = value }} > {{ default: () => [ , , , ], action: () => 查询, }} ) }, }) ``` [组件实现](https://github.com/XiaoDaiGua-Ray/ray-template/blob/main/packages/ui/src/RCollapseGrid/src/index.tsx) · [Props](https://github.com/XiaoDaiGua-Ray/ray-template/blob/main/packages/ui/src/RCollapseGrid/src/props.ts)