element-ui button组件 radio组件源码分析整理笔记(一)
button组件
button.vue
<template> <button class="el-button" @click="handleclick" :disabled="buttondisabled || loading" :autofocus="autofocus" :type="nativetype" :class="[ type ? 'el-button--' + type : '', buttonsize ? 'el-button--' + buttonsize : '', { 'is-disabled': buttondisabled, 'is-loading': loading, 'is-plain': plain, 'is-round': round, 'is-circle': circle } ]" > <i class="el-icon-loading" v-if="loading"></i> <i :class="icon" v-if="icon && !loading"></i> <span v-if="$slots.default"><slot></slot></span> </button> </template> <script> export default { name: 'elbutton', //provider/inject:简单的来说就是在父组件中通过provider来提供变量,然后在子组件中通过inject来注入变量 inject: { elform: { default: '' }, elformitem: { default: '' } }, props: { type: { //按钮类型 type: string, default: 'default' }, size: string, //按钮尺寸 icon: { //图标类名 type: string, default: '' }, nativetype: { //原生type类型 type: string, default: 'button' }, loading: boolean,//是否加载中状态 disabled: boolean,//是否禁用状态 plain: boolean, //是否朴素按钮 autofocus: boolean, //是否默认聚焦 round: boolean,//是否圆角按钮 circle: boolean //是否圆形按钮 }, computed: { //父组件中的变量 _elformitemsize() { return (this.elformitem || {}).elformitemsize; }, //按钮尺寸计算 buttonsize() { return this.size || this._elformitemsize || (this.$element || {}).size; }, //按钮是否禁用 buttondisabled() { return this.disabled || (this.elform || {}).disabled; } }, methods: { handleclick(evt) { this.$emit('click', evt); } } }; </script>
radio组件
radio.vue
<template> <label class="el-radio" :class="[ border && radiosize ? 'el-radio--' + radiosize : '', { 'is-disabled': isdisabled }, { 'is-focus': focus }, { 'is-bordered': border }, { 'is-checked': model === label } ]" role="radio" :aria-checked="model === label" :aria-disabled="isdisabled" :tabindex="tabindex" @keydown.space.stop.prevent="model = isdisabled ? model : label" > <span class="el-radio__input" :class="{ 'is-disabled': isdisabled, 'is-checked': model === label }" > <span class="el-radio__inner"></span> <input class="el-radio__original" :value="label" type="radio" aria-hidden="true" v-model="model" @focus="focus = true" @blur="focus = false" @change="handlechange" :name="name" :disabled="isdisabled" tabindex="-1" > </span> <span class="el-radio__label" @keydown.stop> <slot></slot> <template v-if="!$slots.default">{{label}}</template> </span> </label> </template> <script> import emitter from 'element-ui/src/mixins/emitter'; export default { name: 'elradio', mixins: [emitter], inject: { elform: { default: '' }, elformitem: { default: '' } }, componentname: 'elradio', props: { value: {}, label: {}, disabled: boolean, name: string, border: boolean, size: string }, data() { return { focus: false }; }, computed: { isgroup() { let parent = this.$parent; while (parent) { if (parent.$options.componentname !== 'elradiogroup') { parent = parent.$parent; } else { this._radiogroup = parent; return true; } } return false; }, model: { get() { return this.isgroup ? this._radiogroup.value : this.value; }, set(val) { if (this.isgroup) { this.dispatch('elradiogroup', 'input', [val]); } else { this.$emit('input', val); } } }, _elformitemsize() { return (this.elformitem || {}).elformitemsize; }, radiosize() { const temradiosize = this.size || this._elformitemsize || (this.$element || {}).size; return this.isgroup ? this._radiogroup.radiogroupsize || temradiosize : temradiosize; }, isdisabled() { return this.isgroup ? this._radiogroup.disabled || this.disabled || (this.elform || {}).disabled : this.disabled || (this.elform || {}).disabled; }, tabindex() { return (this.isdisabled || (this.isgroup && this.model !== this.label)) ? -1 : 0; } }, methods: { handlechange() { this.$nexttick(() => { this.$emit('change', this.model); this.isgroup && this.dispatch('elradiogroup', 'handlechange', this.model); }); } } }; </script>
解析:
(1)组件的html结构
<label ...> <span class='el-radio__input'> <span class='el-radio__inner'></span> <input type='radio' .../> </span> <span class='el-radio__label'> <slot></slot> <template v-if="!$slots.default">{{label}}</template> </span> </label>
整个组件是一个外层label嵌套两个span。label放在最外面的作用是扩大鼠标点击范围,点击文字或者input都能触发响应。
第一个 表示圆形按钮,里面的span就是模拟的圆圈,input才是真正的radio按钮,通过样式隐藏了。
第二个表示文字部分。 默认渲染间的文本; 表示如果没有文本,但是
这篇博文中有详细的说明: 强烈推荐!
(2)label部分
<label class="el-radio" :class="[ border && radiosize ? 'el-radio--' + radiosize : '', { 'is-disabled': isdisabled }, { 'is-focus': focus }, { 'is-bordered': border }, { 'is-checked': model === label } ]" role="radio" :aria-checked="model === label" :aria-disabled="isdisabled" :tabindex="tabindex" @keydown.space.stop.prevent="model = isdisabled ? model : label" >
1、 border && radiosize ? 'el-radio--' + radiosize : '',
radiosize 是radio 的尺寸,仅在 border 为真时有效。radiosize是计算属性
radiosize() { // props 的 size 及 form 注入的 size 及全局配置对象 ($element, 此对象由引入时 vue.use() 传入的默认空对象)的 size const temradiosize = this.size || this._elformitemsize || (this.$element || {}).size; // 通过isgroup判断是否被 radio-group 组件包裹,如果包裹优先 radiogroupsize return this.isgroup ? this._radiogroup.radiogroupsize || temradiosize : temradiosize; }
isgroup:获取当前组件的父级组件,然后检查其组件名是否是elradiogroup即单选框组,如果不是就继续检查父级的父级。这个方法会找到距离自己最近的父级elradiogroup组件,有则true,无则false
isgroup() { let parent = this.$parent; while (parent) { if (parent.$options.componentname !== 'elradiogroup') { parent = parent.$parent; } else { this._radiogroup = parent; return true; } } return false; }
2、{ 'is-disabled': isdisabled } 表示是否禁用radio组件,与尺寸类似,就不说了。
3、 { 'is-checked': model === label } 表示当前按钮是否被选中,通过 model === label 控制。这里看下model:
model: { get() { //取值 //通过isgroup判断是否被 radio-group 组件包裹,如果是就返回 radio-group的value:如果不是就返回自己的value return this.isgroup ? this._radiogroup.value : this.value; }, set(val) { //赋值 if (this.isgroup) { // 被 radio-group 组件包裹 ,radio-group 组件发布 input 事件,传递值 this.dispatch('elradiogroup', 'input', [val]); } else { // 没有被 radio-group 组件包裹, 触发父组件上的input事件传递出val this.$emit('input', val); } } }
4、wai-aria无障碍网页应用属性
role="radio" :aria-checked="model === label" :aria-disabled="isdisabled"
wai-aria指无障碍网页应用。主要针对的是视觉缺陷,失聪,行动不便的残疾人以及假装残疾的测试人员。尤其像盲人,眼睛看不到,其浏览网页则需要借助辅助设备,如屏幕阅读器,屏幕阅读机可以大声朗读或者输出盲文。而aria就是可以让屏幕阅读器准确识别网页中的内容,变化,状态的技术规范,可以让盲人这类用户也能无障碍阅读!
5、:tabindex="tabindex" :控制tab是否可以选中
tabindex() { //禁用状态或者单选按钮是在单选框组组件内且不是选中状态时,返回 -1; return (this.isdisabled || (this.isgroup && this.model !== this.label)) ? -1 : 0; }
当tabindex=0时,该元素可以用tab键获取焦点,且访问顺序是按照元素在文档中的顺序来获取焦点;当tabindex=1时,该元素用tab键获取不到焦点;当 tabindex > 0 的元素都切换之后,才会切换到 tabindex = 0 的元素,并且按出现的先后次序进行切换,这里的逻辑就是tab只能访问到选中状态下的单选按钮
6、@keydown.space.stop.prevent="model = isdisabled ? model : label"
空格键按下的时候给model赋值,但是不知道有什么用,不知道在什么场景下用得到。
(3)混入选项
import emitter from 'element-ui/src/mixins/emitter'; mixins: [emitter],
这里主要是用到了dispatch方法
dispatch(componentname, eventname, params) { var parent = this.$parent || this.$root; var name = parent.$options.componentname; while (parent && (!name || name !== componentname)) { parent = parent.$parent; if (parent) { name = parent.$options.componentname; } } if (parent) { //必须用apply定$emit的调用目标对象,因为是在父组件上触发该事件而不是在dispatch里 parent.$emit.apply(parent, [eventname].concat(params)); } },
第一个参数是父级组件的名称,第二个是事件名称,第三个参数是一个数组或者单独的值,逻辑也很简单:不断地取到自己的父组件,判断是否是目标组件,如果不是继续去其父组件判断,如果是则在父组件上调用$emit触发事件。
handlechange() { this.$nexttick(() => { this.$emit('change', this.model); //找到父组件去触发父组件的handlechange事件 this.isgroup && this.dispatch('elradiogroup', 'handlechange', this.model); }); }
this.$on('handlechange', value => { //在radio-group去触发父组件的change事件 this.$emit('change', value); });
参考博文:
1、无障碍阅读:https://www.zhangxinxu.com/wordpress/2012/03/wai-aria-无障碍阅读/
2、element源码分析系列4-radio(单选框):
3、拜读及分析 element 源码 - radio 组件篇:
推荐阅读
-
element-ui Upload 上传组件源码分析整理笔记(十四)
-
element-ui Tag、Dialog组件源码分析整理笔记(五)
-
element-ui button组件 radio组件源码分析整理笔记(一)
-
element-ui Upload 上传组件源码分析整理笔记(十四)
-
element-ui input组件源码分析整理笔记(六)
-
element-ui Steps步骤条组件源码分析整理笔记(九)
-
element-ui switch组件源码分析整理笔记(二)
-
element-ui inputNumber、Card 、Breadcrumb组件源码分析整理笔记(三)
-
element-ui Rate组件源码分析整理笔记(十三)
-
element-ui Message组件源码分析整理笔记(八)