Breadcrumb 面包屑组件 #

基本用法 #

jsx
import {
  Breadcrumb,
  BreadcrumbItem,
  BreadcrumbLink,
  BreadcrumbSeparator,
} from '@chakra-ui/react'
import { ChevronRightIcon } from '@chakra-ui/icons'

function Example() {
  return (
    <Breadcrumb separator={<ChevronRightIcon color="gray.500" />}>
      <BreadcrumbItem>
        <BreadcrumbLink href="#">首页</BreadcrumbLink>
      </BreadcrumbItem>

      <BreadcrumbItem>
        <BreadcrumbLink href="#">文档</BreadcrumbLink>
      </BreadcrumbItem>

      <BreadcrumbItem isCurrentPage>
        <BreadcrumbLink href="#">组件</BreadcrumbLink>
      </BreadcrumbItem>
    </Breadcrumb>
  )
}

分隔符 #

jsx
<Breadcrumb separator="-">
  <BreadcrumbItem>
    <BreadcrumbLink href="#">首页</BreadcrumbLink>
  </BreadcrumbItem>
  <BreadcrumbItem>
    <BreadcrumbLink href="#">产品</BreadcrumbLink>
  </BreadcrumbItem>
  <BreadcrumbItem isCurrentPage>
    <BreadcrumbLink>详情</BreadcrumbLink>
  </BreadcrumbItem>
</Breadcrumb>

自定义分隔符 #

jsx
<Breadcrumb separator={<Text color="gray.400">/</Text>}>
  {/* 内容 */}
</Breadcrumb>

实用示例 #

产品导航 #

jsx
function ProductBreadcrumb({ category, product }) {
  return (
    <Breadcrumb
      fontWeight="medium"
      fontSize="sm"
      separator={<ChevronRightIcon color="gray.500" />}
    >
      <BreadcrumbItem>
        <BreadcrumbLink href="/">首页</BreadcrumbLink>
      </BreadcrumbItem>
      <BreadcrumbItem>
        <BreadcrumbLink href={`/category/${category.id}`}>
          {category.name}
        </BreadcrumbLink>
      </BreadcrumbItem>
      <BreadcrumbItem isCurrentPage>
        <BreadcrumbLink>{product.name}</BreadcrumbLink>
      </BreadcrumbItem>
    </Breadcrumb>
  )
}

带图标的面包屑 #

jsx
<Breadcrumb>
  <BreadcrumbItem>
    <BreadcrumbLink href="#">
      <HStack spacing={1}>
        <Icon as={HomeIcon} />
        <Text>首页</Text>
      </HStack>
    </BreadcrumbLink>
  </BreadcrumbItem>
  <BreadcrumbItem>
    <BreadcrumbLink href="#">设置</BreadcrumbLink>
  </BreadcrumbItem>
</Breadcrumb>
属性 说明
separator 分隔符 React 元素
spacing 间距 尺寸值

下一步 #

现在你已经掌握了 Breadcrumb 组件,接下来学习 Link 链接,了解如何使用链接组件!

最后更新:2026-03-28