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.
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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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ó.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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ás
Hivatkozásvezérlőt jelenít meg belső vagy külső hivatkozások kiválasztásához.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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 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.
WYSIWYG-hivatkozások
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:
{
"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.