Web Share API et partage déclenché par la personne
Concevoir le partage Web autour d’une action explicite, de cibles variables, d’échecs compréhensibles et de solutions accessibles.
Vous voulez la documentation structurée pour Plateforme ?
Cet article fait partie de la bibliothèque éditoriale. Pour les étapes de configuration, la référence et les mises à jour continues, passez directement à la section docs.
La Web Share API permet de demander au navigateur de remettre un contenu choisi à une interface de partage du système ou du navigateur. Il s’agit d’un transfert contrôlé par la personne : aucune cible ni réussite finale n’est garantie. Utilisez un bouton visible, validez les données et gardez une solution pour copier le lien ou télécharger le contenu.
La spécification W3C Web Share définit le modèle et ses exigences de sécurité. Le guide MDN, navigator.share() et navigator.canShare() documentent l’API et ses limites de compatibilité. Consultez aussi les limites des permissions et les workflows respectueux de la confidentialité.
Une action explicite
Les navigateurs peuvent exiger une activation temporaire de la personne. N’ouvrez donc pas la feuille au chargement, au survol ou après un délai. Vérifiez navigator.share et laissez la solution de repli disponible. Un contexte sécurisé est nécessaire, mais la politique du navigateur peut encore refuser l’opération.
canShare() vérifie une proposition sans garantir une cible ni une livraison. share() peut rejeter la promesse après une annulation, des données invalides ou une impossibilité du navigateur. Conservez le formulaire, la route et le focus; l’annulation n’est pas une perte de la tâche.
Données et confidentialité
Construisez le titre, le texte, l’URL et les fichiers à partir du contenu visible. N’ajoutez pas d’identifiants, de notes privées, de jetons ou de métadonnées cachées. Une URL privée doit garder ses contrôles d’accès. N’envoyez pas le contenu des charges utiles aux statistiques par défaut.
Une solution de repli accessible
Proposez de copier un lien, de télécharger une exportation ou d’afficher un lien normal. Chaque action doit avoir un libellé visible et être utilisable au clavier. Signalez le résultat sans supposer l’accès au presse-papiers. Testez le clic, le clavier, l’annulation, les données refusées, l’API absente et le contexte non sécurisé. Mesurez seulement un résultat agrégé comme shared, cancelled ou fallback-used.
Le bouton explique ce qui sera partagé.
L’action commence par un choix explicite.
La page conserve le formulaire.
L’annulation n’efface aucune donnée.
Le contexte sécurisé limite la portée.
La compatibilité peut varier.
L’URL canonique évite un état temporaire.
Les liens privés gardent leurs autorisations.
Les secrets ne figurent pas dans l’URL.
Les fichiers ont un nom et un format visibles.
La copie du lien offre une sortie locale.
Le téléchargement décrit son contenu.
Le focus revient au contrôle initiateur.
L’état est annoncé par un message bref.
Aucun nouvel essai n’est lancé automatiquement.
La cible décide ce qu’elle accepte.
La page ne promet pas la livraison.
La disponibilité n’identifie pas la personne.
Les statistiques utilisent des résultats agrégés.
Le contenu privé reste hors des journaux.
La solution fonctionne sans l’API.
Le clavier atteint toutes les actions.
Le design supporte le zoom et le texte agrandi.
Les traductions longues sont testées.
Le texte bidirectionnel garde son ordre.
Le mode hors ligne conserve le contexte.
Une exportation peut attendre.
Chaque erreur propose l’étape suivante.
Un lien ordinaire reste disponible.
L’autorisation est vérifiée côté serveur.
Le partage ne modifie pas les droits.
Un composant intégré respecte sa limite.
L’hôte peut choisir une autre solution.
Les tests vérifient des résultats visibles.
La feuille du navigateur est externe.
La documentation évite les promesses universelles.
La revue accompagne chaque changement.
La continuité compte plus que l’interface.
L’action reste volontaire.
La solution de repli fait partie de la fonction.
Le parcours reste compréhensible quand le partage est indisponible.
La personne peut continuer sa tâche sans perdre son contexte.
Liste pratique
Sources
Articles Connexes
Faites passer BotBrowser de la recherche à la production
Utilisez ces guides pour comprendre le modèle, puis passez à la validation multi-plateforme, aux contextes isolés et au déploiement navigateur prêt pour l'échelle.