用途:el-radio 是 Element Plus 提供的单选组件,用于在多个选项中做互斥的单选,常见于表单字段、设置项等场景。
主要能力:支持基础单选、禁用态(disabled)、带边框(border)样式、按钮样式(el-radio-button),并可通过 el-radio-group 组织多个选项,或使用 options 属性以数组动态生成选项列表。
使用方式:基础写法为 <el-radio v-model="radio" value="1">Option A</el-radio>。分组时用 <el-radio-group v-model="radio"> 包裹若干 el-radio;边框样式加 border,按钮样式改用 el-radio-button;动态选项可写 :options="options",选项形如 { value: '1', label: 'Option A' }。
关键 API:Radio 的 model-value / v-model 绑定值,value 为单选项值,label 为标签文本,disabled 控制禁用,border 控制边框,size 取 'large' | 'default' | 'small',name 为原生 name 属性;change 事件在值变化时触发。RadioGroup 支持 model-value / v-model、size、disabled、text-color、fill、options、props、type('radio' | 'button')。
最佳实践与限制:自 2.6.0 起单选项值应使用 value 而非 label;按钮样式分组用 el-radio-button;动态列表用 options。该组件基于 Vue 与 Element Plus,具体版本要求、安装命令及收费信息资料未提供。