SimpleTOC – Bloco de sumário

Descrição

Add a Table of Contents block to your posts and pages. The TOC is a nested list of links to all heading found in the post or page. To use it, simply add a block and search for “SimpleTOC” or just “TOC”.

The maximum depth of the toc can be configured in in the blocks’ sidebar among many other options. There can hide the headline “Table of Contents” and add your own by using a normal heading block.

SimpleTOC is open-source and developed on GitHub Pages. If you find a bug or have an idea for a feature please feel free to contribute and create a pull request.

Rode uma nova instância do WordPress com o plugin SimpleTOC já instalado.

Acessibilidade

Este plugin foi criado e desenvolvido para conformidade com o WCAG 2.2 nível AA. O plugin foi testado com tecnologia assistiva e é feito para ser acessível, mas alguns plugins ou temas de terceiros podem afetar a acessibilidade em um site específico. Se você encontrar algum problema de acessibilidade, nos avise e tentaremos corrigir rapidamente.

Recursos

  • Projetado para Gutenberg
  • Zero configuration: Add the SimpleTOC block to your post and that’s it.
  • Saída HTML mínima e válida.
  • Utiliza a tag de detalhes incorporada do navegador para uma interface que pode ser expandida e recolhida.
  • Nenhum JavaScript ou CSS é adicionado. A menos que você ative o menu sanfona.
  • Style SimpleTOC with Gutenberg’s native group styling options.
  • Herda o estilo do seu tema.
  • Efeito de rolagem suave usando CSS.
  • Accessibility built-in by following web standards.
  • Rótulo ARIA opcional e atributos de função de navegação.
  • Translated in multiple languages. Including German, Japanese, Chinese (Taiwan), Dutch, Brazilian Portuguese, French, Spanish and Latvia.
  • Ideal para criar uma seção de perguntas frequentes no seu site.

Customization

  • Os administradores podem utilizar as configurações globais para substituir as configurações de blocos individuais.
  • Add background and text color with Gutenberg groups.
  • Native block support for wide and full width.
  • Controle a profundidade máxima dos títulos.
  • Escolha entre uma lista HTML ordenada e com marcadores. Ou recue a lista.
  • Selecione um nível de título ou transforme-o em um parágrafo.
  • Disable the h2 heading of the TOC block and add your own.

Compatibility

  • GeneratePress and Rank Math support.
  • Works with popular AMP plugins.

Créditos

Este plugin é uma bifurcação do pdewouters e usa código do Easy-Table-of-Contents

Muito obrigado a Tom J Nowell e Sally CJ, que me ajudaram muito com minhas perguntas no wordpress.stackexchange.com

Thanks to Quintus Valerius Soranus for inventing the Table of Contents around 100 BC.

Capturas de tela

  • Bloco do SimpleTOC no editor do Gutenberg.
  • SimpleTOC no post.
  • Simples, mas poderoso. Personalize cada sumário como desejar.
  • Controle a profundidade máxima dos títulos.
  • SimpleTOC estilizado com os estilos de grupo nativos do Gutenberg.
  • Recursos Avançados do SimpleTOC
  • Bloco de Título do Gutenberg: Definir uma âncora personalizada
  • SimpleTOC escondido no menu sanfona.
  • Configurações globais do SimpleTOC.

Blocos

Este plugin disponibiliza 1 bloco.

  • SimpleTOC Adds a Table of Contents.

Instalação

SimpleTOC pode ser encontrado e instalado através do menu Plugin na administração do WordPress (Plugins -> Adicionar Novo). Como alternativa, ele pode ser baixado do WordPress.org e instalado manualmente…

No Gutenberg, adicione um bloco e pesquise “SimpleTOC” ou apenas “TOC”. Salve seu conteúdo antes de usar o bloco.

Perguntas frequentes

Configurando as configurações globais no SimpleTOC

O SimpleTOC permite que você defina configurações globais para o seu site em WordPress. Essas configurações podem ser aplicadas globalmente, sobrepondo-se a quaisquer configurações em nível de bloco que possam existir. Para acessar essas configurações, navegue até a seção SimpleTOC das configurações do WordPress.

How do I add a background color to SimpleTOC using Gutenberg groups?

Select the block and select “group” in the context menu. Apply “background color”, “link color” and “text color” to this group. SimpleTOC will inherit these styles. You would like to use this styled SimpleTOC group next time you write a post? Convert it to a reusable block.

Como excluir um único título do Sumário?

Se você realmente quiser ocultar um único título do sumário, então adicione a classe CSS “simpletoc-hidden” a um bloco de título. Você pode encontrar este campo no mesmo lugar que o campo âncora HTML: Na barra lateral Bloco > Avançado. Mas primeiro, pense no motivo pelo qual você gostaria de esconder um título específico. Talvez você queira remover todos os títulos de um nível de profundidade específico. Então há uma opção para isso nas opções de blocos no Gutenberg. Se você acha que este título não deve fazer parte do sumário, talvez não seja necessário no próprio post?

Eu gostaria de salvar minhas configurações do SimpleTOC como padrão. Isso é possível?

Você pode converter o seu bloco SimpleTOC configurado em um bloco reutilizável no Gutenberg. Ele manterá suas configurações. Dessa forma, você pode usar as configurações desejadas para cada novo post adicionando o bloco reutilizável.

Como adicionar uma tag div de invólucro ao Sumário?

Se você adicionar uma classe personalizada ao bloco SimpleTOC em “Avançado” e então em “Classes CSS adicionais”, uma div com essa classe será envolvida na saída HTML.

Como permitir que os desenvolvedores excluam títulos específicos de forma programática?

Use o filtro ‘simpletoc_excluded_blocks’. Por exemplo, esse código irá excluir blocos de títulos que estão dentro de um bloco de coluna.

Exemplo:

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

    return $blocks;
} );

Como eu mudo a cor do menu sanfona?

O personagem heavy plus que eu usei não pode ser colorido com css sem hacks. Mas você pode alterar o ícone para outra coisa e alterar a cor do novo ícone.

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

Como adicionar o SimpleTOC a todos os artigos automaticamente?

Não vejo uma solução fácil no momento. O SimpleTOC é apenas um bloco que pode ser colocado no seu post. Se houvesse um plugin que adicionasse blocos a todas os posts, então essa seria a solução. Acho que isso deveria ser um plugin separado para manter o código do SimpleTOC limpo e… bem, simples.

Avaliações

29 novembro, 2025 1 resposta
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 maio, 2025 1 resposta
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.
11 janeiro, 2025
Ich hatte den Button erst gar nicht gefunden / übersehen unter “Blöcke” -> “Design” -> “SimpleTOC”.Klein und fein, wirklich zu empfehlen…
5 novembro, 2024
This is an excellent plugin that easily adds table of contents in your posts / pages and it provides links to the relevant headings. Does exactly what I want and I would highly recommend it if you are looking for an easy to use tale of contents block plugin. Thanks so much for sharing.
4 novembro, 2024
Profile bio appears to be a newly established website that focuses on creating bios for various social media platforms such as Instagram, Facebook, and WhatsApp. The site aims to assist users in crafting concise and engaging personal or professional bios, which are essential for making a good first impression online​
20 outubro, 2024 1 resposta
I genuinely appreicate the the SimpleTOC plugin – I use it for my site and it fits in seamlessly. It is a great example of a perfect plugin. And I look forward to contributing to its code in a few months. I have a really bad case of a wonderful domain I got from someone who used it badly and who got that domain semi-blacklisted so I get no SEO traffic at all and SimpleTOC has been one of the highpoints for my users that I get from LinkedIn that in the end result means they stay on average on the page three and a half minutes (3:30+, I think recently it was 3:13 if I excluded suspicious traffic). Some posts get average of five minutes plus. People underestimate time on site and engagement in general but in particular how a small addition like a table of contents can add to the website and customer experience.
Leia todas as 73 avaliações

Colaboradores e desenvolvedores

“SimpleTOC – Bloco de sumário” é um programa de código aberto. As seguintes pessoas contribuíram para este plugin.

Colaboradores

SimpleTOC – Bloco de sumário” foi traduzido para 16 localidades. Agradecemos aos tradutores por suas contribuições.

Traduzir o “SimpleTOC – Bloco de sumário” para seu idioma.

Interessado no desenvolvimento?

Navegue pelo código, consulte o repositório SVN ou assine o registro de desenvolvimento por RSS.

Registro de alterações

6.9.3

  • Fix: Fix Multiple IDs in Table of Contents Thanks @ronalfy
  • Added: Support for GenerateBlocks 2.1.0 Thanks @ronalfy

6.9.1

  • Added: Support for the new V3 block api.
  • Added: Tested compatibility with WordPress 6.9

6.7.3

  • Added: Tested compatibility with WordPress 6.8

6.7.2

  • Added: Support for GenerateBlocks 2.0. Thanks @blronaldhuereca
  • Added: Included an accessibility statement in the plugin description. Thanks Gen Herres.