Breadcrumb 面包屑

如果项目中使用的是 1.x 版本的基础组件(@alifd/next),请在左侧导航顶部切换组件版本。

安装方法

  1. 在命令行中执行以下命令npm install @icedesign/base@latest -S

开发指南

何时使用

用来告知用户当前的位置,以及当前页面在整个网站中的位置,属于一种辅助的导航方式,适用于清晰且具多层次结构的网站,每一层内容为层级归属关系,方便用户返回上一级或各个层级的页面。

API

面包屑

参数说明类型默认值
prefix样式类名的品牌前缀String'next-'
className自定义类名String-
style自定义内联样式Object-
children面包屑子节点 ,需传入 Breadcrumb.Itemcustom-
maxNode面包屑显示的最多个数,超出的部分会被隐藏Number-
separator分隔符,可以是文本,也可以是 IconReactNode<Icon size="xs" type="arrow-right" />

Breadcrumb.Item

参数说明类型默认值
prefix样式类名的品牌前缀String'next-'
className自定义类名String-
style自定义内联样式Object-
children面包屑节点内容ReactNode-
link面包屑节点链接,如果设置这个属性,则该节点为<a /> ,否则是<span />String-

Breadcrumb.Keyword

参数说明类型默认值
prefix样式类名的品牌前缀String'next-'
className自定义类名String-
style自定义内联样式Object-
children关键字内容ReactNode-

Breadcrumb.Number

参数说明类型默认值
prefix样式类名的品牌前缀String'next-'
className自定义类名String-
style自定义内联样式Object-
children数字内容ReactNode-

代码示例

基本用法

使用 Breadcrumb.Item 来设置面包屑子节点,如果设置其 link 属性就是 <a /> 节点,否则为 <span /> 节点,另外可以使用 Breadcrumb.Keyword 来强调文本,Breadcrumb.Number 来为数字设置特殊样式。

Breadcrumb 面包屑 - 图1

查看源码在线预览

  1. import { Breadcrumb } from "@icedesign/base";
  2. ReactDOM.render(
  3. <Breadcrumb>
  4. <Breadcrumb.Item link="javascript:void(0);">Home</Breadcrumb.Item>
  5. <Breadcrumb.Item link="javascript:void(0);">All Categories</Breadcrumb.Item>
  6. <Breadcrumb.Item link="javascript:void(0);">
  7. Womens Clothing
  8. </Breadcrumb.Item>
  9. <Breadcrumb.Item link="javascript:void(0);">
  10. Blouses & Shirts
  11. </Breadcrumb.Item>
  12. <Breadcrumb.Item>
  13. <Breadcrumb.Keyword>T-shirts&nbsp;</Breadcrumb.Keyword>
  14. <Breadcrumb.Number>78,999</Breadcrumb.Number> Results
  15. </Breadcrumb.Item>
  16. </Breadcrumb>,
  17. mountNode
  18. );

显示省略

当超过设置的最大个数的时候,显示省略号。

Breadcrumb 面包屑 - 图2

查看源码在线预览

  1. import { Breadcrumb } from "@icedesign/base";
  2. ReactDOM.render(
  3. <Breadcrumb maxNode={5}>
  4. <Breadcrumb.Item link="javascript:void(0);">Home 1</Breadcrumb.Item>
  5. <Breadcrumb.Item link="javascript:void(0);">Whatever 2</Breadcrumb.Item>
  6. <Breadcrumb.Item link="javascript:void(0);">
  7. All Categories 3
  8. </Breadcrumb.Item>
  9. <Breadcrumb.Item link="javascript:void(0);">
  10. Womens Clothing 4
  11. </Breadcrumb.Item>
  12. <Breadcrumb.Item link="javascript:void(0);">
  13. Blouses & Shirts 5
  14. </Breadcrumb.Item>
  15. <Breadcrumb.Item>T-shirts 6</Breadcrumb.Item>
  16. </Breadcrumb>,
  17. mountNode
  18. );

设置分隔符

也可以设置不同的分隔符。

Breadcrumb 面包屑 - 图3

查看源码在线预览

  1. import { Breadcrumb } from "@icedesign/base";
  2. ReactDOM.render(
  3. <Breadcrumb separator="/">
  4. <Breadcrumb.Item link="javascript:void(0);">Home</Breadcrumb.Item>
  5. <Breadcrumb.Item link="javascript:void(0);">All Categories</Breadcrumb.Item>
  6. <Breadcrumb.Item link="javascript:void(0);">
  7. Womens Clothing
  8. </Breadcrumb.Item>
  9. <Breadcrumb.Item link="javascript:void(0);">
  10. Blouses & Shirts
  11. </Breadcrumb.Item>
  12. <Breadcrumb.Item>T-shirts</Breadcrumb.Item>
  13. </Breadcrumb>,
  14. mountNode
  15. );

相关区块

Breadcrumb 面包屑 - 图4

暂无相关区块