Headlight Table of Contents
| 开发者 | someguy9 |
|---|---|
| 更新时间 | 2026年10月27日 19:18 |
| 捐献地址: | 去捐款 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Automatic: add a table of contents to posts, pages or any public post type, before the first heading or at the top, once a post has enough headings.
- Or place it yourself: use the Table of Contents block or the
[headlight-toc]shortcode. - Works on every post you have: headings get their links when the page is shown, so old posts, Classic Editor posts and headings from shortcodes, patterns, page builders and other blocks are all included. Nothing is saved into your posts.
- Keeps existing links: a heading that already has an id (an HTML anchor from the block editor, your theme or another plugin) keeps it. New ids match the anchors the block editor creates. Switching from Easy Table of Contents or Table of Contents Plus? Pick its link style and every old link to a section keeps working.
- Collapsible with no JavaScript: uses the browser's built-in
<details>element. Choose to start open, start closed, or have no toggle. - Smooth scrolling and sticky headers: smooth scrolling and the sticky header offset are plain CSS, and smooth scrolling is skipped for visitors who turn off animations.
- Numbered (1, 1.1), bullets or plain lists, nested by heading level.
- Accessible: a
<nav>landmark named by its title, real links, and a native toggle that works with a keyboard and screen readers. - Switching is easy:
[toc],[ez-toc],[lwptoc]and[no_toc]left in your posts by other table of contents plugins keep working once that plugin is deactivated. - Plays well with others: works with AMP (passes the AMP validator), recognized by Rank Math's content analysis, and never added to excerpts, feeds or other posts shown on the page.
安装:
- Install and activate the plugin.
- Go to Settings > Table of Contents to choose where it appears and how it looks.
- To place it yourself, add the Table of Contents block or the
[headlight-toc]shortcode to a post.
屏幕截图:
常见问题:
Which headings are listed?
Every heading in the post itself as it is shown: Heading blocks, Classic Editor headings, and headings that come from patterns, shortcodes, Custom HTML, page builders like Elementor, and other blocks like GenerateBlocks and Kadence Blocks. Choose the levels (H1 to H6) in the settings or on the block. Headings in your theme's header, sidebar or footer aren't included.
How do I hide it on one post?
Use the Table of Contents box on the post's edit screen and choose Hide, or add [headlight-toc-off] anywhere in the post ([no_toc] left by other plugins works too). Choose Show to add it to a post whose type isn't turned on in the settings.
How do I leave a heading out?
Add the CSS class headlight-toc-exclude to the heading (Block > Advanced > Additional CSS class), or list its text under Settings > Table of Contents > Leave out headings. * works as a wildcard.
My theme's sticky header covers the heading after clicking a link
Enter the header's height under Settings > Table of Contents > Sticky header height. The WordPress admin bar is accounted for automatically. Some themes, like Kadence, scroll to links with their own script and handle their own sticky header.
I'm switching from Easy Table of Contents or Table of Contents Plus
Deactivate the old plugin (you'll see a reminder while both are active), then under Settings > Table of Contents > Heading links choose "Same as Easy Table of Contents" or "Same as Table of Contents Plus". The old plugin's leftover settings are used, so every heading gets exactly the id it had before and links people have shared to sections of your posts (like #What_is_SEO) keep working. This was checked against Easy Table of Contents 2.0.88 and Table of Contents Plus 202609.1 with headings full of punctuation, quotes, accents, emoji and non-Latin text.
[toc], [ez-toc], [lwptoc] and [no_toc] in your posts keep working too, and in the block editor "Convert to blocks" turns them into the Table of Contents block.
What shortcode options are there?
[headlight-toc title="In this post" levels="2,3" collapse="closed" list="bullets"] places it, and [headlight-toc-off] turns the automatic one off for that post.
title: the heading of the box.levels: which heading levels to list, e.g.2,3.collapse:open,closedoroff(no toggle).list:numbered,bulletsorplain.
What about posts split into pages?
Each page of a post split with a Page Break lists the headings on that page.
Does it work in a sidebar or a site template?
Not yet. The block and shortcode work inside post content.
Does it change my post content?
No. Heading ids are added when the page is shown. In the block editor (with the standard link style), the plugin turns on WordPress's own option to save an HTML anchor on each Heading block as you write, so a link to a section stays the same if you later edit the heading. You can turn that off in the settings.
更新日志:
- First release.