SearchForm 查询表单
列表页上方的查询条件。NsSearchForm 里面包了一个 NsForm,默认插槽直接放 NsFormItem;表单项按网格自动分列,“查询”“重置”按钮放在最后一行的最右边,条件多时可以只显示前几项、其余收起。在输入框里按回车也会查询。
引入
import { NsSearchForm, NsFormItem } from '@ns/ui'
基础用法
model 传查询条件对象,表单项写上 prop(重置要按它找字段)。点“查询”或在输入框里按回车触发 search;点“重置”先把各字段恢复成表单项挂载时的值,再触发 reset。
<script setup lang="ts">
import { reactive } from 'vue'
import { NsSearchForm, NsFormItem, NsInput, NsMessage, NsSelect } from '@ns/ui'
const query = reactive({ name: '', status: 'enabled', type: '' })
const statusOptions = [
{ label: '启用', value: 'enabled' },
{ label: '停用', value: 'disabled' }
]
// 按 query 请求列表,这里只把条件显示出来
const load = (from: string) => {
NsMessage.info(`${from}:${JSON.stringify(query)}`)
}
</script>
<template>
<NsSearchForm :model="query" @search="load('search')" @reset="load('reset')">
<NsFormItem label="名称" prop="name">
<NsInput v-model="query.name" placeholder="请输入名称" clearable />
</NsFormItem>
<NsFormItem label="状态" prop="status">
<NsSelect v-model="query.status" :options="statusOptions" clearable />
</NsFormItem>
<NsFormItem label="类型" prop="type">
<NsInput v-model="query.type" clearable />
</NsFormItem>
</NsSearchForm>
</template>
重置恢复的是挂载时的值,不是空值:页面默认带的条件(比如上面默认只看“启用”的)重置后仍然保留。
布局
表单项是 CSS 网格的格子,按 item-min-width(每列最小宽度)能放几列就分几列,各列等宽,容器变窄时自动减少列数,窄到一列都放不下时按容器宽度显示,不会出现横向滚动条。item-min-width 不写时 large 300px、default 260px、small 220px。
按钮区在最后一行的最右边:最后一行剩下的格子放得下按钮时和表单项同一行,放不下或这一行已经排满时另起一行,按钮靠右。
标签宽度默认 'auto':所有标签取最宽的那个,每列的控件左边对齐。也可以写固定宽度,例如 label-width="80px"。
<script setup lang="ts">
import { reactive } from 'vue'
import { NsSearchForm, NsFormItem, NsInput, NsSelect, NsMessage } from '@ns/ui'
const query = reactive({ name: '', status: '', type: '' })
const statusOptions = [
{ label: '启用', value: 'enabled' },
{ label: '停用', value: 'disabled' }
]
const load = () => {
NsMessage.info('已按当前条件查询')
}
</script>
<template>
<NsSearchForm :model="query" :item-min-width="300" label-width="90px" @search="load">
<NsFormItem label="名称" prop="name">
<NsInput v-model="query.name" clearable />
</NsFormItem>
<NsFormItem label="状态" prop="status">
<NsSelect v-model="query.status" :options="statusOptions" clearable />
</NsFormItem>
<NsFormItem label="类型" prop="type">
<NsInput v-model="query.type" clearable />
</NsFormItem>
</NsSearchForm>
</template>
item-min-width 可以写数字(px)或带单位的字符串。切换下面的宽度,看同样宽的容器里能放几列:
<script setup lang="ts">
import { reactive, ref } from 'vue'
import { NsSearchForm, NsFormItem, NsInput, NsSegmented } from '@ns/ui'
const minWidth = ref<string | number>(200)
const widths = [
{ label: '200(px)', value: 200 },
{ label: '不写(default 是 260px)', value: 0 },
{ label: "'24em'", value: '24em' }
]
const query = reactive({ name: '', code: '', owner: '', location: '', model: '' })
</script>
<template>
<NsSegmented v-model="minWidth" :options="widths" />
<NsSearchForm
:model="query"
:item-min-width="minWidth || undefined"
label-width="70px"
style="margin-top: 16px"
>
<NsFormItem label="名称" prop="name"><NsInput v-model="query.name" /></NsFormItem>
<NsFormItem label="编码" prop="code"><NsInput v-model="query.code" /></NsFormItem>
<NsFormItem label="负责人" prop="owner"><NsInput v-model="query.owner" /></NsFormItem>
<NsFormItem label="位置" prop="location"><NsInput v-model="query.location" /></NsFormItem>
<NsFormItem label="型号" prop="model"><NsInput v-model="query.model" /></NsFormItem>
</NsSearchForm>
</template>
占多列
日期范围这类宽的控件,给表单项写 style="grid-column: span 2" 占两列。容器只放得下一列时自动只占一列。
<script setup lang="ts">
import { reactive } from 'vue'
import { NsSearchForm, NsFormItem, NsInput, NsDatePicker, NsMessage } from '@ns/ui'
const query = reactive<{ name: string; createdAt: [Date, Date] | null }>({
name: '',
createdAt: null
})
const load = () => {
NsMessage.info('已按当前条件查询')
}
</script>
<template>
<NsSearchForm :model="query" @search="load">
<NsFormItem label="名称" prop="name">
<NsInput v-model="query.name" />
</NsFormItem>
<NsFormItem label="创建时间" prop="createdAt" style="grid-column: span 2">
<NsDatePicker v-model="query.createdAt" type="daterange" />
</NsFormItem>
</NsSearchForm>
</template>
折叠
collapse-after 设成 n 时收起状态只显示前 n 项,表单项超过 n 个才显示“展开 / 收起”按钮(在按钮区最后,带箭头)。v-model:expanded 可以读写当前是否展开,不绑定时组件自己记。
收起的项用 v-show 隐藏,仍然挂载着:已经填的值保留,查询时照常带上,重置、校验也包括它们。
<script setup lang="ts">
import { reactive, ref } from 'vue'
import { NsSearchForm, NsFormItem, NsInput, NsSelect, NsMessage } from '@ns/ui'
const expanded = ref(false)
const query = reactive({ name: '', code: '', status: '', owner: '', location: '' })
const statusOptions = [
{ label: '启用', value: 'enabled' },
{ label: '停用', value: 'disabled' }
]
const load = () => {
NsMessage.info('已按当前条件查询')
}
</script>
<template>
<p style="margin-bottom: 12px">
当前{{ expanded ? '展开' : '收起' }}(v-model:expanded = {{ expanded }})
</p>
<NsSearchForm v-model:expanded="expanded" :model="query" :collapse-after="3" @search="load">
<NsFormItem label="名称" prop="name">
<NsInput v-model="query.name" />
</NsFormItem>
<NsFormItem label="编码" prop="code">
<NsInput v-model="query.code" />
</NsFormItem>
<NsFormItem label="状态" prop="status">
<NsSelect v-model="query.status" :options="statusOptions" />
</NsFormItem>
<NsFormItem label="负责人" prop="owner">
<NsInput v-model="query.owner" />
</NsFormItem>
<NsFormItem label="存放位置" prop="location">
<NsInput v-model="query.location" />
</NsFormItem>
</NsSearchForm>
</template>
额外按钮
actions 插槽放在“重置”后面(有折叠按钮时在它前面),适合放导出、新增。插槽里没写 size 的 NsButton 自动跟着查询表单的尺寸;作用域参数 size 可以给其他组件用。
<script setup lang="ts">
import { reactive } from 'vue'
import { NsSearchForm, NsFormItem, NsInput, NsSelect, NsButton, NsMessage } from '@ns/ui'
const query = reactive({ name: '', status: '' })
const statusOptions = [
{ label: '启用', value: 'enabled' },
{ label: '停用', value: 'disabled' }
]
const load = () => {
NsMessage.info('已按当前条件查询')
}
const exportList = () => {
NsMessage.success('已导出当前查询结果')
}
const create = () => {
NsMessage.info('打开新增窗口')
}
</script>
<template>
<NsSearchForm :model="query" @search="load" @reset="load">
<NsFormItem label="名称" prop="name">
<NsInput v-model="query.name" clearable />
</NsFormItem>
<NsFormItem label="状态" prop="status">
<NsSelect v-model="query.status" :options="statusOptions" clearable />
</NsFormItem>
<template #actions>
<NsButton icon="download" @click="exportList">导出</NsButton>
<NsButton type="success" icon="plus" @click="create">新增</NsButton>
</template>
</NsSearchForm>
</template>
作用域参数 size 是查询表单的尺寸,给插槽里不是 NsButton 的组件用。下面的查询表单是 small,右侧切换视图的分段控制器也跟着用 small:
<script setup lang="ts">
import { reactive, ref } from 'vue'
import { NsSearchForm, NsFormItem, NsInput, NsSegmented, NsMessage } from '@ns/ui'
const query = reactive({ name: '' })
const view = ref<string | number>('list')
const views = [
{ value: 'list', icon: 'menu', title: '列表' },
{ value: 'card', icon: 'apps', title: '卡片' }
]
const load = () => {
NsMessage.info(`已按当前条件查询,用${view.value === 'list' ? '列表' : '卡片'}显示`)
}
</script>
<template>
<NsSearchForm :model="query" size="small" @search="load">
<NsFormItem label="名称" prop="name">
<NsInput v-model="query.name" clearable />
</NsFormItem>
<template #actions="{ size }">
<NsSegmented v-model="view" :options="views" :size="size" />
</template>
</NsSearchForm>
</template>
加载状态
loading 为 true 时“查询”按钮转圈、不能点,在输入框里按回车也不触发查询,避免重复请求。“重置”不受影响。
<script setup lang="ts">
import { reactive, ref } from 'vue'
import { NsSearchForm, NsFormItem, NsInput } from '@ns/ui'
const query = reactive({ name: '' })
// 用 setTimeout 模拟请求列表接口,1 秒后返回
const fetchList = () => new Promise((resolve) => setTimeout(resolve, 1000))
const loading = ref(false)
const load = async () => {
loading.value = true
try {
await fetchList()
} finally {
loading.value = false
}
}
</script>
<template>
<NsSearchForm :model="query" :loading="loading" @search="load" @reset="load">
<NsFormItem label="名称" prop="name">
<NsInput v-model="query.name" clearable />
</NsFormItem>
</NsSearchForm>
</template>
按钮文字
search-text、reset-text、expand-text、collapse-text 改四个内置按钮的文字(默认“查询”“重置”“展开”“收起”);show-reset 为 false 时不显示重置按钮。
<script setup lang="ts">
import { reactive } from 'vue'
import { NsSearchForm, NsFormItem, NsInput, NsMessage } from '@ns/ui'
const query = reactive({ name: '' })
const load = () => {
NsMessage.info('已按当前条件查询')
}
</script>
<template>
<NsSearchForm :model="query" search-text="搜索" :show-reset="false" @search="load">
<NsFormItem label="名称" prop="name">
<NsInput v-model="query.name" clearable />
</NsFormItem>
</NsSearchForm>
</template>
reset-text、expand-text、collapse-text 的例子,表单项超过 collapse-after 才会出现折叠按钮:
<script setup lang="ts">
import { reactive } from 'vue'
import { NsSearchForm, NsFormItem, NsInput, NsMessage } from '@ns/ui'
const query = reactive({ name: '', code: '', owner: '' })
const load = () => {
NsMessage.info('已按当前条件查询')
}
</script>
<template>
<NsSearchForm
:model="query"
:collapse-after="2"
reset-text="清空条件"
expand-text="更多条件"
collapse-text="精简条件"
@search="load"
>
<NsFormItem label="名称" prop="name">
<NsInput v-model="query.name" clearable />
</NsFormItem>
<NsFormItem label="编码" prop="code">
<NsInput v-model="query.code" clearable />
</NsFormItem>
<NsFormItem label="负责人" prop="owner">
<NsInput v-model="query.owner" clearable />
</NsFormItem>
</NsSearchForm>
</template>
标签位置
label-position 和 NsForm 一样有四种:right(默认,标签右对齐)、left(左对齐)、top(标签在上方)、float(浮动标签)。切换下面的选项对比,top、float 的细节见后面两节。
<script setup lang="ts">
import { reactive, ref } from 'vue'
import { NsSearchForm, NsFormItem, NsInput, NsSegmented, NsSelect } from '@ns/ui'
import type { FormLabelPosition } from '@ns/ui'
const position = ref<string | number>('right')
const positions = [
{ label: '右对齐(right)', value: 'right' },
{ label: '左对齐(left)', value: 'left' },
{ label: '上方(top)', value: 'top' },
{ label: '浮动(float)', value: 'float' }
]
const query = reactive({ name: '', status: '', location: '' })
const statusOptions = [
{ label: '启用', value: 'enabled' },
{ label: '停用', value: 'disabled' }
]
</script>
<template>
<NsSegmented v-model="position" :options="positions" />
<NsSearchForm
:model="query"
:label-position="position as FormLabelPosition"
style="margin-top: 16px"
>
<NsFormItem label="名称" prop="name">
<NsInput v-model="query.name" clearable />
</NsFormItem>
<NsFormItem label="状态" prop="status">
<NsSelect v-model="query.status" :options="statusOptions" clearable />
</NsFormItem>
<NsFormItem label="存放位置" prop="location">
<NsInput v-model="query.location" clearable />
</NsFormItem>
</NsSearchForm>
</template>
标签在上方
label-position="top" 时标签在控件上方,按钮和控件的底边对齐。
<script setup lang="ts">
import { reactive } from 'vue'
import { NsSearchForm, NsFormItem, NsInput, NsSelect, NsMessage } from '@ns/ui'
const query = reactive({ name: '', status: '' })
const statusOptions = [
{ label: '启用', value: 'enabled' },
{ label: '停用', value: 'disabled' }
]
const load = () => {
NsMessage.info('已按当前条件查询')
}
</script>
<template>
<NsSearchForm :model="query" label-position="top" @search="load">
<NsFormItem label="名称" prop="name">
<NsInput v-model="query.name" clearable />
</NsFormItem>
<NsFormItem label="状态" prop="status">
<NsSelect v-model="query.status" :options="statusOptions" clearable />
</NsFormItem>
</NsSearchForm>
</template>
浮动标签
label-position="float" 时标签放在输入框里,获得焦点、有值或下拉面板打开时浮到上边框上,不占标签列,同样宽度能多放几个查询项。表单项照常写 label 和 prop,规则见 Form 的浮动标签。
<script setup lang="ts">
import { reactive } from 'vue'
import { NsSearchForm, NsFormItem, NsInput, NsSelect, NsMessage } from '@ns/ui'
const query = reactive({ deptName: '', status: '' })
const statusOptions = [
{ label: '正常', value: '0' },
{ label: '停用', value: '1' }
]
const load = () => {
NsMessage.info('已按当前条件查询')
}
</script>
<template>
<NsSearchForm :model="query" label-position="float" @search="load">
<NsFormItem label="部门名称" prop="deptName">
<NsInput v-model="query.deptName" clearable />
</NsFormItem>
<NsFormItem label="部门状态" prop="status">
<NsSelect v-model="query.status" :options="statusOptions" clearable />
</NsFormItem>
</NsSearchForm>
</template>
不同尺寸
size 透传给内部的 NsForm,表单项、控件和按钮都跟着变,网格的间距和每列最小宽度也跟着变。不写时跟随 NsConfigProvider 的 size,都没有时是 'default'。表单项、控件自己写了 size 时以它们为准。
<script setup lang="ts">
import { reactive } from 'vue'
import { NsSearchForm, NsFormItem, NsInput, NsSelect, NsSpace, NsMessage } from '@ns/ui'
const query = reactive({ name: '', status: '' })
const statusOptions = [
{ label: '启用', value: 'enabled' },
{ label: '停用', value: 'disabled' }
]
const load = () => {
NsMessage.info('已按当前条件查询')
}
</script>
<template>
<NsSpace direction="vertical" fill>
<NsSearchForm :model="query" size="large" @search="load">
<NsFormItem label="名称" prop="name">
<NsInput v-model="query.name" clearable />
</NsFormItem>
<NsFormItem label="状态" prop="status">
<NsSelect v-model="query.status" :options="statusOptions" clearable />
</NsFormItem>
</NsSearchForm>
<NsSearchForm :model="query" @search="load">
<NsFormItem label="名称" prop="name">
<NsInput v-model="query.name" clearable />
</NsFormItem>
<NsFormItem label="状态" prop="status">
<NsSelect v-model="query.status" :options="statusOptions" clearable />
</NsFormItem>
</NsSearchForm>
<NsSearchForm :model="query" size="small" @search="load">
<NsFormItem label="名称" prop="name">
<NsInput v-model="query.name" clearable />
</NsFormItem>
<NsFormItem label="状态" prop="status">
<NsSelect v-model="query.status" :options="statusOptions" clearable />
</NsFormItem>
</NsSearchForm>
</NsSpace>
</template>
| 尺寸 | 控件、按钮高度 | 行距 / 列距 | 每列最小宽度 |
|---|---|---|---|
| large | 40px | 20 / 32px | 300px |
| default | 32px | 16 / 24px | 260px |
| small | 24px | 12 / 16px | 220px |
回车查询
焦点在单行输入框(NsInput、NsInputNumber、没有选中建议时的 NsAutoComplete 等)里按回车触发 search。下面这些情况不触发:
- 输入法组合中按回车(确认候选词);
textarea里的回车(换行);- 控件自己用了这次回车:
NsSelect、NsCascader、NsTreeSelect、NsDatePicker、NsTimePicker打开或确认面板,NsInputTag添加标签,NsAutoComplete选中建议; - 焦点在按钮、复选框、单选框上;
loading为true。
查询在这次按键处理完之后触发,NsInputNumber 这类回车时才提交的值已经写进 model。表单原生的提交(浏览器按回车时的隐式提交)被拦下了,不会刷新页面。
查询前校验
rules 和表单项的 rules 照常生效,但点“查询”不会自动校验。需要时在 search 里先调用 validate()。
<script setup lang="ts">
import { reactive, ref } from 'vue'
import { NsSearchForm, NsFormItem, NsInput, NsMessage } from '@ns/ui'
import type { FormRule } from '@ns/ui'
const query = reactive({ name: '', code: '' })
const searchRef = ref<InstanceType<typeof NsSearchForm>>()
const rules: Record<string, FormRule[]> = {
code: [{ pattern: /^[A-Z0-9-]*$/, message: '编码只能是大写字母、数字和 -', trigger: 'blur' }]
}
const load = async () => {
const { valid } = await searchRef.value!.validate()
if (!valid) return
// 请求列表
NsMessage.info('校验通过,已按当前条件查询')
}
</script>
<template>
<NsSearchForm ref="searchRef" :model="query" :rules="rules" @search="load">
<NsFormItem label="名称" prop="name">
<NsInput v-model="query.name" clearable />
</NsFormItem>
<NsFormItem label="编码" prop="code">
<NsInput v-model="query.code" placeholder="例如:AB-01" clearable />
</NsFormItem>
</NsSearchForm>
</template>
事件和方法
最近触发的事件按时间倒序列在下面。点“重置”按钮先恢复字段、再触发 reset;通过 ref 调用 resetFields() 只恢复字段,不触发 reset。validate()、clearValidate() 同 NsForm。
<script setup lang="ts">
import { reactive, ref } from 'vue'
import { NsButton, NsSearchForm, NsFormItem, NsInput, NsMessage, NsSpace } from '@ns/ui'
import type { FormRule, SearchFormExpose } from '@ns/ui'
const searchRef = ref<SearchFormExpose>()
const query = reactive({ name: '', code: 'abc', owner: '', location: '' })
const rules: Record<string, FormRule[]> = {
code: [{ pattern: /^[A-Z0-9-]*$/, message: '编码只能是大写字母、数字和 -' }]
}
const logs = ref<string[]>([])
const log = (text: string) => {
logs.value = [text, ...logs.value].slice(0, 6)
}
const validate = async () => {
const { valid } = await searchRef.value!.validate()
NsMessage[valid ? 'success' : 'error'](valid ? '校验通过' : '校验没通过')
}
</script>
<template>
<NsSpace wrap>
<NsButton size="small" @click="validate">validate()</NsButton>
<NsButton size="small" @click="searchRef?.clearValidate()">clearValidate()</NsButton>
<NsButton size="small" @click="searchRef?.resetFields()">resetFields()</NsButton>
</NsSpace>
<NsSearchForm
ref="searchRef"
:model="query"
:rules="rules"
:collapse-after="2"
style="margin-top: 16px"
@search="log('search')"
@reset="log('reset')"
@update:expanded="(value) => log(`update:expanded:${value}`)"
>
<NsFormItem label="名称" prop="name">
<NsInput v-model="query.name" />
</NsFormItem>
<NsFormItem label="编码" prop="code">
<NsInput v-model="query.code" />
</NsFormItem>
<NsFormItem label="负责人" prop="owner">
<NsInput v-model="query.owner" />
</NsFormItem>
<NsFormItem label="存放位置" prop="location">
<NsInput v-model="query.location" />
</NsFormItem>
</NsSearchForm>
<div class="event-log">
<div v-for="(item, index) in logs" :key="index">{{ item }}</div>
<div v-if="!logs.length">还没有触发事件</div>
</div>
</template>
<style scoped>
.event-log {
margin-top: 12px;
color: var(--ns-text-color-secondary);
font-size: var(--ns-font-size-sm);
line-height: 1.8;
}
</style>
Props
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| model | Record<string, unknown> | - | 查询条件对象。重置时按表单项的 prop 把字段恢复成挂载时的值 |
| rules | Record<string, FormRule[]> | - | 校验规则,同 NsForm。查询前不会自动校验 |
| labelWidth | string | number | 'auto' | 标签宽度。'auto' 时取所有标签里最宽的;数字按 px 算 |
| labelPosition | 'left' | 'right' | 'top' | 'float' | 'right' | 标签位置;float 是浮动标签 |
| size | 'large' | 'default' | 'small' | - | 尺寸,表单项、控件和按钮跟着变。不传时跟随 NsConfigProvider,都没有时是 'default' |
| itemMinWidth | string | number | - | 每列的最小宽度,数字按 px 算。不传时 large 300px、default 260px、small 220px |
| collapseAfter | number | 0 | 收起时只显示前几项,0 表示不折叠。表单项超过它时才显示“展开 / 收起”按钮 |
| expanded | boolean | false | 是否展开,支持 v-model:expanded |
| loading | boolean | false | 查询按钮是否加载中。加载中按钮不能点,回车也不触发查询 |
| showReset | boolean | true | 是否显示重置按钮 |
| searchText | string | '查询' | 查询按钮的文字 |
| resetText | string | '重置' | 重置按钮的文字 |
| expandText | string | '展开' | 收起时折叠按钮的文字 |
| collapseText | string | '收起' | 展开时折叠按钮的文字 |
Events
| 事件 | 回调参数 | 说明 |
|---|---|---|
| search | - | 点查询按钮,或在输入框里按回车 |
| reset | - | 点重置按钮,各字段已经恢复成初始值之后触发 |
| update:expanded | (value: boolean) | 点“展开 / 收起”按钮,用于 v-model:expanded |
Slots
| 插槽 | 作用域参数 | 说明 |
|---|---|---|
| default | - | 放 NsFormItem,每一项占网格的一格 |
| actions | { size: SearchFormSize } | 额外按钮,放在“重置”后面。没写 size 的 NsButton 跟着查询表单的尺寸 |
方法
| 名称 | 类型 | 说明 |
|---|---|---|
| validate | (callback?: FormValidateCallback) => Promise<FormValidateResult> | 校验所有带 prop 的表单项(含收起的项),同 NsForm 的 validate |
| resetFields | (props?: string | string[]) => void | 把字段恢复成初始值并清掉错误提示,同 NsForm;不触发 reset 事件 |
| clearValidate | (props?: string | string[]) => void | 只清掉错误提示,同 NsForm |
类型
import type { SearchFormProps, SearchFormEmits, SearchFormExpose, SearchFormSize } from '@ns/ui'
type SearchFormSize = 'large' | 'default' | 'small'
interface SearchFormExpose {
validate: (callback?: FormValidateCallback) => Promise<FormValidateResult>
resetFields: (props?: string | string[]) => void
clearValidate: (props?: string | string[]) => void
}
FormRule、FormValidateResult、FormValidateCallback 见 Form 表单。
注意事项
- 表单项要写
prop才会被重置和校验;重置恢复的是表单项挂载时的值。先挂载、后从接口拿到默认条件时,重置会回到挂载时的值。 - 默认插槽的每个子元素占一格,一般都放
NsFormItem;v-for、<template>包着的会先展平再计数。 - 折叠按用户写的顺序取前
collapseAfter项,v-if为假的项不计数。 - 标签宽度为
'auto'时,收起的项不参与计算;展开后如果收起的项标签更长,所有标签会一起变宽。介意时写固定的label-width。 - 一项占的列数不要超过窄宽度下的列数:只有一列时会自动改成占一列,但比如两列宽度下写
span 3会多出一列空白。 - 表单项之间的间距由网格给,组件里去掉了
NsFormItem自己的下边距。行距放得下错误提示,small 下错误提示去掉了上边距。 - 根元素是
role="search"的原生<form>,传给NsSearchForm的class、style、id等落在它上面。不要在actions插槽里放native-type="submit"的按钮:回车查询已经由组件处理,提交事件会被拦下。 - 组件本身没有背景和内边距,需要卡片样式时外面包一层
NsCard。