皮皮网

1.Element 2 组件源码剖析之 Layout (栅格化)布局系统
2.element-plus源码学习日志-03
3.element-tabs组件 源码阅读
4.element ui upload 源码解析-逐行逐析
5.elementui源码学习之仿写一个el-timeline
6.element-plus源码与二次开发：package.json解析

Element 2 组件源码剖析之 Layout (栅格化)布局系统

       深入剖析 Element 2 组件中的码系栅格化布局系统，此系统通过基础的码系分栏，为开发者提供快速简便的码系布局解决方案。本文将带你探索栅格系统如何通过行（row）与列（col）组件实现布局的码系灵活性与高效性。我们关注的码系是如何创建一致、规范、码系递归分析源码简洁的码系网页布局，提升用户体验。码系

       网页栅格化布局是码系提升页面设计与开发效率的关键工具，它让页面布局更加统一且易于复用。码系Grid.Guide、码系Bootstrap 等工具提供了灵活的码系栅格系统，允许开发者自定义最大宽度、码系列数及边界，码系以生成优化的码系栅格方案。Element 2 则借鉴 Ant Design 的理念，采用栅格系统基础上的等分原则，以应对设计区域内的大量信息收纳需求。

       栅格化布局系统的核心在于行（row）与列（col）组件。组件行（row）作为列（col）的容器，通过渲染函数构建，支持自定义HTML标签渲染，允许开发者根据需要灵活定制布局结构。列（col）组件则通过渲染函数构建，提供丰富的配置选项，包括间距、对齐方式等，以满足不同布局需求。

       行（row）组件支持通过属性动态调整样式与自定义标签，如gutter属性用于设置栅格间隔，type属性可选择使用Flex布局以实现更灵活的布局模式。justify与align属性分别控制Flex布局下的水平与垂直对齐方式，提供多种排列选项。此外，组件还通过计算属性计算样式，以抵消列（col）组件的内边距，确保布局的精确性。

       列（col）组件则通过渲染函数构建，支持自定义标签渲染，同时包含多个配置属性，如span用于指定列的宽度，gutter属性获取父组件row的间距设置，并根据此计算自己的内边距。组件还动态计算样式，以实现栅格、间隔、左右偏移的灵活调整。响应式布局特性使组件能够在不同屏幕尺寸下自动调整布局，提供适应性设计。

       通过组件的渲染函数与属性配置，Element 2 的栅格化布局系统实现了一种高效、灵活且可扩展的布局解决方案，为开发者提供了强大的工具来构建响应式、美观且功能丰富的网页布局。

element-plus源码学习日志-

       每日学习进阶，承上启下

       昨日探讨了input组件的和平雪花源码使用及编码准则，今日深入剖析element-plus源码，探索新知识。

       文件定位至element-plus\packages\dialog\src\index.vue

       先看模板代码片段，引入了teleport组件，这是新增的内置组件。

       没有使用teleport时，元素作为app组件的子节点；而使用teleport后，元素变为app组件的同级节点，统一挂载于body下，to属性可指定具体id的DOM节点。

       前端展示层级对最终显示结果影响重大。在Vue 2时代，使用Vue.extend创建新实例，挂载于app同级节点，解决全局弹层的层级问题。新自定义组件简化了开发流程，优化代码。

       引入了Vue 3自定义指令，与之前版本有所调整，需进一步学习。

       注意到Vue 3支持fragments，组件不再受限于单一节点，引入新问题，需深入研究官方文档，理解其用法。

       JS代码段回顾了之前讨论过的基础知识，简要审视，复习要点。

       今日总结：学习了Vue的新内置组件teleport，具备将包含的节点挂载至指定DOM节点的功能。并了解了新版本自定义指令的调整。

       下一步规划：基于Jest为组件编写单元测试，学习Jest的基本用法、报告生成等操作，深入框架测试领域。

element-tabs组件 源码阅读

       在深入分析element-tabs组件源码的过程中，需要把握两个基本前提：首先，对API有着深入的理解；其次，带着具体问题进行阅读，以便更高效地获取所需信息。遵循两个基本原则：不要过于纠结于那些无关紧要的细节，而应首先明确自己的实现思路，然后再深入阅读源码。接下来，我们将针对几个关键点进行详细探讨。

       首先，我们关注于元素切换时的滑动效果。通过观察源码，可以发现这种效果实现的关键在于tabs内部的计算逻辑。在`/tabs/src/tab-nav.vue`文件中，使用jsx语法实现的逻辑中，通过判断`type`的类型来决定是否调用`tab-bar`。`tab-bar`内部通过计算属性来计算`nav-bar`的宽度，这一计算依赖于`tabs.vue`通过`props`传入的`panes`数据。这表明`nav-bar`的pinv函数源码宽度是由`panes`数组驱动的，从而实现了动态调整和滑动效果。

       接下来，我们探讨`border-card`中的边框显示机制。通过观察源码，发现`tabs.scss`中`nav-wrap`的样式设置为`overflow: hidden`。这个设置与边框显示之间的关系在于，通过改变当前选中的`tab`的`border-bottom-color`为`#fff`，来实现边框的动态显示效果。具体来说，当激活某个`tab`时，通过调整CSS样式使得边框底边颜色变白，从而达到视觉上的边框显现效果。实现的细节在于通过设置`nav`的盒子位置下移动1px，并且使激活的`tab`的`border-bottom`颜色为白色，以此达成效果。

       再者，`tab-position`共有四个位置调节选项：`top`、`right`、`bottom`和`left`。通过分析源码可以发现，`top`是常规布局，而`left`与`right`是基于`BFC`的两侧布局，`bottom`则通过改变插槽子节点的位置来实现常规布局。具体实现细节在于`el-tabs__content`的代码中，针对`is-left`和`is-right`的SCSS代码，以及`is-top`和`is-bottom`的区别仅在于`tabs.vue`里的放置位置。这意味着`left`和`bottom`的布局是基于`BFC`的两侧等高布局，而`top`和`bottom`则只是常规流体布局，只是位置不同。

       对于`stretch`功能的实现细节，通过分析源码可以得出当`stretch`设置为`false`时，`tab`的显示形式为`inline-block`；当设置为`true`时，父级变为`flex`布局，而子`tab`具有`flex:1`的属性。这表明`stretch`功能通过调整显示模式和布局方式，实现了`tab`的弹性扩展。

       在业务逻辑方面，`tabs`组件的逻辑主要体现在计算`tabs`插槽里的`tab-pane`组件，并将其解析为对应的组件数组`panes`。渲染分为两部分：一方面，通过`tabs`组件将`panes`传给`tab-nav`渲染`tab-header`，另一方面，直接渲染`$slots.default`对应的`tab-pane`组件。`tabs`组件的选中状态由`currentName`控制。`tab-header`通过`inject`获取`tabs`实例的`setCurrentName`方法，从而操作选中的`tab`；而`tab-pane`则是通过`$parents.currentName`实时控制当前`pane`是否展示。

       对于动态新增`tab`的细节，`tabs.vue`在`mounted`时会调用`calcPaneInstances`函数来获取对应的`panes`。`calcPaneInstances`的主要作用是通过`slots.default`获取对应的组件实例。`panes`在两个关键位置被使用：在`tab-nav`组件中构造`tab-header`，以及在不考虑切换影响的内容渲染中。当动态增加`tab-pane`时，虽然`panes`不会响应变化，但通过在`tabs.vue`的虚拟DOM补丁更新后执行`updated`钩子，可以自动更新`panes`。minecraft源码剖析

       此外，`tabs`插槽可以插入不受切换影响的内容，这一特性在`tabs.vue`中的渲染函数中体现。这里，全插槽内容都会被渲染，而`tab-pane`会根据`currentName`来决定是否展示。由此产生的效果是，插槽内容与`tab-pane`的选择逻辑完全分离，使得插槽内容不受切换状态影响。

       当点击单个`tab`时，`tabs.vue`组件内部会通过`props`传递`handleTabClick`函数到`tabNav`组件。`nav`组件将该函数绑定到`click`事件上。当`click`事件触发时，如果不考虑`tab`是否为`disabled`状态，会触发`setCurrentName`函数。这个函数通过`beforeLeave`起到作用，以确保在切换到下一个`tab`之前进行适当的过渡。在`setCurrentName`中使用了两次`$nextTick`，其目的是确保在更新视图时子组件的`$nextTick`操作不会影响父组件的更新流程。

       最后，源码中展示了`props`值`activeName`的使用，其功能与`value`类似，用于绑定选中的`tab`。源码中还提到了组件名称的获取方式，`props`值`vnode.tag`实际指向的是注册组件时返回的`vue-component+[name]`，而通过`vnode.componentOptions.Ctor.options.tag`可以获取正常组件名。如果在`options`中未声明`name`，那么组件名将基于注册组件时的名称。

       通过这次深入阅读，我们不仅掌握了`element-tabs`组件的核心工作原理和实现细节，还学会了如何更有效地阅读和理解复杂的前端组件源码。在阅读过程中，耐心地记录问题、适时放松心情，都能帮助我们更好地理解代码，从而提升技术能力。

element ui upload 源码解析-逐行逐析

       Element UI上传组件（upload）源码解析涉及多个核心环节，从封装的Ajax到组件内部的逻辑处理，每一部分都紧密相连，共同实现文件的上传功能。本文将深入解析这些环节，以提供一个全面且直观的理解。

       首先，我们关注的是Ajax封装的基础，这包括对XMLHttpRequest的掌握与基本使用步骤的理解。XMLHttpRequest为实现异步通信提供了基础，Element UI通过此方式实现在上传过程中与服务器的交互。在封装的Ajax代码中，我们着重探讨其基本逻辑与执行流程，以确保上传操作在不阻塞用户界面的前提下进行。

       接下来，我们将焦点转移到`upload`组件本身。这一组件封装了文件上传的整个过程，包括文件选择、预览、围棋html源码以及最终的上传操作。组件代码解析从`upload.vue`开始，通过`render`函数的解析，我们能够理解组件如何将HTML结构呈现出来，同时结合`div`和`input`属性的细节，深入理解组件的内部逻辑。

       `render`函数的解析尤为关键，它涉及到组件如何响应用户操作，以及如何将上传文件的状态和行为展示给用户。组件的`props`参数定义了如何接收外部数据，并通过`data`参数设置组件的内部状态。`methods`部分则包含了关键的业务逻辑，如文件选择改变时的`handleChange`方法，以及实际开始上传的`uploadFiles`和`upload`方法。

       在`uploadFiles`和`upload`方法的代码细节中，我们关注的是如何处理文件上传的请求，包括组装请求参数、调用HTTP请求以及返回Promise以确保异步操作的正确处理。组件设计时采用大量回调函数，通过定义并执行这些回调，将成功或失败的信息传递给父组件，实现了上传过程的可见性和控制。

       点击事件的处理在组件中扮演着核心角色，它直接影响到用户与上传组件的交互体验。通过分析`render`函数中的具体代码细节，我们可以深入理解组件如何响应用户的点击，以及如何与文件选择和上传过程集成。

       `upload-list`组件用于展示文件列表，其逻辑包括文件列表的展示以及文件的预览功能。通过定义`upload-list`参数，组件能够高效地管理文件集合，为用户提供直观的文件管理界面。

       对于`tabindex`属性的讨论，我们深入解析了其在组件中的应用，包括如何影响键盘导航、以及如何通过设置`tabindex`值来控制元素的优先级。通过理解`tabindex`的全局属性和其对DOM元素行为的影响，我们能更好地构建可访问性强的组件。

       在`upload-dragger`组件中，我们关注的焦点在于如何实现文件拖拽上传功能。通过技术点解析，我们深入理解了如何利用事件监听和DOM操作来实现这一交互特性，为用户提供更便捷的文件上传方式。

       `parseInt`在某些情况下可能用作数据转换或计算，但其在`upload`组件中的具体应用可能需要根据上下文进行具体分析。组件设计时的细节处理，如`uploadDisabled`、`listType`和`fileList`等参数的使用，以及`watch`和`computed`属性的配置，都对组件的动态行为和状态管理至关重要。

       在`methods`部分，我们关注`handleStart`、`handleProgress`和`getFile`等方法的逻辑分析，理解其在文件上传过程中的作用，以及如何处理文件开始上传、上传进度以及获取文件信息等关键事件。

       `abort`方法的使用是为了在用户取消上传操作时提供控制，通过调用子组件的`abort`方法并传入文件对象，实现对指定文件上传的终止。这一功能增强了用户体验，提供了对上传操作的灵活控制。

       在解析组件的`beforeDestroy`生命周期钩子时，我们关注组件销毁前的清理工作，确保资源被正确释放，避免内存泄漏。通过理解`render`函数中的`h`函数的使用，我们可以深入探索组件如何构建和更新其HTML结构。

       本文旨在提供Element UI上传组件源码解析的全面视图，通过详细的代码解析和逻辑分析，帮助开发者深入理解组件的核心实现和设计原则。解析过程中关注的每一个技术点，都是构建高效、用户友好的上传功能不可或缺的部分。最后，我们对Element UI团队的努力表示感谢，他们的贡献为前端开发者提供了强大的工具和资源，促进了技术社区的发展和创新。

elementui源码学习之仿写一个el-timeline

       本文记录了仿写el-timeline组件的细节，以深入理解饿了么UI组件的实现机制。本系列文章将持续更新，深入探讨elementui源码的学习与实践。可访问开源仓库，通过npm start运行代码，结合注释辅助理解。

       时间线组件构成包括：时间线小圆点、时间线竖线条、时间戳与具体内容详情四个部分。如图所示。

       时间线组件主要需求包括：按时间线正序或倒序展示、自定义时间线小圆点样式与颜色、使用小图标替代时间线小圆点、控制时间戳与具体内容详情的位置、时间戳的显示与隐藏。

       对官方组件的见解包括：提供与注入可以简化、时间戳位置优化、简约封装参考其他库组件。Antd与iview的时间线组件参数较为精简。

       回顾知识点：数组方法的使用，如this.$slots.default.reverse()；以及`:style`中的四元表达式应用，如`:style="border: ${ elementIcon} ${ borderColor}"`。

       组件代码示例如下：`myTimeline`、`myTimelineItem`。完整代码在开源仓库，欢迎访问并star。

       若本文对您有所助益，期待您的star，感谢支持！

element-plus源码与二次开发：package.json解析

       element-plus使用pnpm的workspace来搭建monorepo工程，允许在单一码仓库中集中管理大量互相依赖的包，同时确保发布时的独立性。pnpm-workspace.yaml文件在根目录声明内部可引用的包，执行pnpm i后，会在node_modules中创建软连接，无需手动link。

       element-plus组件库将vue声明在peerDependencies中，避免在主项目安装组件库时额外安装vue。通过czg包定义规范，执行提交commit命令，确保遵循git规范。使用play子包进行简单的开发调试，引入本地组件库。通过gen命令快速创建新组件，使用模板生成组件基础模板。生成版本号文件命令用于在构建时提供rollup的banner参数，部署前更新版本号命令从环境变量获取TAG_VERSION和GIT_HEAD，写入到三个包的package.json中的version和gitHead字段。

       清理dist目录命令使用pnpm run -r --parallel，以并行方式执行所有子包的命令，删除根目录下的dist目录，并执行所有子包的clean命令。构建文档和组件库的关键步骤包括使用rollup执行构建，通过@esbuild-kit/cjs-loader将esm和ts实时转换为CommonJS。生成类型声明文件和代码提示文件，复制源样式文件、编译为css、压缩，并输出到特定目录。启动组件库文档docs项目基于vitepress，构建组件文档，本地测试构建出的生产环境docs，生成多语言文件和CROWDIN_TOKEN。

       执行各包的stub命令，使用unbuild打包工具，基于rollup，支持typescript，支持生成commonjs和esmodule和类型声明，无需额外配置。prepare Husky钩子脚本确保自动执行预定义命令，执行pnpm i后，自动执行pnpm stub，编译internal下的三个包入口。

       通过上述详细解析，我们可以清晰了解到element-plus源码与二次开发中的核心功能与流程，从构建结构到构建流程，再到二次开发工具的运用，展示了其高效、灵活的特点。

elementui源码学习之仿写一个el-message

       深入学习elementui源码，理解并仿写一个el-message组件，不仅能够提升编程能力，还能在以后的项目中实现更高效、个性化的组件封装。首先，明确组件的应用场景和需求。

       消息提示组件主要应用于用户执行操作后的交互反馈，例如成功、失败、警告或信息的显示。为了简化封装过程，保留核心功能，我们无需复制官方组件的复杂配置项。

       深入组件效果理解，通过复习不常用的API，学习代码逻辑，并结合注释快速掌握实现原理。重点复习：<code:class的数组用法、:style用法，以便实现不同状态下的样式切换。

       处理用户多次触发消息显示的问题，动态调整消息的布局，使用变量控制消息的位置。学习过渡钩子函数在状态改变时触发的原理，以实现平滑的显示和消失效果。官方文档提供了详细的过渡钩子函数使用说明。

       探讨Vue组件销毁的方式，选择使用v-show结合过渡效果，而非直接使用v-if，以保持界面的平滑过渡。编写代码时，需手动处理组件销毁逻辑，确保过渡消失后安全地移除DOM元素。

       关于Vue组件的继承和扩展，学习Vue.extend等机制，以便更灵活地创建和使用自定义组件。查阅相关文档和代码实例，了解如何在项目中高效利用组件。

       整合以上知识，完成el-message组件的仿写。通过仔细设计和编码，实现功能完整、界面美观的消息提示功能。最后，提供组件的源代码仓库地址，鼓励社区成员一起学习、讨论和改进。

       GitHub仓库地址：github.com/shuirongshui...

React源码 | 1. 基础：ReactElement

       本文将深入探讨ReactElement的基础，重点关注JSX作为React的官方语法，以及其如何通过Babel转换为JavaScript。

       JSX，全称为JavaScript XML，允许开发者在JavaScript中嵌入HTML代码，简化组件的创建与渲染。然而，浏览器无法直接解析JSX，因此需要一个转换器，Babel扮演这一角色，它将JSX代码编译成JavaScript文件，让浏览器能够解析。

       Babel的转换规则相对简单。对于直接的JavaScript写法，无需转换，但为了兼容性，可能会将某些高版本的语法翻译成低版本。关注的重点在于HTML的处理方式。以这行代码为例：

       通过Babel转换后，HTML语法转变成JavaScript语法，即最终将JSX转换为JavaScript。

       接着，我们用复杂一点的例子来演示转换规则。React.createElement函数的使用表明，第一个参数表示节点类型，第二个参数是一个对象，包含属性如key：value，后面则是子节点。通过这个规则，我们了解到JSX语法不仅支持原生HTML节点，还包含大量自定义组件。

       比如，自定义组件定义如下：

       在此，React.createElement的第一个参数转变为变量形式，而非字符串。尝试将函数Comp首字母小写：

       然而，React.createElement的第一个参数又变回字符串。这就解释了在React中自定义组件的首字母应大写的原因：Babel编译时将首字母小写的组件视作原生HTML节点，若将自定义组件首字母小写，后续程序将无法识别，最终报错。

       Babel编译后的JavaScript代码中，React.createElement函数的调用频繁出现，其返回值为ReactElement。通过示例，我们可以看到ReactElement的结构，即一个简单的对象，包含三个或三类参数。编译后，JSX中的HTML节点转换为嵌套的ReactElement对象，这些对象对构建应用的树结构至关重要，且帮助React实现平台无关性。

elementui源码学习之仿写一个el-tabs

       本篇文章记录了仿写一个el-tabs组件的过程，旨在帮助读者更深入地理解饿了么UI组件的工作原理。此系列文章旨在对elementUI源码进行学习与实践，后续会持续更新，仿写其他组件。

       为了便于阅读后续代码，本文将复习一些基础知识。在Vue中，组件的页面结构、逻辑与样式通常分离，例如：

       通过Vue的render函数，我们可以使用jsx语法书写组件，这与React语法相似。例如，要创建一个红色的H3标签并设置背景色为黄绿色，代码如下：

       实现效果如下：

       在此代码中，我们需要记住，jsx语法使用单大括号表示变量的使用。

       另外，若在render函数中需要给子组件传参，可以通过单大括号及三点符号实现，因为单大括号用于表示变量。以官方el-tabs组件为例，说明如何使用jsx语法：

       此组件通常使用jsx语法编写，以适应更灵活的需求。

       在Vue中，可以通过`this.$slots.default`获取组件标签内容中的非命名插槽部分。这个API帮助我们访问默认插槽内容。以下是一个简单的使用示例：

       当打印组件实例时，可以看到存储的内容：

       将此数组应用到el-tabs组件中，可以获取每个`el-tab-pane`组件的`label`、`name`以及其他信息，传递给`tab-nav`组件，从而显示选项卡信息。

       在父子组件间传递参数时，通常使用`v-model`绑定。对于非表单控件的普通自定义组件，需要额外编写代码以实现双向数据绑定。例如：

       此示例展示了如何使用`v-model`进行数据传递。在子组件中，`props`接收`value`参数，通过`this.$emit("input", xxx)`触发更新。

       开始仿写时，首先需要搭建`tabs`结构。一个`tabs`组件通常包含选项卡部分、内容区部分和整个选项卡盒子。这里创建三个文件来实现此功能。

       此过程涉及以下步骤：

       1. 新建`tabs.vue`组件，作为数据中转站。

       2. 创建`tabNav.vue`组件，接收`tabs.vue`的数据并使用`v-for`进行动态渲染。

       3. 编写`myTabContent.vue`组件，配合`v-show`实现仅渲染一个内容。

       实现`tabs`切换效果的方法有多种，如使用动态组件或自行封装一个`tabs`组件。本文旨在仿照官方组件实现常用功能。

       在实际开发中，组件的封装应根据项目需求灵活调整。过度封装或不封装都不理想，组件的复用性对于提高开发效率至关重要。

       若本文有助于您理解el-tabs的工作流程和数据传递方式，我们深感荣幸。欢迎访问我们的GitHub仓库并给予支持，您的每一点贡献都是我们持续创作的动力。