[Site] Active section detection should respect scroll-margin-top

Aberta Para iniciantes
#65,384 1 comentário 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

@AdityaSrivastava185 já está trabalhando nisso.

Desde 21/11/2026.

  • #65387 de @AdityaSrivastava185 — aberto

Avaliação

Dificuldade
2/5
Tempo estimado
1-3 horas
Facilidade para iniciantes
65/100
Tipo de issue
Bug
Clareza
Razoavelmente clara
Status de atividade
Ativa
Stack de tecnologia
css, typescript

Direção de pesquisa

Comece localizando o componente que renderiza a lista "Contents" à direita e acompanha o heading ativo no site de docs; o payload não nomeia nenhum arquivo, então siga o caminho de renderização do sumário a partir da página Intro dos docs. Reproduza clicando em "Desktop", "Web" e "Docker" em uma página com seções curtas, depois inspecione como o heading ativo é escolhido em relação ao viewport e compare-o com o scroll-margin-top de cada heading. Pronto significa que a seção clicada fica destacada e seções curtas não fazem mais o próximo item ficar ativo.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

area/web reproduced type/bug
Description
Issue

On the docs Intro page, clicking an item in the right-hand "Contents" list
scrolls to that section, but the next item gets highlighted instead.

Example: clicking "Desktop" highlights "Web". Clicking "Web" highlights
"Docker". It happens where sections are short.

Currently, the active section is determined using the heading's position relative to the viewport. This can cause the sidebar to highlight a section at the wrong time, especially when headings have an offset for sticky headers.

Expected Behaviour

Active section detection should respect each heading's scroll-margin-top value so that the correct section is highlighted when the heading reaches its intended scroll position

Plugins

No response

OpenCode version

No response

Steps to reproduce
  1. Open any documentation page on the OpenCode website.
  2. Navigate through sections using the table of contents/sidebar.
  3. Click "Desktop" in the Contents list. .
  4. Observe that the active section in the sidebar may not update at the expected scroll position.
Screenshot
issue-01 issue-02
Operating System

macOS 26.5

Terminal

No response

Linguagem predominante
TypeScript
Estrelas
227k
Forks
30.7k
Merge médio
3h 57min
PRs com merge (30d)
484

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de anomalyco/opencode

Todas as issues de anomalyco/opencode

Issues semelhantes

Mais issues de TypeScript

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.