計算ツールを埋め込む
rftools.io の 255 個の計算ツールは、どれでも自分のページに無料で埋め込めます。フレーム内で、固定サイズまたは内容に合わせた高さで、あなたの配色で、7 つの言語のいずれかで動作します。メーカーはキーを追加して、自社の部品値をプリセットできます。
スニペットビルダー
計算ツールと見た目を選び、スニペットをコピーしてください。埋め込みが受け付ける値だけが書き込まれます。すべてのプランで無料です。
色、角、フォント
<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>埋め込みには利用規約の第 5 条が適用されます。
コンパクトウィジェット
サイズを指定するか、結果のみを表示すると、埋め込みはコンパクトウィジェットとして描画されます。入力、主な結果、計算ツール全体へのリンクを表示します。以下は、ほかのサイトのページに表示された「RF リンクバジェット計算ツール」です。
2 つの埋め込み方法
どちらも rftools.io が配信するフレームで同じ計算ツールを表示し、どちらにも以下の同じルールが適用されます。
script スニペットはフレームを挿入し、計算ツールの大きさに合わせてサイズを変更します。リンクはページに残ります。これが帰属表示であり、計算ツールを読み込めないときに訪問者に表示されるものです。
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><iframe src="https://rftools.io/embed/microstrip-impedance/"
title="Microstrip Impedance Calculator - rftools.io"
width="100%" height="640" style="border:0" loading="lazy"></iframe>ローダーは /embed.js です。フレームを組み立てるだけで、ページのチェックは一切行いません。ページ上で動くチェックは信頼できないからです。
パラメーター
これらはフレームのアドレスに追加するか(/embed/microstrip-impedance/?e_theme=light)、script スニペットでは e_ を除いた data- 属性として指定します(data-theme="light")。埋め込みのパラメーターはすべて e_ で始まるため、計算ツールの入力と衝突することはありません。
形式に完全には一致しない値は無視され(スタイルに渡されることはありません)、代わりにキーまたはサイトのデフォルトが適用されます。アドレスの値はキーのデフォルトより優先され、キーのデフォルトはサイトのデフォルトより優先されます。
e_theme=dark、e_theme=match、またはキーで別の指定がない限り、埋め込みはライトです。訪問者自身の rftools.io のテーマは使われません。
計算ツールの入力も名前で指定できます。「マイクロストリップインピーダンス計算ツール」で ?traceWidth=0.8 とすると、0.8 mm から始まります。この方法で指定した入力は、キーのプリセットより優先されます。script スニペットでは、初期値を data-inputs="traceWidth=0.8" に指定します。
| パラメーター | 値 | 効果 | キーのデフォルト |
|---|---|---|---|
| e_key | ek_ と英小文字または数字 16 文字 | キーのプリセット、テーマと言語のデフォルトを適用し、表示と計算をそのキーに帰属させます。 | — |
| e_via | iframe または script | 埋め込みの配置方法。script ローダーが設定し、各イベントとともに記録されます。 | ローダーが設定 |
| e_size | compact(360 × 480)、standard(640 × 360)、または full(全幅、内容に合わせた高さ) | 埋め込みをそのサイズのコンパクトウィジェットとして描画します:ヘッダー、入力、主な結果、「rftools.io で計算ツールを開く」。指定しない場合(e_show もない場合)、埋め込みは従来どおり計算ツールのカード全体です。 | — |
| e_show | results | 入力を隠し、結果のみを表示します。初期値は引き続きアドレスとキーから取られます。e_size でサイズを指定しない限り、全幅のコンパクトウィジェットとして描画します。 | — |
| e_theme | light、dark、または match。デフォルトは light | フレーム内のライトまたはダークの外観。match はホストページに合わせます:script スニペットはページ自体の配色を読み取り、フレーム内では訪問者のシステムのライト/ダーク設定に従います。指定しない場合はキーのデフォルト、それもなければライトです。訪問者自身の rftools.io のテーマは使われません。 | theme |
| e_accent | 16 進数 6 桁、# なし | アクセントカラー:ボタン、フォーカスリング、ハイライト、およびそこから派生する色合い。 | accent |
| e_bg | 16 進数 6 桁、# なし | フレームとそのカードの背景。 | bg |
| e_fg | 16 進数 6 桁、# なし | 文字色。 | fg |
| e_border | 16 進数 6 桁、# なし | 枠線の色。 | border |
| e_radius | 0 から 24 の整数 | カードと入力欄の角の半径(ピクセル)。 | radius |
| e_font | system または inter | フォント:訪問者のシステムフォント、または Inter。 | font |
| e_preset | キーのプリセットのいずれかの id | キーの最初のプリセットではなく、そのプリセットから始めます。明示的に指定した入力値は引き続き優先されます。 | — |
| e_lang | en、es、de、fr、ja、ko、pt | 計算ツールの言語:ラベル、タイトル、埋め込み自体の文言。不明な値は無視されます。 | lang |
キーとプリセット
キーは埋め込みをあなたの組織に結び付けます。キーには、組織名、埋め込みを表示できるサイト、テーマのデフォルト、デフォルトの言語、そしてプリセット(計算ツールごとの、積層材や部品などの名前付きの入力値の組)が含まれます。キーは秘密ではなく公開の識別子で、ページのソースに含まれます。キーを守るのは、以下の許可リストです。
キー付きの埋め込みは、あなたのプリセットをあなたのラベルで一覧表示し、最初のプリセット、または e_preset で指定したプリセットから始まります。アドレスで明示的に指定した入力は引き続き優先されるため、?e_key=…&traceWidth=0.3 とすれば積層材はそのままに配線幅を設定できます。
キーを申請するには、組織名、埋め込みを動かすすべてのサイト(ステージング環境を含む)、および必要なプリセットを記載して contact@rftools.io までメールしてください。オリジンは https://www.example.com の形式で記載します。ドメインのすべてのサブドメインは https://*.example.com として記載できます。キーは rftools.io が発行します。キーの追加、変更、失効はデプロイ作業で、数分かかります。
ドメインの許可リストでできること、できないこと
許可リストを適用するのは、埋め込みや当社のスクリプトではなく、訪問者のブラウザーです。許可リストはキーの利用を保護します。プリセット、テーマ、帰属するカウントは、あなたのページにだけ表示されます。計算ツールへのアクセス制御ではありません。
適用されること
キー付きの埋め込みは、あなたのページにだけ表示されます。
埋め込みにあなたのキーが付いている場合、rftools.io は訪問者のブラウザーに、どのサイトがフレームに表示できるかを伝えます。それはキーに登録されたオリジンだけです。ほかのサイトではブラウザーは何も表示せず、script スニペットは代わりにリンクを表示します。
失効したキーや不明なキーは、どこにも表示されません。
変更のデプロイ後、次にページが読み込まれたときから、フレームはどこでも拒否されます。すでにタブで開かれているコピーには影響しません。
rftools.io のほかのページはフレームに表示できません。
このページを含むほかのすべてのページは、rftools.io 自身しかフレームに表示できません。
防げないこと
キーなしの埋め込みは防げません。
誰でも、どのサイトでも、キーなしでどの計算ツールでも埋め込めます。これは意図的なもので、無料の埋め込みです。キーなしの埋め込みは計算ツールのデフォルト値を表示し、あなたのプリセットやテーマのデフォルトは適用されません。
ページのコードのコピーは防げません。
埋め込みの HTML は公開されています。誰でも取得、コピーしたり、自分のサーバー経由で配信したりでき、許可リストはそれを検知できません。そのようにあなたのキーを使うことは規約違反ですが、どのヘッダーでも止めることはできません。
偽造されたアナリティクスは防げません。
アナリティクスのイベントを認証する仕組みはありません。誰でも任意のキーや任意のサイトを名乗るイベントを送信できます。当社が報告するカウントはカウントであり、証明ではありません。
帰属表示
すべての埋め込みは、その言語で「rftools.io 提供」と表示し、計算ツールのページにリンクします(utm_source=embed 付き)。どのパラメーターやキーの設定でも削除できず、ホワイトラベル版はありません。
利用規約は、帰属表示を残すことと、あなたに発行されたキーだけを使うことを、埋め込みの条件としています。
埋め込みが記録するもの
埋め込みは 2 つのイベントを記録します。読み込みごとに 1 回の embed_view と、訪問者が新しい値で計算するたびの embed_calculate(1 分あたり最大 10 回)です。どちらも、キー(またはキーなし)、計算ツール、ブラウザーが報告する埋め込み先サイトのオリジン、iframe と script のどちらで配置されたかを記録します。
これらは Google Analytics と rftools.io 自身の記録に送られます。rftools.io の記録は、ネットワークアドレスもアカウントも含めずに 90 日間保管されるため、Cookie やアナリティクスがブロックされてもキーのカウントは失われません。Google Analytics はフレーム内でデフォルトの Cookie 設定のまま動作しますが、ブラウザーはほかのサイトのフレーム内ではその Cookie を拒否するため、通常そこでは何も記録されません。キーごとのカウントは rftools.io 自身の記録です。このページのプレビューは何も記録しません。
埋め込みでは、サイトのほかの機能は一切動作しません。広告、セッション記録、AI アシスタント、ログイン・保存・共有の操作はありません。プライバシーポリシーとクッキーポリシーをご覧ください。