Actions et sélection avancée mobiles
Le socle expérimental natif ajoute Popover, DropdownMenu, ContextMenu, Tree, TreeSelect et BulkActionBar. ResourceList accepte une sélection contrôlée, une barre fixe de sélection et des actions par ligne. Les API utilisent les primitives natives, les palettes SIA et les règles de permissions injectées.
Menus et popovers
<DropdownMenu label="Actions" can={access.can} items={[
{ key: 'view', label: 'Consulter', onSelect: openDetail },
{ key: 'delete', label: 'Supprimer', permission: 'contacts.delete', danger: true,
confirmation: { title: 'Supprimer ce contact ?', description: 'Action définitive.' },
onSelect: deleteContact },
]} />Les entrées acceptent description, icône, état coché, désactivation, danger et permission. Les séparateurs et titres de groupe sont des entrées avec type. Une permission déclarée sans can est refusée ; le droit est revérifié avant l'exécution. La source/API doit également autoriser chaque écriture.
Le menu attend la promesse de onSelect, bloque les doubles appuis et la fermeture pendant l'opération, puis se ferme en cas de réussite. En cas d'échec, il reste ouvert et montre un message générique : toucher de nouveau l'action pour réessayer. Une confirmation déclarée s'affiche dans la même surface, afin d'éviter deux modales natives en transition. danger colore l'action ; déclarer explicitement confirmation pour demander cette étape.
ContextMenu propose l'appui long et un bouton alternatif. trigger permet un rendu personnalisé dans DropdownMenu ; utiliser le ref d'ancrage et transmettre show/disabled. open/onOpenChange rendent l'ouverture contrôlable. accessibilityLabel peut nommer précisément le déclencheur sans allonger son texte.
presentation="auto" emploie une feuille sous 640 unités et un panneau ancré au-delà. sheet et popover forcent la préférence ; sans ancre mesurable, une feuille reste le repli. Le panneau est borné au viewport et aux zones sûres, passe au-dessus de l'ancre si nécessaire et se remesure au redimensionnement. Le contenu long défile. Retour Android, Échap sur web et appui extérieur ferment la surface si elle est refermable. Le panneau ancré se ferme à l'ouverture du clavier : pour un formulaire contenant du texte, choisir la feuille, qui réutilise la gestion du clavier existante. Aucun survol n'est nécessaire pour accéder aux actions.
Les transitions d’entrée du panneau acceptent animation (duration, easing, disabled), la feuille réutilise sa transition et sa durée ; le mouvement réduit reste prioritaire. Les defaults du provider utilisent popover, dropdownMenu, tree, treeSelect et bulkActionBar ; une prop explicite prime sur ces valeurs. Les essais tactiles, focus et lecteurs d’écran sur appareils restent nécessaires.
Arbre et sélection hiérarchique
const nodes = [{ key: 'region', label: 'Région', selectable: false, children: [
{ key: 'office', label: 'Bureau principal' },
] }];
<TreeSelect label="Bureau" nodes={nodes} value={office} onValueChange={setOffice} clearable />
<TreeSelect label="Bureaux" nodes={nodes} multiple value={offices}
onValueChange={setOffices} variant="filled" />Une clé doit être non vide et unique dans tout l'arbre. Les nœuds acceptent description, disabled, selectable et children. Un parent désactivé bloque ses descendants ; un parent selectable=false sert seulement de branche. L'expansion et la sélection sont des interactions séparées. La sélection multiple est indépendante par nœud, sans cascade implicite vers les enfants.
Tree anime l’apparition des lignes ; animation et le mouvement réduit contrôlent ce fondu sans ajouter de mesure de hauteur aux branches. Tree propose plain/outline, densités compact/comfortable, expansion contrôlée ou locale et recherche insensible aux accents. La recherche conserve les ancêtres et ouvre les chemins correspondants sans écraser l'expansion précédente. scrollable utilise FlatList pour les lignes visibles ; le mode normal compose l'arbre dans un conteneur déjà défilant. Ne pas imbriquer deux listes verticales virtualisées dans un ScrollView sur le même axe.
TreeSelect garde les modifications dans un brouillon. Valider applique la valeur ; Annuler, Retour et la fermeture la conservent. La recherche est intégrée à la même feuille. Le champ affiche le chemin des valeurs choisies. Les variantes outline/filled/underline, tailles sm/md/lg, erreur rouge, aide, désactivation, lecture seule, valeur contrôlée et remise à zéro sont disponibles. Les nœuds déjà sélectionnés devenus désactivés peuvent rester affichés ; ils ne deviennent pas nouvellement sélectionnables. Fournir l'arbre complet : le chargement de branches à distance n'est pas inclus.
Sélection et actions groupées
<ResourceList resource={resource} query={query} request={request}
selection={{ keys, onChange: setKeys, disabled: busy }}
renderRowActions={contact => <ContactActions contact={contact} />} />
<BulkActionBar selectedKeys={keys} onSelectionChange={setKeys} can={access.can}
scope={queryScope} onBusyChange={setBusy} onComplete={refresh}
actions={[{
key: 'delete', label: 'Supprimer', permission: 'contacts.delete', danger: true,
confirmation: { title: 'Supprimer la sélection ?' },
onRun: (ids, { signal }) => api.removeMany(ids, { signal }),
}]} />ResourceList place les cases et actions à côté du bouton d'ouverture, sans appuis imbriqués. La case de page gère l'état mixte et exclut isSelectable=false. Les clés viennent de la ressource, jamais de l'index. La sélection est contrôlée : l'application choisit sa portée et son maintien entre pages. selection.disabled bloque la sélection, la navigation des lignes et les commandes de requête pendant l'action. Les rendus personnalisés de ligne conservent cases et actions. Le slot selectionToolbar place la barre hors du défilement de la liste pour la garder accessible pendant la sélection.
onRun reçoit un instantané des clés dédupliquées et un AbortSignal. Il retourne { succeeded: ids, failed: [{ id }] } avec les mêmes types de clés que la sélection. Une résolution sans résultat signifie que tout a réussi. Les clés manquantes du résultat restent en échec ; les clés étrangères ou contradictoires sont rejetées. Seules les réussites sont retirées de la sélection. Aucun réessai automatique ne rejoue les opérations déjà réussies. Une exception globale conserve la sélection et masque le détail technique.
La permission et l'état désactivé sont revérifiés lors de la confirmation. scope change lors d'un changement de collection/compte/requête : la requête précédente est annulée et sa réponse tardive ne modifie pas la nouvelle sélection. L'application doit aussi vider ou remplacer les clés correspondantes. Une annulation n'annule pas rétroactivement une écriture reçue par un serveur ; prévoir l'idempotence et des résultats explicites côté API.
Démo et validation
Dans Composants → Actions et sélection, comparer menus automatiques/en feuille/ ancrés, action asynchrone avec échec, confirmation, appui long, arbre et champs hiérarchiques simples/multiples, variantes et états. La palette, le thème et les transitions du panneau se règlent dans Personnaliser.
Dans Contacts, les menus de ligne permettent consultation, modification, changement de statut et suppression confirmée selon les droits. En Administrateur :
- Cliquer Choisir plusieurs contacts, sélectionner des lignes ou la page.
- Activer/désactiver la sélection, puis vérifier les statuts et l'historique.
- Simuler un échec partiel dans Options de démonstration et relancer une action : seule la clé en échec reste sélectionnée et peut être réessayée.
- Annuler puis confirmer une suppression groupée ; vérifier le total et la page.
- Changer recherche, filtre ou page : la sélection est vidée. Elle porte seulement sur la page courante, jamais automatiquement sur toute la base.
- Filtrer l'organisation avec TreeSelect, puis se connecter en Membre : seules les actions de consultation sont accessibles, même en accès direct.
La source de démo persiste les réussites localement, sans API serveur. Restent prévus : chargement distant des branches, sélection en cascade, navigation d'arbre par toutes les touches de bureau, tableau multicolonne tablette et sélection globale de tous les résultats. Ce lot ne porte pas le composant Transfer du web.