升级指南
此处着重列出升级中的不兼容变化和推荐改动。所有变动请见 Changelog。0.9.x => 1.0
从 1.0 开始,antd-mobile
严格遵循 Semantic Versioning 2.0.0 语义化版本规范。
重要变动如下:
组件的 icon 从 iconfont 转为使用 svg 图片
Icon 组件的使用方式没有变化、比如:<Icon type="check" />
,但是由于不再是 font、所以 css font-size 设置不再生效,相对于其他元素的位置偏移设置也与原来的略有不同,工具上的设置要求比之前更加复杂;详细参考 Icon 文档。
Web Slider 拆分成 Slider, Range, createTooltip, 使用方式参见 Slider文档, Range文档
其他常用组件更新注意事项
主要介绍组件核心实现的变更。如无特别说明、组件 API 均向前兼容(新增的 API 请查看对应组件文档)
Button 组件的内部 html 元素由
button
标签更换为a
标签,相应htmlType
API 失效。Form 相关的输入类组件、更明确区分受控与否的状态。
NoticeBar 组件支持常见的横向走马灯功能。
DatePicker
,Pagination
不再接受okText
,dismissText
属性,而是默认内置中文文案,可以利用 LocalProvider 切换为英文文案。DatePicker
的locale
属性结构变化,原来的DatePickerLocale: object
现为{DatePickerLocale, okText, dismissText}