1.ä¸çå°±ä¼çè¶
å®ç¨å°ç»ä»¶ä¹LoadingButton
2.一天一个 Element 组件 - Button
3.element-ui 组件库 button 源码分析
ä¸çå°±ä¼çè¶ å®ç¨å°ç»ä»¶ä¹LoadingButton
ç»ä»¶èæ¯
å¨å¹³æ¶çå·¥ä½ä¸ï¼ç»å¸¸ä¼éå°ä¸ä¸ªåºæ¯ï¼
ç¹å»æé®æ¶è¯·æ±ä¸äºæ¥å£æ°æ®ï¼è为äºé¿å ç¨æ·éå¤çç¹å»æ们é常ä¼ä¸ºè¿äºæé®æ·»å loadingãè¿ä¸ªæ·»å loadingçåè½æ¬èº«æ¶é常ç®åçï¼åªè¦æ们å®ä¹ä¸ä¸ªåé使ç¨å¨Buttonç»ä»¶ä¸å³å¯ï¼ä½å¨ååå°ç®¡ç类项ç®æ¶ï¼è¿æ ·çæé®å¯è½ä¼æé常é常å¤ï¼å¯è½ä¸ä¸ªç»ä»¶ä¸ï¼å¾å¤åéé½æ¯xxx_loadingï¼èæ¶èååä¸å¤ä¼é ãæ¥ä¸æ¥ï¼æ们对Buttonç»ä»¶åä¸ä¸ªç®åçå°è£ æ¥è§£å³è¿ä¸ªèæ¶èååä¸å¤ä¼é çloadingé®é¢
çµææ¥æºæ们å¨ä½¿ç¨AntdçModal对è¯æ¡æ¶ï¼å½æ们çonOk为å¼æ¥å½æ°æ¶ï¼æ¤æ¶Modalçç¡®å®æé®ä¼èªå¨æ·»å loadingææï¼å¨å½æ°æ§è¡å®æåå ³éå¼¹çªï¼å°±åè¿æ ·ï¼æ¤æ¶ï¼ä»£ç å¦ä¸ï¼
asyncFunc(){ returnnewPromise(resolve=>{ setTimeout(()=>{ resolve()},源码)})},handleTestModal(){ constthat=thisthis.$confirm({ title:'æµè¯å¼æ¥å½æ°',content:'å¼æ¥å½æ°å»¶è¿ä¸¤ç§ç»æ',asynconOk(){ awaitthat.asyncFunc()}})},çå°è¿ç§ææåï¼å°±æ³å°ï¼å¦æå¯ä»¥å°è£ ä¸ä¸ªButtonç»ä»¶ï¼å°éè¦æ§è¡çå½æ°ä¼ å ¥ï¼ç»ä»¶ä¸èªå¨æ ¹æ®å½æ°æ§è¡æ åµæ·»å loadingææå²ä¸æ¯é常çæ¹ä¾¿ã
å®ç°LoadingButtonå®ä¹ç»ä»¶åæ°è¿è¾¹å°±å®ä¹å 个大家ä¼å¸¸ç¨å°çåæ°ï¼text(æé®æå)ãtype(æé®ç±»å)ãasyncFunc(æé®ç¹å»æ¶æ§è¡çå¼æ¥å½æ°)ãdelay(loading延è¿)ï¼å¦å¤ï¼è¿éè¦ä¸ä¸ªç»ä»¶å é¨çloadingåéæ¥æ§å¶æ们Buttonç»ä»¶çç¶æï¼ä»£ç å¦ä¸ï¼
exportdefault{ data(){ return{ loading:false}},props:{ text:{ type:String,default:'ç¡®å®'},type:{ type:String,default:'primary'},delay:{ type:Number,default:0},asyncFunc:{ type:Function,default:()=>{ }}},}使ç¨antdä¸çButtonç»ä»¶è¿è¡äºæ¬¡å°è£å¨æ们çèªå®ä¹LoadingButtonç»ä»¶ä¸ï¼å°ä¸é¢å®ä¹çåæ°ä½¿ç¨èµ·æ¥ï¼å¹¶ç»å®ä¸ä¸ªclickäºä»¶ï¼ä»£ç å¦ä¸ï¼
<template><Button:type="type":loading="loading"@click="handleClick">{ { text}}</Button></template><script>import{ Button}from'ant-design-vue'exportdefault{ components:{ Button},methods:{ handleClick(){ }}}</script>å¤æå¼æ¥å½æ°asyncFuncè¿ä¸é¨å为æ´ä¸ªç»ä»¶æéè¦çä¸ä¸ªé¨åï¼å³æ们å¦ä½å»å¤æä¼ å ¥çå½æ°æ¯å¼æ¥å½æ°ï¼å½æä»¬ä¼ å ¥çasyncFuncå½æ°æ¯å¼æ¥å½æ°æ¶ï¼ç»ä»¶æéè¦æ·»å loadingçå¨ç»ï¼é£ä¹æ们åºè¯¥å¦ä½å»å¤æä¸ä¸ªå½æ°æ¯å¦ä¸ºå¼æ¥å½æ°å¢ï¼
åèantdæ¯å¦ä½å®ç°çï¼ä¸é¢æ们åä»ç»äºantdçModal对è¯æ¡ä¸æ类似çé»è¾ï¼é£ä¹ä¸å¦¨å»é 读ä¸ä¸è¿é¨åç¸å ³çæºç ï¼çä¸antdçå®ç°æ¹å¼ï¼
//components/modal/ActionButton.jsxonClick(){ const{ actionFn,closeModal}=this;if(actionFn){ letret;if(actionFn.length){ ret=actionFn(closeModal);}else{ ret=actionFn();if(!ret){ closeModal();}}if(ret&&ret.then){ this.setState({ loading:true});ret.then((...args)=>{ //It'sunnecessarytosetloading=false,fortheModalwillbeunmountedafterclose.//this.setState({ loading:false});closeModal(...args);},e=>{ //Emiterrorwhencatchpromisereject//eslint-disable-next-lineno-consoleconsole.error(e);//See:/post/一天一个 Element 组件 - Button
本文深入解析 Element 的 Button 组件。
获取源码:ElemeFE/element | GitHub,源码标签:v2..0
Button 组件文档:Button 按钮
.vue 文件位置:/packages/button
.scss 文件位置:/packages/theme-chalk/button.scss
.d.ts 文件位置:/types/button.d.ts
el-button 实现基于原生 button 按钮。源码
设置 icon 属性时,源码按钮前显示对应 Icon,源码支持包裹文字。源码手游平台源码sdk源码
在 computed 内处理 buttonSize 和 buttonDisabled 的源码逻辑。buttonSize 优先级为:inject 高阶插件/组件库用例,源码若包裹在 el-form 或 el-form-item 中,源码可通过 this.elForm 和 this.elFormItem 获取。源码
全局尺寸设置 this.$ELEMENT,源码在入口文件 src/index.ts 中设定。源码
buttonDisabled 逻辑参考 buttonSize,源码优先级同上。源码
click 事件逻辑简单,源码基于 HTML button 元素,用户点击触发原生 click 事件。
点击 el-button 时,调用 handleClick 函数,触发 el-button 的 click 事件。若赋予了 @click 函数,仿面具app 源码如示例中的 count++,则该函数将执行。
CSS 相关源码解读将在后续补充。
element-ui 组件库 button 源码分析
团队将基于新的 UI 规范构建组件库,并需实现具备多种主题换肤能力的 button 组件。该组件需支持字体颜色、背景颜色、边框和禁用状态的调整,同时加入一种幽灵按钮类型。分析后,风河的源码决定不在 element-ui 组件库上进行改造,以确保更好的维护性。因此,将参考 element-plus 的 css 自定义变量实现这一目标。
深入分析 element-ui 组件库中的 button 组件,我们关注到以下几个关键点:
首先,button 组件提供了丰富的属性,如尺寸(size)、类型(type)、朴素样式(plain)、选股利器源码圆角(round)、圆形(circle)、加载状态(loading)、禁用(disabled)、图标(icon)以及是否聚焦(autofocus)等,这些属性使按钮组件具有高度的定制性。
接下来,通过查看相关的文件路径,我们发现组件的逻辑主要集中在 button.vue 文件中。该文件定义了组件的支付接口api源码属性和行为,而其样式逻辑则分散在多个文件中,包括 common/var.scss 和 theme-chalk/src/mixins/mixins.scss 等。
在 common/var.scss 文件中,定义了一系列公共变量,如主题颜色、字体颜色、字体大小等,这些变量可以通过不同的主题配置实现组件库的换肤。例如,$--color-primary 变量用于定义主要主题颜色。
为了实现组件的动态换肤,mix 函数被用于将两种颜色按不同比例混合,从而生成新的颜色。例如,mix($--color-white, $--color-primary, %) 表示将白色与主要主题颜色按 % 和 % 的比例混合。
为了遵循 Element 的样式规范,组件库采用了 BEM(Block Element Modifier)命名法来管理样式。在 packages/theme-chalk/src/mixins/mixins.scss 文件中,定义了一系列的函数,如 b()、e() 和 m(),分别用于创建基础类、元素类以及修饰符类。
在 button.scss 组件样式文件中,我们看到组件库的样式被单独管理,通过 Gulp 打包工具。文件中,@include b(button) 函数用于定义 el-button 类样式,同时考虑了相邻按钮间的间距、按钮大小、内边距、字体大小和边框圆角等参数。当需要定义不同状态的样式时,使用 when 函数来实现,如 when(loading) 用于定义加载状态的样式。
针对不同的按钮类型(type)、伪类状态和朴素按钮,组件通过覆盖默认的颜色、背景颜色和边框颜色来实现定制化。颜色的浅化通过 mix 函数与白色混合实现。文本按钮、按钮组以及不同的按钮状态都遵循 BEM 规范,通过生成相应的类样式来定义。
综上所述,通过研究 element-ui 组件库的 button 组件源码,我们深入理解了其设计的巧妙之处。这一过程不仅帮助我们学习了组件库设计的最佳实践,也为我们构建具备高度定制性和维护性的组件库提供了宝贵的启示。