例外列表

使用异常列表来帮助商家注意到重要的、突出的信息,为任务添加额外的上下文。例外列表通常由标题和描述组成。列表中的每个项目在前面都有一个项目符号或图标。

使用图标来增加清晰度或帮助将意思可视化

进口{ExceptionList“@shopify /北极星”进口{NoteMinor“@shopify / polaris-icons”进口反应“反应”函数ExceptionListExample{返回<ExceptionList物品{{图标NoteMinor描述这位顾客太棒了。一定要善待他们!”/>

道具

想让这个功能变得更好吗?请分享你的反馈

接口 ExceptionListProps
项目 []

列表项的集合。

最佳实践

例外列表组件应该:

  • 附加到另一个组件
  • 告诉商家额外的背景,这将有助于他们做出更好的决定
  • 只显示值得注意的、可操作的内容,如高风险订单或缺货项目
  • 少用,这样更有冲击力,不会增加杂乱
  • 只有当图标能让内容更清晰,或者能帮助商家更直观地理解其含义时,才使用它

内容的指导方针

例外列表应该:

  • 突出一个特殊的状态,帮助商家做出决定
  • 使用适当的颜色以配合信息的语气
  • 有一个描述(标题是可选的)
  • 是简洁

对于错误状态,异常列表应该:

  • 要么告诉商家如何解决问题,要么附加到一个让商家解决问题的项目上

如果放在一个项目的旁边资源列表,例外情况清单应:

  • 使整个列表项可单击,因为异常列表本身不可单击

  • 在资源列表项中使用的例外列表

  • 使用异常列表代替横幅

  • 要在页面顶部显示错误,或在表单中指示多个错误,请使用横幅组件
  • 异常列表通常用于资源列表组件显示条件内容

可访问性

异常列表中的项被组织为列表项(<李>)在无序列表包装器(< ul >),因此它们作为一组相关元素传达给辅助技术用户。

与例外列表项一起显示的图标旨在从视觉上强化相邻信息,而不是单独传达信息。它们可以被屏幕阅读器跳过aria-hidden = " true "