# DiscoTOC - índice automático

**URL:** https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143
**Category:** Theme component
**Tags:** official, disco-toc
**Created:** [9 Março , 2019 05:36 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143 "2019-03-09T05:36:22Z")
**Posts on this page:** 20
**Page:** 7

<div class="post-metadata">

### Author: ![Moin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/moin/32/554653_2.png) [@Moin](https://meta.discourse.org/u/Moin)
#### Post date: [9 Julho , 2025 17:32 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/462 "2025-07-09T17:32:38Z")

</div>

> [@alltiagocom](#):
>
> Você sabe se é possível desativar o comportamento em que os subtítulos ficam ocultos quando o título pai não está “em foco”?  
> Gostaria que todos os títulos ficassem visíveis o tempo todo, caso contrário, parece que há menos conteúdo do que realmente existe.

> [@DiscoTOC - automatic table of contents](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/364?u=moin):
>
> If you prefer to have the table of content always fully expanded, try adding this CSS to your theme #d-toc li.d-toc-item \> ul { max-height: 500em !important; overflow: visible !important; opacity: 1 !important; }

---

<div class="post-metadata">

### Author: ![alltiagocom](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/alltiagocom/32/492709_2.png) [@alltiagocom](https://meta.discourse.org/u/alltiagocom)
#### Post date: [9 Julho , 2025 18:03 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/463 "2025-07-09T18:03:33Z")

</div>

Obrigado e desculpe por não ter percebido isso…

Funciona perfeitamente! Realmente aprecio seu tempo e ajuda! 🙌

---

<div class="post-metadata">

### Author: ![alltiagocom](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/alltiagocom/32/492709_2.png) [@alltiagocom](https://meta.discourse.org/u/alltiagocom)
#### Post date: [9 Julho , 2025 18:44 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/464 "2025-07-09T18:44:26Z")

</div>

Tudo está funcionando, mas:

1. No celular, não vejo o botão “Table of Contents” como mostrado nas instruções:

 ![image](https://global.discourse-cdn.com/meta/original/4X/d/2/2/d22cebbf41ff6f890a70f4ca5bc91aa988286ed4.png)

1. A única maneira de vê-lo é adicionando pelo menos um comentário/resposta (eu esperaria que ele aparecesse mesmo que nenhuma resposta fosse adicionada?), mas mesmo assim, o que é mostrado não é o mesmo que na imagem:

 ![IMG_1642](https://global.discourse-cdn.com/meta/original/4X/d/7/2/d724bfd0f16bbd622e6ddfb0a42ea0aa3c824d81.jpeg)

É possível fazer com que ele mostre “Table of Contents”, não apenas o ícone? Estou pensando que talvez seja possível via CSS, mas estava me perguntando se isso é um novo “recurso” ou algo mais que posso mudar para mostrar o texto?

Eu até tentei mudar o texto padrão, caso esse fosse o problema, mas sem sucesso:

![image](https://global.discourse-cdn.com/meta/original/4X/6/c/0/6c081b8cf2c75f197dbbfbba92b2d8d2c4c7a4cf.png)

* * *

EDIT: Consegui adicionar o texto via CSS em um componente personalizado, mas ainda estou me perguntando se isso é um bug ou algo mais?

```css
@media screen and (max-width: 767px) {
  .d-toc-mini button::after {
    content: "Table of Contents";
    margin-left: 5px;
    font-size: 14px;
    vertical-align: middle;
  }
}

```

E eu ainda não descobri o problema de ele só ficar visível na parte inferior (em vez de “fixo”) quando não há respostas.

---

<div class="post-metadata">

### Author: ![Moin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/moin/32/554653_2.png) [@Moin](https://meta.discourse.org/u/Moin)
#### Post date: [9 Julho , 2025 20:19 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/465 "2025-07-09T20:19:10Z")

</div>

> [@alltiagocom](#):
>
> mas eu estava me perguntando se esta é uma nova “funcionalidade”

As capturas de tela na primeira postagem são bem antigas. Você não encontrará nelas nenhuma informação sobre o botão que permite alternar entre linha do tempo e sumário quando há mais de uma postagem, ou informações sobre a funcionalidade de sumário para respostas.

O problema com o botão ausente no celular foi relatado aqui:

> [@DiscoTOC style is broken if there is no reply on mobile](https://meta.discourse.org/t/discotoc-style-is-broken-if-there-is-no-reply-on-mobile/353845?u=moin):
>
> Hello wave DiscoTOC style is connected to the .with-topic-progress class which is added to .topic-navigation if there are more than 1 post in the topic. So without reply the DiscoTOC style will broke. I think TOC should also be active if there is no reply in a topic because it doesn’t related with the reply counts. On desktop it works fine topics with no reply too. Here is a topic for testing: [Customizing the topic list](https://meta.discourse.org/t/customizing-the-topic-list/350411) I think that would be consider to change this behaviour. It’s probabl…

Talvez você também queira apoiar este pedido de funcionalidade: [Fully expand table of content](https://meta.discourse.org/t/fully-expand-table-of-content/270661?u=moin), se preferir suporte oficial em vez de CSS personalizado.

---

<div class="post-metadata">

### Author: ![alltiagocom](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/alltiagocom/32/492709_2.png) [@alltiagocom](https://meta.discourse.org/u/alltiagocom)
#### Post date: [9 Julho , 2025 22:30 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/466 "2025-07-09T22:30:55Z")

</div>

Consegui fazer funcionar quando não há resposta:

> [@DiscoTOC style is broken if there is no reply on mobile](https://meta.discourse.org/t/discotoc-style-is-broken-if-there-is-no-reply-on-mobile/353845/3?u=alltiagocom):
>
> With my basic coding skills and some ChatGPT talk, I made it work, I believe. Created a custom component and put this in the CSS tab: @media (max-width: 767px) { #topic-progress-wrapper.sticky-bottom { position: fixed; bottom: 0; left: 0; right: 0; z-index: 1000; } } and this in the JS tab import { apiInitializer } from "discourse/lib/api"; export default apiInitializer((api) =\> { api.onPageChange(() =\> { const observer = new MutationObs…

Acabei de adicionar meu feedback naquele tópico. Obrigado.

---

<div class="post-metadata">

### Author: ![alltiagocom](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/alltiagocom/32/492709_2.png) [@alltiagocom](https://meta.discourse.org/u/alltiagocom)
#### Post date: [16 Julho , 2025 15:31 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/467 "2025-07-16T15:31:44Z")

</div>

Notei que algo está quebrado.  
No celular, o painel do TOC não desliza sobre o tópico. Ele é adicionado na parte inferior:

 ![image](https://global.discourse-cdn.com/meta/original/4X/2/1/f/21f705c1828bcd2100be4b2e25f874c809022210.png)

Pensei que poderia ser um problema com qualquer um dos outros componentes, mas os desativei todos e deixei apenas este.

* * *

EDIT: Notei que este problema só é visível se o tópico não tiver respostas. Adicionei uma resposta de teste e agora está funcionando. Mesmo um simples Deslistar \> Listar, funcionará:

![image](https://global.discourse-cdn.com/meta/original/4X/6/e/e/6ee317d1e72c889f7e869d3b34979b78383d26f0.png)

Bug…?

---

<div class="post-metadata">

### Author: ![murphyke](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/murphyke/32/184302_2.png) [@murphyke](https://meta.discourse.org/u/murphyke)
#### Post date: [12 Setembro , 2025 19:18 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/468 "2025-09-12T19:18:15Z")

</div>

Instalei o componente de tema DiscoTOC 2.1.0, mas a opção para gerar um TOC não está aparecendo sob o “+” no diálogo do compositor. Estou no Discourse 3.6.0.beta1-dev. No menu “+”, vejo Citar postagem inteira, Inserir tabela, Ocultar detalhes, Inserir data/hora, Adicionar nota de rodapé, Criar enquete e Borrar spoiler.

Existem outros cenários de “não funcionará com”? Este site tem o componente de tema “Custom Header Links” e vários plugins.

Até agora, tentei em uma postagem de tópico wiki e em uma postagem de tópico não wiki.

Documento de teste:

```plaintext
# Título principal

## Título de segundo nível

## Outro título de segundo nível

### Uau, um título de terceiro nível

## Mais um título de segundo nível

```

---

<div class="post-metadata">

### Author: ![Moin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/moin/32/554653_2.png) [@Moin](https://meta.discourse.org/u/Moin)
#### Post date: [12 Setembro , 2025 19:44 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/469 "2025-09-12T19:44:00Z")

</div>

Acho que você adicionou o componente ao seu tema e já tentou atualizar o site no navegador depois disso (menciono isso porque às vezes me esqueço).

Você tentou o botão de pré-visualização do tema? Isso pode ser útil para verificar um conflito com outro componente (embora eu ache improvável)

 ![Screenshot_20250912_213328_Firefox](https://global.discourse-cdn.com/meta/original/4X/7/c/1/7c174ad0af37138bd41dba7c3f00e8160689bb06.jpeg)

Você também pode tentar adicionar manualmente o texto que o botão no menu do compositor adiciona à postagem

```plaintext

<div data-theme-toc="true"> </div>

```

 ![Screenshot_20250912_213958_Firefox](https://global.discourse-cdn.com/meta/original/4X/a/6/3/a6313429ff99e41544127c44efaf55e7e6d83892.jpeg)  
Isso funciona?

---

<div class="post-metadata">

### Author: ![murphyke](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/murphyke/32/184302_2.png) [@murphyke](https://meta.discourse.org/u/murphyke)
#### Post date: [12 Setembro , 2025 20:26 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/470 "2025-09-12T20:26:34Z")

</div>

Muito obrigado por dedicar tanto tempo à sua resposta! Peço desculpas, mas o problema é comigo e com a Apple. Estou usando o Safari em um novo Mac, e o menu “+” quando abre _contém_ a opção de TOC, mas ela não está visível na lista, e o menu não exibe as barras de rolagem que eu possa ver (e elas não aparecem a menos que você role). O alinhamento vertical do conteúdo aconteceu de ser perfeito, como se contivesse N-1 itens em vez de N. Grrrr. Finalmente percebi quando tentei isso no Chrome, e por acaso o item N-1 foi cortado ao meio, então eu rolei…

---

<div class="post-metadata">

### Author: ![Moin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/moin/32/554653_2.png) [@Moin](https://meta.discourse.org/u/Moin)
#### Post date: [12 Setembro , 2025 20:31 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/471 "2025-09-12T20:31:09Z")

</div>

Fico feliz que você tenha encontrado. Eu realmente tive problemas semelhantes uma vez: [Last item of reply composer gear menu inaccessible](https://meta.discourse.org/t/last-item-of-reply-composer-gear-menu-inaccessible/294826?u=moin) Eu não tentei há muito tempo para ver se está melhor agora.

---

<div class="post-metadata">

### Author: ![putty](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/putty/32/370902_2.png) [@putty](https://meta.discourse.org/u/putty)
#### Post date: [4 Novembro , 2025 17:49 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/472 "2025-11-04T17:49:34Z")

</div>

PSA, estou recebendo isso no meu log do console:

 ![CleanShot 2025-11-04 at 12.48.57](https://global.discourse-cdn.com/meta/original/4X/0/a/a/0aa24e17a4974a6c060f48f00db19b257de96ce3.png)

---

<div class="post-metadata">

### Author: ![awesomerobot](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/awesomerobot/32/142900_2.png) [@awesomerobot](https://meta.discourse.org/u/awesomerobot)
#### Post date: [4 Novembro , 2025 18:50 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/473 "2025-11-04T18:50:55Z")

</div>

Obrigado por relatar! Teremos uma atualização pronta hoje

---

<div class="post-metadata">

### Author: ![RBoy](https://avatars.discourse-cdn.com/v4/letter/r/2bfe46/32.png) [@RBoy](https://meta.discourse.org/u/RBoy)
#### Post date: [21 Novembro , 2025 01:00 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/474 "2025-11-21T01:00:56Z")

</div>

Tenho visto este aviso nos logs após atualizar para a versão mais recente do Discourse na semana passada

> Mensagem
> 
> O tema/componente DiscoTOC está gerando erros:  
> TypeError: Falha ao buscar módulo importado dinamicamente: [https://ccc.xxx.com/theme-javascripts/fb8891ef8c38dab255d356c75588ff25d4a97805.js?\_\_ws=ccc.xxx.com](https://ccc.xxx.com/theme-javascripts/fb8891ef8c38dab255d356c75588ff25d4a97805.js?__ws=ccc.xxx.com)
> 
> Backtrace
> 
> TypeError: Falha ao buscar módulo importado dinamicamente: [https://ccc.xxx.com/theme-javascripts/fb8891ef8c38dab255d356c75588ff25d4a97805.js?\_\_ws=ccc.xxx.com](https://ccc.xxx.com/theme-javascripts/fb8891ef8c38dab255d356c75588ff25d4a97805.js?__ws=ccc.xxx.com)
> 
> Env

---

<div class="post-metadata">

### Author: ![Lilly](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/lilly/32/575047_2.png) [@Lilly](https://meta.discourse.org/u/Lilly)
#### Post date: [21 Novembro , 2025 01:05 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/475 "2025-11-21T01:05:28Z")

</div>

Seus componentes Discourse e TOC estão ambos atualizados? Não consigo reproduzir esses erros?

---

<div class="post-metadata">

### Author: ![RBoy](https://avatars.discourse-cdn.com/v4/letter/r/2bfe46/32.png) [@RBoy](https://meta.discourse.org/u/RBoy)
#### Post date: [21 Novembro , 2025 06:05 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/476 "2025-11-21T06:05:09Z")

</div>

Sim, o Discourse está atualizado a partir de 11 de novembro e os componentes também estão atualizados. Estou vendo um erro semelhante para outro componente também

> Mensagem
> 
> O tema/componente Discourse Top Contributors Sidebar está gerando erros:  
> TypeError: Falha ao buscar módulo importado dinamicamente: [https://ccc.xxx.com/theme-javascripts/ddc9fd1b23f86d280ce4a9dbefc40b751d5fb8b4.js?\_\_ws=ccc.xxx.com](https://ccc.xxx.com/theme-javascripts/ddc9fd1b23f86d280ce4a9dbefc40b751d5fb8b4.js?__ws=ccc.xxx.com)

---

<div class="post-metadata">

### Author: ![JBM](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jbm/32/279154_2.png) [@JBM](https://meta.discourse.org/u/JBM)
#### Post date: [25 Novembro , 2025 10:40 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/477 "2025-11-25T10:40:15Z")

</div>

![IMG_0446](https://global.discourse-cdn.com/meta/original/4X/5/b/8/5b857cfb2ed6ba84d9b239745130f91280a2b059.jpeg)

Olá!

Uma pergunta rápida aqui e desculpe pelo (provavelmente) problema já reportado; eu não encontrei onde.

Parece que há um problema de exibição com o (ótimo) tema horizon (captura de tela aqui no meta, com iOS em tela vertical). Isso está registrado para algum lançamento futuro?

Obrigado 🙏.

---

<div class="post-metadata">

### Author: ![Moin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/moin/32/554653_2.png) [@Moin](https://meta.discourse.org/u/Moin)
#### Post date: [25 Novembro , 2025 10:43 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/478 "2025-11-25T10:43:56Z")

</div>

> [@JBM](#):
>
> Isso está registrado para algum lançamento futuro?

Sim, há um tópico sobre isso:  
[https://meta.discourse.org/t/opening-toc-on-ipad-in-portrait-causes-toc-to-overlay-text-with-no-background/387532](https://meta.discourse.org/t/opening-toc-on-ipad-in-portrait-causes-toc-to-overlay-text-with-no-background/387532)

---

<div class="post-metadata">

### Author: ![JBM](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jbm/32/279154_2.png) [@JBM](https://meta.discourse.org/u/JBM)
#### Post date: [25 Novembro , 2025 10:47 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/479 "2025-11-25T10:47:54Z")

</div>

Ótimo. Obrigado pela resposta rápida.

---

<div class="post-metadata">

### Author: ![dax](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/dax/32/244677_2.png) [@dax](https://meta.discourse.org/u/dax)
#### Post date: [25 Novembro , 2025 15:48 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/480 "2025-11-25T15:48:30Z")

</div>

> [@RBoy](#):
>
> Mensagem
> 
> O tema/componente da Barra Lateral dos Principais Contribuidores do Discourse está gerando erros:  
> TypeError: Falha ao buscar módulo importado dinamicamente: [https://ccc.xxx.com/theme-javascripts/ddc9fd1b23f86d280ce4a9dbefc40b751d5fb8b4.js?\_\_ws=ccc.xxx.com](https://ccc.xxx.com/theme-javascripts/ddc9fd1b23f86d280ce4a9dbefc40b751d5fb8b4.js?__ws=ccc.xxx.com)

Esses erros não afetam o Discourse em si. Eles se originam do lado do cliente, provavelmente causados por usuários com conexões instáveis, bloqueadores de anúncios ou outras extensões de navegador interferindo. @david acabou de enviar um PR para suprimir esses avisos, pois eles são essencialmente inevitáveis, decorrentes de fatores externos e não de algo dentro do Discourse.

> <https://github.com/discourse/discourse/pull/36222>
>
> In our experience, this is creating a significant amount of un-actionable noise …in the logs. Themes can fail to boot for all sorts of client-caused reasons, like a poor network connection, adblocker, unsupported browser, etc.
> 
> Logging those to Logster is not helpful, and only leads to confusion for admins and hosting providers.

---

<div class="post-metadata">

### Author: ![bck055](https://avatars.discourse-cdn.com/v4/letter/b/22d042/32.png) [@bck055](https://meta.discourse.org/u/bck055)
#### Post date: [11 Dezembro , 2025 03:23 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/481 "2025-12-11T03:23:30Z")

</div>

Olá,

Você poderia me ajudar a ligar a caixa de visualização como na sua foto?

[Página anterior](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143.md?page=6)

[Próxima página](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143.md?page=8)
