From edc893bf5e74d2ced43cddaa69c15633108f7151 Mon Sep 17 00:00:00 2001 From: y377 <58632405+y377@users.noreply.github.com> Date: Fri, 3 Feb 2023 12:51:04 +0800 Subject: [PATCH] Update tocbot.md --- tocbot.md | 68 +++++++++++++++++++++++++++---------------------------- 1 file changed, 34 insertions(+), 34 deletions(-) diff --git a/tocbot.md b/tocbot.md index a5e2a4d..51a7494 100644 --- a/tocbot.md +++ b/tocbot.md @@ -3,38 +3,38 @@ | `tocSelector` | `.js-toc` | toc选择器,在哪里呈现目录 | | `tocElement` | element | toc元素,或者,您可以改为传入 DOM 节点 | | `contentSelector` | *.js-toc-content* | 内容选择器,在哪里抓取标题来构建目录 | -| contentElement | element | 内容元素,或者,您可以改为传入 DOM 节点 | -| headingSelector | 'h1, h2, h3' | 在 contentSelector 元素中抓取哪些标题 | -|ignoreSelector | `.js-toc-ignore` | 匹配 ignoreSelector 的标题将被跳过 | -| hasInnerContainers |false | 对于内容中相对或绝对定位容器内的标题 | -| linkClass | `'toc-link'` | 添加到链接的主类 | -| extraLinkClasses | `''` | 添加到链接的额外类 | +| `contentElement` | element | 内容元素,或者,您可以改为传入 DOM 节点 | +| `headingSelector` | 'h1, h2, h3' | 在 contentSelector 元素中抓取哪些标题 | +| `ignoreSelector` | `.js-toc-ignore` | 匹配 ignoreSelector 的标题将被跳过 | +| `hasInnerContainers` |false | 对于内容中相对或绝对定位容器内的标题 | +| `linkClass` | `'toc-link'` | 添加到链接的主类 | +| `extraLinkClasses` | `''` | 添加到链接的额外类 | | activeLinkClass | `is-active-link` | 要添加到活动链接的类,该链接对应于页面上最顶部的标题 | -| listClass | `toc-list` | 要添加到列表中的主类 | -| extraListClasses | '' | 可添加到列表中的额外类 | -| isCollapsedClass | `is-collapsed` | 当列表应该折叠时添加的类 | -| collapsibleClass | `is-collapsible` | 当列表应该能够折叠但不一定折叠时添加的类 | -| listItemClass | `'toc-list-item'` | 要添加到列表项的类 | -| activeListItemClass | `is-active-li` | 要添加到活动列表项的类 | -| collapseDepth | 0 | 有多少标题级别不应折叠。例如,数字 6 将显示所有内容,因为只有 6 个标题级别,数字 0 将全部折叠。当您滚动到其中的标题时,隐藏的部分将打开和关闭。 | -| scrollSmooth | true | 启用平滑滚动 | -| scrollSmoothDuration | 420 | 平滑滚动持续时间 | -|scrollSmoothOffset | 0 | 平滑滚动偏移 | -|scrollEndCallback | `function (e) {}` | 滚动结束回调 | -| headingsOffset | 1 | 标题与文档顶部之间的标题偏移量(这意味着较小的调整) | -| throttleTimeout | 50 | 事件触发之间的超时,以确保它不会太快(出于性能原因) | -| positionFixedSelector | null | 元素中添加positionFixedClass | -| positionFixedClass | `is-position-fixed` | 添加固定位置类,使侧边栏在向下滚动超过 fixedSidebarOffset 后固定 | -| fixedSidebarOffset | `auto` | fixedSidebarOffset 可以是任何数字,但默认情况下设置为 auto,它将 fixedSidebarOffset 设置为边栏元素的 offsetTop 从文档顶部开始 | -| includeHtml | false | includeHtml 可以设置为 true 以包含来自标题节点的 HTML 标记,而不是仅包含 textContent | -| includeTitleTags | false | includeTitleTags 自动设置链接的 html 标题标签以匹配标题。这对于 SEO 目的或截断标题时很有用 | -| onClick | `function (e) {}` | onclick 函数应用于目录中的所有链接。将以事件作为第一个参数调用,这可用于停止、传播、防止默认或执行操作 | -| orderedList | true | orderedList 可以设置为 false 以生成无序列表 (ul) 而不是有序列表 (ol) | -| scrollContainer | null | 如果有固定的文章滚动容器,设置计算标题的偏移量 | -| skipRendering | false | 如果ToC DOM已经被外部系统渲染,则阻止它的渲染 | -| headingLabelCallback | false | 更改标题标签的可选回调。
例如,它可以用于减少并在您认为太长的多行标题上放置省略号。
每次解析标题时调用。 需要一个字符串并返回修改后的标签以显示。
此外,可以在标题上使用属性 `data-heading-label` 来指定
在 TOC 中使用的较短的字符串。
`function (string) => string` | -| ignoreHiddenElements | false | 忽略隐藏在 DOM 中的标题 | -| headingObjectCallback | null | 可选的回调来修改已解析标题的属性。
在节点参数中传递标题元素,在obj参数中提供默认解析器解析的信息。
函数必须返回相同或修改过的obj。
如果没有返回,则标题将从TOC中排除。
`function (object, HTMLElement) => object \| void` | -| basePath | `''` | 设置基本路径,如果你在' head '中使用' base '标签,这很有用 | -| disableTocScrollSync | false | 只在`tocSelector`滚动时生效,保持toc滚动位置与内容同步。 | -| tocScrollOffset | 0 | 当滚动页面时,toc滚动(顶部)位置的偏移。只有在`disableTocScrollSync`为false时才有效。 | +| `listClass` | `toc-list` | 要添加到列表中的主类 | +| `extraListClasses` | '' | 可添加到列表中的额外类 | +| `isCollapsedClass` | `is-collapsed` | 当列表应该折叠时添加的类 | +| `collapsibleClass` | `is-collapsible` | 当列表应该能够折叠但不一定折叠时添加的类 | +| `listItemClass` | `'toc-list-item'` | 要添加到列表项的类 | +| `activeListItemClass` | `is-active-li` | 要添加到活动列表项的类 | +| `collapseDepth` | 0 | 有多少标题级别不应折叠。例如,数字 6 将显示所有内容,因为只有 6 个标题级别,数字 0 将全部折叠。当您滚动到其中的标题时,隐藏的部分将打开和关闭。 | +| `scrollSmooth` | true | 启用平滑滚动 | +| `scrollSmoothDuration` | 420 | 平滑滚动持续时间 | +| `scrollSmoothOffset` | 0 | 平滑滚动偏移 | +| `scrollEndCallback` | `function (e) {}` | 滚动结束回调 | +| `headingsOffset` | 1 | 标题与文档顶部之间的标题偏移量(这意味着较小的调整) | +| `throttleTimeout` | 50 | 事件触发之间的超时,以确保它不会太快(出于性能原因) | +| `positionFixedSelector` | null | 元素中添加positionFixedClass | +| `positionFixedClass` | `is-position-fixed` | 添加固定位置类,使侧边栏在向下滚动超过 fixedSidebarOffset 后固定 | +| `fixedSidebarOffset` | `auto` | fixedSidebarOffset 可以是任何数字,但默认情况下设置为 auto,它将 fixedSidebarOffset 设置为边栏元素的 offsetTop 从文档顶部开始 | +| `includeHtml` | false | includeHtml 可以设置为 true 以包含来自标题节点的 HTML 标记,而不是仅包含 textContent | +| `includeTitleTags` | false | includeTitleTags 自动设置链接的 html 标题标签以匹配标题。这对于 SEO 目的或截断标题时很有用 | +| `onClick` | `function (e) {}` | onclick 函数应用于目录中的所有链接。将以事件作为第一个参数调用,这可用于停止、传播、防止默认或执行操作 | +| `orderedList` | true | orderedList 可以设置为 false 以生成无序列表 (ul) 而不是有序列表 (ol) | +| `scrollContainer` | null | 如果有固定的文章滚动容器,设置计算标题的偏移量 | +| `skipRendering` | false | 如果ToC DOM已经被外部系统渲染,则阻止它的渲染 | +| `headingLabelCallback` | false | 更改标题标签的可选回调。
例如,它可以用于减少并在您认为太长的多行标题上放置省略号。
每次解析标题时调用。 需要一个字符串并返回修改后的标签以显示。
此外,可以在标题上使用属性 `data-heading-label` 来指定
在 TOC 中使用的较短的字符串。
`function (string) => string` | +| `ignoreHiddenElements` | false | 忽略隐藏在 DOM 中的标题 | +| `headingObjectCallback` | null | 可选的回调来修改已解析标题的属性。
在节点参数中传递标题元素,在obj参数中提供默认解析器解析的信息。
函数必须返回相同或修改过的obj。
如果没有返回,则标题将从TOC中排除。
`function (object, HTMLElement) => object \| void` | +| `basePath` | `''` | 设置基本路径,如果你在' head '中使用' base '标签,这很有用 | +| `disableTocScrollSync` | false | 只在`tocSelector`滚动时生效,保持toc滚动位置与内容同步。 | +| `tocScrollOffset` | 0 | 当滚动页面时,toc滚动(顶部)位置的偏移。只有在`disableTocScrollSync`为false时才有效。 |