Die Verstecktes Feld Ist die eine Steuerung in den Master Addons Widget-builder Das Editoren nie sehen Es hält einen festen Wert, den Sie einmal im Builder setzen, sagen wir eine Versionszeichenfolge oder eine Layout-Taste Der Wert wandert mit dem Widget und druckt durch ein Template-Token, aber nirgendwo im Elementor-Panel erscheint eine Eingabe dafür.
Sogar das Hidden-Feld unterstützt Bedingungenund sein gespeicherter Wert druckt durch die Twig-Syntax-Vorlagen-Engine Wie jeder andere Token können Sie ihn also in referenzieren {% if %} Checks über Ihre Vorlage Beide Guides behandeln die Details.
Das macht es zum richtigen Zuhause für Konstanten, die Ihre Vorlage benötigt, aber Benutzer dürfen nicht bearbeiten. Alles, was ein neugieriger Client versehentlich ändern könnte, bleibt außer Reichweite. Ihre HTML-, CSS- und JS-Panels können es immer noch wie jeden anderen Wert lesen.
Was das Hidden-Feld tut #
- Speichert einen im Builder definierten festen Zeichenfolgenwert ohne sichtbare Steuerung im Elementor.
- Drucke, die überall im HTML-, CSS- oder JS-Panel des Widgets einen Wert haben
{{ your_field_name }}. - Hält Konfigurationskonstanten aus der Bearbeitungs-Benutzeroberfläche fern, sodass sie nicht pro Seite geändert werden können.
- Verhält sich wie ein Textwert in der Vorlagenlogik, also Konditionale wie
{% if mode == 'embed' %}Arbeit.
Wenn dies Ihr erstes benutzerdefiniertes Widget ist, lesen Sie die Übersicht über Widget Builder Vor dieser Seite; Es deckt das Editorlayout ab, das die Felddokumente annehmen.
Bevor Sie beginnen #
- WordPress Mit Elementor Installiert und aktiv.
- Master-Addons für Elementor Installiert und aktiv Neu im Plugin? siehe die Installationsführung.
- Ein benutzerdefiniertes Widget, das im Widget Builder-Editor geöffnet ist Unser Beispiel ist ein Karteneinbettungs-Widget, bei dem ein verstecktes Feld benannt ist
map_style_keyÜberträgt die feste Kennungsbezeichnung für den Kartenstil, die das Einbettungsskript erwartet.
So fügen Sie ein verstecktes Feld hinzu #
Ziehen Sie die Versteckt Feld aus dem Feldfeld in einen beliebigen Abschnitt Der Tab spielt hier keine Rolle, da so oder so nichts im Panel rendert, seine Optionen öffnen sich links, sobald es landet.
Versteckte Feldoptionen erklärt #
Die Optionsliste ist von der Bauart her kurz:
- Etikett: Ein Name für den eigenen Bezug im Inneren des Bauherrn Er zeigt sich nie in Elementor.
- Name: Die eindeutige Kennung, auf die sich Ihre Vorlagen beziehen Nur Buchstaben, Zahlen und Unterstriche, zum Beispiel
map_style_key. - Standard: Der Wert, den das Feld hält Da es keine Benutzeroberfläche gibt, um es später zu ändern, ist dies effektiv der Wert, Punkt.
Verbinden Sie das Versteckte Feld mit seinem Token #
Das Feld Versteckt ist ein Tokenfeld Drucken Sie es genau wie einen Textwert, in jedem der drei Panels:
<!-- HTML panel -->
<div class="ma-map" data-style="{{ map_style_key }}"></div>
// JS panel
var styleKey = "{{ map_style_key }}";
initMap(styleKey);Auch Template-Logik kann darauf verzweigen, wenn Sie zwei interne Modi desselben Widgets versenden, kann ein Hidden-Feld den Zweig auswählen, ohne die Wahl offenzulegen:
{% if widget_mode == 'compact' %}
<div class="ma-map ma-map--compact"></div>
{% else %}
<div class="ma-map ma-map--full"></div>
{% endif %}Ein leiser Fehlermodus, um darüber Bescheid zu wissen: Wenn Sie das Feld später umbenennen, druckt jeder Token, der immer noch auf den alten Namen zeigt, eine leere Zeichenfolge aus. Nichts Fehler, das Widget rendert einfach mit einem Rohling, wo sich früher die Konstante befand. Nach einem Umbenennen durchsuchen Sie alle drei Panels nach dem alten Namen, bevor Sie speichern.
Pass auf: Ein Verstecktes Feld ist unsichtbar, nicht geheim Sein Wert wird immer noch in das Seitenmarkup oder Skript reingerendert, das Besucher ansehen können-source. Halten Sie private API-Schlüssel und Anmeldeinformationen davon fern; es ist für Konfigurationskonstanten, nicht Geheimnisse.
Verwenden Sie das Feld Versteckt in Elementor #
Fügen Sie Ihr benutzerdefiniertes Widget zu einer Seite in Elementor hinzu. Das Panel zeigt jedes andere von Ihnen definierte Steuerelement an und nichts für das Feld Versteckt. Diese Abwesenheit ist die Funktion. Der Wert wird bereits angewendet und das gerenderte Widget spiegelt ihn vom ersten Drop an wider.
Häufige Anwendungsfälle #
- Layouttasten Das interne CSS oder JS verzweigt sich pro Widget.
- Versionszeichenfolgen Zum Debuggen von ausgelieferten Widgets in ein Datenattribut gestempelt.
- Flags für den API-Modus Beispielsweise ein Einbettungstyp, den das Skript des Widgets liest.
- Fragmente von Klassennamen behoben In das Markup gedruckt, sodass eine Widget-Familie Styling-Hooks teilt.
- Vorlagenverzweigungsschalter Wenn Sie ein Widget in zwei internen Varianten exportieren.
Tipps für die Arbeit mit dem Hidden-Feld #
- Benennen Sie es wie die Konstante, die es ist.
map_style_keySagt dem nächsten Betreuer, was der Token bedeutet;hidden_1Nicht tut. - Legen Sie vor dem Speichern die Standardeinstellung fest. Von der Elementorseite gibt es keine zweite Chance; Eine leere Standardeinstellung gibt überall dort, wo das Token erscheint, eine leere Zeichenfolge wieder.
- Zitiere es in JS. Der Wert ist eine Zeichenfolge, also schreiben Sie
var key = "{{ map_style_key }}";Mit Zitaten. - Bevorzugen Sie ein sichtbares Feld, sobald Benutzer die Kontrolle benötigen. In dem Moment, in dem ein Wert pro Seite abweichen sollte, tauschen Sie das Feld Versteckt gegen ein Text oder Wählen Feld statt Benutzer aufzufordern, Widget-Internals zu bearbeiten.
- Keine Geheimnisse. Der Wert landet in der öffentlichen Seitenausgabe, also behandeln Sie ihn als sichtbar für jeden, der die Quelle liest.
Häufig gestellte Fragen #
Was ist das Hidden-Feld im Master Addons Widget Builder?
Das Feld Versteckt speichert einen festen Wert innerhalb eines benutzerdefinierten Elementor-Widgets, ohne dass im Panel ein Bedienelement angezeigt wird. Sie legen den Wert einmal im Builder fest und Vorlagen drucken ihn mit {{ field_name }} Im HTML, CSS, oder JS-Panel. können Editoren es nicht sehen oder ändern.
Warum sollte ich ein Hidden-Feld verwenden, anstatt den Wert in meinem HTML fest zu kodieren?
Zentralisierung. Wenn dieselbe Konstante an mehreren Stellen in den HTML-, CSS- und JS-Panels erscheint, hält ein verstecktes Feld sie synchron, und das spätere Aktualisieren des Widgets bedeutet, dass eine Standardeinstellung geändert wird, anstatt durch drei Panels zu jagen.
Können Benutzer den Wert eines verborgenen Felds in Elementor ändern?
Nein. Das Feld gibt keine Eingabe im Panel ab, daher ist sein Wert bei der Standardeinstellung im Builder festgelegt. Um es zu ändern, muss das Widget im Widget Builder selbst bearbeitet werden.
Kann ich den Wert des Feldes Versteckt in Template-Konditionalen verwenden?
Ja. Es verhält sich wie jeder Textwert, also {% if widget_mode == 'compact' %} Funktioniert Damit kann eine Widget-Definition einen internen Switch tragen, mit dem Benutzer nie interagieren.
Ist der Wert des Hidden-Feldes privat?
Nein. Es ist vor dem Bearbeitungsfeld verborgen, wird aber wie jedes andere Token auf der Seite wiedergegeben, wo jeder es in der Seitenquelle lesen kann. Speichern Sie darin keine API-Geheimnisse oder Anmeldeinformationen.
Ist das Feld Versteckt in der kostenlosen Version verfügbar?
Das Feld Versteckt gehört zum freien Steuerungssatz, neben Grundlagen wie Text und Textarea Die vollständige Widget Builder Erfahrung mit der kompletten Feldbibliothek ist Teil von Master Addons Pro; siehe die Preisseite Einzelheiten.
Einwickelnd #
Das Widget Builder Hidden-Feld löst ein leises, aber reales Problem: Werte, die ein Widget berühren darf, hängen davon ab, dass kein Editor sie einmal definieren soll, drucken Sie ihr Token wo nötig aus, und die Konstante liefert mit dem Widget überall dort, wo es verwendet wird Wenn ein Wert doch editierbar sein sollte, greifen Sie nach einem sichtbaren Feld wie Nummer Oder Text statt Erkunden Sie den Rest der Master Addons Widgets und Erweiterungen, und sehen Sie sich die an Preisseite Für das, was jeder Plan beinhaltet.