隐藏

的 隐藏的字段 是主插件中的一个控件 小部件生成器 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 Builder 编辑器中打开的自定义小部件,我们的示例是一个地图嵌入小部件,其中有一个名为"隐藏"字段 map_style_key 携带嵌入脚本期望的固定地图样式标识符。

如何添加隐藏字段 #

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

解释了隐藏字段选项 #

选项列表设计较短:

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

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

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,而不是要求用户编辑小部件内部。
• 没有秘密。 该值最终会出现在公共页面输出中,因此请将其视为任何读取源的人都可以看到。

常见问题 #

包裹起来 #

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