如何进行迁移antd@4
如何进行迁移antd@4,很多新手对此不是很清楚,为了帮助大家解决这个难题,下面小编将为大家详细讲解,有这方面需求的人可以来学习下,希望你能有所收获。
创新互联坚持“要么做到,要么别承诺”的工作理念,服务领域包括:做网站、成都做网站、企业官网、英文网站、手机端网站、网站推广等服务,满足客户于互联网时代的蔡甸网站设计、移动媒体设计的需求,帮助企业找到有效的互联网解决方案。努力成为您成熟可靠的网络建设合作伙伴!
antd@4 rc 发布已经有一段时间了(大概已经两周了),官网[1] 也已同步放出。最为一个酷爱尝鲜的人,当然要第一时间安装升级。第一时间享受到了的 antd@4 各种优势。
升级点
首先对我而言最大的改进在于性能,select ,table 和 tree 已经全面支持了虚拟滚动,作为了早早的使用了 rc-tree来解决性能问题的人,antd@4 中提供自然是更好不过了,毕竟自己写样式和动态是非常复杂的。
重写的 table 和 from 解决很多遗留的疑难杂症,具体可以查看豆酱老师的 antd@4 系列文章[2],里面详细写了心路历程,在 form 中我们不需要使用 getFieldDecorator
和 Form.create
这两个方法。已 Pro 全区块为例,这两个方法分别出现了 87 和 22次,在我自己的一个维护项目中找到了142 个 getFieldDecorator
,更不用说为了封装组件 getFieldDecorator
被当成 props 传来传去的造成的各种复杂性提升了。在 v4 中我们终于可以摆脱它了。
瞧这都是删除的 diff
Table 现在也可以自动的获得宽度,并且拥有更加优秀的固定到侧边,已 Pro-Table[3] 为例,这里是 3.0 的 table。
在 4.0 中,不会发生高度错位的问题。
迁移方法
antd@4 变得更加多才多艺,带来了巨量的提升,那我们怎么才能使用到这么棒的 4.0 呢 , 其实很简单,Pro 已经全部迁移了一把[4] 。官方贴心的为我们提供了 codemod-v4,使用起来也是非常简单。
# 通过 npx 直接运行
npx -p @ant-design/codemod-v4 antd4-codemod src
# 或者全局安装
# 使用 npm
npm i -g @ant-design/codemod-v4
# 或者使用 yarn
yarn global add @ant-design/codemod-v4
# 运行
antd4-codemod src
值得注意的是 如果项目中使用了
会转化成 LegacyIcon
,这里需要检查一下,如果你不是组件库你一定是不需要 LegacyIcon
,迁移之后一定要删除它,不然会造成图标文件被全量打入,它可是有 540K 左右的大小。
为了更加的语义化,icon 将从 i 标签修改为 span 标签,改完之后需要记得去查看一下有没有类似 i{}
,i.anticon
等用法,如果有可以修改为 span{}
, span.antion
来保证迁移完成的样式问题。
另外由于 form 不兼容,codemod 不会自动帮你迁移到新的写法, 但是迁移到兼容包 @ant-design/compatible
方便在和新版本一起使用,而不用完全迁移。兼容包中 ant-from
类名将会更新为 ant-legacy-form
,如果你修改了 form 的默认样式记得检查一下,并且修改它。
如果碰到表单无法撑开的问题可以加入下面的代码:
:global {
.ant-legacy-form-item .ant-legacy-form-item-control-wrapper {
width: 100%;
}
}
Pro中使用
Pro 在第一时间也迁移了 antd@4 ,我们只需要在 create umi 中选择 ant-design-pro,即可获得最新的 4.0 分支代码。
❯❯❯ create-umi
? Select the boilerplate type ant-design-pro
? ???? Which language do you want to use? TypeScript
? ???? Want to use better and faster antd? Yes
>
> 使用 antd 4.0 可能会有一些兼容性问题,阅读下面的文档了解具体的改动
> There may be some compatibility issues when using antd 4.0. Read the following documents for specific changes
> https://next.ant.design/docs/react/migration-v4-cn
>
如果你想获得迁移到新的版本,可以按照上面的文档描述实现,但是 Pro 中支持通过设置 icon 配置菜单图标,在 4.0 中将无法得到支持,所以我们提供了相应的插件[5]来保留此功能。
使用方式如下 :
yarn add umi-plugin-antd-icon-config -D
并且在 config.ts 中设置
export default {
plugins:[['umi-plugin-antd-icon-config', {}]],
}
无痛迁移 antd@4 就是这么简单。所有的官方区块也已经支持了 antd@4,请大家安心使用。如果想使用 antd 的 新特性,不打包全部的 icon, 可以尝试升级 ProLayout@5.0。
由于 4.0 的 icon 有一些删改,如果发现图标消失,请在 antd 官网中寻找合适的进行替换。
看完上述内容是否对您有帮助呢?如果还想对相关知识有进一步的了解或阅读更多相关文章,请关注创新互联行业资讯频道,感谢您对创新互联的支持。
当前文章:如何进行迁移antd@4
文章起源:http://scyanting.com/article/jhpppd.html