# xForm 组件
# 综合示例
配置 json,生成 form 表单,本示例展示了 xForm 的各种用法:设置初始值、树形选择器、表单校验 等
<template>
<div class="app-container" :v-loading="loading">
<x-form ref="xForm" v-model="formData" :config="formConfig" />
</div>
</template>
<script>
export default {
data() {
return {
loading: 0,
formData: {
status: 'enable' // 默认数据
},
treeData: [{
id: "1",
name: "xx公司",
children: [
{
id: "2",
name: "技术部",
children: [
{ id: "4", name: "Java 组" },
{ id: "5", name: "Web 组" },
{ id: "6", name: "PHP 组" },
{ id: "7", name: "Python 组" }
]
},
{ id: "3", name: "售后部" }
]
}]
}
},
computed: {
formConfig() {
const _this = this
return {
inline: false,
item: [
{
xType: 'input',
name: 'username',
label: '登录名',
tooltip: '登录名的<br />提示信息',
rules: [{ required: true, message: '请输入', trigger: ['blur', 'change'] }]
},
{
xType: 'datePicker',
type: 'date',
name: 'birthday',
label: '生日',
rules: [{ required: true, message: '请输入', trigger: ['blur', 'change'] }] },
{
xType: 'select',
type: 'tree',
name: 'deptId',
label: '部门', dic: { data: _this.treeData, label: 'name', value: 'id'},
rules: [{ required: true, message: '请输入', trigger: ['blur', 'change'] } ]
},
{
xType: 'select',
type: 'tree',
name: 'deptId2',
label: '部门多选',
multiple: true,
dic: { data: _this.treeData, label: 'name', value: 'id'},
rules: [{ required: true, message: '请输入', trigger: ['blur', 'change'] } ]
},
{
xType: 'input',
name: 'phone',
label: '手机号',
rules: [ { required: true, pattern: /^1[3-9][0-9]{9}$/, message: '请输入正确的手机号', trigger: ['blur', 'change'] }]
},
{
xType: 'input',
name: 'email',
label: '邮箱',
rules: [{ type: 'email', message: '请输入正确的邮箱地址', trigger: ['blur', 'change'] }]
},
{
xType: 'select',
name: 'sex',
label: '性别',
dic: [{ label: '男', value: 'male' }, { label: '女', value: 'female' }]
},
{
xType: 'select',
name: 'sex2',
label: '自定义下拉',
dic: {data: [{id: 1, name: "男男"}], label: 'name', value: 'id'}
},
{
xType: 'radio',
name: 'status',
label: '状态',
dic: [ { label: '激活', value: 'enable' }, { label: '锁定', value: 'disable' }]
},
{
xType: 'checkbox',
name: 'hobby',
label: '爱好',
dic: [ { label: '篮球', value: 'basketball' }, { label: '足球', value: 'football' }]
},
{
xType: "input",
type: 'password',
name: "password",
label: '密码'
},
{
xType: 'input',
type: 'textarea',
name: 'remark',
label: '备注'
}
],
operate: [
{ text: '保存', show: true, click: _this.save },
{ text: '取消', show: true, click: () => console.log('cancel') }
]
}
}
},
methods: {
save() {
this.loading++;
this.$refs['xForm'].validate().then(() => {
console.log(this.formData)
}).catch(e => console.error(e)).finally(() => this.loading--)
}
}
}
</script>
显示代码
# slot 插入
在 form 表单之间插入任意信息,满足自定义需求,支持两种不同的插入方式,设置 xType=slot 时,表示保留 form 原有的 itemLabel,插入 label 后的内容;当设置 slot='slotName' 时表示插入一段和 form 完全无关的代码
<template>
<div class="app-container" :v-loading="loading">
<x-form ref="xForm" v-model="formData" :config="formConfig">
<template #titleSlot>
<p style="color: red;">这是插入的一段文字</p>
</template>
<template #age>
<input type="text">
</template>
<template #address>
<div v-for="(item, index) in formData.address" :key="index" style="margin-bottom: 10px">
<el-input v-model="item.value" style="width: 300px"></el-input>
<el-button type="primary" icon="el-icon-plus" circle @click="addAddress"></el-button>
<el-button type="primary" icon="el-icon-minus" circle @click="removeAddress(index)"></el-button>
</div>
</template>
</x-form>
</div>
</template>
<script>
export default {
data() {
return {
loading: 0,
formData: {
status: 'enable', // 默认数据
address: [
{ value: '' }
]
},
treeData: [{
id: "1",
name: "xx公司",
children: [
{
id: "2",
name: "技术部",
children: [
{ id: "4", name: "Java 组" },
{ id: "5", name: "Web 组" },
{ id: "6", name: "PHP 组" },
{ id: "7", name: "Python 组" }
]
},
{ id: "3", name: "售后部" }
]
}]
}
},
computed: {
formConfig() {
const _this = this
return {
inline: false,
item: [
{ xType: 'input', name: 'username', label: '登录名', rules: [{ required: true, message: '请输入', trigger: ['blur', 'change'] }] },
{ xType: "input", type: 'password', name: "password", label: '密码', },
{ slot: "titleSlot" },
{ xType: "slot", name: "age", label: "年龄" },
{ xType: "slot", name: "address", label: '地址' },
],
operate: [
{ text: '保存', show: true, click: _this.save },
{ text: '取消', show: true, click: () => console.log('cancel') }
]
}
}
},
methods: {
addAddress() {
this.formData.address.push({ value: '' })
},
removeAddress(index) {
this.formData.address.splice(index, 1)
},
save() {
this.loading++;
this.$refs['xForm'].validate().then(() => {
console.log(this.formData)
}).catch(e => console.error(e)).finally(() => this.loading--)
}
}
}
</script>
显示代码
# 远程搜索
在 form 表单之间插入任意信息,满足自定义需求
<template>
<div class="app-container" :v-loading="loading">
<x-form ref="xForm" v-model="formData" :config="formConfig" />
</div>
</template>
<script>
export default {
data() {
return {
loading: 0,
restaurants: [],
formData: {},
}
},
mounted() {
this.restaurants = this.loadAll();
},
computed: {
formConfig() {
const _this = this
return {
inline: false,
item: [
{ xType: 'autocomplete', fetchSuggestions: _this.querySearch, name: 'username', label: '登录名', rules: [{ required: true, message: '请输入', trigger: ['blur', 'change'] }] },
],
operate: [
{ text: '保存', show: true, click: _this.save },
{ text: '取消', show: true, click: () => console.log('cancel') }
]
}
}
},
methods: {
save() {
this.loading++;
this.$refs['xForm'].validate().then(() => {
console.log(this.formData)
}).catch(e => console.error(e)).finally(() => this.loading--)
},
querySearch(queryString, cb) {
let restaurants = this.restaurants;
let results = queryString ? restaurants.filter(this.createFilter(queryString)) : restaurants;
// 调用 callback 返回建议列表的数据
cb(results);
},
createFilter(queryString) {
return (restaurant) => {
return (restaurant.value.toLowerCase().indexOf(queryString.toLowerCase()) === 0);
};
},
loadAll() {
return [
{ "value": "三全鲜食(北新泾店)", "address": "长宁区新渔路144号" },
{ "value": "Hot honey 首尔炸鸡(仙霞路)", "address": "上海市长宁区淞虹路661号" },
{ "value": "新旺角茶餐厅", "address": "上海市普陀区真北路988号创邑金沙谷6号楼113" },
{ "value": "泷千家(天山西路店)", "address": "天山西路438号" },
{ "value": "胖仙女纸杯蛋糕(上海凌空店)", "address": "上海市长宁区金钟路968号1幢18号楼一层商铺18-101" },
{ "value": "贡茶", "address": "上海市长宁区金钟路633号" },
{ "value": "豪大大香鸡排超级奶爸", "address": "上海市嘉定区曹安公路曹安路1685号" },
{ "value": "茶芝兰(奶茶,手抓饼)", "address": "上海市普陀区同普路1435号" },
{ "value": "十二泷町", "address": "上海市北翟路1444弄81号B幢-107" },
{ "value": "星移浓缩咖啡", "address": "上海市嘉定区新郁路817号" },
{ "value": "阿姨奶茶/豪大大", "address": "嘉定区曹安路1611号" },
{ "value": "新麦甜四季甜品炸鸡", "address": "嘉定区曹安公路2383弄55号" },
{ "value": "Monica摩托主题咖啡店", "address": "嘉定区江桥镇曹安公路2409号1F,2383弄62号1F" },
{ "value": "浮生若茶(凌空soho店)", "address": "上海长宁区金钟路968号9号楼地下一层" },
{ "value": "NONO JUICE 鲜榨果汁", "address": "上海市长宁区天山西路119号" },
{ "value": "CoCo都可(北新泾店)", "address": "上海市长宁区仙霞西路" },
{ "value": "快乐柠檬(神州智慧店)", "address": "上海市长宁区天山西路567号1层R117号店铺" },
{ "value": "Merci Paul cafe", "address": "上海市普陀区光复西路丹巴路28弄6号楼819" },
{ "value": "猫山王(西郊百联店)", "address": "上海市长宁区仙霞西路88号第一层G05-F01-1-306" },
{ "value": "枪会山", "address": "上海市普陀区棕榈路" },
{ "value": "纵食", "address": "元丰天山花园(东门) 双流路267号" },
{ "value": "钱记", "address": "上海市长宁区天山西路" },
{ "value": "壹杯加", "address": "上海市长宁区通协路" },
{ "value": "唦哇嘀咖", "address": "上海市长宁区新泾镇金钟路999号2幢(B幢)第01层第1-02A单元" },
{ "value": "爱茜茜里(西郊百联)", "address": "长宁区仙霞西路88号1305室" },
{ "value": "爱茜茜里(近铁广场)", "address": "上海市普陀区真北路818号近铁城市广场北区地下二楼N-B2-O2-C商铺" },
{ "value": "鲜果榨汁(金沙江路和美广店)", "address": "普陀区金沙江路2239号金沙和美广场B1-10-6" },
{ "value": "开心丽果(缤谷店)", "address": "上海市长宁区威宁路天山路341号" },
{ "value": "超级鸡车(丰庄路店)", "address": "上海市嘉定区丰庄路240号" },
{ "value": "妙生活果园(北新泾店)", "address": "长宁区新渔路144号" },
{ "value": "香宜度麻辣香锅", "address": "长宁区淞虹路148号" },
{ "value": "凡仔汉堡(老真北路店)", "address": "上海市普陀区老真北路160号" },
{ "value": "港式小铺", "address": "上海市长宁区金钟路968号15楼15-105室" },
{ "value": "蜀香源麻辣香锅(剑河路店)", "address": "剑河路443-1" },
{ "value": "北京饺子馆", "address": "长宁区北新泾街道天山西路490-1号" },
{ "value": "饭典*新简餐(凌空SOHO店)", "address": "上海市长宁区金钟路968号9号楼地下一层9-83室" },
{ "value": "焦耳·川式快餐(金钟路店)", "address": "上海市金钟路633号地下一层甲部" },
{ "value": "动力鸡车", "address": "长宁区仙霞西路299弄3号101B" },
{ "value": "浏阳蒸菜", "address": "天山西路430号" },
{ "value": "四海游龙(天山西路店)", "address": "上海市长宁区天山西路" },
{ "value": "樱花食堂(凌空店)", "address": "上海市长宁区金钟路968号15楼15-105室" },
{ "value": "壹分米客家传统调制米粉(天山店)", "address": "天山西路428号" },
{ "value": "福荣祥烧腊(平溪路店)", "address": "上海市长宁区协和路福泉路255弄57-73号" },
{ "value": "速记黄焖鸡米饭", "address": "上海市长宁区北新泾街道金钟路180号1层01号摊位" },
{ "value": "红辣椒麻辣烫", "address": "上海市长宁区天山西路492号" },
{ "value": "(小杨生煎)西郊百联餐厅", "address": "长宁区仙霞西路88号百联2楼" },
{ "value": "阳阳麻辣烫", "address": "天山西路389号" },
{ "value": "南拳妈妈龙虾盖浇饭", "address": "普陀区金沙江路1699号鑫乐惠美食广场A13" }
];
}
}
}
</script>
显示代码
# 子表单
适用于一对多的场景
<template>
<div class="app-container" :v-loading="loading">
<x-form ref="xForm" v-model="formData" :config="formConfig">
<template #slotTag="scope">
<el-tag>{{ scope.row.username }}</el-tag>
</template>
</x-form>
</div>
</template>
<script>
export default {
data() {
return {
loading: 0,
formData: {
userList: [
{
username: '张三',
birthday: new Date(),
age: "18",
weight: '50kg',
},
{
username: '张三',
birthday: new Date(),
age: "18",
weight: '50kg',
},
{
username: '张三',
birthday: new Date(),
age: "18",
weight: '50kg',
},
{
username: '张三',
birthday: new Date(),
age: "18",
weight: '50kg',
},
]
}
}
},
computed: {
formConfig() {
const _this = this
return {
inline: false,
item: [
{
xType: 'input',
name: 'username',
label: '登录名',
tooltip: "登录名的提示",
rules: [{ required: true, message: '请输入', trigger: ['blur', 'change'] }]
},
{
xType: 'datePicker',
type: 'date',
name: 'birthday',
label: '生日',
rules: [{ required: true, message: '请输入', trigger: ['blur', 'change'] }]
},
{
xType: 'tabs',
tabs: [
{
label: '人员列表',
name: 'userList',
add:(arr)=>{ // 自定义插入方法
arr.splice(arr.length, 0, {
username: '张三',
birthday: new Date(),
age: "18",
weight: '50kg',
})
console.log("add")
},
remove:(arr)=>{ // 自定义移除方法
console.log("remove")
},
addConfig: { // 覆盖默认配置
show: true,
text: '新增1',
},
operate: { // 本配置会覆盖全局配置,所以不写也可以,默认采用全局配置
show: true,
label: '操作',
width: '60px',
headerAlign: 'center',
align: 'center',
btn: [
{
type: 'danger',
icon: 'el-icon-close',
size: 'mini',
circle: true,
style: '',
className: ''
},
{
type: 'primary',
icon: 'el-icon-open',
size: 'mini',
circle: true,
style: '',
className: '',
show: false
}
]
},
spanMethod: ({ row, column, rowIndex, columnIndex }) => {
if (columnIndex === 0) {
if (rowIndex % 2 === 0) {
return {
rowspan: 2,
colspan: 1
}
} else {
return {
rowspan: 0,
colspan: 0
}
}
}
},
column: [
{
label: '信息',
children: [
{
label: '合并体重',
name: 'weight',
renderHeader: (h, { column, $index }) => {
return h('div',[
h('span', column.label),
h('el-button', {
style: "display: inline-block; margin-left: 10px;",
on: {
click: () => window.alert("自定义头部,具体见vue的jsx语法")
},
props: {
icon: "el-icon-delete",
circle: true,
size: 'mini'
}
}),
])
},
},
{
label: '年龄',
name: 'age',
disabled: true,
xType: 'input',
},
{
label: '登录名',
name: 'username',
xType: 'input',
headerAlign: 'left',
tooltip: "表格的提示",
style: 'width: 100px',
rules: [{ required: true, message: '请输入', trigger: ['blur', 'change'] }]
}
]
},
{
xType: 'datePicker',
type: 'date',
name: 'birthday',
label: '生日',
rules: [{ required: true, message: '请输入', trigger: ['blur', 'change'] }]
},
{
xType: 'slot',
label: '插槽插入(多级表头无法自定义插槽)',
slot: true,
name: 'slotTag',
},
]
},
{
label: '人员列表2',
show: true,
name: 'userList2',
add:(arr)=>{ // 自定义插入方法
arr.splice(arr.length, 0, {})
console.log("add")
},
remove: (arr, index) => {
arr.splice(index, 1)
console.log("remove")
},
column: [
{
xType: 'input',
name: 'username',
label: '登录名2',
},
{
xType: 'datePicker',
type: 'date',
name: 'birthday',
label: '生日2',
rules: [{ required: true, message: '请输入', trigger: ['blur', 'change'] }]
},
]
},
{
type: 'form',
label: '表单',
name: 'formTab',
addConfig: {show: false},
formConfig: { // 同XForm配置
item: [
{
xType: 'input',
label: '身高',
name: 'height'
},
{
xType: 'select',
label: '性别',
name: 'sex',
dic: [{label: '男', value: 'male'}, {label: '女', value: 'female'}]
}
]
}
}
]
}
],
operate: [
{ text: '保存', show: true, click: _this.save },
{ text: '取消', show: true, click: () => console.log('cancel') }
]
}
}
},
methods: {
save() {
this.loading++;
this.$refs['xForm'].validate().then(() => {
console.log(this.formData)
}).catch(e => console.error(e)).finally(() => this.loading--)
}
}
}
</script>
显示代码