Docs: `overrideScrollViewContentInsetAdjustmentBehavior` option missing from Native Bottom Tab Navigator page

Aberta Para iniciantes

#1,491 aberta em 17/5/2026 0 comentários 0 reações 0 responsáveis Ver no GitHub

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade: 1/5
Tempo estimado: Menos de uma hora
Facilidade para iniciantes: 90/100

Tipo de issue: Documentação
Clareza: Claramente especificada
Status de atividade: Pouca atividade
Stack de tecnologia: react-native
Domínio: documentation

Direção de pesquisa

Abra docs/native-bottom-tab-navigator.md e leia a seção Options em torno de tabBarStyle e tabBarMinimizeBehavior. Verifique o JSDoc da opção em packages/bottom-tabs/src/unstable/types.tsx e documente seu valor padrão, as limitações iOS-only e native-only e o sintoma de um espaço vazio com um cabeçalho transparente. A tarefa estará concluída quando os leitores puderem encontrar e entender essa opção na página Native Bottom Tab Navigator.

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

Descrição

The Tab.Screen option overrideScrollViewContentInsetAdjustmentBehavior is implemented and exposed in @react-navigation/bottom-tabs/unstable but not listed on the Native Bottom Tab Navigator docs page.

It's an iOS-only option with non-obvious default behaviour, and it's the only escape hatch for a fairly common visible bug — a blank gap appearing above content in a native-stack screen with headerTransparent: true nested inside a NativeTabs tab. The bug was reported in #12946 and the fix is exactly this option, but a reader hitting the symptom has no way to discover it from the docs.

JSDoc from the source

Whether to override the contentInsetAdjustmentBehavior of the first ScrollView in the first descendant chain from the tab screen.

By default, react-native's ScrollView has contentInsetAdjustmentBehavior set to never instead of UIKit-default (which is automatic). This prevents ScrollViews from respecting navigation bar insets. When this prop is set to true, automatic behavior is reverted.

To disable this behavior for specific screens, set this option to false.

Only supported with native implementation.

Defaults to true. iOS-only.

Suggested doc placement

Under "Options" on docs/native-bottom-tab-navigator.md, next to tabBarStyle / tabBarMinimizeBehavior (other iOS-flavoured presentation options). A brief mention of the symptom it fixes ("blank gap above content in a nested transparent-header screen on iOS") would help a lot.

Happy to PR if useful — just want to flag the gap before the next person hits it.

Linguagem predominante: JavaScript
Estrelas: 324
Forks: 2k
Métricas de merge de PRs: Nenhum PR com merge em 30d

Guia de contribuição

Nenhum guia de contribuição indexado para este repositório

Primeiros passos

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