My Profile Photo

Jesse


Hi, 我是 Jesse,一名 iOS 开发者,热爱编程,平常也喜欢摄影。欢迎大家能多多交流。


TOC功能测试

TOC功能测试页面

这是一个测试页面,用于验证目录(TOC)功能是否正常工作。

第一章:简介

欢迎来到TOC功能测试页面。这个页面包含多个层级的标题,用于测试目录生成和跳转功能。

1.1 功能特性

目录功能包含以下特性:

  • 自动生成目录索引
  • 支持多层级标题
  • 平滑滚动效果
  • 响应式设计

1.2 技术实现

TOC功能使用了以下技术:

  • Jekyll模板引擎
  • JavaScript动态处理
  • CSS响应式布局

第二章:主要功能

2.1 目录生成

目录会自动扫描文章中的所有标题并生成对应的目录项。

2.1.1 支持的标题类型

支持以下HTML标题标签:

  • h1: 一级标题
  • h2: 二级标题
  • h3: 三级标题
  • h4: 四级标题
  • h5: 五级标题
  • h6: 六级标题
2.1.1.1 标题ID生成

系统会自动为没有ID的标题生成唯一的ID,确保锚点跳转功能正常工作。

2.1.1.2 中文支持

完全支持中文标题的ID生成和显示。

2.1.2 目录样式

目录具有美观的样式设计:

  • 层级缩进显示
  • 悬停效果
  • 活动状态高亮
  • 响应式布局

2.2 交互功能

点击跳转

点击目录项会平滑滚动到对应章节:

// 平滑滚动实现
window.scrollTo({
  top: targetElement.offsetTop - 120,
  behavior: 'smooth'
});

滚动高亮

当用户滚动页面时,目录会自动高亮当前阅读位置的章节。

2.3 响应式设计

TOC功能在不同设备上都有良好的显示效果:

  • 桌面端:右侧固定目录
  • 平板端:顶部可折叠目录
  • 手机端:移动端优化样式

第三章:使用方法

3.1 默认启用

默认情况下,TOC功能会在所有博文页面启用。

3.2 禁用TOC

如果需要在特定页面禁用TOC功能,可以在front matter中添加:

---
layout: post
title: "无目录的文章"
toc: false
---

第四章:总结

TOC功能为用户提供了便捷的文章导航体验,特别是在阅读长篇技术文章时非常有用。

4.1 优势

  • 提升用户体验
  • 改善文章可读性
  • 便于快速定位内容

4.2 后续改进

未来可以考虑添加以下功能:

  • 目录搜索功能
  • 自定义样式选项
  • 目录导出功能

感谢使用TOC功能!

目录