BottomSheet mobile : présentation et mouvement
Disponible pour la prochaine publication
La feuille SIA va désormais bord à bord sur téléphone : aucune marge horizontale ou inférieure extérieure en mode normal. Les coins supérieurs sont arrondis, le bas rejoint l’écran et les zones sûres protègent le contenu et les actions à l’intérieur de la feuille. Sur grand écran, sa largeur est bornée à 640 unités par défaut, pour garder le contenu lisible.
La barre de prise se trouve à 8 unités du bord supérieur de la surface, sans padding supplémentaire au-dessus. Sa zone de geste est élargie autour de la barre ; le titre et le bouton de fermeture restent séparés de cette zone. Le titre et la description occupent un en-tête fixe ; le contenu défile et le pied d’actions reste visible. Le bouton Fermer est circulaire avec l’icône SIA. Les couleurs suivent le thème clair/sombre.
Présentation
<BottomSheet
open={open}
onOpenChange={setOpen}
title="Choisir une ressource"
description="Confirmez la sélection pour continuer."
snapPoints={['45%', '70%', '95%']}
defaultIndex={1}
footer={<ResourceActions />}
>
<ResourceOptions />
</BottomSheet>| Prop | Effet |
|---|---|
variant="edge" | Défaut : largeur disponible, bord inférieur au bord de l’écran ; largeur bornée sur grand écran. |
variant="floating" | Marges extérieures de 12 et coins inférieurs arrondis ; option explicite. |
cornerRadius | Arrondi de la surface, 28 par défaut. |
maxWidth | Largeur maximale, 640 par défaut, minimum 240. |
showHandle | Affiche/masque la poignée ; par défaut visible si le geste est disponible. |
colors.background, border, handle, backdrop | Surcharges de la surface, séparation, poignée et masque. |
headerStyle, contentContainerStyle, footerStyle | Styles des trois zones sans reconstruire le moteur de feuille. |
density="compact" | Espacements latéraux réduits pour les éditeurs compacts, sans reculer la poignée. |
La description est rendue une seule fois, dans l’en-tête. Sur une petite position ou pendant la saisie, l’en-tête se compacte et la description laisse la place au contenu ; elle réapparaît à l’agrandissement. Sur un clavier très contraint, la poignée par défaut s’efface temporairement (showHandle=true peut l’imposer). footer accepte le contenu de l’application et reçoit un cadre séparé avec la protection de la zone système basse. Sans pied, cette protection est ajoutée au contenu. Quand le clavier apparaît, la protection inférieure de l’écran n’est pas ajoutée une seconde fois au-dessus du clavier. Le mode flottant protège les zones sûres à l’extérieur et ne les ajoute pas une seconde fois à l’intérieur.
Animation
<BottomSheet
open={open}
onOpenChange={setOpen}
title="Options"
animation={{ type: 'spring', damping: 28, stiffness: 300, mass: 1,
exitDuration: 160 }}
/>Par défaut, l’ouverture utilise un ressort amorti et la fermeture une transition plus courte. La feuille glisse depuis sa hauteur réelle : elle n’attend pas de parcourir tout l’écran avant d’apparaître. Le masque s’anime avec elle, tandis que la surface garde son opacité. Le ressort est borné pour ne pas découvrir une fente sous la feuille lors d’un dépassement.
animation.type:spring(défaut),timing,none.damping,stiffness,massrèglent le ressort.durationrègle l’ouverture temporelle ;exitDurationrègle la fermeture.animationDurationconserve la durée historique des positions en mode timing. Quand elle est seule fournie, le mode timing est conservé pour compatibilité.animation={{ type: 'none' }}et la préférence système de mouvement réduit suppriment les animations d’ouverture, fermeture et retour aux positions.
À la fermeture, la hauteur réellement atteinte est conservée jusqu’à la sortie, sans retour à la hauteur initiale. Sur Android, le fond de la feuille peut aussi s’étendre derrière la barre système basse, tandis que les actions restent protégées par leurs marges sûres internes.
Le doigt garde le contrôle pendant le glissement ; le ressort intervient au relâchement pour rejoindre une position ou revenir en place. L’ouverture et le retour en translation utilisent le pilote natif ; le redimensionnement en hauteur utilise le pilote JavaScript, sans ajout de dépendance native.
Les modales centrées conservent leur présentation et leur transition temporelle. Les positions, gestes, fermeture par Retour Android, adaptation au clavier et rendus contenant une FlatList restent pris en charge.
Démonstration et validation
Composants → Feuilles et gestes propose les modes bord à bord/flottant et les animations ressort/temporelle/aucune. L’exemple inclut une recherche, une sélection en liste virtualisée et un pied Annuler/Confirmer. Les trois positions permettent de vérifier la poignée et le suivi du doigt.
Les contrôles automatisés couvrent les marges, la position de la poignée, les zones sûres, les styles, les moteurs d’animation et le mouvement réduit. Le clavier système et les gestes réels restent à confirmer dans Expo Go.