The Switcher field sætter Elementors velkendte ja/nej-skift i en brugerdefineret widget. Der vises et svirp i panelet, og der vises et badge, et layout strammes, eller en hel blok af markup slukkes. Inde i Master Addons Widget Builder, Switcheren er standard måde at gøre enhver del af en widget valgfri.
Switcheren er det mest almindelige kildefelt til Betingelser: det gemmer yes når den er tændt, så andre kontroller kan vise eller skjule baseret på det. På forenden, den Twig-syntaks skabelon motor lader dig pakke markup ind {% if my_toggle %} så vippen styrer outputtet også. Begge guider dækker opsætning og begrænsninger.
Dens værdi er bevidst enkel: en streng som yes når vippen er tændt, en tom streng, når den er slukket. Det kortlægger lige på skabelonbetingelser. I praksis ender næsten hver Switcher pakket ind i en {% if %} bloker eller kør betingelserne for andre betjeningsanordninger.
Hvad Switcher-feltet gør #
- Gengiver Elementors tænd/sluk-skift i widgetpanelet med dine egne tænd/sluk-etiketter.
- Returnerer en konfigurerbar streng (standard
yes) når den er tændt, og en tom streng, når den er slukket. - Drives
{% if %}blokke i skabelonen, så markup gengives kun, når skiftet er slået til. - Skifter CSS-klasser inline, for eksempel
class="card {% if compact_mode %}is-compact{% endif %}". - Fungerer som den sædvanlige chauffør for Betingelser på andre felter, der viser eller skjuler hele grupper af kontroller.
Opbygning af din første widget? Start med Widget Builder oversigt, så kom tilbage hertil.
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 prissætning kort widget med en Switcher opkaldt
show_badgedet afslører et “populært” bånd på kortet.
Sådan tilføjes et Switcher-felt #
Træk Switcher felt fra panelet felter til en sektion under Content eller Style fane. Dens muligheder åbnes til venstre, så snart den lander.
Switcher felt muligheder forklaret #
- Etiket: teksten vist ved siden af skiftet i Elementor, for eksempel “Vis badge”.
- Navn: den unikke identifikator, dine skabeloner henviser til. Kun bogstaver, tal og understregninger, f.eks
show_badge. - Label On / Label Off: de korte tekster på selve skiftet, “Ja” og “Nej” som standard.
- Returværdi: den snor feltet holder mens den er tændt,
yessom standard. Skift den, når din skabelon eller dit script forventer en bestemt streng. - Standard: indstil den til returværdien for at starte skiftet på; lad den være tom for at starte.
Bemærk, at Standard- og returværdi skal matche nøjagtigt, for at skifte skal starte på. Hvis du ændrer returværdien til enabled men lad Standard være yes, widgetten falder ind med vippen af, og ingen fejl fortæller dig hvorfor.
Tilslut switcheren med en {% if %} blok #
Switcheren er et tokenfelt, men du udskriver sjældent dets token alene. Off betyder tom streng, og en tom streng er falsy i skabelonlogik, så det naturlige mønster er betinget i HTML-panelet:
{% if show_badge %}
<span class="pc-badge">Popular</span>
{% endif %}Toggle on, badgen gengiver. Toggle off, markup forsvinder helt, efterlader ingen tom indpakning bag. Det samme mønster skifter klasser uden ekstra markup:
<article class="pc-card {% if compact_mode %}is-compact{% endif %}">Switcherens andet job er at køre Betingelser. Ethvert felt i widgetten kan indstilles til kun at blive vist, når Switcheren er tændt, så skift “Vis badge” kan også afsløre et badge tekstfelt og en badge farvekontrol i panelet. Det holder panelet kort, indtil indstillingen faktisk er i brug.
Pas på: hvis du sammenligner værdien eksplicit, skal du sammenligne med Return Value-strengen, ikke etiketten. {% if show_badge == 'yes' %} matcher standard Return Value; {% if show_badge == 'Yes' %} matcher aldrig, for “Ja” er kun vippets visningstekst. Nøgen sandhed, {% if show_badge %}, omgår spørgsmålet.
Brug Switcher-kontrollen i Elementor #
Tilføj din brugerdefinerede widget til en side i Elementor (genindlæs editoren, hvis siden allerede var åben). Switcheren vises som standard Elementor-skift under din etiket. Klik på den, og forhåndsvisningen opdateres med det samme; eventuelle felter, der er betinget af den, vises eller forsvinder i panelet på samme tid.
Almindelige brugstilfælde #
- Valgfri badges og bånd på kort, pakket ind i en
{% if %}block. - Layoutvarianter som en kompakt tilstand, anvendt som en modifikatorklasse.
- Vis/skjul sektioner såsom en sidefodsnote, et ikon eller en sekundær knap.
- Funktionskontakter til scripts, hvor JS-panelet læser værdien for at aktivere automatisk afspilning eller animation.
- Panel gatekeeping, der kun afslører en gruppe relaterede kontroller, når deres funktion er slået til.
Tips til at arbejde med Switcher-feltet #
- Test sandhed, ikke etiketter.
{% if show_badge %}er alt, hvad de fleste skabeloner har brug for; tænd-tilstanden er en ikke-tom streng, og slukket-tilstanden er tom. - Pak hele den valgfrie blok ind. Sæt
{% if %}omkring den komplette markup medfølger indpakning, så en off-skift efterlader ingen tomme elementer til at bryde afstanden. - Standard bevidst. Start skiftet til (Standard = Returværdi) for funktioner, de fleste websteder ønsker, fra for ekstramateriale.
- Par det med betingelser. En switcher plus to eller tre betingede felter læser langt bedre i panelet end fem altid synlige kontroller.
- Nævn det som et spørgsmål, som vippen svarer på.
show_badgeogcompact_modelæs naturligt indeni{% if %}blocks.
Ofte stillede spørgsmål #
Hvad er Switcher-feltet i Master Addons Widget Builder?
Feltet Switcher tilføjer Elementors tænd/sluk-skift til en brugerdefineret widget. Når den er tændt, holder den sin Return Value-streng (yes som standard); når den er slukket, holder den en tom streng. Skabeloner ombryder typisk valgfri markering i {% if field_name %} ... {% endif %} at reagere på det.
Hvilken værdi gemmer Switcheren egentlig?
En streng. On betyder den Returværdi du konfigurerede, off betyder en tom streng. Der er ingen sand/falsk boolesk, hvorfor eksplicitte sammenligninger skal matche Returværdien nøjagtigt.
Hvordan viser jeg kun markup, når vippen er tændt?
Pak det ind i en betinget i HTML-panelet: {% if show_badge %}<span class="badge">Popular</span>{% endif %}. Blokken gengiver slet ingenting, mens vippen er slukket.
Kan en Switcher vise eller skjule andre felter i panelet?
Ja, og det er den mest almindelige driver til det. Indstil Betingelser på ethvert andet felt skal du kræve Switcherens værdi, og disse kontroller vises kun i Elementor, mens skiftet er tændt.
Hvorfor består min {% if show_badge == 'Ja' %} check aldrig?
Fordi “Ja” er skiftets Label On-tekst, ikke dens værdi. Den gemte værdi er Return Value, yes med små bogstaver som standard. Sammenlign med det, eller brug blot {% if show_badge %}.
Kan jeg ændre, hvad feltet returnerer, når det er tændt?
Ja, gennem indstillingen Returværdi. Dette er nyttigt, når JS-panelet forventer en bestemt flagstreng, eller når du udskriver værdien direkte i en dataattribut.
Indpakning #
Feltet Widget Builder Switcher er det mindste kontrolelement med den bredeste rækkevidde: en vippe kan tilføje opmærkning, bytte klasser og omforme panelet gennem Betingelser på én gang. Kombiner det med en Nummerfelt for afstembare funktioner eller en Repeaterfelt hvis valgfrie ekstramateriale det afslører. Udforsk resten af Master Addons widgets og udvidelser, og se den prissætning side for hvad hver plan indeholder.