Gå til indhold

Felttyper

Blockstudio tilbyder en række felttyper til opbygning af blokgrænseflader.

Projekter kan også registrere deres egne felttyper med navnerum ved hjælp af blockstudio/field_types. Brug denne løsning, når du har brug for en ny redigeringskontrol eller en struktureret værdiform. Brug felter af typen custom/{name}, når du kun har brug for at genbruge en gruppe eksisterende felter.

Field Patterns Cookbook

Praktiske opskrifter: betingede grupper, smarte valglister, repeatere og forespørgselsbaseret lagring.

Generelle egenskaber

Tabellen nedenfor viser fælles egenskaber og almindelige værdimuligheder. default og fallback understøttes, hvor de er angivet i tabellen over egenskaber for hver felttype.

Egenskab Type Beskrivelse
id string Entydig identifikator for attributten
type string Felttypen
label string Visningsetiket, der vises i editoren
description string Beskrivelsestekst, der vises under feltet
default mixed Standardværdi for feltet
fallback mixed Reserveværdi, når feltet er tomt
help string Hjælpetekst, der vises som et værktøjstip ved siden af etiketten
hidden boolean Skjul feltet i UI
switch boolean Vis en til/fra-knap, der kan deaktivere feltet. Standardværdien er false.
translate boolean Sæt til false for at udelade feltet fra konfigurationen WPML
conditions array Regler for betinget logik

Filfelter med "returnFormat": "id" bevarer importerede strengreferencer, herunder enkeltværdier i repeatere. Uafklarede navne viser reservekort uden miniaturebilleder; Blockstudio omsætter dem ikke til vedhæftnings-ID’er. Se bærbare mediehenvisninger for detaljer.

Se Indlæsning af ikoner for anmodninger fra vælgeren, nye forsøg og ikonundersæt.

attributes

Gengiver felter til indtastning af dataattributter.

JSON
{
  "type": "attributes"
}

Egenskaber

Egenskab Type Beskrivelse
default array Standardværdi, der anvendes, første gang blokken tilføjes.
fallback array Reserveværdi, der vises, når feltværdien er tom.
link boolean Gør det muligt at vælge et link fra en rullemenu.
media boolean Gør det muligt at vælge medier fra en rullemenu.

blok

Refererer til en anden Blockstudio-blok og udfolder dens felter direkte. I skabeloner returneres værdien som det renderede blokoutput.

JSON
{
  "type": "block"
}

Egenskaber

Egenskab Type Beskrivelse
block string Navnet på den blok, der skal refereres til (e.g., "mytheme/card").
returnFormat string Hvordan værdien skal returneres i skabeloner.

afkrydsningsfelt

Viser et sæt afkrydsningsfelter.

JSON
{
  "type": "checkbox",
  "options": [
    {
      "value": "option1",
      "label": "Option 1"
    },
    {
      "value": "option2",
      "label": "Option 2"
    }
  ]
}

Egenskaber

Egenskab Type Beskrivelse
default array | string | number Standardværdi, der skal anvendes, når blokken tilføjes første gang.
fallback array | string | number Reserveværdi, der vises, når feltværdien er tom.
options array Valgmuligheder.
returnFormat string Angiver returværdiformatet.
populate object
toggle boolean | string Tilføjer et afkrydsningsfelt over valgmulighederne, som vælger eller fravælger dem alle. En streng bruges som dets etiket, og true bruger standardetiketten.

klasser

Viser et felt til valg af CSS-klasser.

JSON
{
  "type": "classes"
}

Egenskaber

Egenskab Type Beskrivelse
default string Standardværdi, der anvendes, første gang blokken tilføjes.
fallback string Reserveværdi, der vises, når feltværdien er tom.
tailwind boolean Om Tailwind-klasser skal aktiveres for dette inputfelt.

kode

Viser en kodeeditor.

JSON
{
  "type": "code"
}

Egenskaber

Egenskab Type Beskrivelse
default string Standardværdi, der anvendes, når blokken tilføjes første gang.
fallback string Reserveværdi, der vises, når feltværdien er tom.
autoCompletion boolean Om autofuldførelse skal aktiveres.
foldGutter boolean Om foldningsmargen skal vises.
height string Editorens højde.
language string Det sprog, der skal bruges til synt fremhævning.
lineNumbers boolean Om linjenumre skal vises.
maxHeight string Editorens maksimale højde.
minHeight string Editorens minimale højde.
popout boolean Om der skal vises en knap, som åbner editoren i et pop op-vindue.
asset boolean Gengiver CSS, SCSS eller JavaScript fra feltet som et blokaktiv, så skabelonen ikke behøver at udskrive style- eller script-tagget.

farve

Viser en farvepalette og farvevælger.

JSON
{
  "type": "color",
  "options": [
    {
      "value": "option1",
      "label": "Option 1"
    },
    {
      "value": "option2",
      "label": "Option 2"
    }
  ]
}

Egenskaber

Egenskab Type Beskrivelse
default string Værdien af den indstilling, der skal vælges, når blokken tilføjes første gang.
fallback string Værdien af den indstilling, der vises, når feltværdien er tom.
options array
populate object
clearable boolean Om paletten skal have en knap til at rydde valget.
disableCustomColors boolean Om brugerdefinerede farver skal tillades.

dato

Viser en datovælger.

JSON
{
  "type": "date"
}

Egenskaber

Egenskab Type Beskrivelse
default string Standardværdi, der anvendes, første gang blokken tilføjes.
fallback string Reserveværdi, der vises, når feltværdien er tom.
startOfWeek number Ugedagen, som ugen skal begynde på. 0 for søndag, 1 for mandag osv.

dato og klokkeslæt

Viser en dato- og tidsvælger.

JSON
{
  "type": "datetime"
}

Egenskaber

Egenskab Type Beskrivelse
default string Standardværdi, der anvendes, første gang blokken tilføjes.
fallback string Reserveværdi, der vises, når feltværdien er tom.
is12Hour boolean Om der bruges et 12-timers ur. Med et 12-timers ur vises en AM/PM-komponent, og tidsformatet antages at være MM-DD-YYYY (i modsætning til standardformatet DD-MM-YYYY).

filer

Viser en knap til mediebiblioteket. Valgte elementer kan omarrangeres direkte.

JSON
{
  "type": "files",
  "min": 0,
  "max": 100,
  "multiple": false
}

Egenskaber

Egenskab Type Beskrivelse
default array | object | number Standardværdi, der anvendes, første gang blokken tilføjes.
fallback array | object | number Reserveværdi, der vises, når feltværdien er tom.
addToGallery boolean Hvis true åbner galleriets mediedialog direkte i mediebiblioteket, hvor brugeren kan tilføje flere billeder. Hvis false åbner galleriets mediedialog i redigeringstilstand, hvor brugeren kan redigere eksisterende billeder ved at omarrangere dem, fjerne dem eller ændre deres attributter. Gælder kun, hvis gallery === true.
allowedTypes array | string Array med de medietyper, der kan uploades eller vælges fra mediebiblioteket. Hver type er en streng, der kan indeholde den generelle MIME-type e.g: ‘image’, ‘audio’, ‘text’ eller den fulde MIME-type e.g: ‘audio/mpeg’, ‘image/gif’. Hvis allowedTypes ikke er angivet, tillades alle MIME-typer.
gallery boolean Hvis true initialiserer komponenten alle de tilstande, der kræves for at repræsentere et galleri. Som standard åbnes mediedialogen i galleriets redigeringsvisning, men dette kan ændres med addToGalleryflag.
max number Maksimalt antal filer, der kan tilføjes.
min number Minimalt antal filer, der kan tilføjes.
multiple boolean Om flere valg skal tillades.
size boolean Føjer en rullemenu til valg af mediestørrelse til feltet.
textMediaButton string Medieknappens tekst.
title string Titel, der vises i mediedialogen.
returnFormat string Angiver værdiformatet, der skal returneres.
returnSize string Mediestørrelsen, der skal returneres ved brug af returformatet URL.

farveovergang

Viser en farveovergangspalette og farveovergangsvælger

JSON
{
  "type": "gradient",
  "options": [
    {
      "value": "option1",
      "label": "Option 1"
    },
    {
      "value": "option2",
      "label": "Option 2"
    }
  ]
}

Egenskaber

Egenskab Type Beskrivelse
default string Værdien af den indstilling, der skal vælges, når blokken tilføjes første gang.
fallback string Værdien af den indstilling, der vises, når feltværdien er tom.
options array
populate object
clearable boolean Om paletten skal have en knap til at rydde valget.
disableCustomGradients boolean Om brugerdefinerede farver skal tillades.

gruppe

Viser flere felter i en (valgfrit) sammenklappelig beholder.

JSON
{
  "type": "group"
}

Egenskaber

Egenskab Type Beskrivelse
title string Titeltekst. Den vises også, når komponenten er lukket.
opened boolean Når værdien er true, forbliver komponenten åben uanset initialOpen-egenskaben og
initialOpen boolean Om panelet skal være åbent fra start.
scrollAfterOpen boolean Ruller indholdet ind i visningen, når det bliver synligt.
class string Brugerdefineret CSS-klasse, der anvendes på gruppen.
style object Brugerdefinerede CSS-stile, der anvendes på gruppen.
attributes array Accepterer alle andre felttyper bortset fra en anden fanebladstype.

html-tag

Viser en HTML-vælger. Nyttig til valg af overskriftsniveauer eller semantiske elementer.

JSON
{
  "type": "html-tag"
}

Egenskaber

Egenskab Type Beskrivelse
default string Standardværdi, der anvendes, første gang blokken tilføjes.
fallback string Reserveværdi, der vises, når feltværdien er tom.
tags string | array Hvilke tags der skal medtages. Brug en forudindstillet streng eller et array med tagnavne.
exclude array Tags, der skal udelades fra forudindstillingen. Gælder kun, når der bruges en forudindstillet streng til tags.

ikon

Viser et SVG-ikon fra et ikonsæt.

JSON
{
  "type": "icon"
}

Egenskaber

Egenskab Type Beskrivelse
default object Standardværdi, der anvendes, første gang blokken tilføjes.
fallback object Reserveværdi, der vises, når feltværdien er tom.
sets array | string Hvilket ikonsæt der skal medtages. Lad feltet være tomt for at medtage alle.
subSets array | string Hvilket underikonsæt der skal medtages. Lad feltet være tomt for at medtage alle.
returnFormat string Formatet, ikonet skal returneres i.

Viser en linkkontrol til valg af interne eller eksterne links.

JSON
{
  "type": "link"
}

Egenskaber

Egenskab Type Beskrivelse
default object Standardværdi, der anvendes, første gang blokken tilføjes.
fallback object Reserveværdi, der vises, når feltværdien er tom.
hasRichPreviews boolean Om der skal vises omfattende forhåndsvisninger, når der tilføjes et URL.
noDirectEntry boolean Om en søgeforespørgsel i stil med URL direkte kan konverteres til et link.
noURLSuggestion boolean Om der skal tilføjes et reserveforslag, som behandler søgeforespørgslen som en URL.
opensInNewTab boolean Tilføjer en skifteknap til linkdialogen.
showSuggestions boolean Om der skal vises forslag, mens der indtastes i URL.
textButton string Brugerdefineret tekst, der skal vises i linkknappen.
withCreateSuggestion boolean Om søgninger efter links uden match kan oprette et forslag til en ny kladdeside.

meddelelse

Viser en meddelelse med brugerdefineret indhold.

JSON
{
  "type": "message"
}

Egenskaber

Egenskab Type Beskrivelse
default string Standardværdi, der anvendes, første gang blokken tilføjes.
fallback string Reserveværdi, der vises, når feltværdien er tom.
value string Meddelelsen, der skal vises. Blok- og attributdata er tilgængelige med klammeparentessyntaks, e.g.: {block.title} eller {attributes.text}

tal

Viser et talinputfelt.

JSON
{
  "type": "number",
  "min": 0,
  "max": 100,
  "step": 1
}

Egenskaber

Egenskab Type Beskrivelse
default number Standardværdi, der anvendes, første gang blokken tilføjes.
fallback number Reserveværdi, der vises, når feltværdien er tom.
dragDirection string Bestemmer trækaksen, der bruges til at øge eller mindske værdien.
dragThreshold number Hvis isDragEnabled er true, angiver dette, hvor mange px der skal trækkes, før værdien ændres.
hideHTMLArrows boolean Hvis true skjules standardpilene i inputfeltet HTML.
isShiftStepEnabled boolean Hvis true aktiveres musebevægelsen, der øger eller mindsker talværdien. Hvis SHIFT holdes nede under træk, øges værdien med shiftStep.
max number Den maksimale værdilængde.
min number Minimal værdilængde.
required boolean Hvis true kræves et gyldigt tal inden for kontrolfeltets min-/maksinterval. Hvis false accepteres en tom streng som gyldig værdi.
shiftStep number Hvor meget værdien øges, når SHIFT-tasten holdes nede. Denne forskydningsværdi er en multiplikator for trinværdien. Hvis trinværdien f.eks. er 5, og shiftStep er 10, øges eller mindskes værdien med 50 for hvert spring.
step number Hvor meget værdien ændres ved øgning eller mindskning. Det bruges også til validering, da værdien skal være et multiplum af step (forskudt med min, hvis angivet) for at være gyldig. Accepterer den særlige strengværdi any, som ophæver valideringsbegrænsningen og får trinhandlinger til at øge eller mindske værdien med 1.

alternativknap

Viser et sæt alternativknapper.

JSON
{
  "type": "radio",
  "options": [
    {
      "value": "option1",
      "label": "Option 1"
    },
    {
      "value": "option2",
      "label": "Option 2"
    }
  ]
}

Egenskaber

Egenskab Type Beskrivelse
default string | number Standardværdi, der anvendes, når blokken tilføjes første gang.
fallback string | number Reserveværdi, der vises, når feltværdien er tom.
options array Mulige valgmuligheder.
returnFormat string Angiver returværdiens format.
populate object
display string Sæt til buttonGroup for at vise valgmulighederne som en gruppe knapper i stedet for alternativknapper.
allowNull boolean Giver brugeren mulighed for at rydde værdien ved at klikke på den valgte alternativknap igen.

interval

Viser et intervalinputfelt til angivelse af en talværdi mellem to punkter.

JSON
{
  "type": "range",
  "min": 0,
  "max": 100,
  "step": 1
}

Egenskaber

Egenskab Type Beskrivelse
default number Standardværdi, der anvendes, første gang blokken tilføjes.
fallback number Reserveværdi, der vises, når feltværdien er tom.
allowReset boolean Hvis denne egenskab er true, vises en knap til nulstilling af skyderen.
initialPosition number Skyderens startposition, der bruges, når der ikke er angivet nogen værdi. initialPosition begrænses til intervallet mellem de angivne min- og max-egenskabsværdier.
isShiftStepEnabled boolean Hvis true aktiveres musebevægelsen, der øger eller mindsker talværdien. Hvis SHIFT holdes nede under træk, øges værdien med shiftStep.
marks array Viser en visuel repræsentation af trintakmærker. Brugerdefinerede markører kan angives med et Array.
max number Den maksimale værdilængde.
min number Minimal værdilængde.
railColor string CSS-farvestreng til tilpasning af skinnens baggrund.
resetFallbackValue number Den værdi, der gendannes, hvis der klikkes på knappen Nulstil (aktiveret af allowReset)
separatorType string Angiver, om skillelinjen over eller under kontrolrækken skal være deaktiveret eller have fuld bredde. Som standard placeres den under rækken, men dækker ikke kontrolikonets understregning.
shiftStep number Hvor meget værdien øges, når SHIFT-tasten holdes nede. Denne forskydningsværdi er en multiplikator for trinværdien. Hvis trinværdien f.eks. er 5, og shiftStep er 10, øges eller mindskes værdien med 50 for hvert spring.
showTooltip boolean Tvinger værktøjstipset UI til at blive vist eller skjult. Tilsidesættes med false, når step er angivet til den særlige strengværdi any.
step number Hvor meget værdien ændres ved øgning eller mindskning. Det bruges også til validering, da værdien skal være et multiplum af step (forskudt med min, hvis angivet) for at være gyldig. Accepterer den særlige strengværdi any, som ophæver valideringsbegrænsningen og får trinhandlinger til at øge eller mindske værdien med 1.
trackColor string CSS-farvestreng til tilpasning af sporets baggrund.
withInputField boolean Afgør, om talinputfeltet vises ved siden af RangeControl. Tilsidesættes med false, når step er angivet til den særlige strengværdi any.

valg

Viser et valgfelt med understøttelse af enkelt- og flervalg.

JSON
{
  "type": "select",
  "options": [
    {
      "value": "option1",
      "label": "Option 1"
    },
    {
      "value": "option2",
      "label": "Option 2"
    }
  ],
  "multiple": false
}

Egenskaber

Egenskab Type Beskrivelse
default array | string | number Standardværdi, der anvendes, første gang blokken tilføjes.
fallback array | string | number Reserveværdi, der vises, når feltværdien er tom.
multiple boolean Hvis true kan flere muligheder vælges. "stylisedUi" aktiveres automatisk.
options array Muligheder at vælge imellem.
returnFormat string Angiver værdiformatet, der skal returneres.
populate object
stylisedUi boolean Viser en stiliseret version af et valgfelt med mulighed for at søge blandt elementerne.
allowNull boolean | string Tillader brugeren at vælge en tom mulighed. Hvis true er etiketten tom; ellers vises den angivne streng som mulighed.
allowReset boolean Hvis denne egenskab er true, vises en knap til nulstilling af valget.

faner

Viser en grænseflade med faner til gruppering af felter.

JSON
{
  "type": "tabs"
}

Egenskaber

Egenskab Type Beskrivelse
tabs array Fanerne, der skal vises.

tekst

Viser et enkeltlinjet tekstinputfelt.

JSON
{
  "type": "text",
  "min": 0,
  "max": 100
}

Egenskaber

Egenskab Type Beskrivelse
default string Standardværdi, der anvendes, første gang blokken tilføjes.
fallback string Reserveværdi, der vises, når feltværdien er tom.
max number Den maksimale værdilængde.
min number Minimal værdilængde.

tekstområde

Viser et tekstområde-inputfelt.

JSON
{
  "type": "textarea",
  "min": 0,
  "max": 100,
  "rows": 4
}

Egenskaber

Egenskab Type Beskrivelse
default string Standardværdi, der anvendes, første gang blokken tilføjes.
fallback string Reserveværdi, der vises, når feltværdien er tom.
max number Den maksimale værdilængde.
min number Minimal værdilængde.
rows number Antallet af rækker, tekstområdet skal indeholde.

til/fra-knap

Viser en til/fra-knap for true/false.

JSON
{
  "type": "toggle"
}

Egenskaber

Egenskab Type Beskrivelse
default boolean Standardværdi, der anvendes, første gang blokken tilføjes.
fallback boolean Reserveværdi, der vises, når feltværdien er tom.

gentager

Viser et sæt felter, der kan gentages.

JSON
{
  "type": "repeater",
  "min": 0,
  "max": 100
}

Egenskaber

Egenskab Type Beskrivelse
default array Rækker, som en ny blok starter med. Hver række er et objekt med feltværdier. Har forrang frem for de rækker, som min opretter.
min number Mindste antal rækker.
max number Største antal rækker.
minimized boolean Skjul de eksisterende rækker, når editoren åbnes. Rækker, der tilføjes i editoren, starter udfoldede.
textButton string Tekst på tilføj-knappen.
textMinimized string | object Tekst, der vises, når rækkerne er minimeret.
textRemove string | boolean Bekræftelsesspørgsmål, der vises i editoren, når en gentagerrække fjernes. En ikke-tom streng ændrer spørgsmålet; false fjerner rækken straks uden en dialog. Hvis værdien udelades, er true eller er en tom streng, bruges standards spørgsmålet.
attributes array Accepterer alle andre felttyper end endnu et tabs-felt.

richtext

Attributfelt til RichText-felter.

JSON
{
  "type": "richtext"
}

Egenskaber

Egenskab Type Beskrivelse
default string Standardværdi, der anvendes, når blokken tilføjes første gang.
fallback string Reserveværdi, der vises, når feltværdien er tom.

unit

Viser et talfelt med en rullemenu til enheder.

JSON
{
  "type": "unit"
}

Egenskaber

Egenskab Type Beskrivelse
default string Standardværdi, der anvendes, når blokken tilføjes første gang.
fallback string Reserveværdi, der vises, når feltværdien er tom.
disableUnits boolean Hvis værdien er true, skjules feltet til valg af enhed.
isPressEnterToChange boolean Hvis værdien er true, skal der trykkes på ENTER for at udløse onChange. Hvis indstillingen er aktiveret, udløses en ændring også, når man tabber væk fra feltet.
isResetValueOnUnitChange boolean Hvis værdien er true, og den valgte enhed har en standardværdi, angives denne værdi ved skift af enhed.
isUnitSelectTabbable boolean Angiver, om feltet til valg af enhed kan fokuseres med tabulatortasten.
units array

wysiwyg

Viser en WYSIWYG-editor.

JSON
{
  "type": "wysiwyg"
}

Egenskaber

Egenskab Type Beskrivelse
default string Standardværdi, der anvendes, når blokken tilføjes første gang.
fallback string Reserveværdi, der vises, når feltværdien er tom.
toolbar object Editorens værktøjslinjekonfiguration.
mode string code åbner feltet i kodevisningen. both tilføjer en knap til at skifte mellem den visuelle visning og kodevisningen.

Indlæsning af ikoner

Editoren indlæser et ikonsæt, når du fokuserer på vælgeren første gang eller ændrer sættet eller undersættet, ikke når du vælger blokken. Felter, der anmoder om det samme sæt, deler den igangværende anmodning. Det gemte ikonnavn forbliver synligt før indlæsning, og hvis du fokuserer på vælgeren igen, forsøges en mislykket anmodning igen.

tabler-icons understøtter outline og filled. Et undersæt, der er konfigureret specifikt til det valgte sæt, har forrang; ellers bruger vælgeren solid, hvis det er tilgængeligt, eller sættets første undersæt. Sæt uden undersæt udelader subSet. Sætnavne slås kun op i medfølgende filer. Gengivelse på frontend cacher enkelte ikoner i stedet for at gemme hele ikonsæt i database-transienter.

Importerede indstillingsværdier

Afkrydsningsfelter og rullelister med "multiple": true gemmer normalt et array af { "value": "...", "label": "..." }-objekter. De accepterer også et enkelt indstillingsobjekt, en skalar streng eller et tal samt et array af skalare værdier, der importeres via REST API eller indholdsværktøjer. Dette fungerer også i gentagerrækker.

Editoren viser disse værdier som valg uden at omskrive deres lagrede struktur, når der gemmes uden ændringer. Hvis et valg tilføjes eller fjernes, gemmes værdierne som det sædvanlige array af indstillingsobjekter. Numeriske 0 og strengværdier "0" er gyldige valg. Skabeloner modtager feltets konfigurerede returnFormat, ligesom de gør for værdier, der er valgt i editoren. Valgmulighederne skal stadig passe til feltets deklarerede eller udfyldte valg.

En indbygget rulleliste med ét valg og uden en gemt værdi eller standardværdi viser en deaktiveret tom pladsholder i stedet for sin første mulighed. Hvis den første mulighed vælges eksplicit, gemmes den. Når et valg er gemt, forsvinder pladsholderen. Brug allowNull, når redaktører også skal kunne rydde et valg; en tom pladsholder gør ikke i sig selv et obligatorisk valg muligt at rydde.

Gentagerens startrækker

I editoren omfatter standardværdier indlejrede minimumsrækker, før indsættelse. Du behøver ikke åbne blokkens indstillinger for at initialisere dem, og indsættelse af blokken tilføjer ikke et ekstra trin til fortrydelse for disse rækker.

Når et gentagelsesfelt har min, men ingen gemt værdi eller eksplicit default, initialiserer serveren så mange rækker med standardværdierne fra rækkernes felter. Dette gælder også for PHP-indlejringer, bloktags og filbaserede sidekilder, der aldrig er blevet åbnet i editoren. For eksempel gengiver "min": 2 med et tekstfelt, hvis standardværdi er "New item", to rækker, der indeholder den værdi.

Gemte rækker og en eksplicit gentagelsesværdi default har forrang. En eksplicit gemt tom liste, false eller null genskaber ikke fjernede rækker. Gengivelse gemmer ikke disse genererede standardværdier på indlægget. min og max begrænser editorens kontrolelementer; de afkorter eller udfylder ikke en gemt liste ved gengivelse. Brug bs_validate_block() til at rapportere overtrædelser af rækkebegrænsninger i importeret indhold.

Rækkefelter uden default er false i en genereret række, så sådan en række har intet indhold. Rækker, som redaktører tilføjer og lader stå tomme, ser ens ud. En skabelon, der udskriver et kort, en overskrift eller et listeelement for hver række, bør springe rækker uden indhold over uden for editoren og beholde dem i editoren, så deres felter fortsat kan redigeres:

PHP
<?php foreach ( $a['items'] as $item ) : ?>
  <?php if ( ! $isEditor && ! $item['title'] && ! $item['text'] ) continue; ?>
  <div class="item">
    <h3><?php echo $item['title']; ?></h3>
    <p><?php echo $item['text']; ?></p>
  </div>
<?php endforeach; ?>

Fjernelse af gentagelsesrækker

Når en række fjernes, åbnes editorens bekræftelsesdialog med knapperne Slet og Annuller. Annuller eller Escape lader rækken være uændret. Rækken fjernes først efter bekræftelse, også i indlejrede gentagelsesfelter.

textRemove styrer den samme adfærd for alle gentagelsesfelter:

Værdi Adfærd
Udeladt, true eller "" Vis standardbekræftelsen.
En ikke-tom streng Vis det tilpassede spørgsmål ved hjælp af den eksisterende mekanisme til oversættelse af tilpasset tekst.
false Fjern rækken straks uden en dialog.

For eksempel ændrer "textRemove": "Remove this team member?" spørgsmålet. Den eksisterende begrænsning min forhindrer fortsat fjernelse af rækker under minimumsantallet.

Indlejring af gentagelsesfelter

En gentagelsesrække accepterer alle felttyper undtagen tabs. Et tabs-felt i en række, også inde i en gruppe uden en id, viser en meddelelse i editoren i stedet for sine felter. Udvidelsen PHPStan rapporterer det for block.json og field.json. Hold rækkens felter på samme niveau, eller flyt fanerne uden for gentagelsesfeltet.

WYSIWYG-linkværktøjslinjen indsætter som standard links, der åbnes i samme fane, uden at tilføje target eller rel. Aktivér indstillingen for nye faner med toolbar.formats.link.opensInNewTab:

JSON
{
  "id": "content",
  "type": "wysiwyg",
  "toolbar": {
    "formats": {
      "link": {
        "opensInNewTab": true
      }
    }
  }
}

Når der vælges en ny fane, tilføjes target="_blank" og rel="noreferrer noopener". Når indstillingen slås fra, fjernes disse automatiske attributter. Hvis du vil anvende attributter på alle links i feltet, skal du angive toolbar.formats.link.attributes, for eksempel { "class": "content-link", "rel": "nofollow" }. Eksplicit konfiguration bevares, og sikkerhedstokens for nye faner føjes til den konfigurerede rel.

En indtastet URL bliver ikke automatisk til et link, og et klik på et eksisterende link i feltet fører ikke væk fra editoren. Tidligere gemte linkattributter bevares i eksisterende indhold; de overføres ikke automatisk.