_index.js
单选框内部一共有三个组件:el-radio
、el-radio-button
和el-radio-group
,我们将一一进行讲解。
import Radio from './src/radio';
import RadioButton from './src/radio-button.vue';
import RadioGroup from './src/radio-group.vue';
export default function(Vue) {
Vue.component(Radio.name, Radio);
Vue.component(RadioButton.name, RadioButton);
Vue.component(RadioGroup.name, RadioGroup);
};
export { Radio, RadioButton, RadioGroup };
radio-group
radio-group
的实现十分简单,就是一个div.radio-group
包裹着一个slot
。
<template>
<div class="el-radio-group">
<slot></slot>
</div>
</template>
script
包含一系列改变样式的prop
。
props: {
size: String, // Radio 按钮组尺寸
fill: { // 按钮激活时的填充色和边框色
type: String,
default: '#20a0ff'
},
textColor: { // 按钮激活时的文本颜色
type: String,
default: '#fff'
}
},
watch
上监听了value
,它会触发change
事件并且向父组件传递el.form.change
事件。
watch: {
value(value) {
this.$emit('change', value);
this.dispatch('ElFormItem', 'el.form.change', [this.value]);
}
}
其中dispatch
是从emitter
这一mixin
中引入的,我们将在mixin篇
中进行讲解,简单的说,这是用来模拟vue1.0
中向父组件传播事件的$dispatch
的。
mixins: [Emitter],
radio
radio
组件其实也先相对简单,它同样引入了emitter
这一mixin
,我们将按照从外往里的顺序进行分析。
label
首先最外面是一个label
标签作为包裹。
<label class="el-radio">
</label>
input
然后,是作为input
的span
部分,它包含一个用来表示选中效果的span
和一个不可以见的input
用来模拟原生的radio
。
最外层el-radio__input
最外层是span.el-radio__input
,上面有一些动态class
,来调整样式,我们也将一一进行讲解。
<span class="el-radio__input"
:class="{
'is-disabled': disabled,
'is-checked': model === label,
'is-focus': focus
}"
>
</span>
disabled
disabled
是一个简单的Boolean
型的prop
,会影响是否可以选中。
props:{
disabled: Boolean,
}
label
label
是radio
选中时的value
,也是通过prop
传递的。
props: {
label: {},
}
model
model
是一个计算属性,也不是很复杂,就是用来实现v-model
的。
computed: {
model: {
get() {
// 如果父组件是radio-group,返回父组件的value,否则返回自己的value
return this.isGroup ? this._radioGroup.value : this.value;
},
set(val) {
if (this.isGroup) {
// 如果父组件是 radio-group,派发input事件,让父组件去 emit input 事件
this.dispatch('ElRadioGroup', 'input', [val]);
} else {
// 否则自己 emit input 事件
this.$emit('input', val);
}
}
}
}
其中isGroup
是另一个计算属性,用来一直向上寻找,看看有没有父组件乃至祖先组件是radio-group
。
computed: {
isGroup() {
let parent = this.$parent;
while (parent) {
if (parent.$options.componentName !== 'ElRadioGroup') {
parent = parent.$parent;
} else {
this._radioGroup = parent;
return true;
}
}
return false;
},
}
focus
focus
是一个data
属性,会在原生的input
的获得焦点和失去焦点时被改变。
el-radio__inner
el-radio__inner
是用来实现选中效果的,通过css
控制。
<span class="el-radio__inner"></span>
input
最后是一个input
来模拟原生的radio
,上面进行了一些简单的处理,并绑定了相应的数据。
<input
class="el-radio__original"
:value="label"
type="radio"
v-model="model"
@focus="focus = true"
@blur="focus = false"
:name="name"
:disabled="disabled">
radio-button
radio-button
和radio
基本上一样。
label
最外面仍然是一个label
。
<label
class="el-radio-button"
:class="[
size ? 'el-radio-button--' + size : '',
{ 'is-active': value === label }
]"
>
</label>
size
size
是一个计算属性,它直接使用了沿着父组件向上寻找到的radio-group
上设置的size
。
computed: {
size() {
return this._radioGroup.size;
}
}
_radioGroup
也是一个计算属性,它将一直向上寻找radio-group
:
computed: {
_radioGroup() {
let parent = this.$parent;
while (parent) {
if (parent.$options.componentName !== 'ElRadioGroup') {
parent = parent.$parent;
} else {
return parent;
}
}
return false;
},
}
label
label
是一个prop
,用来表示选中该按钮时的value
值。
props: {
label: {},
}
value
value
是用来实现v-model
的,来获取选择的按钮,从其代码可以看出来,radio-button
和radio
不同,它不能脱离radio-group
单独使用:
computed: {
value: {
get() {
return this._radioGroup.value;
},
set(value) {
this._radioGroup.$emit('input', value);
}
},
}
input
然后是用来模拟原生radio
的input
,上面绑定了相应的数据:
<input
class="el-radio-button__orig-radio"
:value="label"
type="radio"
v-model="value"
:name="name"
:disabled="disabled">
el_radio-button__inner
最后是真正会显示的按钮span
即其样式,它内部的值可以通过匿名的默认slot
或者label
进行设置,前者具有更高的优先级:
<span class="el-radio-button__inner" :style="value === label ? activeStyle : null">
<slot></slot>
<template v-if="!$slots.default">{{label}}</template>
</span>
可以看出上面还绑定了一个动态的style
,它通过判断value === label
决定当前按钮是否被选中,然后应用activeStyle
,而这个activeStyle
也是一个计算属性,简单的说它会根据父级radio-group
的属性来设置样式:
computed: {
activeStyle() {
return {
backgroundColor: this._radioGroup.fill,
borderColor: this._radioGroup.fill,
color: this._radioGroup.textColor
};
},
}