Ugrás a tartalomhoz

Mezőtípusok

A Blockstudio számos mezőtípust kínál blokkfelületek kialakításához.

A projektek saját, névtérrel ellátott mezőtípusokat is regisztrálhatnak a blockstudio/field_types használatával. Akkor válassza ezt, ha új szerkesztővezérlőre vagy strukturált értékre van szüksége. A custom/{name} mezőket akkor használja, ha csupán meglévő mezők csoportját szeretné újrafelhasználni.

Mezőminták szakácskönyve

Gyakorlati példák: feltételes csoportok, intelligens választómezők, ismétlők és lekérdezhető tárolás.

Általános tulajdonságok

Az alábbi táblázat a közös tulajdonságokat és a gyakori értékbeállításokat sorolja fel. A default és a fallback az egyes mezőtípusok Tulajdonságok táblázatában megadott esetekben támogatott.

Tulajdonság Típus Leírás
id karakterlánc Az attribútum egyedi azonosítója
type karakterlánc A mezőtípus
label karakterlánc A szerkesztőben megjelenő címke
description karakterlánc A mező alatt megjelenő leírás
default vegyes A mező alapértelmezett értéke
fallback vegyes Tartalékérték, ha a mező üres
help karakterlánc Súgószöveg, amely címke melletti elemleírásként jelenik meg
hidden logikai A mező elrejtése a UI elől
switch logikai Kapcsoló megjelenítése, amellyel letiltható a mező. Alapértelmezett értéke false.
translate logikai Állítsa false értékre, ha ki szeretné hagyni a mezőt a WPML konfigurációból
conditions tömb Feltételes logikai szabályok

A "returnFormat": "id" értékű fájlmezők megőrzik az importált karakterlánc-hivatkozásokat, az ismétlőcsoportokon belüli egyedi értékeket is beleértve. A fel nem oldott nevek bélyegkép nélküli tartalékkártyaként jelennek meg; a Blockstudio nem oldja fel őket mellékletazonosítókká. Részletekért lásd: hordozható médiahivatkozások.

A választóval kapcsolatos kérésekről, újrapróbálkozásokról és ikonkészletekről lásd: Ikonok betöltése.

attribútumok

Adatattribútum-bemeneteket jelenít meg.

JSON
{
  "type": "attributes"
}

Tulajdonságok

Tulajdonság Típus Leírás
default array Az alapértelmezett érték, amelyet a blokk első hozzáadásakor kell alkalmazni.
fallback array Tartalékérték, amely akkor jelenik meg, ha a mező értéke üres.
link boolean Lehetővé teszi hivatkozás kiválasztását egy legördülő listából.
media boolean Lehetővé teszi média kiválasztását egy legördülő listából.

blokk

Egy másik Blockstudio blokkra hivatkozik, és annak mezőit beágyazva jeleníti meg. Sablonokban az érték a megjelenített blokk kimenetét adja vissza.

JSON
{
  "type": "block"
}

Tulajdonságok

Tulajdonság Típus Leírás
block string A hivatkozandó blokk neve (e.g., „mytheme/card”).
returnFormat string Az érték visszaadásának módja a sablonokban.

jelölőnégyzet

Jelölőnégyzetek csoportját jeleníti meg.

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

Tulajdonságok

Tulajdonság Típus Leírás
default array | string | number Alapértelmezett érték, amelyet a blokk első hozzáadásakor kell alkalmazni.
fallback array | string | number Tartalékérték, amely akkor jelenik meg, ha a mező értéke üres.
options array Választható beállítások.
returnFormat string Meghatározza a visszatérési érték formátumát.
populate object
toggle boolean | string Jelölőnégyzetet ad a beállítások fölé, amellyel mindegyik kiválasztható vagy törölhető. A címkéje karakterláncként adható meg; a true az alapértelmezett címkét használja.

osztályok

Mezőt jelenít meg CSS osztályok kiválasztásához.

JSON
{
  "type": "classes"
}

Tulajdonságok

Tulajdonság Típus Leírás
default string Az alapértelmezett érték, amelyet a blokk első hozzáadásakor kell alkalmazni.
fallback string Tartalékérték, amely akkor jelenik meg, ha a mező értéke üres.
tailwind boolean Megadja, hogy engedélyezze-e a Tailwind osztályokat ehhez a beviteli mezőhöz.

kód

Kódszerkesztőt jelenít meg.

JSON
{
  "type": "code"
}

Tulajdonságok

Tulajdonság Típus Leírás
default string Alapértelmezett érték, amelyet a blokk első hozzáadásakor kell alkalmazni.
fallback string Tartalékérték, amely akkor jelenik meg, ha a mező értéke üres.
autoCompletion boolean Engedélyezze-e az automatikus kiegészítést.
foldGutter boolean Megjelenjen-e az összecsukási sáv.
height string A szerkesztő magassága.
language string A szintaxiskiemeléshez használandó nyelv.
lineNumbers boolean Megjelenjenek-e a sorszámok.
maxHeight string A szerkesztő maximális magassága.
minHeight string A szerkesztő minimális magassága.
popout boolean Megjelenjen-e egy gomb, amely előugró ablakban nyitja meg a szerkesztőt.
asset boolean A mezőből származó CSS, SCSS vagy JavaScript blokk-eszközként jelenik meg, így a sablonnak nem kell kiírnia a stílus- vagy szkriptcímkét.

szín

Színpalettát és színválasztót jelenít meg.

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

Tulajdonságok

Tulajdonság Típus Leírás
default string Az opció értéke, amelyet a blokk első hozzáadásakor ki kell választani.
fallback string Az opció értéke, amely akkor jelenik meg, ha a mező értéke üres.
options array
populate object
clearable boolean Legyen-e törlőgomb a palettán.
disableCustomColors boolean Engedélyezettek-e az egyéni színek.

dátum

Dátumválasztót jelenít meg.

JSON
{
  "type": "date"
}

Tulajdonságok

Tulajdonság Típus Leírás
default string Az alapértelmezett érték, amelyet a blokk első hozzáadásakor kell alkalmazni.
fallback string Tartalékérték, amely akkor jelenik meg, ha a mező értéke üres.
startOfWeek number A hét kezdőnapja. 0 a vasárnap, 1 a hétfő stb.

dátum és idő

Dátum- és időválasztót jelenít meg.

JSON
{
  "type": "datetime"
}

Tulajdonságok

Tulajdonság Típus Leírás
default string Az alapértelmezett érték, amelyet a blokk első hozzáadásakor kell alkalmazni.
fallback string Tartalékérték, amely akkor jelenik meg, ha a mező értéke üres.
is12Hour boolean 12 órás órát használunk-e. 12 órás óra esetén AM/PM vezérlő jelenik meg, az idő formátuma pedig MM-DD-YYYY (az alapértelmezett DD-MM-YYYY formátum helyett).

fájlok

A médiatárat megnyitó gombot jelenít meg. A kiválasztott elemek sorrendje közvetlenül módosítható.

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

Tulajdonságok

Tulajdonság Típus Leírás
default array | object | number Az alapértelmezett érték, amelyet a blokk első hozzáadásakor kell alkalmazni.
fallback array | object | number Tartalékérték, amely akkor jelenik meg, ha a mező értéke üres.
addToGallery boolean Ha igaz, a galéria médiamodálja közvetlenül a médiatárban nyílik meg, ahol a felhasználó további képeket adhat hozzá. Ha hamis, a galéria médiamodálja szerkesztési módban nyílik meg, ahol a felhasználó átrendezheti, eltávolíthatja vagy módosíthatja a meglévő képek attribútumait. Csak akkor érvényes, ha gallery === true.
allowedTypes array | string A médiatárból feltöltendő vagy kiválasztandó médiatípusok tömbje. Minden típus olyan karakterlánc, amely tartalmazhat általános MIME-típust e.g: ‘image’, ‘audio’, ‘text’, vagy teljes MIME-típust e.g: ‘audio/mpeg’, ‘image/gif’. Ha az allowedTypes nincs beállítva, minden MIME-típus engedélyezett.
gallery boolean Ha igaz, a komponens elindítja a galéria megjelenítéséhez szükséges összes állapotot. Alapértelmezés szerint a médiamodál a galéria szerkesztőnézetében nyílik meg, de ez az addToGalleryflag használatával megváltoztatható.
max number A hozzáadható fájlok maximális száma.
min number A hozzáadható fájlok minimális száma.
multiple boolean Engedélyezett-e több elem kiválasztása.
size boolean Méretválasztó legördülő listát ad a mezőhöz.
textMediaButton string A médiagomb szövege.
title string A médiamodálban megjelenő cím.
returnFormat string Megadja a visszatérési érték formátumát.
returnSize string A visszaadandó médiaméret a URL visszatérési formátum használatakor.

színátmenet

Színátmenet-palettát és -választót jelenít meg.

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

Tulajdonságok

Tulajdonság Típus Leírás
default string Az opció értéke, amelyet a blokk első hozzáadásakor ki kell választani.
fallback string Az opció értéke, amely akkor jelenik meg, ha a mező értéke üres.
options array
populate object
clearable boolean Legyen-e törlőgomb a palettán.
disableCustomGradients boolean Engedélyezettek-e az egyéni színek.

csoport

Több mezőt jelenít meg egy (opcionálisan) összecsukható tárolóban.

JSON
{
  "type": "group"
}

Tulajdonságok

Tulajdonság Típus Leírás
title string Címszöveg. Akkor is látható, ha a komponens zárva van.
opened boolean Ha true értékre van állítva, a komponens a initialOpen tulajdonság értékétől és a következőtől függetlenül nyitva marad:
initialOpen boolean Megadja, hogy a panel kezdetben nyitva legyen-e.
scrollAfterOpen boolean Láthatóvá váláskor a tartalmat a nézetbe görgeti.
class string Egyéni CSS osztály, amelyet a csoport kap.
style object Egyéni CSS stílusok, amelyeket a csoport kap.
attributes array A másik tabs kivételével minden mezőtípust elfogad.

html-tag

HTML címkeválasztót jelenít meg. Hasznos címsorszintek vagy szemantikai elemek kiválasztásához.

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

Tulajdonságok

Tulajdonság Típus Leírás
default string Az alapértelmezett érték, amelyet a blokk első hozzáadásakor kell alkalmazni.
fallback string Tartalékérték, amely akkor jelenik meg, ha a mező értéke üres.
tags string | array A felveendő címkék. Használjon előre beállított karakterláncot vagy címkeneveket tartalmazó tömböt.
exclude array Az előbeállításból kizárandó címkék. Csak akkor érvényes, ha a címkékhez előre beállított karakterláncot használ.

ikon

Ikonkészletből származó SVG-ikont jelenít meg.

JSON
{
  "type": "icon"
}

Tulajdonságok

Tulajdonság Típus Leírás
default object Az alapértelmezett érték, amelyet a blokk első hozzáadásakor kell alkalmazni.
fallback object Tartalékérték, amely akkor jelenik meg, ha a mező értéke üres.
sets array | string A felveendő ikonkészlet. Hagyja üresen az összes felvételéhez.
subSets array | string A felveendő alikonkészlet. Hagyja üresen az összes felvételéhez.
returnFormat string Az ikon visszatérési formátuma.

Hivatkozásvezérlőt jelenít meg belső vagy külső hivatkozások kiválasztásához.

JSON
{
  "type": "link"
}

Tulajdonságok

Tulajdonság Típus Leírás
default object Az alapértelmezett érték, amelyet a blokk első hozzáadásakor kell alkalmazni.
fallback object Tartalékérték, amely akkor jelenik meg, ha a mező értéke üres.
hasRichPreviews boolean Megjelenjenek-e gazdag előnézetek egy URL hozzáadásakor.
noDirectEntry boolean Engedélyezett-e a URL-szerű keresőkifejezés közvetlen hivatkozássá alakítása.
noURLSuggestion boolean Tartalékjavaslatot ad hozzá, amely keresőkifejezésként kezeli a URL-t.
opensInNewTab boolean Kapcsolóvezérlőt ad hozzá a hivatkozásmodálhoz.
showSuggestions boolean Javaslatok jelenjenek-e meg a URL beírásakor.
textButton string A hivatkozásgombon megjelenítendő egyéni szöveg.
withCreateSuggestion boolean Létrehozhatnak-e az egyezés nélküli hivatkozáskeresések új piszkozatoldal-javaslatot.

üzenet

Egyéni tartalmú üzenetet jelenít meg.

JSON
{
  "type": "message"
}

Tulajdonságok

Tulajdonság Típus Leírás
default string Az alapértelmezett érték, amelyet a blokk első hozzáadásakor kell alkalmazni.
fallback string Tartalékérték, amely akkor jelenik meg, ha a mező értéke üres.
value string A megjelenítendő üzenet. A blokk- és attribútumadatok szögletes zárójeles szintaxissal érhetők el, e.g.: {block.title} vagy {attributes.text}

szám

Számbeviteli mezőt jelenít meg.

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

Tulajdonságok

Tulajdonság Típus Leírás
default number Az alapértelmezett érték, amelyet a blokk első hozzáadásakor kell alkalmazni.
fallback number Tartalékérték, amely akkor jelenik meg, ha a mező értéke üres.
dragDirection string Meghatározza az érték növeléséhez vagy csökkentéséhez használt húzási tengelyt.
dragThreshold number Ha az isDragEnabled true, ez szabályozza, hány px-t kell húzni az érték változásához.
hideHTMLArrows boolean Ha true, az alapértelmezett beviteli HTML nyilak rejtve maradnak.
isShiftStepEnabled boolean Ha true, egérrel történő húzással növelhető vagy csökkenthető a számérték. Húzás közben a SHIFT nyomva tartása a shiftStep értékkel növeli a módosítás mértékét.
max number Az érték maximális hossza.
min number Az érték minimális hossza.
required boolean Ha true, érvényes számot kényszerít ki a vezérlő min/max tartományán belül. Ha false, az üres karakterlánc is érvényes érték lehet.
shiftStep number A SHIFT billentyű nyomva tartásakor alkalmazott növekmény. Ez az érték a lépésérték szorzója. Például ha a lépésérték 5, a shiftStep pedig 10, minden ugrás 50-nel növeli vagy csökkenti az értéket.
step number Az érték növelésekor vagy csökkentésekor alkalmazott módosítási mérték. Az érvényesítésben is szerepet játszik: az értéknek a step többszörösének kell lennie (a megadott min értékkel eltolva) ahhoz, hogy érvényes legyen. Elfogadja az any speciális karakterlánc-értéket, amely feloldja az érvényesítési korlátozást, és a léptetési műveletek során 1-gyel növeli vagy csökkenti az értéket.

választógomb

Választógombok csoportját jeleníti meg.

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

Tulajdonságok

Tulajdonság Típus Leírás
default string | number Alapértelmezett érték, amelyet a blokk első hozzáadásakor kell alkalmazni.
fallback string | number Tartalékérték, amely akkor jelenik meg, ha a mező értéke üres.
options array A választható lehetőségek.
returnFormat string Meghatározza a visszatérési érték formátumát.
populate object
display string Állítsa be buttonGroup értékre, ha a lehetőségeket választógombok helyett gombok csoportjaként szeretné megjeleníteni.
allowNull boolean Lehetővé teszi, hogy a felhasználó a kiválasztott választógombra kattintva törölje az értéket.

tartomány

Tartománybeviteli mezőt jelenít meg két pont közötti számérték megadásához.

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

Tulajdonságok

Tulajdonság Típus Leírás
default number Az alapértelmezett érték, amelyet a blokk első hozzáadásakor kell alkalmazni.
fallback number Tartalékérték, amely akkor jelenik meg, ha a mező értéke üres.
allowReset boolean Ha ez a tulajdonság true, megjelenik a csúszka visszaállítására szolgáló gomb.
initialPosition number A csúszka kezdőpozíciója, ha nincs megadott érték. Az initialPosition a megadott min és max tulajdonságértékek közé lesz szorítva.
isShiftStepEnabled boolean Ha true, egérrel történő húzással növelhető vagy csökkenthető a számérték. Húzás közben a SHIFT nyomva tartása a shiftStep értékkel növeli a módosítás mértékét.
marks array Megjeleníti a lépéseket jelölő osztásokat. Egyéni jelölők tömbként adhatók meg.
max number Az érték maximális hossza.
min number Az érték minimális hossza.
railColor string CSS színkarakterlánc a sín háttérszínének testreszabásához.
resetFallbackValue number Az az érték, amelyre a Reset gombra kattintva visszaáll a mező (az allowReset engedélyezése esetén).
separatorType string Meghatározza, hogy a vezérlősor alatti vagy feletti elválasztóvonal letiltott legyen-e, vagy teljes szélességű. Alapértelmezés szerint alul helyezkedik el, és nem húzódik a vezérlőikon alá.
shiftStep number A SHIFT billentyű nyomva tartásakor alkalmazott növekmény. Ez az érték a lépésérték szorzója. Például ha a lépésérték 5, a shiftStep pedig 10, minden ugrás 50-nel növeli vagy csökkenti az értéket.
showTooltip boolean A Tooltip UI megjelenítésének vagy elrejtésének kikényszerítése. Ha a step értéke az any speciális karakterlánc, ezt felülírja a false érték.
step number Az érték növelésekor vagy csökkentésekor alkalmazott módosítási mérték. Az érvényesítésben is szerepet játszik: az értéknek a step többszörösének kell lennie (a megadott min értékkel eltolva) ahhoz, hogy érvényes legyen. Elfogadja az any speciális karakterlánc-értéket, amely feloldja az érvényesítési korlátozást, és a léptetési műveletek során 1-gyel növeli vagy csökkenti az értéket.
trackColor string CSS színkarakterlánc a sáv háttérszínének testreszabásához.
withInputField boolean Meghatározza, hogy a számbeviteli mező a RangeControl mellett jelenjen-e meg. Ha a step értéke az any speciális karakterlánc, ezt felülírja a false érték.

kiválasztás

Egy vagy több elem kiválasztását támogató választómezőt jelenít meg.

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

Tulajdonságok

Tulajdonság Típus Leírás
default array | string | number Az alapértelmezett érték, amelyet a blokk első hozzáadásakor kell alkalmazni.
fallback array | string | number Tartalékérték, amely akkor jelenik meg, ha a mező értéke üres.
multiple boolean Ha true, több lehetőség is kiválasztható. A „stylisedUi” automatikusan engedélyezve lesz.
options array A választható lehetőségek.
returnFormat string Megadja a visszatérési érték formátumát.
populate object
stylisedUi boolean Keresési lehetőséggel ellátott, stilizált választót jelenít meg.
allowNull boolean | string Lehetővé teszi az üres lehetőség kiválasztását. Ha true, a címke üres lesz, ellenkező esetben a lehetőségnél megadott karakterlánc jelenik meg.
allowReset boolean Ha ez a tulajdonság true, megjelenik a választó visszaállítására szolgáló gomb.

fülek

Mezők csoportosítására szolgáló füles felületet jelenít meg.

JSON
{
  "type": "tabs"
}

Tulajdonságok

Tulajdonság Típus Leírás
tabs array A megjelenítendő fülek.

szöveg

Egysoros szövegbeviteli mezőt jelenít meg.

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

Tulajdonságok

Tulajdonság Típus Leírás
default string Az alapértelmezett érték, amelyet a blokk első hozzáadásakor kell alkalmazni.
fallback string Tartalékérték, amely akkor jelenik meg, ha a mező értéke üres.
max number Az érték maximális hossza.
min number Az érték minimális hossza.

szövegterület

Szövegterület-beviteli mezőt jelenít meg.

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

Tulajdonságok

Tulajdonság Típus Leírás
default string Az alapértelmezett érték, amelyet a blokk első hozzáadásakor kell alkalmazni.
fallback string Tartalékérték, amely akkor jelenik meg, ha a mező értéke üres.
max number Az érték maximális hossza.
min number Az érték minimális hossza.
rows number A szövegterület sorainak száma.

kapcsoló

Be/ki kapcsolót jelenít meg.

JSON
{
  "type": "toggle"
}

Tulajdonságok

Tulajdonság Típus Leírás
default boolean Az alapértelmezett érték, amelyet a blokk első hozzáadásakor kell alkalmazni.
fallback boolean Tartalékérték, amely akkor jelenik meg, ha a mező értéke üres.

ismétlő

Ismételhető mezőkészletet jelenít meg.

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

Tulajdonságok

Tulajdonság Típus Leírás
default array Az új blokk kezdeti sorai. Minden sor egy mezőértékeket tartalmazó objektum. Elsőbbséget élvez azzal a sorszámmal szemben, amelyet a min hoz létre.
min number A sorok minimális száma.
max number A sorok maximális száma.
minimized boolean A meglévő sorok összecsukása a szerkesztő megnyitásakor. A szerkesztőben hozzáadott sorok kibontva jelennek meg.
textButton string A hozzáadás gomb szövege.
textMinimized string | object Az összecsukott soroknál megjelenő szöveg.
textRemove string | boolean Megerősítő kérdés, amely ismétlőmező-sor eltávolításakor jelenik meg a szerkesztőben. Nem üres karakterlánc esetén a kérdés lecserélődik; false esetén a sor párbeszédpanel nélkül azonnal törlődik. Ha nincs megadva, true vagy üres karakterlánc esetén az alapértelmezett kérdés jelenik meg.
attributes array Az összes többi mezőtípust elfogadja, kivéve egy másik tabs mezőt.

richtext

A RichText mezők attribútummezője.

JSON
{
  "type": "richtext"
}

Tulajdonságok

Tulajdonság Típus Leírás
default string A blokk első hozzáadásakor alkalmazandó alapértelmezett érték.
fallback string Tartalékérték, amely akkor jelenik meg, ha a mező értéke üres.

unit

Számbeviteli mezőt jelenít meg mértékegység-választóval.

JSON
{
  "type": "unit"
}

Tulajdonságok

Tulajdonság Típus Leírás
default string A blokk első hozzáadásakor alkalmazandó alapértelmezett érték.
fallback string Tartalékérték, amely akkor jelenik meg, ha a mező értéke üres.
disableUnits boolean Ha igaz, a mértékegység-választó mező rejtve marad.
isPressEnterToChange boolean Ha igaz, a módosítás kiváltásához meg kell nyomni az ENTER billentyűt. A módosítás a mező elhagyásakor is kiváltódik.
isResetValueOnUnitChange boolean Ha igaz, és a kiválasztott mértékegységhez tartozik alapértelmezett érték, mértékegység-váltáskor ez az érték lesz beállítva.
isUnitSelectTabbable boolean Meghatározza, hogy a mértékegység-választó mező elérhető-e a Tab billentyűvel.
units array

wysiwyg

WYSIWYG-szerkesztőt jelenít meg.

JSON
{
  "type": "wysiwyg"
}

Tulajdonságok

Tulajdonság Típus Leírás
default string Alapértelmezett érték, amelyet a blokk első hozzáadásakor kell alkalmazni.
fallback string Tartalékérték, amely akkor jelenik meg, ha a mező értéke üres.
toolbar object A szerkesztő eszköztárának beállítása.
mode string A code kódszerkesztő nézetben nyitja meg a mezőt. A both gombot ad hozzá, amellyel a vizuális és a kódnézet között lehet váltani.

Ikonok betöltése

A szerkesztő akkor tölt be egy ikonkészletet, amikor először fókuszba kerül a választója, vagy amikor módosítja a készletet vagy az alkészletet, nem pedig a blokk kiválasztásakor. Az azonos készletet kérő mezők megosztják a folyamatban lévő kérést. A tárolt ikonnév betöltés előtt is látható marad, és a választóra való újbóli fókuszálás megpróbálja újra a sikertelen kérést.

tabler-icons támogatja a outline és a filled használatát. A kiválasztott készlethez kifejezetten beállított alkészlet elsőbbséget élvez; ellenkező esetben a választó elérhetőség esetén a solid alkészletet, vagy a készlet első alkészletét használja. Az alkészlet nélküli készleteknél a subSet kimarad. A készletnevek csak a csomagban található fájlokra oldhatók fel. A frontend megjelenítés az egyes ikonokat gyorsítótárazza, nem a teljes ikonkészleteket tárolja adatbázis-tranziensekben.

Importált opcióértékek

A "multiple": true értékkel rendelkező jelölőnégyzetek és választólisták általában { "value": "...", "label": "..." } objektumokból álló tömböt tárolnak. Elfogadnak továbbá egyetlen opcióobjektumot, skalár karakterláncot vagy számot, illetve skalár értékek tömbjét is, ha azokat a REST API vagy tartalomkezelő eszközök importálták. Ez ismétlősorokon belül is működik.

A szerkesztő kijelölésként jeleníti meg ezeket az értékeket anélkül, hogy érintetlen mentéskor átírná a tárolt formátumukat. Egy kijelölés hozzáadása vagy eltávolítása az opcióobjektumok szokásos tömbjét írja ki. A 0 számérték és a "0" karakterlánc érvényes kijelölés. A sablonok a mező beállított returnFormat értékét kapják meg, ugyanúgy, mint a szerkesztőben kiválasztott értékek esetén. Az opcióknak továbbra is egyezniük kell a mező deklarált vagy feltöltött választási lehetőségeivel.

Az érték vagy alapértelmezett érték nélküli natív egyszeres választólista letiltott, üres helyőrzőt jelenít meg az első opció helyett. Az első opció kifejezett kiválasztása tárolja azt. A választás tárolása után a helyőrző eltűnik. Használja a allowNull lehetőséget, ha a szerkesztőknek a kijelölés törlését is engedélyezni kell; az üres helyőrző önmagában nem teszi törölhetővé az egyébként kötelező választást.

Ismétlő kezdeti sorai

A szerkesztőben az alapértékek a beillesztés előtt tartalmazzák a beágyazott minimális sorszámot. Ezek inicializálásához nem kell megnyitnia a blokk beállításait, és a blokk beillesztése nem ad hozzájuk egy második visszavonási lépést.

Ha egy ismétlő min értékkel rendelkezik, de nincs mentett értéke vagy explicit default beállítása, a szerver ennyi sort hoz létre a sor mezőinek alapértelmezett értékeivel. Ez a PHP beágyazásokra, blokkcímkékre és fájlalapú oldalakra is érvényes, amelyeket még soha nem nyitottak meg a szerkesztőben. Például egy "min": 2 két olyan sort jelenít meg, amelyben a szövegmező alapértelmezett értéke "New item".

A mentett sorok és az ismétlő explicit default beállítása elsőbbséget élveznek. A kifejezetten mentett üres lista, false vagy null nem hozza létre újra a törölt sorokat. A megjelenítés nem menti vissza ezeket a létrehozott alapértelmezett értékeket a bejegyzésbe. A min és a max a szerkesztő vezérlőire vonatkozik; megjelenítéskor nem csonkítja és nem egészíti ki a mentett listát. A sorokra vonatkozó korlátozások megsértésének jelzéséhez importált tartalomban használja a bs_validate_block() lehetőséget.

A default nélküli sormezők értéke false egy létrehozott sorban, ezért az ilyen sor nem tartalmaz tartalmat. A szerkesztők által hozzáadott, majd üresen hagyott sorok ugyanígy néznek ki. A sablonoknak, amelyek minden sorhoz kártyát, címsort vagy listaelemet jelenítenek meg, a szerkesztőn kívül ki kell hagyniuk a tartalom nélküli sorokat, a szerkesztőben viszont meg kell tartaniuk őket, hogy mezőik szerkeszthetők maradjanak:

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; ?>

Ismétlő eltávolítása

Egy sor eltávolításakor megnyílik a szerkesztő megerősítő párbeszédablaka Törlés és Mégse gombokkal. A Mégse gomb vagy az Escape billentyű változatlanul hagyja a sort. A sor csak a megerősítés után törlődik, beágyazott ismétlők esetén is.

textRemove határozza meg ugyanezt a viselkedést minden ismétlőnél:

Érték Viselkedés
Nincs megadva, true vagy "" Az alapértelmezett megerősítő kérdés megjelenítése.
Nem üres szöveg Az egyéni kérdés megjelenítése a meglévő egyéni szövegfordítási mechanizmussal.
false A sor azonnali eltávolítása párbeszédablak nélkül.

Például a "textRemove": "Remove this team member?" módosítja a kérdést. A meglévő min korlátozás továbbra is megakadályozza a minimális szám alatti sorok eltávolítását.

Ismétlők beágyazása

Egy ismétlősor minden mezőtípust elfogad, kivéve a tabs típust. Ha egy sorban lévő tabs mező egy id nélküli csoporton belül található, a szerkesztő a mezők helyett egy értesítést jelenít meg. A PHPStan bővítmény jelzi ezt a block.json és field.json esetében. Tartsa a sor mezőit egy szinten, vagy helyezze a füleket az ismétlőn kívülre.

A WYSIWYG-hivatkozás eszköztára alapértelmezés szerint olyan hivatkozásokat szúr be, amelyek ugyanabban a lapon nyílnak meg, és nem ad hozzájuk target vagy rel attribútumot. Az új lapon való megnyitás beállításához engedélyezze a toolbar.formats.link.opensInNewTab lehetőséget:

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

Az új lap kiválasztásakor hozzáadódik a target="_blank" és a rel="noreferrer noopener". Kikapcsolásakor ezek az automatikus attribútumok eltávolításra kerülnek. Ha a mező minden hivatkozására attribútumokat szeretne alkalmazni, állítsa be a toolbar.formats.link.attributes értéket, például így: { "class": "content-link", "rel": "nofollow" }. A kifejezett konfiguráció megmarad, az új lapon való megnyitáshoz szükséges biztonsági tokenek pedig hozzáadódnak a konfigurált rel értékhez.

A URL beírása nem alakítja azt automatikusan hivatkozássá, és a mezőben lévő meglévő hivatkozásra kattintva sem navigál el a szerkesztőből. A korábban mentett hivatkozási attribútumok megmaradnak a meglévő tartalomban; a rendszer nem alakítja át őket automatikusan.