欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

element-ui button组件 radio组件源码分析整理笔记(一)

程序员文章站 2022-10-16 12:33:46
Button组件 button.vue Radio组件 radio.vue 解析: (1)组件的html结构 整个组件是一个外层label嵌套两个span。label放在最外面的作用是扩大鼠标点击范围,点击文字或者input都能触发响应。 第一个 表示圆形按钮,里面的span就是模拟的圆圈,inpu ......

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 组件篇: