使用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
相关产品推荐
相关产品推荐

