RCollapseGrid
适合有多个条件的搜索表单。底层用 NGrid 渲染,子项必须是 NGridItem。使用 cols、responsive、collapsedRows、xGap 和 yGap 配置网格;未指定间距时回退到 12,传 0 保留零间距。
交互示例
查看示例源码
vue
<template>
<DemoFrame>
<div class="ray-demo">
<RCollapseGrid
v-model:open="open"
:cols="2"
:collapsedRows="1"
:collapseToggleText="copy.toggle"
>
<NGridItem v-for="field in fields" :key="field">
<NInput
v-model:value="filters[field]"
:placeholder="copy.fields[field]"
:aria-label="copy.fields[field]"
/>
</NGridItem>
<template #action>
<NButton type="primary" @click="submitted = { ...filters }">{{
copy.search
}}</NButton>
</template>
</RCollapseGrid>
<output class="ray-demo-result">{{ submitted ?? copy.hint }}</output>
</div>
</DemoFrame>
</template>
<script setup lang="ts">
import { RCollapseGrid } from '@ray-template/ui/collapse-grid'
import { NButton, NGridItem, NInput } from 'naive-ui'
import { useData } from 'vitepress'
import { computed, reactive, ref } from 'vue'
import DemoFrame from './DemoFrame.vue'
const fields = ['name', 'department', 'role', 'id'] as const
const filters = reactive({ name: '', department: '', role: '', id: '' })
const { lang } = useData()
const copy = computed(() =>
lang.value.startsWith('en')
? {
fields: {
name: 'Name',
department: 'Department',
role: 'Role',
id: 'ID',
},
toggle: ['Expand', 'Collapse'] as [string, string],
search: 'Search',
hint: 'Expand to show more filters.',
}
: {
fields: { name: '姓名', department: '部门', role: '岗位', id: '编号' },
toggle: ['展开', '收起'] as [string, string],
search: '查询',
hint: '展开后可填写更多条件',
},
)
const open = ref(false)
const submitted = ref<typeof filters>()
</script>| 属性 | 默认 | 说明 |
|---|---|---|
open | false | 展开状态,true 表示展开,false 表示收起。 |
actionSpan | 1 | 操作区占用的网格列数。 |
actionAlign | 'end' | 操作区 CSS 对齐值,可用 auto、end、center、start。 |
collapseToggleText | ['展开', '收起'] | 两个位置依次对应收起时和展开时显示的按钮文案。 |
bordered | true | 外层卡片边框。 |
default 渲染筛选项,action 渲染查询按钮,collapse(collapsed) 可替换展开按钮。自定义折叠插槽只收到布尔值,需要自行绑定按钮并修改 open。
受控状态与更新事件
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 () => (
<RCollapseGrid
open={open.value}
cols={3}
collapsedRows={1}
onUpdateOpen={(value) => {
open.value = value
}}
>
{{
default: () => [
<NGridItem>
<NInput placeholder="订单号" />
</NGridItem>,
<NGridItem>
<NInput placeholder="客户" />
</NGridItem>,
<NGridItem>
<NInput placeholder="城市" />
</NGridItem>,
],
action: () => <NButton type="primary">查询</NButton>,
}}
</RCollapseGrid>
)
},
})