Dates, heures, documents et images sur mobile
Ce lot ajoute Calendar, DatePicker, DateRangePicker, TimePicker, DateTimePicker, FileUpload, ImageUpload et NativeFilePickerProvider au paquet natif. Les pages /forms/dates et /forms/files permettent de les essayer dans la démo Expo.
Valeurs explicites
| Composant | Valeur contrôlée | Usage |
|---|---|---|
| Calendar / DatePicker | YYYY-MM-DD ou chaîne vide | Jour civil : naissance, réservation, échéance. |
| DateRangePicker | { start, end }, mêmes dates civiles | Séjour ou période ; début puis fin, remise au début si le second choix est antérieur. |
| TimePicker | HH:mm ou chaîne vide | Heure du jour ; affichage 12/24 h configurable sans changer la valeur. |
| DateTimePicker | YYYY-MM-DDTHH:mm ou chaîne vide | Rendez-vous local ; l’application choisit explicitement son fuseau métier. |
Une date civile n’est jamais parsée comme un timestamp UTC. Les dates impossibles sont rejetées ; les bornes doivent être valides et ordonnées. Ces valeurs ne représentent pas un instant universel. La conversion de fuseau, les heures ambiguës ou inexistantes lors d’un changement d’heure restent à traiter par l’application. Aucun fuseau n’est deviné.
Le calendrier propose navigation mensuelle, choix rapide de l’année, premier jour de semaine, locale Intl, jours indisponibles, sélection et période. Les jours sont annoncés avec leur date et leur état. Les bornes et isDateDisabled portent sur les jours sélectionnables ; pour une période, les extrémités sont validées, pas la réservation métier de chaque jour intérieur. Le passage de mois apparaît en fondu configurable via animation et defaults.calendar, avec priorité au mouvement réduit.
Les sélecteurs gardent un brouillon dans une feuille. Confirmer applique le choix ; Fermer ou Retour conserve la valeur précédente. Désactiver le contrôle ferme la feuille. clearable, readOnly, disabled, trois apparences et trois tailles suivent le langage des autres champs. La feuille reprend les animations et les zones sûres communes. Le calendrier est construit avec les primitives SIA natives, indépendamment des styles de sélecteurs propres à chaque système.
<DatePicker label="Jour" value={day} onValueChange={setDay}
minDate="2026-11-01" maxDate="2026-12-31" clearable />
<TimePicker label="Heure" value={time} onValueChange={setTime}
minTime="08:00" maxTime="18:00" minuteStep={15} />Le pas des minutes configure les choix proposés ; une minute préexistante hors du pas reste conservée, sans arrondi silencieux. Le changement d’heure retient une minute autorisée. Les bornes de DateTimePicker s’appliquent aussi à l’heure sur les jours limites. Le formatage suit locale et hour12.
Un adaptateur pour les capacités du système
Le cœur SIA ne charge aucun module Expo. Fournir un NativeFilePickerAdapter au provider, ou un picker propre au champ. La démo utilise les modules officiels expo-document-picker et expo-image-picker, aux versions compatibles déterminées par le SDK Expo installé. Une application React Native sans Expo peut fournir son propre adaptateur avec le même contrat.
<NativeFilePickerProvider adapter={mySystemPicker}>
<FileUpload label="Justificatifs" value={files} onValueChange={setFiles}
multiple maxFiles={3} maxSize={5 * 1024 * 1024}
accept={['application/pdf']} />
<ImageUpload label="Photos" value={photos} onValueChange={setPhotos}
allowCamera previewSize={112} />
</NativeFilePickerProvider>Un asset contient uri, name, et si connues size, mimeType, width, height. L’adaptateur reçoit le type de sélection, la source, les filtres, le mode multiple et un AbortSignal ; il renvoie les assets ou null pour une annulation. Une erreur reste réessayable sans afficher son détail technique. L’annulation SIA invalide le résultat ; elle ne garantit pas la fermeture d’un sélecteur système déjà ouvert.
La démo demande l’autorisation caméra seulement après un appui sur Prendre une photo. La photothèque utilise le sélecteur système d’images sans demander d’accès complet préalable. Les messages de permissions des applications compilées sont configurés dans app.json. Expo Go utilise ses propres permissions : la sélection, le refus et la réactivation doivent être essayés sur téléphone. Les APIs web nécessitent un geste utilisateur et dépendent des capacités du navigateur.
Les images ont un aperçu ; les documents affichent nom et taille. Le retrait est explicite. La lecture seule conserve la consultation. Une requête est verrouillée pendant son exécution ; les doublons d’URI et résultats tardifs après annulation, désactivation ou démontage sont ignorés. Plusieurs fichiers sont ajoutés dans la limite configurée ; un choix unique remplace la sélection existante.
accept reconnaît MIME exact, familles MIME et extensions. maxSize est en octets ; si cette limite est configurée, une taille inconnue est refusée plutôt que supposée valide. validate(asset) ajoute une règle et onRejected reçoit les refus. Les messages sont personnalisables via messages. Les métadonnées et contrôles clients ne remplacent pas la vérification des contenus côté serveur. Les URIs de cache ne constituent pas un stockage durable : l’application organise copie et nettoyage.
Non livré par ce lot : transfert réseau automatique, progression d’envoi, compression/recadrage, lecture du contenu des documents et import récursif de dossier.
Formulaires et démonstration
Form/Field prennent en charge les types date, dateRange, dateTime, time, file et image. Les options passent dans dateOptions ou fileOptions. Les règles locales valident formats, bornes, périodes et pièces ; un tableau de fichiers vide ou une période entièrement vide est vide pour required. Le validateur reste configurable par l’application. Les références des déclencheurs permettent le focus sur les champs invalides.
La page Dates et heures présente les trois apparences, tailles, bornes, erreurs, lecture seule, désactivation, format 12 h, calendrier autonome et formulaire. Documents et images propose sélection multiple, caméra, aperçu, refus simulé, limites, mêmes variantes et pièce requise dans un formulaire. Les sélections restent locales et aucun envoi serveur n’est simulé comme réel.
Les tests couvrent les contrats de date, le brouillon, les contraintes, les règles déclaratives, l’annulation, les doublons et les permissions simulées. Les exports compilent Android/iOS/web. Restant à confirmer sur téléphone : sélection système, permissions réelles, caméra, accessibilité, tailles de texte et interactions entre feuilles imbriquées et clavier.
Les modales isolent le contexte de défilement de la page située derrière elles : une recherche dans un sélecteur imbriqué ne déplace pas le formulaire extérieur. Un formulaire placé dans la modale possède son propre contexte.
Actions fixes et rouleaux de l’heure
Dans les sélecteurs de date, période et rendez-vous, Aujourd’hui et Confirmer sont placés dans le pied fixe, hors du contenu défilant. Aujourd’hui respecte les bornes et les jours indisponibles et ne valide pas le brouillon automatiquement. Calendar conserve son bouton autonome ; showToday={false} permet de le retirer.
L’heure utilise désormais des colonnes tactiles qui défilent et s’alignent sur une valeur centrale. Heures et minutes sont côte à côte ; le format 12 h ajoute une colonne AM/PM. Le contrat HH:mm reste sur 24 h. Confirmer attend l’arrêt des rouleaux pour ne pas enregistrer une valeur antérieure à celle affichée. Le passage sur une valeur bloquée s’aligne sur une valeur autorisée ; le changement d’heure conserve si possible la minute courante. Une minute préexistante hors du pas est conservée dans la liste pendant l’édition afin de ne pas déplacer les lignes en plein geste.
loop (défaut true) permet l’enroulement ; les copies sont recentrées après arrêt sans saut visuel. visibleRows accepte 3 ou 5 ; en l’absence de prop, un écran bas utilise trois lignes. Les colonnes sont ajustables avec lecteur d’écran et les flèches Haut/Bas dans l’aperçu web. Le mouvement réduit retire les changements d’échelle et les déplacements automatiques animés. La démo expose les modes compact/cyclique et les pas 1, 5, 15 et 30 minutes.
Les tests couvrent l’alignement, le passage cyclique, les bornes, AM/PM et la conservation du brouillon. La sensation des gestes et l’inertie restent à valider sur Android/iOS réels.
Afficher un mois entier dans un espace limité
Les sélecteurs de date et de période n’imbriquent plus le calendrier dans une ScrollView. Leur feuille compacte est plafonnée sur les grands écrans, puis réduite à la hauteur sûre disponible sur les petits écrans. Le mois et le choix de l’année partagent le même en-tête ; les jours de semaine et toutes les rangées du mois, y compris une sixième semaine, restent dans la zone mesurée. Aujourd’hui et Confirmer sont toujours en dehors de cette grille. Le choix de l’année reste recherchable dans sa feuille dédiée.
Calendar conserve sa présentation autonome par défaut. compact intègre le choix de l’année à l’en-tête ; availableHeight répartit la place restante entre les rangées. L’en-tête, les jours de semaine et les actions sont mesurés avant le calcul. Les jours restent à 44 unités lorsqu’il y a assez de place ; la grille réduit leur hauteur dans une zone plus courte. Le texte numérique est ajusté à la cellule et son agrandissement est borné pour éviter une découpe. Les dates complètes et les états sélectionné/désactivé restent accessibles. Le comportement n’ajoute aucun défilement interne au calendrier.
Le rendez-vous présente deux vues Date et Heure, au lieu d’empiler les éditeurs. Le brouillon vit dans le sélecteur et conserve les choix lors des changements de vue. Aujourd’hui ramène sur Date. La vue Heure utilise trois lignes lorsque la hauteur du panneau ne permet pas cinq lignes. Fermer conserve la valeur initiale ; Confirmer applique ensemble date et heure.
Les briques communes ajoutent density="compact" à Modal/BottomSheet, fill aux TabsContent et labelHidden aux sélections. Le libellé masqué reste le nom du contrôle et du dialogue ; une accessibilityValue explicite est respectée lorsque le rendu de valeur est personnalisé. La poignée conserve une zone tactile de 48 unités avec son débordement tactile ; les boutons gardent leur taille habituelle. Les réglages par défaut des autres modales, panneaux et sélections sont conservés.