# RCollapseGrid
适合有多个条件的搜索表单。底层用 `NGrid` 渲染,子项必须是 `NGridItem`。使用 `cols`、`responsive`、`collapsedRows`、`xGap` 和 `yGap` 配置网格;未指定间距或传 `0` 时当前实现回退到 12。
## 交互示例
::: 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`。
::: warning 受控状态与更新事件
`onUpdateOpen` 和 `onUpdate:open` 回传的是内部 `collapsed`,与 `open` 相反。当前基线使用受控模式时手动取反,避免直接双向绑定把语义接反。两个监听器同时绑定会各调用一次。
:::
```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 = !collapsed
}}
>
{{
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)