2026-11-04 15:02:26 +08:00

71 lines
2.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# RCollapseGrid
<script setup>
import CollapseGridDemo from '../../examples/CollapseGridDemo.vue'
</script>
适合有多个条件的搜索表单。底层用 `NGrid` 渲染,子项必须是 `NGridItem`。使用 `cols`、`responsive`、`collapsedRows`、`xGap` 和 `yGap` 配置网格;未指定间距或传 `0` 时当前实现回退到 12。
## 交互示例
<ClientOnly>
<CollapseGridDemo />
</ClientOnly>
::: 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 () => (
<RCollapseGrid
open={open.value}
cols={3}
collapsedRows={1}
onUpdateOpen={(collapsed) => {
open.value = !collapsed
}}
>
{{
default: () => [
<NGridItem>
<NInput placeholder="订单号" />
</NGridItem>,
<NGridItem>
<NInput placeholder="客户" />
</NGridItem>,
<NGridItem>
<NInput placeholder="城市" />
</NGridItem>,
],
action: () => <NButton type="primary">查询</NButton>,
}}
</RCollapseGrid>
)
},
})
```
[组件实现](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)