资源项目
资源项表示集合中的特定对象,例如产品或订单。它们提供关于资源类型的上下文信息,并链接到对象的详细信息页面。
基本资源项,其详细信息在使用点被填充。
进口{卡,ResourceList,ResourceItem,文本}从“@shopify /北极星”;进口{useState}从“反应”;函数ResourceItemExample(){常量[设置selecteditem,setSelectedItems]=useState([]);返回(<卡><ResourceListresourceName={{单数:“博客”,复数:“博客”}}项目={[{id:6,url:的帖子/ 6,标题:如何从线框图中获取价值,作者:“乔纳森红树林”,},]}设置selecteditem={设置selecteditem}onSelectionChange={setSelectedItems}可选择的renderItem={(项)= >{常量{id,url,标题,作者}=项;常量authorMarkup=作者?<div>通过{作者}</div>:零;返回(<ResourceItemid={id}url={url}accessibilityLabel={`查看详细信息$ {标题}`}的名字={标题}><文本变体=“bodyMd”fontWeight=“大胆”作为=“h3”>{标题}</文本>{authorMarkup}</ResourceItem>);}}/></卡>);}
所需的组件
资源项组件必须包装在资源列表组件。
可访问性
资源项的功能是链接到该项的全页表示形式。每个项目应该有一个唯一的的名字
道具。为每一个ResourceItem
,accessibilityLabel
道具应该用来给链接一个唯一的aria-label
价值。的aria-label
值应该传达链接的目的,使用的名字
价值。使用屏幕阅读器或其他文本语音转换工具的商家应该能够轻松区分每个链接。
向资源项添加自定义内容时,请确保所有文本对所有用户可用,并且所有自定义控件具有唯一的可访问名称,以帮助用户了解控件激活时将发生什么。
键盘
方法可以激活链接输入/返回键。
如果您向资源项添加了自定义控件,那么请确保这些控件:
- 可以和键盘一起使用吗
- 按逻辑顺序接收键盘焦点
- 显示一个可见的焦点指示器
最佳实践
资源项应该:
- 根据所显示的特定类型的上下文进行定制。
- 单击时执行操作。操作应该导航到资源的详细信息页面或提供关于该项的更多详细信息。
资源项可以选择:
- 提供快捷键操作从资源的详细信息页面快速访问频繁的操作。
内容的指导方针
资源项应该:
- 展示商家需要的信息,以找到他们正在寻找的商品。
- 支持特定类型资源的商家任务。
- 避免冒号。
- 快捷键操作对于按钮,不需要遵循完整的动词+名词公式。
相关的组件
要显示相关内容的简单列表,请执行以下操作使用列表组件.