Skip to main content
Version: latest

自定义JS/CSS

重要提示

该功能为 旗舰版 付费功能,如未升级,请先 升级 后再使用。

简介​

自定义 JS/CSS 允许团队上传自己编写的 JavaScript 与 CSS 文件,腾讯问卷会在页面加载时自动把它们注入到页面中,用于对页面做个性化定制,例如:

  • CSS:调整页面配色以匹配企业品牌、隐藏或调整某些页面元素的样式;
  • JS:修改页面文案、为页面增加少量交互、接入企业自己的统计脚本等。

使用前提​

  1. 已开启自定义域名:自定义 JS/CSS 只会注入到通过自定义域名访问的页面中。未设置或未开启自定义域名时,「新增JS/CSS文件」按钮不可点击,并提示「开启此功能需要设置并开启自定义域名」。
  2. 旗舰版:团队需为旗舰版,否则新增、修改、开关、删除时都会弹出升级提示。
  3. 操作权限:需要是团队中拥有「域名配置」权限的成员。

功能入口​

团队管理后台 → 配置管理 → 域名配置 → JS/CSS配置

链接分享页标题修改为「链接分享」

功能说明​

新增 JS/CSS 文件​

点击「新增JS/CSS文件」,填写以下内容后保存:

字段说明
配置名称必填,最多 100 个字符,仅用于在列表中区分不同配置
上传文件必填,每次上传一个文件,仅支持 .js、.css,单个文件不超过 256KB

文件名只能包含中英文、数字、下划线 _、连字符 -、点 .、空格与括号,长度不超过 100 个字符。系统根据文件扩展名识别配置类型(JS 或 CSS)。

可创建的配置数量由团队套餐决定,超出上限后将无法继续新增。

配置列表​

列表展示团队下所有 JS/CSS 配置,包含:配置名称、创建人、配置类型(JS / CSS)、审核状态、更新时间与操作。

内容安全检查与审核​

  • 上传时系统会自动扫描文件内容,命中高危内容(如内嵌 <script>、javascript: 伪协议、CSS @import 等)会直接拒绝上传,具体规则见 CSS 与 JS;
  • 上传成功后配置进入「待审核」状态,此时开关不可开启;
  • 「审核通过」后才能开启;
  • 「审核拒绝」的配置无法开启,如果被拒绝时处于开启状态,会被自动关闭。

开启 / 关闭​

通过操作列的开关控制配置是否生效。开关变更后:

  • 若自定义域名为「全站生效」:配置成功后即可在新域名使用工作台相关的操作;
  • 若自定义域名为「仅问卷回答端生效」:配置不会影响当前所在的工作台,不会刷新页面,可以使用新域名打开答题页。

下载​

下载当前配置对应的文件,可在此基础上二次修改后重新上传。

修改​

可以修改配置名称,也可以替换文件:

  • 仅修改名称:不影响审核状态与开关状态;
  • 替换文件:配置会自动关闭并重新进入「待审核」状态,需要审核通过后再次手动开启。

删除​

删除前会二次确认,删除后该配置立即失效。删除一条已开启的配置时,会同样走上述的配置下发流程。

默认配置 default.css​

添加自定义域名后,系统会自动创建一条名为 default css 的 CSS 配置(文件名 default.css)。该配置默认已审核通过、处于关闭状态,打开开关即可生效,也可以下载后作为编写自定义 CSS 的参考。具体内容见 CSS。

生效范围​

自定义 JS/CSS 是否注入,取决于页面是否通过自定义域名访问,因此它的生效范围跟随自定义域名的「生效范围」设置(团队管理后台 → 配置管理 → 域名配置 → 自定义域名 → 生效范围):

自定义域名生效范围会注入 JS/CSS 的页面不会注入 JS/CSS 的页面
仅问卷回答端生效通过自定义域名打开的问卷答题页工作台、问卷编辑、分享投放、数据分析等页面(这些页面仍在原域名下)
全站生效自定义域名下的所有页面:登录页、工作台、问卷编辑、分享投放、数据分析、问卷答题页等—
提示
  • 受访者如果通过腾讯问卷域名的链接答题(可在「分享 → 问卷链接」中切换为腾讯问卷域名链接),不会加载自定义 JS/CSS;
  • 同一份 JS/CSS 会在生效范围内的所有页面加载,如果只想作用于某个页面,需要在代码中自行判断页面路径或提高选择器的针对性,详见 CSS 与 JS;
  • 「全站生效」为旗舰版功能。如果编写的 JS/CSS 作用于工作台、编辑端等页面(如 default.css、JS 示例),需要先将自定义域名设置为「全站生效」才能看到效果。

注意事项​

caution
  • 引入自定义 JS/CSS 需要慎重,错误的代码可能导致页面样式错乱、功能异常甚至无法打开;
  • 腾讯问卷在版本升级后,页面的结构与类名可能会发生变化,可能导致自定义 JS/CSS 失效,需要团队自行维护;
  • 请勿通过自定义 JS 采集受访者的隐私信息,或将页面数据发送到未经授权的第三方。