react-navigation / react-navigation/react-navigation.github.io
Docs: `overrideScrollViewContentInsetAdjustmentBehavior` option missing from Native Bottom Tab Navigator page
Ninguém assumiu esta issue ainda.
- Linguagem predominante
- JavaScript
- Estrelas
- 324
- Forks
- 2k
- Métricas de merge de PRs
- Nenhum PR com merge em 30d
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
contentInsetAdjustmentBehaviorof the firstScrollViewin the first descendant chain from the tab screen.By default,
react-native'sScrollViewhascontentInsetAdjustmentBehaviorset toneverinstead of UIKit-default (which isautomatic). This prevents ScrollViews from respecting navigation bar insets. When this prop is set totrue,automaticbehavior is reverted.To disable this behavior for specific screens, set this option to
false.Only supported with
nativeimplementation.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.
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.
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.
Avaliação
- Stack de tecnologia
- react-native
- Domínio
- documentation
- Tipo de issue
- Documentação
- Dificuldade
- 1/5
- Tempo estimado
- Menos de uma hora
- Status de atividade
- Pouca atividade
- Clareza
- Claramente especificada
- Facilidade para iniciantes
- 90/100