1.element-tabs组件 源码阅读
2.Android Jetpack组件之Lifecycle-Aware组件使用及源码解析
3.Vue源码-模板编译和组件化
4.Designable 应用和源码浅析
5.element-ui 组件库 button 源码分析
6.读读antd源码之通用组件
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`的宽度是由`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`。
此外,`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`组件的核心工作原理和实现细节,还学会了如何更有效地阅读和理解复杂的前端组件源码。在阅读过程中,耐心地记录问题、适时放松心情,都能帮助我们更好地理解代码,从而提升技术能力。
Android Jetpack组件之Lifecycle-Aware组件使用及源码解析
Android Jetpack 的 Lifecycle-Aware 组件有助于提升代码的组织性和可维护性。传统的开发方式是在 Activity 或 Fragment 的生命周期方法中处理业务逻辑,这可能导致代码冗余和 bug 的增加。使用 Lifecycle 组件可以将依赖移出,将业务逻辑内置于组件本身。
Lifecycle 是一个抽象类,其子类 LifecycleRegistry 代表组件的生命周期状态。Activity 和 Fragment 通过 LifecycleOwner 接口间接实现,xss平台搭建源码通过 getLifecycle() 方法获取 Lifecycle 对象。生命周期状态图包括事件(Event)和状态(Status)两个主要部分。
对于 Java1.7 环境,可以通过注解监听生命周期变化;Java1.8 则推荐使用 DefaultLifecycleObserver 接口。在模块的 build.gradle 中添加依赖,创建监听器并注册到 Activity 或 Fragment 中,如 LifeCycleListener 的示例所示。
在源码层面,ComponentActivity 实现 LifecycleOwner 接口,它通过一个无界面的 ReportFragment 感知 Activity 的生命周期。ReportFragment 在 Activity 初始化时处理生命周期事件,这部分通过匿名内部类 ActivityInitializationListener 和 ProcessLifecycleOwner 中的回调实现。
之前的生命周期监听通常是通过 Application 的 ActivityLifecycleCallbacks 进行的,但现在更灵活,监听对象细化到了单个 Activity。ProcessLifecycleOwner 的初始化涉及到 ContentProvider 和 LifecycleDispatcher,它们分别负责添加 ReportFragment 和分发 Activity 生命周期状态。
总结来说,使用 Lifecycle-Aware 组件可以简化生命周期管理,提高代码质量,而 ProcessLifecycleOwner 的初始化过程则与 Activity 的生命周期感知密切相关。使用合适的工具,如 AndroidXRef,可以更好地理解和分析 Android 源代码。
Vue源码-模板编译和组件化
这一篇我们将深入探讨Vue的模板编译和组件化相关内容,内容分为三个主要部分:前置知识、模板编译过程、组件实例的创建和挂载机制。
首先,让我们从模板编译的相关知识储备开始。
模板编译的核心目标是把模板(template)转换成渲染函数(render)。
根据执行时间的不同,模板编译过程分为运行时编译和构建时编译。
Vue 2.6中,模板编译成render函数的工具是Vue Template Explorer。而在Vue 3.0 beta中,这个工具是vue-next-template-explorer.netlify.app。此外,我们还可以使用AST explorer来查看各种解析器生成的AST。
编译的结果需要通过测试数据来验证。
接下来,我们来探讨抽象语法树(AST)的概念及其应用。
Vue组件化部分主要研究以下三个方面:组件注册、组件创建、组件patch。
在Vue中,组件注册是通过Vue.component完成的。Vue.extend()函数用于创建组件构造函数。
组件的创建是在_createElement中处理的,主要使用createComponent函数完成。
组件的patch过程涉及到Vue._update()、patch()、createElm()和createComponent等函数。
Designable 应用和源码浅析
本文基于 Designable 1.0.0-beta. 进行演示和分析,旨在提供对设计组件和源码的浅析。Designable 提供了丰富的功能和组件,以满足复杂应用需求。以下将对其中的几个关键特性进行详细介绍。
首先,网站源码免费看使用说明页面示例展示了集成代码组件的灵活性和便利性。在设计页面中,可以直观地嵌套和组合基础组件,实现高效且直观的界面构建。
复杂组件如 FormCollapse 的实现是 Designable 的亮点之一。FormCollapse 支持添加 CollapsePanel,并允许用户通过拖拽功能将子组件添加到指定区域。这种动态布局和交互方式极大地提高了组件的适应性和灵活性。
对于 JSON Schema 和 TreeNode 的互转,Designable 提供了高效的转换机制。这一功能使得数据结构的管理与操作更为便捷,适用于各种需要动态数据交换的应用场景。
深入探讨 Designable 的项目结构时,发现其基于 Lerna 的 monorepo 架构,包含多个独立但紧密关联的项目。主要包包括核心逻辑、React 组件、示例应用和设置表单等。这种结构确保了代码的可维护性和可扩展性。
核心逻辑中,Designable 大量运用了 reactive 库,以实现组件间的响应式交互。在 models 中定义的类通过 define 命令实现响应式数据管理,确保数据变动时视图自动更新。React 组件通过 @formily/reactive-react observer 方法,将组件转变为响应式实体,确保每次视图渲染时,自动收集依赖并在依赖更新时重新渲染。
SettingForm 作为设置表单的核心,通过订阅发布类 Subscribable 来管理事件处理。它记录事件处理函数,当发布事件时,会循环调用所有事件处理函数,传入事件对象供处理函数决策是否匹配,实现事件的高效响应与处理。
Engine 类和相关图如 DragDropDriver 和 effect 初始化流程图展示了 Designable 在组件动态管理和交互优化上的设计思路。通过 driver 初始化流程,实现组件的拖拽功能,以及 effect 的初始化,确保应用的流畅性和交互性。
在 Designable 中,修改组件属性的机制允许用户在运行时直接调整组件的配置,无需重新加载页面或进行复杂的编码操作,提高了开发效率和应用的动态适应性。
element-ui 组件库 button 源码分析
团队将基于新的 UI 规范构建组件库,并需实现具备多种主题换肤能力的 button 组件。该组件需支持字体颜色、背景颜色、边框和禁用状态的调整,同时加入一种幽灵按钮类型。分析后,决定不在 element-ui 组件库上进行改造,以确保更好的维护性。因此,将参考 element-plus 的 css 自定义变量实现这一目标。
深入分析 element-ui 组件库中的 button 组件,我们关注到以下几个关键点:
首先,button 组件提供了丰富的属性,如尺寸(size)、波段trix公式源码类型(type)、朴素样式(plain)、圆角(round)、圆形(circle)、加载状态(loading)、禁用(disabled)、图标(icon)以及是否聚焦(autofocus)等,这些属性使按钮组件具有高度的定制性。
接下来,通过查看相关的文件路径,我们发现组件的逻辑主要集中在 button.vue 文件中。该文件定义了组件的属性和行为,而其样式逻辑则分散在多个文件中,包括 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 组件源码,我们深入理解了其设计的巧妙之处。这一过程不仅帮助我们学习了组件库设计的最佳实践,也为我们构建具备高度定制性和维护性的组件库提供了宝贵的启示。
读读antd源码之通用组件
ui组件库在ui开发框架中扮演着类似模具的角色,极大地提升了生产效率。无论是设计风格、基础功能还是操作交互,ui组件库都进行了高度统一,为项目开发提供了开箱即用的便捷。在React领域,中后台项目常用到的ui组件库,非Ant Design(antd)莫属。
本文将分享antd组件库的源码,探讨我们习以为常的功能背后的逻辑处理。在阅读过程中,将遵循《阅读前端源码的思路》,文章将直接分享重点,忽略具体细节。
一个没有设计理念的ui组件库,都不好意思称作ui组件库。官方文档中,第一个栏目就是“设计”,可见设计是ui组件库的灵魂,它包含了自身的价值观和模式,并遵循一系列规范。本文将先分享阅读的第1个,通用组件的源码。
通用组件包含三个:Button、Icon、Typography。关于这些组件,我们可以从官方文档中看到一些值得思考的功能。例如,Button的点击动作反馈,Icon的内部图标封装,Typography的文本处理或功能封装等。
antd的组件源码相对混乱,但我们可以从中找到一些有趣的点。例如,Button组件中关于按钮文字是两个汉字时插入空格的逻辑,以及内容劫持的过程。Wave组件的实现主要涉及到transition和animation,其中onClick方法的关键在于updateCSS方法,它动态添加样式,并添加transition和animation。
Icon组件则被搬到了@ant-design/icons库中实现,主要是一些样式、事件和图标引用的处理。Typography组件则提供了一系列文本样式的内容,其中文本拷贝使用了copy-to-clipboard库,文本溢出处理则通过Ellipsis组件实现。
本文对antd源码之通用组件的探讨就到这里,希望能帮助你更好地理解这些组件的内部逻辑。
源码游戏和组件游戏的区别
源码,是指可以直接更改游戏布局、功能的游戏源代码。它是由程序员用他们的工作语言编写的,而这个工作语言就是“源码”。
组件:是源码经过编译后的程序,也就是说可以封装重用。
没写过复杂 React 组件?来实现下 AntD 的 Space 组件吧
React 开发者在日常工作中经常编写组件,但这些大多为业务组件,复杂度并不高。
组件通常通过传入 props 并使用 hooks 组织逻辑来渲染视图,偶尔会用到 context 跨层传递数据。
相对复杂的组件是怎样的呢?antd 组件库中就有许多。
今天,我们将实现antd组件库中的一个组件——Space组件。
首先,我们来了解一下Space组件的使用方法:
Space是一个布局组件,用于设置组件的间距,还可以设置多个组件的对齐方式。
例如,我们可以使用Space组件来包裹三个盒子,设置方向为水平,渲染结果如下:
当然,我们也可以设置为垂直:
水平和垂直的间距可以通过size属性设置,如large、middle、small或任意数值。
多个子节点可以设置对齐方式,如start、end、center或baseline。
此外,当子节点过多时,可以设置换行。
Space组件还可以单独设置行列的间距。
最后,它还可以设置split分割线部分。
此外,你也可以不直接设置size,而是通过ConfigProvider修改context中的默认值。
Space组件会读取context中的size值,这样如果有多个Space组件,就不需要每个都设置,只需要添加一个ConfigProvider即可。
这就是Space组件的全部用法,简单回顾一下几个参数和用法:
Space组件的使用方法很简单,但功能非常强大。
接下来,我们来探讨一下这样的布局组件是如何实现的。
首先,我们来看一下它最终的DOM结构:
每个box都包裹了一层div,并设置了ant-space-item类。
split部分包裹了一层span,并设置了ant-space-item-split类。
最外层包裹了一层div,并设置了ant-space类。
这些看起来很简单,但实现起来却有很多细节。
下面我们来写一下Space组件的实现代码:
首先,我们声明组件props的类型。
需要注意的是,style是React.CSSProperties类型,即可以设置各种CSS样式。
split是React.ReactNode类型,即可以传入jsx。
其余参数的类型根据其取值而定。
Space组件会对所有子组件包裹一层div,因此需要遍历传入的children并做出修改。
props传入的children需要转换为数组,可以使用React.Children.toArray方法。
虽然children已经是数组了,但为什么还要使用React.Children.toArray转换一下呢?
因为toArray可以对children进行扁平化处理。
更重要的是,直接调用children.sort()会报错,而toArray之后就不会了。
因此,我们会使用React.Children.forEach、React.Children.map等方法操作children,而不是直接操作。
但这里我们有一些特殊的需求,比如空节点不过滤掉,依然保留。
因此,我们使用React.Children.forEach自己实现toArray:
这部分比较容易理解,就是使用React.Children.forEach遍历jsx节点,对每个节点进行判断,如果是数组或fragment就递归处理,否则push到数组中。
保不保留空节点可以根据keepEmpty的option来控制。
这样,children就可以遍历渲染item了,这部分是这样的:
我们单独封装了一个Item组件。
然后,我们遍历childNodes并渲染这个Item组件。
最后,我们将所有的Item组件放在最外层的div中:
这样就可以分别控制整体布局和Item布局了。
具体的布局还是通过className和样式来实现的:
className通过props计算而来,使用了classnames包,这是react生态中常用的包,根据props动态生成className基本都会使用这个包。
这个前缀是动态获取的,最终就是ant-space的前缀。
这些class的样式都定义好了:
整个容器使用inline-flex,然后根据不同的参数设置align-items和flex-direction的值。
最后一个direction的css可能大家没用过,是设置文本方向的。
这样,就通过props动态给最外层div添加了相应的className,设置了对应的样式。
但还有一部分样式没有设置,也就是间距。
其实这部分可以使用gap设置,当然,也可以使用margin,但处理起来比较麻烦。
不过,antd这种组件自然要做得兼容性好一点,所以两种都支持,支持gap就使用gap,否则使用margin。
问题来了,antd是如何检测浏览器是否支持gap样式的呢?
antd创建一个div,设置样式,并添加到body下,然后查看scrollHeight的值,最后删除这个元素。
这样就可以判断是否支持gap、column等样式,因为不支持的话高度会是0。
然后antd提供了一个这样的hook:
第一次会检测并设置state的值,之后直接返回这个检测结果。
这样组件里就可以使用这个hook来判断是否支持gap,从而设置不同的样式了。
最后,这个组件还会从ConfigProvider中取值,我们之前见过:
所以,我们再处理一下这部分:
使用useContext读取context中的值,并设置为props的解构默认值,这样如果传入了props.size就使用传入的值,否则使用context中的值。
这里给Item子组件传递数据也是通过context,因为Item组件不一定会在哪一层。
使用createContext创建context对象:
把计算出的size和其他一些值通过Provider设置到spaceContext中:
这样子组件就能拿到spaceContext中的值了。
这里使用了useMemo,很多同学不会用,其实很容易理解:
props变化会触发组件重新渲染,但有时候props并不需要变化却每次都变,这样就可以通过useMemo来避免它不必要的更新。
useCallback也是同样的道理。
计算size时封装了一个getNumberSize方法,为字符串枚举值设置了一些固定的数值:
至此,这个组件我们就完成了,当然,Item组件还没展开讲。
先来欣赏一下这个Space组件的全部源码:
回顾一下要点:
思路理得差不多了,再来看一下Item的实现:
这部分比较简单,直接上全部代码了:
通过useContext从SpaceContext中取出Space组件里设置的值。
根据是否支持gap来分别使用gap或margin、padding的样式来设置间距。
每个元素都用div包裹一下,设置className。
如果不是最后一个元素并且有split部分,就渲染split部分,用span包裹。
这块还是比较清晰的。
最后,还有ConfigProvider的部分没有看:
这部分就是创建一个context,并初始化一些值:
有没有感觉antd里用context简直太多了!
确实。
为什么?
因为你不能保证组件和子组件隔着几层。
比如Form和FormItem:
比如ConfigProvider和各种组件(这里是Space):
还有刚讲过的Space和Item。
它们能用props传数据吗?
不能,因为不知道隔几层。
所以antd里基本都是用context传数据的。
你会你在antd里会见到大量的用createContext创建context,通过Provider修改context值,通过Consumer或useContext读取context值的这类逻辑。
最后,我们来测试一下自己实现的这个Space组件吧:
测试代码如下:
这部分不用解释了。就是ConfigProvider包裹了两个Space组件,这两个Space组件没有设置size值。
设置了direction、align、split、wrap等参数。
渲染结果是正确的:
就这样,我们自己实现了antd的Space组件!
完整代码在github:github.com/QuarkGluonPl...
总结:
一直写业务代码,可能很少写一些复杂的组件,而antd里就有很多复杂组件,我们挑Space组件来写了下。
这是一个布局组件,可以通过参数设置水平、垂直间距、对齐方式、分割线部分等。
实现这个组件的时候,我们用到了很多东西:
很多同学不会封装布局组件,其实就是对整体和每个item都包裹一层,分别设置不同的class,实现不同的间距等的设置。
想一下,这些东西以后写业务组件是不是也可以用上呢?
Drf序列化组件——序列化源码分析!
Drf序列化组件的核心在于将数据从Queryset或对象形式转化为JSON格式,以实现数据的高效传输和展示。主要涉及Serializer、ModelSerializer以及字段和参数的处理。
首先,Serializer是基础,用于处理单一对象的序列化,ModelSerializer在此基础上扩展,支持直接操作数据库模型。在序列化过程中,不同类型的数据库字段需要适当处理,如处理日期、自定义类型等。多对多关系的序列化可以通过两种方法:一是直接在Serializer中处理,二是利用嵌套的Serializer实现。
序列化器的嵌套和继承功能使得结构复杂的数据关系得以清晰展现。源码流程分析分为加载字段和序列化两个步骤。加载字段是根据定义的字段信息来获取数据,而序列化则根据这些字段执行相应的转换。在创建InfoSerializers类时,首先实例化对象,然后利用metaclass进行类的创建。列表排序是其中一个小知识点。根据many参数的不同,序列化行为会有所差异,many=False时处理单个对象,many=True则处理列表对象。
序列化过程由当前类和ListSerializer类触发,最终生成ser.data序列化结果。通过清晰的流程图,可以直观地理解这个过程。总的来说,Drf序列化组件的源码分析帮助我们深入了解如何将复杂数据结构转化为易于处理的JSON格式。