Intégrer un calculateur
Intégrez gratuitement n'importe lequel des 255 calculateurs de rftools.io à vos propres pages. Il s'affiche dans un cadre, à une taille fixe ou aussi haut que son contenu, dans vos couleurs et dans l'une des sept langues. Les fabricants peuvent ajouter une clé pour précharger les valeurs de leurs propres composants.
Générateur d'extraits de code
Choisissez un calculateur et son apparence, puis copiez un extrait. Seules les valeurs que l'intégration accepte y sont écrites. Gratuit dans toutes les offres.
Couleurs, coins et police
<iframe src="https://rftools.io/embed/microstrip-impedance/"
title="Microstrip Impedance Calculator - rftools.io"
width="100%" height="640" style="border:0" loading="lazy"></iframe><div data-rftools-embed data-calculator="microstrip-impedance">
<a href="https://rftools.io/calculators/rf/microstrip-impedance/">Microstrip Impedance Calculator</a> on rftools.io
</div>
<script src="https://rftools.io/embed.js" async></script>L'intégration est régie par la section 5 des Conditions d'utilisation.
Le widget compact
Avec une taille, ou avec les résultats seuls, une intégration affiche le widget compact : les entrées, les principaux résultats et un lien vers le calculateur complet. Voici le calculateur Calculateur de budget RF Link tel qu'il apparaît sur la page de quelqu'un d'autre.
Deux façons d'intégrer
Les deux donnent le même calculateur dans un cadre servi par rftools.io, et les deux sont soumises aux mêmes règles ci-dessous.
L'extrait script insère le cadre et le redimensionne à mesure que le calculateur s'agrandit ou se réduit. Son lien reste dans votre page : c'est l'attribution, et ce que voient vos visiteurs si le calculateur ne peut pas se charger.
L'extrait iframe ne nécessite aucun script dans votre page. Sa hauteur est fixe : indiquez-en une qui convient au calculateur.
<div data-rftools-embed data-calculator="microstrip-impedance">
<a href="https://rftools.io/calculators/rf/microstrip-impedance/">Microstrip Impedance Calculator</a> on rftools.io
</div>
<script src="https://rftools.io/embed.js" async></script><iframe src="https://rftools.io/embed/microstrip-impedance/"
title="Microstrip Impedance Calculator - rftools.io"
width="100%" height="640" style="border:0" loading="lazy"></iframe>Le chargeur est /embed.js. Il ne fait que construire le cadre : il ne vérifie rien sur votre page, car une vérification exécutée sur votre page ne serait pas fiable.
Paramètres
Ajoutez-les à l'adresse du cadre (/embed/microstrip-impedance/?e_theme=light), ou, sur l'extrait script, comme attributs data- sans le e_ (data-theme="light"). Tous les paramètres d'intégration commencent par e_, si bien qu'aucun ne peut entrer en conflit avec une entrée du calculateur.
Une valeur qui ne respecte pas exactement son format est ignorée (jamais transmise à un style), et la valeur par défaut de la clé ou du site s'applique à la place. Une valeur dans l'adresse l'emporte sur la valeur par défaut de la clé, qui l'emporte sur celle du site.
Une intégration est claire sauf si e_theme=dark, e_theme=match ou votre clé en décident autrement. Le thème rftools.io du visiteur n'est jamais utilisé.
Les entrées du calculateur peuvent aussi être prédéfinies par leur nom : ?traceWidth=0.8 sur le calculateur Calculateur d'impédance Microruban le fait démarrer à 0.8 mm. Une entrée donnée ainsi l'emporte sur le préréglage d'une clé. Sur l'extrait script, les valeurs de départ se placent dans data-inputs="traceWidth=0.8".
| Paramètre | Valeurs | Effet | Valeur par défaut de la clé |
|---|---|---|---|
| e_key | ek_ et 16 lettres minuscules ou chiffres | Applique les préréglages, le thème et la langue par défaut de la clé, et attribue à la clé les affichages et les calculs. | — |
| e_via | iframe ou script | Comment l'intégration a été placée. Défini par le chargeur du script ; enregistré avec chaque événement. | défini par le chargeur |
| e_size | compact (360 × 480), standard (640 × 360) ou full (pleine largeur, aussi haut que son contenu) | Affiche l'intégration comme le widget compact à cette taille : un en-tête, les entrées, les principaux résultats et « Ouvrir le calculateur complet ». Sans lui (et sans e_show), l'intégration est la carte complète du calculateur, comme avant. | — |
| e_show | results | Masque les entrées et n'affiche que les résultats. Les valeurs de départ viennent toujours de l'adresse et de la clé. Affiche le widget compact, en pleine largeur sauf si e_size fixe une taille. | — |
| e_theme | light, dark ou match ; par défaut light | Apparence claire ou sombre dans le cadre. match suit la page hôte : l'extrait script lit les couleurs de la page elle-même et, dans un cadre, suit le réglage clair ou sombre du système du visiteur. Sans lui, la valeur par défaut de la clé, sinon clair. Le thème rftools.io du visiteur n'est jamais utilisé. | theme |
| e_accent | six chiffres hexadécimaux, sans # | Couleur d'accent : boutons, anneaux de focus et mises en évidence, plus une teinte dérivée. | accent |
| e_bg | six chiffres hexadécimaux, sans # | Fond du cadre et de ses cartes. | bg |
| e_fg | six chiffres hexadécimaux, sans # | Couleur du texte. | fg |
| e_border | six chiffres hexadécimaux, sans # | Couleur des bordures. | border |
| e_radius | un nombre entier de 0 à 24 | Rayon des coins de la carte et des entrées, en pixels. | radius |
| e_font | system ou inter | Police : la police système du visiteur, ou Inter. | font |
| e_preset | l'id de l'un des préréglages de la clé | Part de ce préréglage au lieu du premier de la clé. Les valeurs d'entrée explicites l'emportent toujours. | — |
| e_lang | en, es, de, fr, ja, ko, pt | La langue du calculateur : libellés, titre et textes propres à l'intégration. Les valeurs inconnues sont ignorées. | lang |
Clés et préréglages
Une clé relie une intégration à votre organisation. Elle contient le nom de votre organisation, les sites autorisés à l'afficher, des réglages de thème par défaut, une langue par défaut et des préréglages : des ensembles nommés de valeurs d'entrée, comme vos stratifiés ou vos composants, pour chaque calculateur. Une clé est un identifiant public, pas un secret : elle figure dans le code source de votre page. Ce qui la protège, c'est la liste d'autorisation décrite ci-dessous.
Une intégration avec clé présente vos préréglages sous vos libellés et part du premier, ou de celui que désigne e_preset. Les entrées données explicitement dans l'adresse l'emportent toujours : ?e_key=…&traceWidth=0.3 conserve votre stratifié et fixe la piste.
Pour demander une clé, écrivez à contact@rftools.io en indiquant le nom de votre organisation, chaque site sur lequel l'intégration fonctionnera (préproduction comprise) et vos éventuels préréglages. Indiquez les origines sous la forme https://www.example.com ; tous les sous-domaines d'un domaine peuvent être indiqués sous la forme https://*.example.com. Les clés sont délivrées par rftools.io ; en ajouter, en modifier ou en révoquer une est un déploiement, qui prend quelques minutes.
Ce que fait la liste d'autorisation des domaines, et ce qu'elle ne fait pas
La liste d'autorisation est appliquée par les navigateurs de vos visiteurs, et non par l'intégration ni par notre script. Elle protège l'usage de votre clé : vos préréglages, votre thème et les comptages attribués n'apparaissent que sur vos pages. Ce n'est pas un contrôle d'accès au calculateur.
Appliqué
Une intégration avec clé ne s'affiche que sur vos pages.
Lorsqu'une intégration porte votre clé, rftools.io indique au navigateur du visiteur quels sites peuvent l'afficher dans un cadre : exactement les origines enregistrées pour votre clé. Sur tout autre site, le navigateur n'affiche rien ; l'extrait script affiche alors son lien.
Une clé révoquée ou inconnue ne s'affiche nulle part.
Le cadre est refusé partout, dès le chargement de page qui suit le déploiement du changement. Les copies déjà ouvertes dans un onglet ne sont pas concernées.
Le reste de rftools.io ne peut pas être affiché dans un cadre.
Toute autre page, celle-ci comprise, ne peut être affichée dans un cadre que par rftools.io lui-même.
Non bloqué
Les intégrations sans clé ne sont pas empêchées.
N'importe qui peut intégrer n'importe quel calculateur sans clé, sur n'importe quel site. C'est voulu : c'est l'intégration gratuite. Une intégration sans clé affiche les valeurs par défaut du calculateur, sans vos préréglages ni vos réglages de thème par défaut.
Les copies du code de la page ne sont pas empêchées.
Le HTML de l'intégration est public. N'importe qui peut le récupérer, le copier ou le servir depuis son propre serveur, et la liste d'autorisation ne peut pas le voir. Utiliser votre clé de cette façon enfreint les conditions, mais aucun en-tête ne peut l'empêcher.
Les statistiques falsifiées ne sont pas empêchées.
Rien n'authentifie un événement de mesure d'audience. N'importe qui peut en envoyer un indiquant n'importe quelle clé ou n'importe quel site. Les comptages que nous communiquons sont des comptages, pas des preuves.
Attribution
Chaque intégration affiche « Propulsé par rftools.io », dans sa langue, avec un lien vers la page du calculateur (marqué utm_source=embed). Aucun paramètre ni aucun réglage de clé ne le supprime, et il n'existe pas de version en marque blanche.
Les Conditions d'utilisation posent comme conditions de l'intégration le maintien de l'attribution et l'utilisation exclusive d'une clé qui vous a été délivrée.
Ce qu'enregistre une intégration
Une intégration enregistre deux événements : embed_view une fois par chargement, et embed_calculate chaque fois qu'un visiteur calcule avec de nouvelles valeurs (au plus dix par minute). Les deux indiquent la clé (ou aucune), le calculateur, l'origine du site intégrant telle que le navigateur la communique, et si l'intégration a été placée par iframe ou par script.
Ils sont envoyés à Google Analytics et aux propres registres de rftools.io, qui les conservent 90 jours sans adresse réseau et sans compte, de sorte que les comptages d'une clé résistent aux cookies bloqués et à la mesure d'audience bloquée. Google Analytics fonctionne dans le cadre avec ses réglages de cookies par défaut, que les navigateurs refusent dans un cadre sur un autre site ; il n'y enregistre donc généralement rien, et les comptages par clé sont les propres registres de rftools.io. Les aperçus de cette page n'enregistrent rien.
Rien d'autre du site ne fonctionne dans une intégration : ni publicité, ni enregistrement de session, ni assistant IA, ni commandes de connexion, d'enregistrement ou de partage. Consultez la Politique de confidentialité et la Politique en matière de cookies.