Widget Indicatifs.com
Un petit widget intégrable pour orienter les utilisateurs vers la recherche d’indicatif.
Widget de recherche
Le widget Indicatifs.com permet d’ajouter un lien de recherche d’indicatif sur un site tiers. Il reste volontairement simple et renvoie vers le moteur principal.
<script src="https://www.indicatifs.com/widget.js" async></script>Utilisation recommandée
- Afficher le widget près d’un champ téléphone international.
- Conserver le lien de crédit vers Indicatifs.com.
- Ne pas l’utiliser comme annuaire inversé nominatif.
Le widget renvoie vers le moteur complet. Pour une intégration serveur, préférez la documentation de l’API, le lookup ou la méthode de formatage.
Fonctionnement et confidentialité
Le widget recherche dans la même base publique que le site. La saisie est traitée localement et sert uniquement à proposer une fiche pays ou une page de code. Il n’identifie pas l’abonné et ne doit pas recevoir de donnée confidentielle.
Pour intégrer la base dans un autre projet, préférez les exports JSON ou CSV versionnés. Un lien visible vers la fiche source permet au lecteur de vérifier la date et les limites.
Ressources développeur
Bonnes pratiques d’intégration
Affichez un libellé expliquant que le résultat concerne l’indicatif et non le propriétaire du numéro. Ne préremplissez pas le widget avec des coordonnées personnelles et ne conservez pas les saisies. Testez l’intégration au clavier et sur mobile, puis gardez le script asynchrone pour ne pas bloquer le rendu de la page hôte.
Intégration responsable du widget
Le widget peut être ajouté à une page éditoriale ou à un intranet pour proposer une recherche rapide. Il charge la base publiée par Indicatifs.com et renvoie vers la fiche canonique afin que l’utilisateur puisse lire la source, la date et les limites.
Évitez de présenter le résultat comme un annuaire inversé. Le libellé doit parler de pays, de zone ou de catégorie, jamais du propriétaire supposé du numéro. Une intégration correcte conserve aussi le lien vers la méthodologie.
Performance et confidentialité
Le traitement de recherche est réalisé côté navigateur à partir de données statiques. L’intégrateur reste responsable de sa politique de sécurité, de son consentement pour d’éventuels services tiers et de la mise à jour du script lorsqu’une nouvelle version est publiée.
Test avant publication
Vérifiez le widget avec +33, +212, +1 212, +800, +888 et une valeur inconnue. Le résultat doit rester lisible au clavier et sur mobile, ne pas ouvrir automatiquement une page et afficher une erreur claire lorsque le code n’existe pas.
Ne modifiez pas les URL canoniques renvoyées : elles assurent la cohérence entre l’outil, le sitemap et les données structurées.
Intégration accessible et résiliente
Le formulaire doit fonctionner au clavier, annoncer le résultat et conserver la saisie après une erreur. Réservez l’espace du résultat pour éviter un saut visuel sur mobile.
| Succès | Code, type et lien canonique. |
| Ambiguïté | Toutes les destinations. |
| Échec réseau | Proposer de réessayer. |
| Inconnu | Aucune correspondance inventée. |
Sans JavaScript, une explication et un lien vers le moteur principal doivent rester disponibles.
États que le widget doit afficher
Le widget doit rendre visibles la saisie vide, l’absence de résultat, le code partagé et l’échec de chargement des données. Aucun de ces états ne doit laisser un ancien résultat à l’écran.
Le lien vers la fiche canonique reste accessible au clavier et sur mobile.
Respect de la page hôte
Le widget ne doit ni modifier les titres de la page hôte, ni injecter de lien caché, ni charger de publicité. Son rôle est limité à la recherche et au renvoi explicite vers la fiche canonique choisie par l’utilisateur. Les styles doivent rester encapsulés pour éviter les conflits.
Sources complémentaires : Métadonnées techniques libphonenumber. Ces références sont utilisées selon leur périmètre respectif.
Référence officielle : liste officielle UIT des indicatifs E.164, pour l’attribution des codes internationaux. Consultation éditoriale : 26 août 2026.
Intégration robuste et accessible
Le widget doit rester un raccourci vers la source, pas une copie silencieuse de la base. Affichez un intitulé compréhensible, laissez le lien utilisable au clavier et prévoyez un texte de remplacement si le script ne charge pas.
| Contrôle | Résultat attendu |
|---|---|
| JavaScript désactivé | Un lien vers Indicatifs.com reste visible |
| Navigation clavier | Focus identifiable et action déclenchable |
| Petit écran | Pas de débordement horizontal |
| Cache | Version du script maîtrisée lors d’une mise à jour |
Ne présentez pas le widget comme un validateur d’identité : il aide à rechercher un indicatif et renvoie vers la fiche qui en expose les limites.