嵌入 Fillio 表单

将 Fillio 表单添加到任意网站的三种方式：标准、弹窗和全页。

在哪里获取代码

打开表单，进入“分享”标签页并选择“嵌入”。Fillio 会用您的表单 ID 和所选选项生成代码片段。下面的示例就是它的产物。

嵌入模式

选择适合您布局的模式。

标准

在页面某一区域内联嵌入

弹窗

触发时以模态弹窗形式打开

全页

占据整个 HTML 页面

标准嵌入

将代码粘贴到任意 HTML 页面中。表单将以内联 iframe 的形式呈现。

嵌入代码

<iframe data-fillio-src="https://fillio.so/embed/YOUR_FORM_ID" width="100%" height="800" frameborder="0" marginheight="0" marginwidth="0" title="Form" loading="lazy"></iframe>
<script>var d=document,w="https://fillio.so/widgets/embed.js",v=function(){"undefined"!=typeof Fillio?Fillio.loadEmbeds():d.querySelectorAll("iframe[data-fillio-src]:not([src])").forEach((function(e){e.src=e.dataset.fillioSrc}))};if("undefined"!=typeof Fillio)v();else if(d.querySelector('script[src="'+w+'"]')==null){var s=d.createElement("script");s.src=w,s.onload=v,s.onerror=v,d.body.appendChild(s);}</script>

自动调整高度依赖代码片段中的组件脚本。保留它，iframe 就会随着填写者翻页而伸缩。

不使用脚本时

如果您不想加载组件脚本，就用一个固定高度的普通 iframe。它不会自适应，所以请按最长的一页来定高度。

<iframe src="https://fillio.so/embed/YOUR_FORM_ID" width="100%" height="800" frameborder="0" marginheight="0" marginwidth="0" title="Form" style="border: 1px solid #e5e7eb; border-radius: 8px;"></iframe>

选项

在嵌入 URL 后追加以下查询参数来自定义行为。

参数	说明
?hideTitle=1	隐藏嵌入内的表单标题
?transparentBackground=1	移除嵌入框架的白色背景
?dynamicHeight=1	自动调整 iframe 高度以匹配表单高度

弹窗嵌入

可从任意按钮或链接触发表单。需要加载 Fillio 组件脚本。

1. 添加脚本

<script async src="https://fillio.so/widgets/embed.js"></script>

2. 通过按钮触发

<button data-fillio-open="YOUR_FORM_ID" data-fillio-width="500">Open Form</button>

任何带 data-fillio-open 的元素都会套上 Fillio 的默认按钮样式。加上您自己的 class 即可覆盖它。

属性	说明
data-fillio-open	表单 ID（必填）
data-fillio-width	弹窗宽度（像素）
data-fillio-hide-title	设置为 1 可隐藏表单标题

3. 通过 JavaScript 触发

Fillio.openPopup('YOUR_FORM_ID', {
  width: 500,
  hideTitle: false,
  onOpen: function () {},
  onClose: function () {}
});

随时用您自己的代码关闭弹窗。

Fillio.closePopup('YOUR_FORM_ID');

从链接打开

URL 片段可以在页面加载时立刻打开弹窗，这样从菜单项、消息或另一个页面进入表单都很方便。

<a href="https://your-site.com/page#fillio-open=YOUR_FORM_ID&fillio-width=600">Open Form</a>

弹窗行为

未设置宽度时弹窗宽 500 px，且在任一方向都不会超过视口的 90%。点击遮罩或按 Esc 即可关闭，onOpen 和 onClose 分别在两端触发。

全页嵌入

当表单需要填满整个视口时，请使用此 HTML 模板。

<html>
  <head>
    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0">
    <title>Form</title>
    <script async src="https://fillio.so/widgets/embed.js"></script>
    <style type="text/css">
      html { margin: 0; height: 100%; overflow: hidden; }
      iframe { position: absolute; top: 0; right: 0; bottom: 0; left: 0; border: 0; }
    </style>
  </head>
  <body>
    <iframe data-fillio-src="https://fillio.so/embed/YOUR_FORM_ID" width="100%" height="100%" frameborder="0" marginheight="0" marginwidth="0" title="Form"></iframe>
  </body>
</html>

选项

在嵌入 URL 后追加以下查询参数来自定义行为。

参数	说明
?transparentBackground=1	移除嵌入框架的白色背景

提示

嵌入的表单和托管版本表现完全一致：条件逻辑、多页和您的表单主题在 iframe 里都照常工作。