主插件
定价
查看类别

隐藏

罗伊·杰米
2026年8月6日更新完毕

5 分钟阅读

的 隐藏的字段 是主插件中的一个控件 小部件生成器 that editors never see。it 保存一个固定值,你在构建器中设置一次,比如版本字符串或布局键。该值随小部件一起移动并通过模板令牌打印,但 Elementor 面板中的任何位置都不会出现它的输入。

甚至隐藏字段也支持 条件并且其存储值通过打印 Twig-语法模板引擎 与任何其他令牌一样,您可以将其引用 {% if %} 检查您的模板。两本指南都涵盖了详细信息。

这使得它成为模板需求常量的合适主页,但用户不得编辑。任何奇怪的客户端可能会意外更改的内容都遥不可及。您的 HTML、CSS 和 JS 面板仍然可以像任何其他值一样读取它。

Hidden 字段的作用 #

  • 存储在构建器中定义的固定字符串值,而 Elementor 中没有可见的控制。
  • 通过小部件的 HTML、CSS 或 JS 面板中任何位置进行值打印 {{ your_field_name }}.
  • 将配置常量保留在编辑 UI 之外,因此无法按页面更改它们。
  • 行为就像模板逻辑中的文本值,因此条件诸如此类 {% if mode == 'embed' %} 工作。

如果这是您的第一个自定义小部件,请阅读 小部件生成器概述 在此页面之前;它涵盖了文档假设的字段的编辑器布局。

在开始之前 #

  • 文字出版社 与 元素 已安装并处于活动状态。
  • Elementor 的主插件 已安装并处于活动状态。插件新增?参见 安装指南.
  • Widget 生成器编辑器中打开的自定义小部件,我们的示例是一个地图嵌入小部件,其中有一个名为"隐藏"字段 map_style_key 携带嵌入脚本期望的固定地图样式标识符。

如何添加隐藏字段 #

拖动 隐藏 field 从字段面板进入任何部分。此处选项卡并不重要,因为无论哪种方式,面板中都没有渲染。它的选项一落地就在左侧打开。

解释了隐藏字段选项 #

选项列表设计较短:

  • 标签: 构建器内部供您自己参考的名称。它从未在 Elementor 中显示。
  • 名称: your模板所指的唯一标识符。字母、数字、下划线仅,例如 map_style_key.
  • 默认: field 持有的值,由于后面没有 UI 可以更改,所以这实际上就是值,full stop。

将隐藏字段与其令牌连接起来 #

Hidden字段是一个令牌字段, 打印它就像一个文本值, 在三个面板中的任何一个:

<!-- HTML panel -->
<div class="ma-map" data-style="{{ map_style_key }}"></div>

// JS panel
var styleKey = "{{ map_style_key }}";
initMap(styleKey);

Template逻辑也可以在上面分支, 如果寄出同一个小部件的两个内部模式, 一个隐藏字段可以选择分支, 而不会暴露选择:

{% if widget_mode == 'compact' %}
<div class="ma-map ma-map--compact"></div>
{% else %}
<div class="ma-map ma-map--full"></div>
{% endif %}

One quiting failure mode to know about: 如果你稍后重命名字段,每个仍然指向旧名称的令牌都会打印一个空字符串,没有错误,小部件只是渲染了一个空白,其中常数曾经是重命名,在保存之前搜索所有三个面板的旧名称。

小心: a Hidden字段是不可见的,不是秘密的,它的值仍然渲染到访问者可以查看的页面标记或脚本中-source。Private API密钥和凭据都不要放在它里面;它是用于配置常量,而不是秘密。

使用 Elementor 中的隐藏字段 #

Elementor 中将自定义小部件添加到页面,面板显示您定义的每个其他控件,而隐藏字段则没有任何内容,那个缺失是功能,该值已经应用,渲染的小部件从第一个下降中反映出来。

常见用例 #

  • 布局键 每个小部件固定该内部 CSS 或 JS 分支。
  • 版本字符串 印入数据属性以调试已发送的小部件。
  • API 模式标志 如嵌入式键入小部件的脚本读取。
  • 修复了类名片段 打印到标记中,以便小部件系列共享造型挂钩。
  • 模板分支交换机 当您导出两个内部变体中的一个小部件时。

使用隐藏字段的技巧 #

  • 像常数一样命名它。 map_style_key 告诉下一个维护者代币的含义; hidden_1 不是。
  • 保存前设置默认值。 Elementor 端没有第二次机会;空默认在令牌出现的任何地方都呈现空字符串。
  • JS中引用它。 值是一个字符串,所以写 var key = "{{ map_style_key }}"; 附有引言。
  • 一旦用户需要控制,请选择可见字段。 每页值应该不同的时刻,将隐藏字段替换为 a 文本 或 选择 field,而不是要求用户编辑小部件内部。
  • 没有秘密。 该值最终会出现在公共页面输出中,因此请将其视为任何读取源的人都可以看到。

常见问题 #

Master Addons Widget Builder 中的隐藏字段是什么?

Hidden 字段将一个固定值存储在自定义 Elementor 小部件内,而无需在面板中渲染任何控件,您在构建器中设置该值一次,模板将其打印为 {{ field_name }} HTML、CSS、JS面板中,编辑器无法看到或更改它。

为什么我会使用隐藏字段而不是对 HTML 中的值进行硬编码?

Centralization。HTML、CSS 和 JS 面板的几个地方出现相同的常量时,一个隐藏字段会使它们保持同步,稍后更新小部件意味着改变一个默认值,而不是通过三个面板进行狩猎。

用户可以在 Elementor 中更改隐藏字段的值吗?

No。字段在面板中没有输入,因此它的值固定在你在构建器中设置的任何默认值。更改它需要编辑Widget构建器本身中的小部件。

我可以在模板条件式中使用隐藏字段的值吗?

是的。它的行为类似于任何文本值,所以 {% if widget_mode == 'compact' %} works。this让一个小部件定义携带一个内部开关,用户永远不会与之交互。

Hidden 字段的价值是否私有?

No。编辑面板中隐藏,但它像任何其他令牌一样渲染到页面中,任何人都可以在页面源中读取它。不要将API秘密或凭据存储在其中。

免费版本中隐藏字段可用吗?

Hidden 字段属于自由控制集,与 Text 和 Textarea 等基础知识并列。完整的字段库的完整 Widget Builder 体验是 Master Addons Pro 的一部分;请参阅 定价页面 详情。

包裹起来 #

Widget Builder Hidden 字段解决了一个安静但真正的问题:值一个小部件取决于没有编辑器应该触摸定义一次,在需要的地方打印它的令牌,以及常量随小部件随处运送一个值毕竟应该可编辑时,触及一个可见字段,如 號 或者文本代替。探索其余部分 主插件小部件和扩展,并看到 定价页面 对于每个计划包含的内容。

你的感受是什么