form-create 支持的在表单内部生成任何 vue 组件
提醒
$f.component()
方法获取该组件的生成规则时,才需要定义form-create
初始化后会自动将 maker
转换为 object
,可通过全局配置switchMaker
来控制是否自动转换通过建立一个虚拟 DOM的方式生成自定义组件
参数:
{string} tab
组件名/标签名{string} field = undefined
{string} title = undefined
1.6.1+用法:
maker.create('i-button','btn','自定义按钮')
Maker
let rule = [
formCreate.maker.create('i-button').props({
type:'primary',
field:'btn'
loading:true
})
]
$f = formCreate.create(rule);
上面的代码是通过 maker
生成器动态生成一个正在加载的 iview
按钮组件
Json
let rule = [
{
type:'i-button',
field:'btn'
props:{
type:'primary',
field:'btn',
loading:true
}
}
]
$f = formCreate.create(rule);
上面的代码是通过json
方式动态生成一个iview
按钮组件
可以通过一下两种方式动态修改组件的配置项
通过rule
修改组件生成规则
rule[0].props.loading = false;
通过$f.component()
方法获取组件的生成规则并修改
$f.component().btn.props.loading = false;
let rule = [
{
type:'row',
children:[
{
type:'i-col',
props:{
span:12
},
children:[
formCreate.maker.input('商品名称','goods_name','iphone'),
formCreate.maker.number('商品加个','goods_price',8688)
]
},
{
type:'i-col',
props:{
span:12
},
children:[
formCreate.maker.dateTime('创建时间','create_at'),
formCreate.maker.radio('是否显示','is_show').options([
{value:1,label:'显示'},
{value:0,label:'不显示'}
])
]
}
]
}
]
通过模板的方式生成自定义组件,maker.createTmp
方法是该方法的别名
参数:
{string} template
{Vue} vm
{string} field = undefined
{string} title = undefined
1.6.1+用法:
maker.template('<i-button></i-button>',new Vue,'btn','自定义按钮')
Maker
let rule = [
formCreate.maker.template('<i-button :loading="loading">{{text}}</i-button>',new Vue({
data:{
loading:true,
text:'正在加载中...'
}
}))
]
上面的代码是通过 maker
生成器动态生成一个正在加载的 iview
按钮组件
Json
let rule = [
{
type:'template',
template:'<i-button :loading="loading">{{text}}<i-button>',
vm:new Vue({
data:{
loading:true,
text:'正在加载中'
}
})
}
]
$f = formCreate.create(rule);
上面的代码是通过Object
方式动态生成一个iview
按钮组件
可以通过一下两种方式动态修改vm
组件内部的值
通过rule
获取自定义组件的vm
并修改
rule[0].vm.text = '加载完毕';
rule[0].vm.loading = false;
通过$f.component()
方法获取自定义组件的vm
并修改
$f.component().btn.vm.text = '加载完毕';
$f.component().btn.vm.loading = false;
通过表单回调事件,修改组件内部状态
fc:input
1.6.0+通过 formData , getValue 方法获取自定义组件field
时触发.可通过自定义组件向formData
中添加value
this.$on('fc:input',function(cb,$f) {
//TODO 返回自定义组件 value
//异步触发调用无效
cb(this.value);
})
fc:set-value
1.6.0+通过 setValue , changeValue , changeField 方法设置自定义组件field
值时触发
this.$on('fc:set-value',function(newValue,$f) {
//TODO 更新自定义组件内部 value
this.value = newValue;
})
fc:disabled
通过 disabled 方法禁用自定义组件时触发
this.$on('fc:disable',function(disabled,$f) {
//TODO 自定义组件更新禁用状态
this.disabled = disabled;
})
fc:reset-field
通过 resetFields 方法重置表单时触发
this.$on('fc:reset-field',function($f) {
//TODO 还原自定义组件内部 value
this.value = this.oldValue;
})
自定义按钮组件,获取按钮禁用状态
maker.create('i-button', 'btn').props({
type: "primary",
size: "large",
shape: undefined,
long: true,
htmlType: "button",
disabled: false,
icon: "ios-upload",
loading: false,
show: true
}).on({
"fc:disabled": function (disabled, $f) {
$f.component().btn.props.disabled = disabled;
},
"fc:input": function (cb, $f) {
cb($f.component().btn.props.disabled);
},
"fc:set-value": function (val, $f) {
$f.component().btn.props.disabled = val;
}
}).col({span: 12}).children(['测试自定义按钮'])
设置自定义组件禁用状态,触发fc:set-value
事件
$f.setValue('btn',false);
获取自定义组件禁用状态,触发fc:input
事件
$f.getValue('btn');
禁用按钮组件,触发fc:disabled
事件
$f.disabled('btn')
自定义计数器按钮组件,获取按钮点击数
template
方式生成的自定义组件没有fc:
前缀
maker.template('<i-button @click="onClick" long :disabled="disabled">{{num}}</i-button>', new Vue({
data: {
num: 0,
disabled: false
},
methods: {
onClick: function () {
this.num++;
},
//表单禁用事件
onDisabled: function (disabled) {
this.disabled = disabled;
},
//表单重置事件
onResetField: function () {
this.num = 0;
},
//表单提交事件
onInput: function (cb, $f) {
cb(this.num);
},
//通过setValue,changeField,changeValue方法设置表单值时事件
onSetValue: function (val, $f) {
this.num = val;
}
},
created: function () {
this.$on('fc:disabled', this.onDisabled);
this.$on('fc:reset-field', this.onResetField);
this.$on('fc:input', this.onInput);
this.$on('fc:set-value', this.onSetValue);
}
}), 'tmp', '自定义 title');
操作方式和示例一相同