导航
控件的侧边栏中显示主导航框架一个应用程序。导航包括一个链接列表,商家使用这些链接在应用程序的各个部分之间移动。
控件中显示导航菜单框架。
进口{框架,导航}从“@shopify /北极星”;进口{HomeMinor,OrdersMinor,ProductsMinor}从“@shopify / polaris-icons”;进口反应从“反应”;函数NavigationExample(){返回(<框架><导航位置=“/”><导航。部分项目={[{url:' / ',标签:“回家”,图标:HomeMinor,},{url:“/道路/ /地方”,标签:“订单”,图标:OrdersMinor,徽章:“15”,},{url:“/道路/ /地方”,标签:“产品”,图标:ProductsMinor,},]}/></导航></框架>);}
道具
想让这个功能变得更好吗?请分享你的反馈。
接口
NavigationProps
- 位置 字符串
- 孩子们吗? 反应。ReactNode
- contextControl吗? 反应。ReactNode
- onDismiss吗? () = >无效
- ariaLabelledBy吗? 字符串
-
用作aria-label - by的元素Id。
- logoSuffix吗? 反应。ReactNode
-
接受用于补充徽标标记的组件。
所需的组件
必须将导航组件传递给框架组件。导航组件的移动版本出现在窗口的顶部组件。
最佳实践
导航组件应该:
- 包含在单击时执行操作的主要导航项。每个动作都应该导航到一个URL,或者触发另一个动作,比如模态叠加。
- 只使用辅助操作作为主要操作的补充操作。
- 提供非主要链接或操作作为部分或项的次要操作。
- 根据相关的类别将导航项分组为部分。
- 使用章节标题来阐明章节的类别。
- 使用主图标进行项目操作。
- 使用次要操作的小图标。
- 使用提供的导航节组件对导航项进行分组。
内容的指导方针
导航:
- 主要和次要导航项使用句子大小写
做
- 欧宝体育官网入口首页
不
- 欧宝体育官网入口首页
- 用尽可能少的词来描述每个项目的标签
做
- 产品
不
- 你店里的产品
- 部分标签全部用大写
做
- 销售渠道
不
- 销售渠道
导航部分
导航部分将相关的导航项组合在一起。导航部分可以通过标题来明确。商家可以使用部分在特定类别中轻松找到导航项。
部分属性
道具 | 类型 | 描述 |
---|---|---|
项目 | 项[] | 要在节内呈现的导航项的集合 |
图标 | IconProps(“源”) | 在部分标题旁边显示的图标 |
标题 | 字符串 | 为导航部分提供标题的字符串属性 |
填满 | 布尔 | 一个布尔属性,指示该部分是否应该占用所有可用的垂直空间 |
汇总 | 汇总 | 确定导航部分的折叠行为的对象 |
行动 | 行动 | 呈现一个仅限图标的操作,作为部分标题旁边的补充操作 |
分隔符 | 布尔 | 一个布尔属性,指示该节是否应该有可视分隔符 |
导航部分项目
导航组件的内容由导航项组成。每个项目都是商家可以采取的链接或行动。
项属性
道具 | 类型 | 描述 |
---|---|---|
url | 字符串 | 单击导航项时要导航到的位置 |
匹配 | 布尔 | 一个布尔属性,指示导航项是否应响应密切匹配的位置属性 |
exactMatch | 布尔 | 一个布尔属性,指示导航项是否应响应完全匹配的位置属性 |
matchPaths | string [] | 一个字符串属性,为要响应的导航项提供附加路径的集合 |
excludePaths | string [] | 提供导航项不应响应的路径的显式集合的字符串属性 |
图标 | IconProps(“源”) | 在导航栏旁边显示的图标。请选择这里的小图标。如果必须使用主图标,请设置shouldResizeIcon 道具对真 |
徽章 | 字符串| null | 一个字符串属性,允许内容显示在导航项旁边的标识中 |
标签 | 字符串 | 一个字符串属性,允许内容在导航项中显示为链接文本 |
禁用 | 布尔 | 一个布尔属性,指示是否禁用导航项 |
新 | 布尔 | 通过向父项添加指示点并向项添加徽标(由徽标道具覆盖)来指示导航项是否为新项 |
accessibilityLabel | 字符串 | 一个视觉上隐藏的标签,用于屏幕阅读器理解导航项的内容 |
选择 | 布尔 | 一个布尔属性,指示导航项是否为当前选择的项 |
shouldResizeIcon | 布尔 | 是否允许主图标以与小图标相同的大小显示 |
subNavigationItems | SubNavigationItem [] | 呈现为嵌套辅助导航项的导航项集合 |
secondaryAction | SecondaryAction | 呈现一个仅限图标的操作,作为导航项旁边的补充操作 |
onClick () | 函数 | 处理单击导航项的回调函数 |
SubNavigationItem
属性
道具 | 类型 | 描述 |
---|---|---|
url | 字符串 | 单击导航项时要导航到的位置 |
匹配 | 布尔 | 一个布尔属性,指示导航项是否应响应密切匹配的位置属性 |
exactMatch | 布尔 | 一个布尔属性,指示导航项是否应响应完全匹配的位置属性 |
matchPaths | string [] | 一个字符串属性,为要响应的导航项提供附加路径的集合 |
excludePaths | string [] | 提供导航项不应响应的路径的显式集合的字符串属性 |
外部 | 布尔 | 是否为外部链接。如果是,则会在标签旁边显示一个外部链接图标 |
标签 | 字符串 | 一个字符串属性,允许内容在导航项中显示为链接文本 |
禁用 | 布尔 | 一个布尔属性,指示是否禁用导航项 |
新 | 布尔 | 通过向父项添加指示点并向项添加徽标(由徽标道具覆盖)来指示导航项是否为新项 |
onClick () | 函数 | 处理单击导航项的回调函数 |
SecondaryAction
属性
道具 | 类型 | 描述 |
---|---|---|
url | 字符串 | 单击导航项时要导航到的位置 |
accessibilityLabel | 字符串 | 一个视觉上隐藏的标签,用于屏幕阅读器理解导航项的内容 |
图标 | IconProps(“源”) | 在导航栏旁边显示的图标。请选择这里的小图标。如果必须使用主图标,请设置shouldResizeIcon 道具对真 |
onClick () | 函数 | 处理单击导航项的回调函数 |
工具提示 | TooltipProps | 将鼠标悬停在操作按钮上时显示工具提示的选项 |
导航部分汇总
Rollup允许导航部分中的项目在它们对商家有用时卷起并显示出来。
汇总属性
道具 | 类型 | 描述 |
---|---|---|
后 | 数量 | 导航部分应该折叠之后的若干项 |
视图 | 字符串 | 为节视图操作提供内容的字符串属性 |
隐藏 | 字符串 | 为节隐藏操作提供内容的字符串属性 |
activePath | 字符串 | 表示应用程序当前URL的字符串属性 |
导航部分动作
Action允许在部分标题旁边呈现一个补充性的图标操作。
动作特性
道具 | 类型 | 描述 |
---|---|---|
图标 | IconProps(“源”) | 作为操作内容显示的图标 |
accessibilityLabel | 字符串 | 一个视觉上隐藏的标签,供屏幕阅读器理解操作的内容 |
onClick () | 函数 | 处理单击操作的回调函数 |
工具提示 | TooltipProps | 将鼠标悬停在操作按钮上时显示工具提示的选项 |