Skip to content

Formulaires dans les overlays et import de dossier ​

Les corrections M41 à M44 relevées par DevHub sont implémentées dans les sources SIA UI et préparées pour la prochaine release. Elles concernent les composants npm et leurs copies installées par la CLI, depuis une source unique.

Sélecteur dans un tiroir ou une modale ​

Un Select utilise Overlay pour placer sa liste dans document.body. Sa position dans le DOM ne suffit donc pas à déterminer s'il appartient au tiroir. Le runtime conserve désormais cette appartenance par contexte React, à travers les portails. La pile ordonne aussi les modales, tiroirs et panneaux flottants.

Il n'est plus nécessaire de désactiver closeOnOutsideClick pour choisir une option dans un Drawer. Un clic extérieur ferme d'abord le panneau flottant. Échap ferme le sélecteur et rend le focus à son déclencheur ; un second Échap peut fermer le dialogue. Les overlays doivent utiliser la même instance de @sia-ui/react et de @sia-ui/headless.

Le runtime exporte useOverlayLayer, OverlayScope et useOverlayScrollLock pour les compositions d'overlays. useOverlayLayer prend open, kind et elementRef ; il rend layer, zIndex, isTop et contains. Placer OverlayScope layer={layer} autour des descendants et appliquer zIndex au conteneur portalisé. contains inclut les panneaux descendants, isTop limite les demandes de fermeture au premier plan. Le hook ne remplace pas une gestion du clavier et du focus adaptée au composant.

Focus des formulaires contrôlés ​

Modal initialise le focus à l'ouverture et le restitue à la fermeture. Changer un callback inline onOpenChange pendant une frappe ne relance plus ce cycle. Échap utilise toujours la dernière version du callback. La tâche de focus différée est annulée à la fermeture. Tab et Maj+Tab restent dans la modale active. Le verrou de défilement est partagé entre les dialogues : il est libéré quand le dernier verrou actif est retiré.

Valeurs des cartes mobiles ​

Les titres et les valeurs des cartes DataTable reviennent à la ligne par défaut, y compris les libellés interactifs. column.truncate: true demande explicitement une seule ligne avec ellipse, dans le tableau et les cartes. Éviter cette option pour les instructions et les actions longues. Une cellule personnalisée imposant elle-même une largeur fixe ou nowrap reste sous la responsabilité de l'application.

Import de dossier ​

tsx
import { useState } from "react";
import { FileUpload, type FileUploadEntry } from "@sia-ui/react-web";

function ImportProject() {
  const [entries, setEntries] = useState<FileUploadEntry[]>([]);
  return (
    <FileUpload
      directory
      maxFiles={500}
      maxFileSize={10 * 1024 * 1024}
      maxTotalSize={25 * 1024 * 1024}
      maxDepth={12}
      onEntriesChange={setEntries}
    />
  );
}

onEntriesChange reçoit des { file, relativePath }, avec la racine conservée, par exemple mon-projet/src/index.ts. La sélection native et le dépôt récursif produisent le même contrat, trié par chemin. onFilesChange reste disponible et reçoit uniquement les File ; les chemins du dépôt ne sont pas injectés dans File.webkitRelativePath. Utiliser onEntriesChange pour les dossiers.

Le dépôt parcourt tous les lots de l'API Entries, y compris ceux au-delà du premier lot du navigateur. Les limites sont vérifiées avant émission ; une erreur ne remplace pas la sélection précédente par des résultats partiels. onReadError reçoit une FileUploadReadError avec un code stable. Le message visible et les libellés viennent de la locale française ou anglaise.

En mode dossier, les défauts sont 1000 fichiers, 100 Mio cumulés et 20 niveaux de dossiers. maxFileSize est facultatif. En mode fichiers, les limites de nombre et de taille ne s'appliquent que si elles sont renseignées ; multiple={false} refuse plusieurs fichiers déposés. La lecture est asynchrone dans les deux modes.

Pendant le parcours, un état annoncé et un bouton « Annuler la lecture » sont affichés. Une nouvelle sélection, la désactivation ou le démontage annule la lecture précédente ; ses réponses tardives sont ignorées. Choisir à nouveau le même dossier est possible.

Le choix natif utilise webkitdirectory et le dépôt utilise l'API Entries du navigateur. Si le dépôt de dossier n'est pas pris en charge, un message demande d'utiliser le bouton de sélection ; aucun aplatissement silencieux n'est fait. Les dossiers vides ne sont pas représentés. accept reste une indication pour le sélecteur natif, pas une validation serveur. Les chemins, exclusions métier, contenus et tailles doivent être revérifiés par l'API qui reçoit l'import. Aucun fichier n'est envoyé automatiquement.

Mettre à jour DevHub après la release ​

Mettre à jour les paquets de fondations puis les entrées overlay, drawer, modal, data-table et file-upload avec la CLI. Comparer les fichiers retouchés avant de les remplacer. Retirer ensuite les contournements M41, M42 et M43, et migrer l'import natif M44 vers le contrat onEntriesChange si souhaité. Ces migrations dans DevHub ne sont pas incluses dans cette modification SIA UI.

Les stories SelectPortalisé, FormulaireContrôlé, CartesMultilignes et Dossier permettent de vérifier les comportements en situation.

Publié sous licence MIT.