Skjult

The Skjult felt er den ene kontrol i Master Addons Widget Builder den editorer aldrig se. Det holder en fast værdi, du indstiller én gang i bygherren, siger en versionsstreng eller et layout nøgle. Værdien rejser med widget og udskriver gennem en skabelon token, men ingen input for det vises overalt i Elementor panel.

Selv Skjult-feltet understøtter Betingelser, og dens lagrede værdi udskriver gennem Twig-syntaks skabelon motor som ethvert andet token, så du kan henvise til det {% if %} tjekker på tværs af din skabelon. Begge guider dækker detaljerne.

Det gør det til det rigtige hjem for konstanter, som din skabelon har brug for, men brugerne må ikke redigere. Alt, hvad en nysgerrig klient kan ændre ved et uheld, forbliver uden for rækkevidde. Dine HTML-, CSS- og JS-paneler kan stadig læse det som enhver anden værdi.

Hvad Skjult feltet gør #

• Gemmer en fast strengværdi defineret i builderen uden synlig kontrol i Elementor.
• Udskriver, der værdsætter hvor som helst i widgettens HTML-, CSS- eller JS-panel igennem {{ your_field_name }}.
• Holder konfigurationskonstanter ude af redigeringsbrugergrænsefladen, så de ikke kan ændres pr. side.
• Opfører sig som en tekstværdi i skabelonlogik, så betingede betingelser som f.eks {% if mode == 'embed' %} work.

Hvis dette er din første brugerdefinerede widget, skal du læse Widget Builder oversigt før denne side; det dækker editorlayoutet, som feltdokumenterne antager.

Før du starter #

• WordPress med Elementor installeret og aktiv.
• Master Addons til Elementor installeret og aktiv. Ny i plugin'et? Se den installationsvejledning.
• En brugerdefineret widget åben i Widget Builder editor. Vores eksempel er en kort embed widget, hvor et Skjult felt navngivet map_style_key bærer den faste kortstilidentifikator, som indlejringsscriptet forventer.

Sådan tilføjes et Skjult felt #

Træk Skjult felt fra panelet felter ind i enhver sektion. Fanen betyder ikke noget her, da intet gengives i panelet på nogen måde. Dens muligheder åbnes til venstre, så snart den lander.

Skjulte feltindstillinger forklaret #

Optionslisten er kort efter design:

• Etiket: et navn til din egen reference inde i bygherren. Det viser sig aldrig i Elementor.
• Navn: den unikke identifikator, dine skabeloner henviser til. Kun bogstaver, tal og understregninger, f.eks map_style_key.
• Standard: den værdi feltet holder. Da der ikke er nogen brugergrænseflade til at ændre det senere, er dette reelt værdien, punktum.

Forbind feltet Skjult med dets token #

Feltet Skjult er et tokenfelt. Udskriv det nøjagtigt som en tekstværdi, i et hvilket som helst af de tre paneler:

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

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

Skabelon logik kan også forgrene sig på det. Hvis du sender to interne tilstande af samme widget, kan et Skjult felt vælge grenen uden at udsætte valget:

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

En stille fejltilstand at vide om: hvis du omdøber feltet senere, udskriver hvert token, der stadig peger på det gamle navn, en tom streng. Intet fejl, widgetten gengives bare med et tomt, hvor konstanten plejede at være. Efter et omdøbning skal du søge i alle tre paneler efter det gamle navn, før du gemmer.

Pas på: et Skjult felt er usynligt, ikke hemmeligt. Dets værdi gengives stadig i sidemarkeringen eller scriptet, som besøgende kan se-kilde. Hold private API-nøgler og legitimationsoplysninger ude af det; det er til konfigurationskonstanter, ikke hemmeligheder.

Brug feltet Skjult i Elementor #

Tilføj din brugerdefinerede widget til en side i Elementor. Panelet viser hver anden kontrol, du definerede, og intet for feltet Skjult. Det fravær er funktionen. Værdien er allerede anvendt, og den gengivne widget afspejler den fra den første dråbe.

Almindelige brugstilfælde #

• Layoutnøgler den interne CSS eller JS forgrener sig, fast pr. widget.
• Versionsstrenge stemplet ind i en dataattribut til fejlfinding af afsendte widgets.
• flag i API-tilstand såsom en indlejringstype, som widgettens script læser.
• Faste klasse navnefragmenter printet ind i markup'et, så en widgetfamilie deler stylingkroge.
• Skabelon gren switche når du eksporterer én widget i to interne varianter.

Tips til at arbejde med feltet Skjult #

• Nævn det som den konstant, det er. map_style_key fortæller den næste vedligeholder, hvad tokenet betyder; hidden_1 ikke.
• Indstil standarden, før du gemmer. Der er ingen ny chance fra Elementor-siden; en tom standard gengiver en tom streng overalt, hvor tokenet vises.
• Citer det i JS. Værdien er en streng, så skriv var key = "{{ map_style_key }}"; med citater.
• Foretræk et synligt felt, når brugerne har brug for kontrol. I det øjeblik en værdi skal afvige pr. side, skal du bytte feltet Skjult til en Text eller Select felt i stedet for at bede brugerne om at redigere widget interne.
• Ingen hemmeligheder. Værdien ender i offentlig side output, så behandle det som synligt for alle, der læser kilden.

Ofte stillede spørgsmål #

Indpakning #

Widget Builder Hidden-feltet løser et stille, men reelt problem: værdier en widget afhænger af, at ingen editor skal røre. Definer det én gang, udskriv dets token, hvor det er nødvendigt, og de konstante skibe med widget overalt, hvor det bruges. Når en værdi alligevel skal kunne redigeres, skal du nå et synligt felt som Number eller Tekst i stedet. Udforsk resten af Master Addons widgets og udvidelser, og se den prissætning side for hvad hver plan indeholder.