
BrowserUX Share Button
Une solution moderne pour permettre le partage de contenu fluide sur tous les appareils et plateformes.
BrowserUX Share Button est un Web Component léger, accessible et personnalisable, conçu pour simplifier le partage de liens grâce à l’API Web Share native, lorsqu’elle est disponible, ou via une modale fallback élégante et responsive. Il prend en charge plusieurs plateformes (Email, X, WhatsApp, etc.), détecte automatiquement les métadonnées à partager et offre une localisation complète, une personnalisation visuelle et une compatibilité avec tous les frameworks.
Télécharger v1.0.3
HTML pur, React, Vue ou Angular
Voir le CHANGELOG
npm install browserux-share-button
Fonctionnalités
-
🎛 Comportement de partage intelligent
-
Prise en charge de l'API Web Share native
Utilise la méthodenavigator.share()
lorsqu'elle est disponible, idéale pour les contextes mobiles et PWA -
Fallback automatique
Replie vers une interface modale moderne et tactile lorsque le partage natif n'est pas pris en charge -
Détection automatique des métadonnées
Lit automatiquement les métadonnées de partagetitle
,text
eturl
via les attributs HTML, le document, ou le manifeste web -
Partage multi-plateformes
Prend en charge Email, SMS, X (Twitter), Facebook, WhatsApp, LinkedIn, Telegram et Reddit -
Désactivation par plateforme
Désactivez une ou plusieurs plateformes via des attributs commefacebook="false"
ousms="false"
-
Prise en charge de l'API Web Share native
-
🔧 Expérience développeur
-
Shadow DOM optionnel (
no-shadow
)
Rendu en Shadow DOM par défaut ; option de le désactiver pour un style global plus flexible -
Compatible avec tous les frameworks
Fonctionne avec tous les frameworks frontend (React, Vue, Angular) ou en HTML pur -
Léger et optimisé pour le tree-shaking
Zéro dépendance. Importe uniquement ce dont vous avez besoin, avec types TypeScript inclus -
Modulaire et typé
Écrit en TypeScript avec enumsSharePlatform
typés et utilitaires exportables (getShareIcon
,getBestIconUrl
)
-
Shadow DOM optionnel (
-
♿ Accessibilité & internationalisation
-
Accessibilité clavier et ARIA
Modale accessible avec rôles ARIA, piège au focus, et navigation clavier (Escape, Tab, Shift+Tab) -
Support multilingue (
lang
)
Interface et labels ARIA localisés, détectés automatiquement ou définis manuellement via l'attributlang
) -
Retours visuels et auditifs
Messages personnalisés pour les succès/erreurs de copie, erreurs de partage ou problèmes d'initialisation
-
Accessibilité clavier et ARIA
-
🎨 Personnalisation visuelle
-
Variables CSS pour le style
Personnalisez le bouton et la modale via des propriétés CSS (--bux-share-btn-*
,--bux-share-fallback-*
, etc.). -
Contenu personnalisable via slot
Ajoutez votre propre icône ou libellé dans le bouton principal avecslot name="icon"
-
Animation adaptée au mobile
Fallback mobile avec effet de glissement vers le haut et possibilité de fermeture par balayage
-
Variables CSS pour le style