SimpleTOC – Table of Contents Block

Beskrivelse

Tilføj en indholdsfortegnelsesblok til dine indlæg og sider. Indholdsfortegnelsen er en indlejret liste med links til alle overskrifter, der findes i indlægget eller på siden. For at bruge den skal du blot tilføje en blok og søge efter “SimpleTOC” eller bare “TOC”.

Den maksimale dybde for indholdsfortegnelsen kan konfigureres i blokkens sidepanel blandt mange andre indstillinger. Der kan du også skjule overskriften “Indholdsfortegnelse” og tilføje din egen ved at bruge en almindelig overskriftsblok.

Start en ny WordPress-instans op med SimpleTOC-pluginnet forudinstalleret.

Brugerfeedback

“Det er letvægts, stabilt og fuldt kompatibelt med WordPress Full Site Editing. En pålidelig løsning, der integreres sømløst og yder præcis som forventet.”
@js100 på wordpress.org

“Gør arbejdet perfekt og tilføjer ingen spildkode/bloat.”
@clicknathan på wordpress.org

“Enkel og alligevel kraftfuld. Fantastisk plugin, der gør præcis det, du har brug for.”
@mixey på wordpress.org

Tilgængelighed

Dette plugin er designet & udviklet til overholdelse af WCAG 2.2 niveau AA. Pluginnet er testet med hjælpeteknologier og er beregnet til at være tilgængeligt, men visse tredjeparts-plugins eller -temaer kan påvirke den enkelte tilgængelighed på et givet websted. Hvis du finder et tilgængelighedsproblem, bedes du sige til, så vil vi prøve at udbedre det hurtigst muligt.
Skjulte indholdsfortegnelser bruger native <details>– og <summary>-semantik uden ekstra ARIA-referencer, der kræver tilpassede ID’er.

Funktioner

  • Designet til Gutenberg.
  • Ingen konfiguration krævet: Tilføj SimpleTOC-blokken til dit indlæg, og det er det hele.
  • Minimalt og gyldigt HTML-output.
  • Benytter browserens indbyggede details-tag til en sammenklappelig grænseflade.
  • Ingen JavaScript eller CSS som standard. Valgfrie funktioner som accordion-menu, blød rulning eller boks-stil tilføjer kun minimale filer/assets, når de er aktiveret.
  • Optional Box style in Gutenberg’s Styles tab with a default gray background.
  • Native text, link, background, spacing, and typography controls.
  • Global block styling through theme.json.
  • Arver stilen fra dit tema.
  • Blød rulle-effekt (smooth scrolling) via CSS.
  • Indbygget tilgængelighed ved at følge webstandarder.
  • Standard Gutenberg block wrapper with navigation role and ARIA label attributes.
  • Oversat til flere sprog. Herunder tysk, japansk, kinesisk (Taiwan), hollandsk, brasiliansk portugisisk, fransk, spansk og lettisk.
  • Ideel til at oprette en sektion med ofte stillede spørgsmål (FAQ) på dit websted.

Tilpasning

  • Administratorer kan benytte globale indstillinger til at tilsidesætte de individuelle blokindstillinger.
  • Set text, link, and background colors in Gutenberg’s Styles tab.
  • Native bloksupport for bred og fuld bredde.
  • Set vertical margins and padding with native spacing controls.
  • Styr den maksimale dybde af overskrifterne.
  • Vælg mellem en ordnet liste eller en punktopstilling i HTML. Eller indryk listen.
  • Select the Box style directly in Gutenberg’s Styles tab.
  • Vælg et overskriftsniveau eller lav det om til et afsnit.
  • Deaktiver H2-overskriften i indholdsfortegnelsesblokken og tilføj din egen.

Kompatibilitet

  • Support for GeneratePress og Rank Math.
  • Fungerer med populære AMP-plugins.

Sådan bidrager du

SimpleTOC er open source og udvikles på GitHub Pages. Hvis du finder en fejl eller har en idé til en funktion, er du velkommen til at bidrage og oprette en pull request.

Krediteringer

Mange tak til Tom J Nowell og Sally CJ, som begge hjalp mig meget med mine spørgsmål ovre på wordpress.stackexchange.com

Og mange flere tak til alle de udviklere på GitHub, der har hjulpet mig med at gøre SimpleTOC til det, det er i dag!

Tak til Quintus Valerius Soranus for at opfinde indholdsfortegnelsen omkring år 100 f.Kr.

Skærmbilleder

Blokke

Dette plugin giver 1 blok.

  • SimpleTOC Adds a Table of Contents.

Installation

SimpleTOC kan findes og installeres via Plugin-menuen i WordPress-administrationen (Plugins -> Tilføj nyt). Alternativt kan det downloades fra WordPress.org og installeres manuelt …

Tilføj en blok i Gutenberg og søg efter “SimpleTOC” eller blot “TOC”. Gem venligst dit indhold, før du bruger blokken.

FAQ

Konfiguration af globale indstillinger i SimpleTOC

SimpleTOC giver dig mulighed for at konfigurere globale indstillinger for dit WordPress-websted. Disse indstillinger kan gennemtvinges globalt og tilsidesætte eventuelle konfigurationer på blokniveau. For at tilgå disse indstillinger skal du navigere til SimpleTOC-sektionen i WordPress-indstillingerne.

How do I add colors or the Box style to SimpleTOC?

Select the SimpleTOC block and open Gutenberg’s Styles tab. Choose the Box style or use the native color controls to set text, link, and background colors. Native spacing controls are available for vertical margins and padding.

Hvordan ekskluderes en enkelt overskrift fra indholdsfortegnelsen?

Hvis du virkelig ønsker at skjule en enkelt overskrift fra indholdsfortegnelsen, skal du tilføje CSS-klassen “simpletoc-hidden” til en overskriftsblok. Du kan finde dette felt samme sted som HTML-ankerfeltet: I Blok > Avanceret-sidepanelet. Men overvej først grunden til, at du ønsker at skjule en specifik overskrift. Måske vil du fjerne alle overskrifter på et bestemt dybdeniveau? Så er der en indstilling til det i blokkens indstillinger i Gutenberg. Hvis du mener, at overskriften ikke bør være en del af indholdsfortegnelsen, er den måske slet ikke nødvendig i selve indlægget?

Jeg vil gerne gemme mine SimpleTOC-indstillinger som standard. Er det muligt?

Du kan konvertere din konfigurerede SimpleTOC-blok til en genanvendelig blok i Gutenberg. Den vil bevare sine indstillinger. På denne måde kan du bruge dine foretrukne indstillinger i hvert nyt indlæg ved at tilføje den genanvendelige blok.

How can I style SimpleTOC through theme.json?

Add styles for the simpletoc/toc block to your theme.json. SimpleTOC uses the standard Gutenberg block wrapper and supports native colors, vertical margins, padding, font size, and line height settings.

The following example sets default colors, spacing, and typography for every SimpleTOC block:

{
    "$schema": "https://schemas.wp.org/trunk/theme.json",
    "version": 3,
    "styles": {
        "blocks": {
            "simpletoc/toc": {
                "color": {
                    "background": "#f5f5f5",
                    "text": "#1e1e1e"
                },
                "elements": {
                    "link": {
                        "color": {
                            "text": "#0057b8"
                        }
                    }
                },
                "spacing": {
                    "margin": {
                        "top": "1.5rem",
                        "bottom": "1.5rem"
                    },
                    "padding": {
                        "top": "1rem",
                        "right": "1rem",
                        "bottom": "1rem",
                        "left": "1rem"
                    }
                },
                "typography": {
                    "fontSize": "1rem",
                    "lineHeight": "1.6"
                }
            }
        }
    }
}

Replace the example values with your theme’s values or preset variables. Selecting the Box style adds the standard is-style-boxed class.

Hvordan giver man udviklere mulighed for at ekskludere specifikke overskrifter programmatisk?

Brug ‘simpletoc_excluded_blocks’-filteret. Dette kodeeksempel vil for eksempel ekskludere overskriftsblokke, der er placeret i en kolonneblok.

Eksempel:

add_filter( 'simpletoc_excluded_blocks', function ( array $blocks ) {
    $blocks[] = 'core/column';

    return $blocks;
} );

Hvordan ændrer jeg farven på accordion-menuen?

Det fede plustegn, jeg har brugt, kan ikke farves med CSS uden hacks. Men du kan ændre ikonet til noget andet og ændre farven på det nye ikon.

.simpletoc-collapsible::after {
    content: "✖";
    color: #e94c89;
}

Hvordan tilføjer jeg automatisk SimpleTOC til alle artikler?

Jeg ser ikke en nem løsning på nuværende tidspunkt. SimpleTOC er blot en blok, der kan placeres i dit indlæg. Hvis der var et plugin, der tilføjede blokke til ethvert indlæg, ville det være løsningen. Jeg mener, at dette bør være et andet adskilt plugin for at holde koden i SimpleTOC ren og … tja, simpel.

Anmeldelser

21. august, 2026 1 svar
I just wished this block would follow good practices for developing blocks. I was wondering why I can’t style it through theme.json and discovered that it hasn’t standard block wrapper. After inspecting block code, I found that it uses get_block_wrapper_attributes() function, but optionally. After finding that option digged under advanced block settings, I was able to style it like I do other blocks. Otherwise, this is a great block plugin.
7. januar, 2026 1 svar
Does the job with no fuss. I feel that the option to include a basic show/hide button (no animations or other bloat necessary) would add a great deal of polish for very little impact. But, the plugin advertises itself as something that is minimalist, no CSS, no JS, and that is what it is. The links also follow the CSS rules from the site theme which is strangely not the case for other TOC plugins. Well done this dev.
29. november, 2025 1 svar
The plugin works exceptionally well. It is lightweight, stable, and fully compatible with WordPress Full Site Editing. A reliable solution that integrates seamlessly and performs exactly as expected.
13. maj, 2025 1 svar
Comparing this to the “Table Of Contents Block” by WPDeveloper, I prefer this one because: It just works automatically. It has less options, but just enough to do what you need. It adds nothing to the frontend to cause bloat. No CSS, no JS. At least not right out of the box. Additional settings can be enabled that will add these, but it’s nice that we have the option! This is an example of what a well-written plugin should be.
Læs alle 77 anmeldelser

Bidragsydere & udviklere

“SimpleTOC – Table of Contents Block” er open source-software. Følgende personer har bidraget til dette plugin.

Bidragsydere

“SimpleTOC – Table of Contents Block” er blevet oversat til 19 sprog. Tak til oversætterne for deres bidrag.

Oversæt “SimpleTOC – Table of Contents Block” til dit eget sprog.

Interesseret i udvikling?

Gennemse koden, tjek SVN repository, eller abonner på udviklerloggen via RSS.

Ændringslog

7.3.0

  • Changed: Box is now a native Gutenberg block style in the Styles tab.
  • Added: Native text, link, background color, margin, and padding controls.
  • Added: theme.json styling support for colors, spacing, and typography.
  • Added: WordPress 7.1 support and automated compatibility tests.
  • Changed: Existing box-style blocks and the global Force box style setting remain compatible.
  • Thanks: Lovro Hrust (@lovor) for the theme.json and block styling feedback.