Polaris Web Components 1.1 现已在稳定的 Polaris CDN 频道上提供,这是该 CDN 采用新的语义化版本控制模型后的首个次要版本更新。
以下 URL 现在提供 Polaris 1.1
使用polaris.js或polaris-1.js的应用会自动接收此更新,无需任何操作。
如果您需要继续使用此版本,可以将您的应用固定到 Polaris 1.1:
<script src="https://cdn.shopify.com/shopifycloud/polaris-1.1.js"></script>Polaris 1.1 的新增功能
新增组件
- EmptyState用于空列表、表格和页面;在TableBody内部时,它会在表格标题下方渲染为一条全宽消息。
- Number. 使用等宽数字的内联数值文本,使数字列对齐。
- Progress. 显示可衡量任务或目标的进展程度。
新增属性
- fontSize应用于Heading、Paragraph以及Text:直接设置文本大小。
- visibleMonths应用于DatePicker:显示一个月、两个月,或由选择器自行决定;接受auto、1或2。
- supplementalStart应用于Page:在主页面内容之前放置的内容。
错误修复
- 覆盖层(Overlays)。show、hide、aftershow、afterhide和aftertoggle事件不再冒泡,这与toggle的行为一致;请在覆盖层本身上监听,或使用匹配的on*属性。此外,还修复了拖拽结束于覆盖层外部时覆盖层意外关闭的问题。
- Page. 修复了页眉对齐和间距、长标题截断、打印布局以及窄屏幕上的水平溢出问题。
- Modal:修复了点击或拖拽跨越模态框边缘时的意外关闭、焦点返回、标题溢出以及模态框在页面中移动后的行为问题。按钮现在从其所在的插槽获取variant,且您自行设置的任何variant仍具有最高优先级。
- Popover与Menu:修复了溢出滚动、定位、打开后调整大小、Safari 中的延迟隐藏以及按 Escape 键关闭嵌套模态框的问题。
- Tooltip. 修复了定位问题、首次渲染居中偏差、继承的文本颜色以及在部分支持 Popover API 的浏览器中的错误。
- DatePicker:修复了跨本地化的星期标题和屏幕阅读器播报问题。将相同的value重新设置回选择器(React 组件在选择后会执行此操作)不再触发第二个input和change事件,因此onChange仅运行一次而非两次。默认情况下,选择器会扩展以填充可用宽度。
- Select. 修复了在选项解析之前显示空值的问题。
- NumberField:修复了默认的max。现在支持科学计数法。
- TextArea. 修复了标签对齐和键盘快捷键问题。
- DateField. 修复了 Safari 中日历关闭的问题。现在其尺寸与其他所有字段一致。
- ColorPicker. 修复了单击选择问题。
- 所有字段。带有autocomplete="off"的字段现在也会告知密码管理器跳过它们。
已弃用
- fontVariantNumeric应用于Text和Paragraph仍然有效,但我们建议使用新的Number组件替代。
相关文档
- App Home 文档
- Polaris CDN 正在采用语义化版本控制

