Incorporar uma calculadora
Incorpore gratuitamente qualquer uma das 255 calculadoras do rftools.io nas suas páginas. Ela roda em um frame, com tamanho fixo ou com a altura do seu conteúdo, nas suas cores e em qualquer um dos sete idiomas. Fabricantes podem adicionar uma chave para pré-carregar os valores das próprias peças.
Gerador de snippets
Escolha uma calculadora e a aparência dela e copie um snippet. Só os valores que a incorporação aceita são gravados nele. Grátis em todos os planos.
Cores, cantos e fonte
<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>A incorporação é regida pela seção 5 dos Termos de uso.
O widget compacto
Com um tamanho, ou só com resultados, uma incorporação desenha o widget compacto: as entradas, os principais resultados e um link para a calculadora completa. Veja a calculadora Calculadora de orçamento RF Link como ela aparece na página de outra pessoa.
Duas formas de incorporar
As duas oferecem a mesma calculadora em um frame servido pelo rftools.io, e as duas seguem as mesmas regras abaixo.
O snippet script insere o frame e o redimensiona conforme a calculadora cresce ou diminui. O link dele fica na sua página: é a atribuição e o que seus visitantes veem se a calculadora não carregar.
O snippet iframe não precisa de nenhum script na sua página. A altura é fixa, então defina uma em que a calculadora caiba.
<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>O carregador é /embed.js. Ele só monta o frame: não faz nenhuma verificação da sua página, porque uma verificação rodando na sua página não seria confiável.
Parâmetros
Adicione-os ao endereço do frame (/embed/microstrip-impedance/?e_theme=light) ou, no snippet script, como atributos data- sem o e_ (data-theme="light"). Todo parâmetro de incorporação começa com e_, então nenhum pode coincidir com uma entrada da calculadora.
Um valor que não corresponde exatamente ao formato é ignorado (nunca é passado para um estilo), e o padrão da chave ou do site é aplicado no lugar. Um valor no endereço prevalece sobre o padrão da chave, que prevalece sobre o do site.
Uma incorporação é clara, a menos que e_theme=dark, e_theme=match ou a sua chave digam outra coisa. O tema do rftools.io do próprio visitante nunca é usado.
As entradas da calculadora também podem ser predefinidas pelo nome: ?traceWidth=0.8 na calculadora Calculadora de impedância Microstrip faz com que ela comece em 0.8 mm. Uma entrada informada assim prevalece sobre a predefinição de uma chave. No snippet script, os valores iniciais vão em data-inputs="traceWidth=0.8".
| Parâmetro | Valores | Efeito | Padrão da chave |
|---|---|---|---|
| e_key | ek_ e 16 letras minúsculas ou dígitos | Aplica as predefinições e os padrões de tema e de idioma da chave, e atribui visualizações e cálculos à chave. | — |
| e_via | iframe ou script | Como a incorporação foi colocada. Definido pelo carregador do script; registrado com cada evento. | definido pelo carregador |
| e_size | compact (360 × 480), standard (640 × 360) ou full (largura total, com a altura do conteúdo) | Desenha a incorporação como o widget compacto nesse tamanho: um cabeçalho, as entradas, os principais resultados e “Abrir a calculadora completa”. Sem ele (e sem e_show), a incorporação é o cartão completo da calculadora, como antes. | — |
| e_show | results | Oculta as entradas e mostra só os resultados. Os valores iniciais continuam vindo do endereço e da chave. Desenha o widget compacto, em largura total, a menos que e_size defina um tamanho. | — |
| e_theme | light, dark ou match; padrão light | Aparência clara ou escura dentro do frame. match segue a página hospedeira: o snippet script lê as cores da própria página e, dentro de um frame, segue a configuração clara ou escura do sistema do visitante. Sem ele, o padrão da chave; senão, claro. O tema do rftools.io do próprio visitante nunca é usado. | theme |
| e_accent | seis dígitos hexadecimais, sem # | Cor de destaque: botões, anéis de foco e realces, mais um tom derivado. | accent |
| e_bg | seis dígitos hexadecimais, sem # | Fundo do frame e dos cartões. | bg |
| e_fg | seis dígitos hexadecimais, sem # | Cor do texto. | fg |
| e_border | seis dígitos hexadecimais, sem # | Cor da borda. | border |
| e_radius | um número inteiro de 0 a 24 | Raio dos cantos do cartão e das entradas, em pixels. | radius |
| e_font | system ou inter | Fonte: a fonte do sistema do visitante, ou Inter. | font |
| e_preset | o id de uma das predefinições da chave | Parte dessa predefinição em vez da primeira da chave. Valores de entrada explícitos continuam prevalecendo. | — |
| e_lang | en, es, de, fr, ja, ko, pt | O idioma da calculadora: rótulos, título e os textos da própria incorporação. Valores desconhecidos são ignorados. | lang |
Chaves e predefinições
Uma chave liga uma incorporação à sua organização. Ela contém o nome da sua organização, os sites autorizados a exibi-la, os padrões de tema, um idioma padrão e predefinições: conjuntos nomeados de valores de entrada, como seus laminados ou suas peças, por calculadora. Uma chave é um identificador público, não um segredo: ela fica no código-fonte da sua página. O que a protege é a lista de permissões descrita abaixo.
Uma incorporação com chave lista suas predefinições com os seus rótulos e parte da primeira, ou daquela indicada por e_preset. As entradas informadas explicitamente no endereço continuam prevalecendo, então ?e_key=…&traceWidth=0.3 mantém o seu laminado e define a trilha.
Para solicitar uma chave, envie um e-mail para contact@rftools.io com o nome da sua organização, todos os sites em que a incorporação vai rodar (inclusive o de homologação) e as predefinições que quiser. Informe as origens como https://www.example.com; todos os subdomínios de um domínio podem ser informados como https://*.example.com. As chaves são emitidas pelo rftools.io; adicionar, alterar ou revogar uma é uma implantação, que leva alguns minutos.
O que a lista de permissões de domínios faz, e o que ela não faz
A lista de permissões é aplicada pelos navegadores dos seus visitantes, não pela incorporação nem pelo nosso script. Ela protege o uso da sua chave: suas predefinições, seu tema e as contagens atribuídas só aparecem nas suas páginas. Não é um controle de acesso à calculadora.
Aplicado
Uma incorporação com chave só aparece nas suas páginas.
Quando uma incorporação leva a sua chave, o rftools.io informa ao navegador do visitante quais sites podem exibi-la em um frame: exatamente as origens registradas para a sua chave. Em qualquer outro site o navegador não mostra nada; o snippet script mostra então o link dele.
Uma chave revogada ou desconhecida não aparece em lugar nenhum.
O frame é recusado em todos os lugares, a partir do próximo carregamento de página depois que a alteração é implantada. Cópias já abertas em uma aba não são afetadas.
O restante do rftools.io não pode ser exibido em um frame.
Qualquer outra página, inclusive esta, só pode ser exibida em um frame pelo próprio rftools.io.
Não impedido
Incorporações sem chave não são impedidas.
Qualquer pessoa pode incorporar qualquer calculadora sem chave, em qualquer site. Isso é proposital: é a incorporação gratuita. Uma incorporação sem chave mostra os valores padrão da calculadora, sem as suas predefinições nem os seus padrões de tema.
Cópias do código da página não são impedidas.
O HTML da incorporação é público. Qualquer pessoa pode buscá-lo, copiá-lo ou servi-lo pelo próprio servidor, e a lista de permissões não consegue ver isso. Usar a sua chave dessa forma viola os termos, mas nenhum cabeçalho consegue impedir.
Análises forjadas não são impedidas.
Nada autentica um evento de análise. Qualquer pessoa pode enviar um em nome de qualquer chave ou de qualquer site. As contagens que informamos são contagens, não provas.
Atribuição
Toda incorporação mostra “Desenvolvido por rftools.io”, no idioma dela, com link para a página da calculadora (marcado com utm_source=embed). Nenhum parâmetro e nenhuma configuração da chave o remove, e não existe versão white label.
Os Termos de uso estabelecem como condições da incorporação manter a atribuição e usar apenas uma chave emitida para você.
O que uma incorporação registra
Uma incorporação registra dois eventos: embed_view uma vez por carregamento, e embed_calculate sempre que um visitante calcula com novos valores (no máximo dez por minuto). Os dois indicam a chave (ou nenhuma), a calculadora, a origem do site que incorpora conforme informada pelo navegador e se ela foi colocada por iframe ou por script.
Eles vão para o Google Analytics e para os registros do próprio rftools.io, que os guardam por 90 dias sem endereço de rede e sem conta, de modo que as contagens de uma chave resistem a cookies bloqueados e a análises bloqueadas. O Google Analytics roda no frame com as configurações de cookies padrão, que os navegadores recusam dentro de um frame em outro site; por isso, normalmente ele não registra nada ali, e as contagens por chave são os registros do próprio rftools.io. As prévias nesta página não registram nada.
Nada mais do site roda em uma incorporação: nada de anúncios, gravação de sessão, assistente de IA ou controles de login, salvamento ou compartilhamento. Veja a Política de privacidade e a Política de cookies.