Translation in progress
This page hasn't been translated into English yet, so the content below is in Chinese. The code examples work the same way.
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。