代码演示
如何引入
基本用法
通过传入 timeZone 参数,用户可以为时间类组件配置时区:
RTL/LTR
全局配置
direction
可以改变组件的文本方向(1.8.0)。rtl
表示从右到左 (类似希伯来语或阿拉伯语), ltr
表示从左到右 (类似中文、英语等大部分语言)。特殊组件:
- Modal,Notification,Toast 的命令式调用需要通过 prop 传
direction
。 - 如果你想对有方向性的 Icon 做 RTL 国际化,需要自己单独进行处理。我们认为对 Icon 进行 RTL 会让它变得难以理解和维护。其他组件内的 icon Semi 已经做了 RTL 适配。
- Table 的固定列或表头,树形数据,虚拟化表格暂不支持 RTL,Slider 暂不支持 RTL
API 参考
属性 | 说明 | 类型 | 默认值 |
---|---|---|---|
direction | 设置文本的方向 | ltr | rtl | ltr |
getPopupContainer | 指定父级 DOM,弹层将会渲染至该 DOM 中,自定义需要设置 position: relative | function():HTMLElement | () => document.body |
locale | 多语言配置,同LocaleProvider 中locale 参数的用法 | object | |
timeZone | 时区标识 | string|number |
时区标识
- 数字,例如
1
、-9.5
,代表距离 UTC 的时间偏移,单位为小时,可以为负数或小数; - 字符串,例如
GMT-09:30
、GMT+08:00
这样的以"GMT"
开头的表征偏移字符串,也可以为 IANA 标识,如Asia/Shanghai
、America/Los_Angeles
等。
当你使用数字或
GMT-09:00
类似写法时,Semi 内部会将这些时区标识转换为 IANA 标识。- 如设置
-9
或GMT-09:00
时,会转换成Pacific/Gambier
。某些数字对应的 IANA 标识可能有多个,Semi 首选无夏令时的 IANA 标识; - 如果该数字没有对应的无夏令时 IANA 标识,如
-3.5
、3.5
、10.5
、13.75
,这时我们映射的就是一个有夏令时的 IANA 标识,有夏令时的时区会在偏移量上进行调整,如-3.5
会在进入夏令时后在标准时间上增加 1h。
如果你想准确设置一个地区的时区,推荐使用 IANA 标识而不是前面的用法。这里可以查看 IANA 标识列表,以及时区是否有夏令时。
FAQ
- ConfigProvider中没有提供全局自定义prefix classname的功能,有类似需求如何实现(例如SDK中使用了Semi,期望打包的dom样式不带.semi-xx前缀,以免被宿主的全局 CSS 影响)?
- 由于 prefixCls 需要同时被组件层的 js/css 消费,Semi 将此开关放在了webpack plugin的配置项中,而不是作为ConfigProvider的配置项。
- 如果你使用webpack,请在
SemiWebpackPlugin
的参数中进行配置