Integrar una calculadora
Integre cualquiera de las 255 calculadoras de rftools.io en sus propias páginas, gratis. Funciona dentro de un marco, con un tamaño fijo o tan alta como su contenido, con sus colores y en cualquiera de siete idiomas. Los fabricantes pueden añadir una clave para precargar los valores de sus propios componentes.
Generador de fragmentos de código
Elija una calculadora y su aspecto, y copie el fragmento. Solo se escriben en él los valores que la integración acepta. Gratis en todos los planes.
Colores, esquinas y fuente
<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>La integración está regulada por la sección 5 de los Condiciones de uso.
El widget compacto
Con un tamaño, o con solo resultados, una integración dibuja el widget compacto: las entradas, los resultados principales y un enlace a la calculadora completa. Así se ve la calculadora Calculadora de Presupuesto de Enlace RF en la página de otra persona.
Dos formas de integrar
Ambas ofrecen la misma calculadora dentro de un marco servido por rftools.io, y a ambas se aplican las mismas reglas que siguen.
El fragmento script inserta el marco y cambia su tamaño a medida que la calculadora crece o se reduce. Su enlace permanece en su página: es la atribución y lo que ven sus visitantes si la calculadora no puede cargarse.
El fragmento iframe no necesita ningún script en su página. Su altura es fija, así que indique una que se ajuste a la calculadora.
<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>El cargador es /embed.js. Solo construye el marco: no hace ninguna comprobación de su página, porque una comprobación que se ejecuta en su página no sería fiable.
Parámetros
Añádalos a la dirección del marco (/embed/microstrip-impedance/?e_theme=light) o, en el fragmento script, como atributos data- sin el e_ (data-theme="light"). Todos los parámetros de la integración empiezan por e_, así que ninguno puede coincidir con una entrada de la calculadora.
Un valor que no se ajusta exactamente a su formato se ignora (nunca se pasa a un estilo) y se aplica en su lugar el predeterminado de la clave o el del sitio. Un valor en la dirección prevalece sobre el predeterminado de la clave, que prevalece sobre el del sitio.
Una integración es clara salvo que e_theme=dark, e_theme=match o su clave indiquen otra cosa. Nunca se usa el tema de rftools.io del propio visitante.
Las entradas de la calculadora también se pueden preestablecer por nombre: ?traceWidth=0.8 en la calculadora Calculadora de Impedancia Microstrip la inicia en 0.8 mm. Una entrada indicada así prevalece sobre el ajuste preestablecido de una clave. En el fragmento script, los valores iniciales van en data-inputs="traceWidth=0.8".
| Parámetro | Valores | Efecto | Predeterminado de la clave |
|---|---|---|---|
| e_key | ek_ y 16 letras minúsculas o dígitos | Aplica los ajustes preestablecidos, el tema y el idioma predeterminados de la clave, y atribuye a la clave las visualizaciones y los cálculos. | — |
| e_via | iframe o script | Cómo se colocó la integración. Lo fija el cargador del script; se registra con cada evento. | lo fija el cargador |
| e_size | compact (360 × 480), standard (640 × 360) o full (a todo el ancho, tan alto como su contenido) | Dibuja la integración como el widget compacto con ese tamaño: un encabezado, las entradas, los resultados principales y «Abrir la calculadora completa». Sin él (y sin e_show), la integración es la tarjeta completa de la calculadora, como antes. | — |
| e_show | results | Oculta las entradas y muestra solo los resultados. Los valores iniciales siguen viniendo de la dirección y de la clave. Dibuja el widget compacto, a todo el ancho salvo que e_size fije un tamaño. | — |
| e_theme | light, dark o match; predeterminado light | Aspecto claro u oscuro dentro del marco. match sigue a la página anfitriona: el fragmento script lee los colores de la propia página y, dentro de un marco, sigue la configuración clara u oscura del sistema del visitante. Sin él, el predeterminado de la clave o, si no, claro. Nunca se usa el tema de rftools.io del propio visitante. | theme |
| e_accent | seis dígitos hexadecimales, sin # | Color de acento: botones, anillos de foco y resaltados, más un tono derivado. | accent |
| e_bg | seis dígitos hexadecimales, sin # | Fondo del marco y de sus tarjetas. | bg |
| e_fg | seis dígitos hexadecimales, sin # | Color del texto. | fg |
| e_border | seis dígitos hexadecimales, sin # | Color del borde. | border |
| e_radius | un número entero de 0 a 24 | Radio de las esquinas de la tarjeta y de las entradas, en píxeles. | radius |
| e_font | system o inter | Fuente: la fuente del sistema del visitante, o Inter. | font |
| e_preset | el id de uno de los ajustes preestablecidos de la clave | Parte de ese ajuste preestablecido en lugar del primero de la clave. Los valores de entrada explícitos siguen prevaleciendo. | — |
| e_lang | en, es, de, fr, ja, ko, pt | El idioma de la calculadora: etiquetas, título y los textos propios de la integración. Los valores desconocidos se ignoran. | lang |
Claves y ajustes preestablecidos
Una clave vincula una integración con su organización. Contiene el nombre de su organización, los sitios que pueden mostrarla, los valores predeterminados de tema, un idioma predeterminado y ajustes preestablecidos: conjuntos con nombre de valores de entrada, como sus laminados o componentes, para cada calculadora. Una clave es un identificador público, no un secreto: está en el código fuente de su página. Lo que la protege es la lista de dominios permitidos que se describe abajo.
Una integración con clave muestra sus ajustes preestablecidos con sus etiquetas y parte del primero, o del que indique e_preset. Las entradas indicadas explícitamente en la dirección siguen prevaleciendo, de modo que ?e_key=…&traceWidth=0.3 mantiene su laminado y fija la pista.
Para solicitar una clave, escriba a contact@rftools.io con el nombre de su organización, todos los sitios en los que funcionará la integración (incluido el de pruebas) y los ajustes preestablecidos que quiera. Indique los orígenes como https://www.example.com; los subdominios de todo un dominio se pueden indicar como https://*.example.com. Las claves las emite rftools.io; añadir, cambiar o revocar una es un despliegue, que tarda unos minutos.
Qué hace la lista de dominios permitidos y qué no hace
La lista de dominios permitidos la aplican los navegadores de sus visitantes, no la integración ni nuestro script. Protege el uso de su clave: sus ajustes preestablecidos, su tema y los recuentos atribuidos aparecen solo en sus páginas. No es un control de acceso a la calculadora.
Se aplica
Una integración con clave solo se muestra en sus páginas.
Cuando una integración lleva su clave, rftools.io indica al navegador del visitante qué sitios pueden mostrarla en un marco: exactamente los orígenes registrados para su clave. En cualquier otro sitio el navegador no muestra nada, y el fragmento script muestra entonces su enlace.
Una clave revocada o desconocida no se muestra en ningún sitio.
El marco se rechaza en todas partes a partir de la siguiente carga de página tras desplegarse el cambio. Las copias ya abiertas en una pestaña no se ven afectadas.
El resto de rftools.io no se puede mostrar en un marco.
Cualquier otra página, incluida esta, solo puede mostrarla en un marco el propio rftools.io.
No se impide
No se impiden las integraciones sin clave.
Cualquiera puede integrar cualquier calculadora sin clave, en cualquier sitio. Es deliberado: es la integración gratuita. Una integración sin clave muestra los valores predeterminados de la calculadora, sin sus ajustes preestablecidos ni sus valores predeterminados de tema.
No se impiden las copias del código de la página.
El HTML de la integración es público. Cualquiera puede descargarlo, copiarlo o servirlo desde su propio servidor, y la lista de dominios permitidos no puede verlo. Usar su clave de ese modo incumple los términos, pero ningún encabezado puede impedirlo.
No se impiden las analíticas falsificadas.
Nada autentica un evento de analítica. Cualquiera puede enviar uno que nombre cualquier clave o cualquier sitio. Los recuentos que comunicamos son recuentos, no pruebas.
Atribución
Toda integración muestra «Con la tecnología de rftools.io», en su idioma, con un enlace a la página de la calculadora (etiquetado con utm_source=embed). Ningún parámetro ni ninguna configuración de clave lo elimina, y no existe una versión de marca blanca.
Los Condiciones de uso establecen como condiciones de la integración mantener la atribución y usar solo una clave emitida para usted.
Qué registra una integración
Una integración registra dos eventos: embed_view una vez por carga, y embed_calculate cada vez que un visitante calcula con valores nuevos (como máximo diez por minuto). Ambos indican la clave (o ninguna), la calculadora, el origen del sitio que la integra tal como lo comunica el navegador, y si se colocó mediante iframe o script.
Se envían a Google Analytics y a los registros propios de rftools.io, que los conservan durante 90 días sin dirección de red y sin cuenta, de modo que los recuentos de una clave resisten a las cookies bloqueadas y a la analítica bloqueada. Google Analytics se ejecuta en el marco con su configuración de cookies predeterminada, que los navegadores rechazan dentro de un marco en otro sitio, por lo que normalmente no registra nada allí; los recuentos por clave son los registros propios de rftools.io. Las vistas previas de esta página no registran nada.
Nada más del sitio se ejecuta en una integración: ni publicidad, ni grabación de sesiones, ni asistente de IA, ni controles para iniciar sesión, guardar o compartir. Consulte la Política de privacidad y la Política de cookies.