Radio
单选框
注意
你永远都应该使用Radio.Group而不是Radio,本组件实际上并未对Radio进行封装。是原始的ElRadio组件。新版ElRadio的入参value会和Field的入参冲突,想要兼容就必须对入参进行额外的包裹,带来不必要的复杂度。而且对于表单而言应该没有单独使用的场景,额外的封装显得有些多余。
提示
本组件做了对低版本element-plus的兼容处理,即无论你在使用哪个版本的element-plus,不使用插槽时dataSource中的对象都应包含label和value(但在低版本时使用插槽渲染还是要使用label属性来作为value)。
Markup Schema 案例
vue
<script lang="ts" setup>
import { createForm } from '@formily/core'
import { createSchemaField, FormProvider } from '@formily/vue'
import { FormItem, Radio, Submit } from '@silver-formily/element-plus'
const form = createForm()
const { SchemaField, SchemaStringField } = createSchemaField({
components: {
FormItem,
Radio,
},
})
async function log(value) {
console.log(value)
}
</script>
<template>
<FormProvider :form="form">
<SchemaField>
<SchemaStringField
name="radio"
title="单选"
x-decorator="FormItem"
x-component="Radio.Group"
:enum="[
{
label: '选项1',
value: 1,
},
{
label: '选项2',
value: 2,
},
]"
/>
<SchemaStringField
name="radio-slot"
title="插槽单选"
x-decorator="FormItem"
x-component="Radio.Group"
:enum="[
{
label: '选项1',
value: 1,
},
{
label: '选项2',
value: 2,
},
]"
:x-content="{
option: (_, { attrs }) => {
return `插槽渲染的${attrs.option.label}`
},
}"
/>
</SchemaField>
<Submit @submit="log">
提交
</Submit>
</FormProvider>
</template>JSON Schema 案例
vue
<script lang="ts" setup>
import { createForm } from '@formily/core'
import { createSchemaField } from '@formily/vue'
import { Form, FormItem, Radio, Submit } from '@silver-formily/element-plus'
const { SchemaField } = createSchemaField({
components: {
FormItem,
Radio,
},
})
const schema = {
type: 'object',
properties: {
radio: {
'type': 'boolean',
'title': '单选',
'enum': [
{
label: '选项1',
value: 1,
},
{
label: '选项2',
value: 2,
},
],
'x-decorator': 'FormItem',
'x-component': 'Radio.Group',
'x-component-props': {
optionType: 'button',
},
},
},
}
const form = createForm()
async function onSubmit(value) {
console.log(value)
}
</script>
<template>
<Form :form="form">
<SchemaField :schema="schema" />
<Submit @submit="onSubmit">
提交
</Submit>
</Form>
</template>Template 案例
vue
<script lang="ts" setup>
import { createForm } from '@formily/core'
import { Field, FormProvider } from '@formily/vue'
import { FormItem, Radio, Submit } from '@silver-formily/element-plus'
const form = createForm()
async function log(value) {
console.log(value)
}
</script>
<template>
<FormProvider :form="form">
<Field
name="radio"
title="单选"
:decorator="[FormItem]"
:component="[Radio.Group]"
:data-source="[
{
label: '选项1',
value: 1,
},
{
label: '选项2',
value: 2,
},
]"
/>
<Field
name="radio-slot"
title="单选插槽"
:component="[Radio.Group]"
:decorator="[FormItem]"
:data-source="[
{ label: '标签1', value: '1' },
{ label: '标签2', value: '2' },
]"
>
<template #option="{ option }">
使用插槽渲染的{{ option.label }}
</template>
</Field>
<Submit @submit="log">
提交
</Submit>
</FormProvider>
</template>API
参考 https://cn.element-plus.org/zh-CN/component/radio.html
扩展属性
| 属性名 | 类型 | 描述 | 默认值 |
|---|---|---|---|
| optionType | enum | 样式类型 | 'default' |
Checkbox Slot
| 插槽名 | 说明 | 类型 |
|---|---|---|
| option | 自定义每个选项渲染方式的作用域插槽 | object |