You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

使用Docusaurus的DocCardList组件时,能否隐藏指定文件并显示其余文件?

如何分批显示Docusaurus的DocCardList导航卡片

你可以通过标签分组的方式实现分批显示卡片,同时也能轻松隐藏特定页面的卡片,具体步骤如下:

1. 给目标页面添加分组标签

在需要分类的页面顶部的front matter(YAML区域)中添加标签,比如:

  • 要先展示的两个页面:
---
title: 页面A
tags: ['first-group']
---
---
title: 页面B
tags: ['first-group']
---
  • 要后展示的两个页面:
---
title: 页面C
tags: ['second-group']
---
---
title: 页面D
tags: ['second-group']
---
  • 如果要完全隐藏某个页面的卡片,不给它加任何用于筛选的标签即可,或者在其front matter中设置:
---
title: 要隐藏的页面
sidebar_position: false
---

2. 在主页分批调用DocCardList

在主页中先调用第一组的卡片,添加自定义文本后,再调用第二组:

import DocCardList from '@theme/DocCardList';

// 第一组卡片
<DocCardList tags={['first-group']} />

// 中间添加你的自定义文本
这是第一组卡片和第二组卡片之间的说明内容...

// 第二组卡片
<DocCardList tags={['second-group']} />

补充说明

DocCardList默认不支持exclude或hide这类直接排除参数,所以用标签分组是官方推荐的灵活筛选方式。如果需要更复杂的逻辑,也可以基于官方组件二次封装自定义筛选逻辑,但标签分组已经能满足你的需求。

内容的提问来源于stack exchange,提问作者Cynthia

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.20 12:33:12