Typy pól
Blockstudio udostępnia różne typy pól do tworzenia interfejsów bloków.
Projekty mogą również rejestrować własne typy pól z przestrzenią nazw za pomocą
blockstudio/field_types. Użyj tego,
gdy potrzebujesz nowej kontrolki edytora lub ustrukturyzowanej wartości. Użyj pól
custom/{name}, gdy chcesz jedynie
ponownie wykorzystać grupę istniejących pól.
Praktyczne przykłady: grupy warunkowe, inteligentne listy wyboru, powtarzacze i przeszukiwalne przechowywanie danych.
Właściwości ogólne
Poniższa tabela zawiera wspólne właściwości i typowe opcje wartości. Obsługiwane są default i
fallback, jeśli wymieniono je w tabeli właściwości danego typu pola.
| Właściwość | Typ | Opis |
|---|---|---|
id |
string | Unikalny identyfikator atrybutu |
type |
string | Typ pola |
label |
string | Etykieta wyświetlana w edytorze |
description |
string | Tekst opisu wyświetlany pod polem |
default |
mixed | Wartość domyślna pola |
fallback |
mixed | Wartość zastępcza, gdy pole jest puste |
help |
string | Tekst pomocy wyświetlany jako podpowiedź obok etykiety |
hidden |
boolean | Ukryj pole w UI |
switch |
boolean | Wyświetl przełącznik, który może wyłączyć pole. Domyślnie false. |
translate |
boolean | Ustaw na false, aby pominąć pole w konfiguracji WPML |
conditions |
array | Reguły logiki warunkowej |
Pola plików z "returnFormat": "id" zachowują zaimportowane odwołania do ciągów,
w tym pojedyncze wartości w powtarzalnych sekcjach. Nierozpoznane nazwy wyświetlają karty zastępcze
bez miniatur; Blockstudio nie zamienia ich na identyfikatory załączników. Szczegóły znajdziesz w
przenośnych odwołaniach do mediów.
Zobacz Ładowanie ikon, aby poznać żądania selektora, ponowne próby i podzbiory ikon.
attributes
Renderuje pola wejściowe atrybutów danych.
{
"type": "attributes"
}
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
default |
array |
Wartość domyślna stosowana przy pierwszym dodaniu bloku. |
fallback |
array |
Wartość zastępcza wyświetlana, gdy pole jest puste. |
link |
boolean |
Umożliwia wybór odnośnika z listy rozwijanej. |
media |
boolean |
Umożliwia wybór mediów z listy rozwijanej. |
blok
Odwołuje się do innego bloku Blockstudio, rozwijając jego pola w tekście. W szablonach wartość zwraca wyrenderowany wynik bloku.
{
"type": "block"
}
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
block |
string |
Nazwa bloku, do którego należy się odwołać (np. e.g, „mytheme/card”). |
returnFormat |
string |
Sposób zwracania wartości w szablonach. |
pole wyboru
Wyświetla zestaw pól wyboru.
{
"type": "checkbox",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
default |
array | string | number |
Wartość domyślna stosowana przy pierwszym dodaniu bloku. |
fallback |
array | string | number |
Wartość zastępcza wyświetlana, gdy wartość pola jest pusta. |
options |
array |
Opcje do wyboru. |
returnFormat |
string |
Określa format zwracanej wartości. |
populate |
object |
|
toggle |
boolean | string |
Dodaje nad opcjami pole wyboru, które zaznacza lub odznacza je wszystkie. Jego etykietą jest ciąg tekstowy; wartość true używa etykiety domyślnej. |
klasy
Wyświetla pole do wyboru klas CSS.
{
"type": "classes"
}
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
default |
string |
Wartość domyślna stosowana przy pierwszym dodaniu bloku. |
fallback |
string |
Wartość zastępcza wyświetlana, gdy pole jest puste. |
tailwind |
boolean |
Czy włączyć klasy Tailwind dla tego pola wejściowego. |
kod
Wyświetla edytor kodu.
{
"type": "code"
}
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
default |
string |
Wartość domyślna stosowana przy pierwszym dodaniu bloku. |
fallback |
string |
Wartość zastępcza wyświetlana, gdy wartość pola jest pusta. |
autoCompletion |
boolean |
Czy włączyć autouzupełnianie. |
foldGutter |
boolean |
Czy wyświetlać obszar składania kodu. |
height |
string |
Wysokość edytora. |
language |
string |
Język używany do podświetlania składni. |
lineNumbers |
boolean |
Czy wyświetlać numery wierszy. |
maxHeight |
string |
Maksymalna wysokość edytora. |
minHeight |
string |
Minimalna wysokość edytora. |
popout |
boolean |
Czy wyświetlać przycisk otwierający edytor w wyskakującym oknie. |
asset |
boolean |
Renderuje z pola CSS, SCSS lub JavaScript jako zasób bloku, dzięki czemu szablon nie musi wyświetlać tagu style ani script. |
kolor
Wyświetla paletę kolorów i próbnik kolorów.
{
"type": "color",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
default |
string |
Wartość opcji wybieranej przy pierwszym dodaniu bloku. |
fallback |
string |
Wartość opcji wyświetlana, gdy wartość pola jest pusta. |
options |
array |
|
populate |
object |
|
clearable |
boolean |
Czy paleta powinna zawierać przycisk czyszczenia. |
disableCustomColors |
boolean |
Czy zezwalać na niestandardowy kolor. |
data
Wyświetla selektor daty.
{
"type": "date"
}
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
default |
string |
Wartość domyślna stosowana przy pierwszym dodaniu bloku. |
fallback |
string |
Wartość zastępcza wyświetlana, gdy pole jest puste. |
startOfWeek |
number |
Dzień, od którego zaczyna się tydzień. 0 oznacza niedzielę, 1 poniedziałek itd. |
data i godzina
Wyświetla selektor daty i godziny.
{
"type": "datetime"
}
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
default |
string |
Wartość domyślna stosowana przy pierwszym dodaniu bloku. |
fallback |
string |
Wartość zastępcza wyświetlana, gdy pole jest puste. |
is12Hour |
boolean |
Czy używać zegara 12-godzinnego. Przy zegarze 12-godzinnym wyświetlany jest widżet AM/PM, a format daty to MM-DD-YYYY (zamiast domyślnego DD-MM-YYYY). |
pliki
Wyświetla przycisk otwierający bibliotekę mediów. Wybrane elementy można zmieniać kolejnością bezpośrednio w interfejsie.
{
"type": "files",
"min": 0,
"max": 100,
"multiple": false
}
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
default |
array | object | number |
Wartość domyślna stosowana przy pierwszym dodaniu bloku. |
fallback |
array | object | number |
Wartość zastępcza wyświetlana, gdy pole jest puste. |
addToGallery |
boolean |
Jeśli wartość to true, okno galerii mediów otwiera się bezpośrednio w bibliotece mediów, gdzie użytkownik może dodać kolejne obrazy. Jeśli wartość to false, okno galerii mediów otwiera się w trybie edycji, w którym użytkownik może edytować istniejące obrazy, zmieniając ich kolejność, usuwając je lub modyfikując ich atrybuty. Dotyczy tylko sytuacji, gdy gallery === true. |
allowedTypes |
array | string |
Tablica typów mediów do przesłania lub wybrania z biblioteki mediów. Każdy typ to ciąg znaków, który może zawierać ogólny typ MIME e.g: „image”, „audio”, „text” albo pełny typ MIME e.g: „audio/mpeg”, „image/gif”. Jeśli allowedTypes nie jest ustawione, dozwolone są wszystkie typy MIME. |
gallery |
boolean |
Jeśli wartość to true, komponent inicjuje wszystkie stany wymagane do obsługi galerii. Domyślnie okno mediów otwiera się w widoku edycji galerii, ale można to zmienić za pomocą addToGalleryflag. |
max |
number |
Maksymalna liczba plików, które można dodać. |
min |
number |
Minimalna liczba plików, które można dodać. |
multiple |
boolean |
Czy zezwalać na wybór wielu elementów. |
size |
boolean |
Dodaje do pola listę rozwijaną z rozmiarami mediów. |
textMediaButton |
string |
Tekst przycisku mediów. |
title |
string |
Tytuł wyświetlany w oknie mediów. |
returnFormat |
string |
Określa format zwracanej wartości. |
returnSize |
string |
Rozmiar mediów zwracany przy użyciu formatu URL. |
gradient
Wyświetla paletę gradientów i próbnik gradientu.
{
"type": "gradient",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
default |
string |
Wartość opcji wybieranej przy pierwszym dodaniu bloku. |
fallback |
string |
Wartość opcji wyświetlana, gdy wartość pola jest pusta. |
options |
array |
|
populate |
object |
|
clearable |
boolean |
Czy paleta powinna zawierać przycisk czyszczenia. |
disableCustomGradients |
boolean |
Czy zezwalać na niestandardowy kolor. |
grupa
Wyświetla wiele pól w (opcjonalnie) zwijanym kontenerze.
{
"type": "group"
}
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
title |
string |
Tekst tytułu. Jest widoczny także wtedy, gdy komponent jest zamknięty. |
opened |
boolean |
Ustawienie true pozostawia komponent otwarty niezależnie od właściwości initialOpen. |
initialOpen |
boolean |
Określa, czy panel ma być początkowo otwarty. |
scrollAfterOpen |
boolean |
Przewija zawartość do widocznego obszaru po jej pokazaniu. |
class |
string |
Własna klasa CSS stosowana do grupy. |
style |
object |
Własne style CSS stosowane do grupy. |
attributes |
array |
Przyjmuje wszystkie pozostałe typy pól poza kolejnym tabs. |
znacznik html
Wyświetla selektor znaczników HTML. Przydatny do wyboru poziomów nagłówków lub elementów semantycznych.
{
"type": "html-tag"
}
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
default |
string |
Wartość domyślna stosowana przy pierwszym dodaniu bloku. |
fallback |
string |
Wartość zastępcza wyświetlana, gdy pole jest puste. |
tags |
string | array |
Które znaczniki uwzględnić. Użyj gotowego ciągu znaków lub tablicy nazw znaczników. |
exclude |
array |
Znaczniki wykluczone z gotowego zestawu. Dotyczy tylko użycia gotowego ciągu znaków dla znaczników. |
ikona
Wyświetla ikonę SVG z zestawu ikon.
{
"type": "icon"
}
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
default |
object |
Wartość domyślna stosowana przy pierwszym dodaniu bloku. |
fallback |
object |
Wartość zastępcza wyświetlana, gdy pole jest puste. |
sets |
array | string |
Który zestaw ikon uwzględnić. Pozostaw puste, aby uwzględnić wszystkie. |
subSets |
array | string |
Który podzestaw ikon uwzględnić. Pozostaw puste, aby uwzględnić wszystkie. |
returnFormat |
string |
Format zwracanej ikony. |
odnośnik
Wyświetla kontrolkę odnośnika do wyboru odnośników wewnętrznych lub zewnętrznych.
{
"type": "link"
}
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
default |
object |
Wartość domyślna stosowana przy pierwszym dodaniu bloku. |
fallback |
object |
Wartość zastępcza wyświetlana, gdy pole jest puste. |
hasRichPreviews |
boolean |
Czy podczas dodawania URL wyświetlać podglądy z formatowaniem. |
noDirectEntry |
boolean |
Czy umożliwić bezpośrednie przekształcenie zapytania wyszukiwania typu URL w odnośnik. |
noURLSuggestion |
boolean |
Czy dodać sugestię zastępczą, która traktuje zapytanie wyszukiwania jako URL. |
opensInNewTab |
boolean |
Dodaje przełącznik do okna odnośnika. |
showSuggestions |
boolean |
Czy wyświetlać sugestie podczas wpisywania URL. |
textButton |
string |
Niestandardowy tekst wyświetlany wewnątrz przycisku odnośnika. |
withCreateSuggestion |
boolean |
Czy nierozpoznane wyszukiwanie odnośnika może utworzyć sugestię nowej strony w wersji roboczej. |
komunikat
Wyświetla komunikat z niestandardową treścią.
{
"type": "message"
}
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
default |
string |
Wartość domyślna stosowana przy pierwszym dodaniu bloku. |
fallback |
string |
Wartość zastępcza wyświetlana, gdy pole jest puste. |
value |
string |
Komunikat do wyświetlenia. Dane bloku i atrybutów są dostępne w składni nawiasowej, e.g: {block.title} lub {attributes.text} |
liczba
Wyświetla pole wprowadzania liczby.
{
"type": "number",
"min": 0,
"max": 100,
"step": 1
}
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
default |
number |
Wartość domyślna stosowana przy pierwszym dodaniu bloku. |
fallback |
number |
Wartość zastępcza wyświetlana, gdy pole jest puste. |
dragDirection |
string |
Określa oś przeciągania do zwiększania lub zmniejszania wartości. |
dragThreshold |
number |
Jeśli isDragEnabled ma wartość true, określa liczbę pikseli przeciągania przed zmianą wartości. |
hideHTMLArrows |
boolean |
Jeśli wartość to true, ukrywa domyślne strzałki pola wejściowego HTML. |
isShiftStepEnabled |
boolean |
Jeśli wartość to true, włącza zwiększanie lub zmniejszanie liczby za pomocą przeciągania myszą. Przytrzymanie klawisza SHIFT podczas przeciągania zwiększa wartość o shiftStep. |
max |
number |
Maksymalna długość wartości. |
min |
number |
Minimalna długość wartości. |
required |
boolean |
Jeśli wartość to true, wymusza prawidłową liczbę w zakresie min/max kontrolki. Jeśli wartość to false, pusty ciąg znaków jest dozwoloną wartością. |
shiftStep |
number |
Wartość zwiększenia przy przytrzymanym klawiszu SHIFT. Jest to mnożnik wartości step. Na przykład jeśli wartość step wynosi 5, a shiftStep wynosi 10, każdy skok zwiększy lub zmniejszy wartość o 50. |
step |
number |
Wartość, o którą zmienia się liczba podczas zwiększania lub zmniejszania. Służy też do walidacji: wartość musi być wielokrotnością step (z przesunięciem o min, jeśli określono), aby była prawidłowa. Przyjmuje specjalną wartość ciągu znaków any, która znosi ograniczenie walidacyjne i powoduje zmianę wartości o 1 przy każdym zwiększeniu lub zmniejszeniu. |
przyciski jednokrotnego wyboru
Wyświetla zestaw przycisków jednokrotnego wyboru.
{
"type": "radio",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
default |
string | number |
Wartość domyślna stosowana przy pierwszym dodaniu bloku. |
fallback |
string | number |
Wartość zastępcza wyświetlana, gdy wartość pola jest pusta. |
options |
array |
Dostępne opcje. |
returnFormat |
string |
Określa format zwracanej wartości. |
populate |
object |
|
display |
string |
Ustaw na buttonGroup, aby wyświetlać opcje jako grupę przycisków zamiast pól wyboru. |
allowNull |
boolean |
Pozwala użytkownikowi wyczyścić wartość przez ponowne kliknięcie wybranego pola wyboru. |
suwak zakresu
Wyświetla suwak pozwalający ustawić wartość liczbową między dwoma punktami.
{
"type": "range",
"min": 0,
"max": 100,
"step": 1
}
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
default |
number |
Wartość domyślna stosowana przy pierwszym dodaniu bloku. |
fallback |
number |
Wartość zastępcza wyświetlana, gdy pole jest puste. |
allowReset |
boolean |
Jeśli wartość tej właściwości to true, wyświetlany jest przycisk resetowania suwaka. |
initialPosition |
number |
Pozycja początkowa suwaka używana, gdy nie przekazano wartości. Wartość initialPosition zostanie ograniczona do zakresu między podanymi wartościami właściwości min i max. |
isShiftStepEnabled |
boolean |
Jeśli wartość to true, włącza zwiększanie lub zmniejszanie liczby za pomocą przeciągania myszą. Przytrzymanie klawisza SHIFT podczas przeciągania zwiększa wartość o shiftStep. |
marks |
array |
Wyświetla wizualne oznaczenia wartości step. Własne oznaczenia można przekazać jako tablicę. |
max |
number |
Maksymalna długość wartości. |
min |
number |
Minimalna długość wartości. |
railColor |
string |
Ciąg znaków koloru CSS służący do dostosowania tła szyny suwaka. |
resetFallbackValue |
number |
Wartość przywracana po kliknięciu przycisku Reset (włączanego przez allowReset). |
separatorType |
string |
Określa, czy linia separatora pod/ponad wierszem kontrolki ma być wyłączona czy pełnej szerokości. Domyślnie znajduje się poniżej i nie obejmuje podkreślenia ikony kontrolki. |
shiftStep |
number |
Wartość zwiększenia przy przytrzymanym klawiszu SHIFT. Jest to mnożnik wartości step. Na przykład jeśli wartość step wynosi 5, a shiftStep wynosi 10, każdy skok zwiększy lub zmniejszy wartość o 50. |
showTooltip |
boolean |
Wymusza wyświetlenie lub ukrycie podpowiedzi UI. Ustawienie jest zastępowane wartością false, gdy step ma specjalną wartość ciągu znaków any. |
step |
number |
Wartość, o którą zmienia się liczba podczas zwiększania lub zmniejszania. Służy też do walidacji: wartość musi być wielokrotnością step (z przesunięciem o min, jeśli określono), aby była prawidłowa. Przyjmuje specjalną wartość ciągu znaków any, która znosi ograniczenie walidacyjne i powoduje zmianę wartości o 1 przy każdym zwiększeniu lub zmniejszeniu. |
trackColor |
string |
Ciąg znaków koloru CSS służący do dostosowania tła ścieżki suwaka. |
withInputField |
boolean |
Określa, czy obok RangeControl wyświetlać pole wprowadzania liczby. Ustawienie jest zastępowane wartością false, gdy step ma specjalną wartość ciągu znaków any. |
lista wyboru
Wyświetla pole wyboru obsługujące wybór jednej lub wielu opcji.
{
"type": "select",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
],
"multiple": false
}
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
default |
array | string | number |
Wartość domyślna stosowana przy pierwszym dodaniu bloku. |
fallback |
array | string | number |
Wartość zastępcza wyświetlana, gdy pole jest puste. |
multiple |
boolean |
Jeśli wartość to true, można wybrać wiele opcji. Funkcja stylisedUi zostanie włączona automatycznie. |
options |
array |
Dostępne opcje. |
returnFormat |
string |
Określa format zwracanej wartości. |
populate |
object |
|
stylisedUi |
boolean |
Wyświetla stylizowaną wersję listy wyboru z możliwością wyszukiwania elementów. |
allowNull |
boolean | string |
Umożliwia użytkownikowi wybranie pustej opcji. Jeśli wartość to true, etykieta będzie pusta; w przeciwnym razie opcja wyświetli określony ciąg znaków. |
allowReset |
boolean |
Jeśli wartość tej właściwości to true, wyświetlany jest przycisk resetowania listy wyboru. |
karty
Wyświetla interfejs z kartami do grupowania pól.
{
"type": "tabs"
}
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
tabs |
array |
Karty do wyświetlenia. |
tekst
Wyświetla jednoliniowe pole tekstowe.
{
"type": "text",
"min": 0,
"max": 100
}
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
default |
string |
Wartość domyślna stosowana przy pierwszym dodaniu bloku. |
fallback |
string |
Wartość zastępcza wyświetlana, gdy pole jest puste. |
max |
number |
Maksymalna długość wartości. |
min |
number |
Minimalna długość wartości. |
pole tekstowe
Wyświetla pole tekstowe.
{
"type": "textarea",
"min": 0,
"max": 100,
"rows": 4
}
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
default |
string |
Wartość domyślna stosowana przy pierwszym dodaniu bloku. |
fallback |
string |
Wartość zastępcza wyświetlana, gdy pole jest puste. |
max |
number |
Maksymalna długość wartości. |
min |
number |
Minimalna długość wartości. |
rows |
number |
Liczba wierszy pola tekstowego. |
przełącznik
Wyświetla przełącznik wartości true/false.
{
"type": "toggle"
}
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
default |
boolean |
Wartość domyślna stosowana przy pierwszym dodaniu bloku. |
fallback |
boolean |
Wartość zastępcza wyświetlana, gdy pole jest puste. |
elementy powtarzalne
Renderuje zestaw pól, które można powielać.
{
"type": "repeater",
"min": 0,
"max": 100
}
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
default |
array |
Wiersze, od których zaczyna się nowy blok. Każdy wiersz jest obiektem wartości pól. Ma pierwszeństwo przed wierszami tworzonymi przez min. |
min |
number |
Minimalna liczba wierszy. |
max |
number |
Maksymalna liczba wierszy. |
minimized |
boolean |
Zwiń istniejące wiersze po otwarciu edytora. Wiersze dodane w edytorze są początkowo rozwinięte. |
textButton |
string |
Tekst przycisku dodawania. |
textMinimized |
string | object |
Tekst wyświetlany po zminimalizowaniu wierszy. |
textRemove |
string | boolean |
Pytanie potwierdzające wyświetlane w edytorze podczas usuwania wiersza powtarzalnego. Niepusty ciąg zmienia treść pytania; false usuwa wiersz od razu, bez okna dialogowego. Pominięcie, true lub pusty ciąg powoduje użycie domyślnego pytania. |
attributes |
array |
Akceptuje wszystkie typy pól poza kolejnym polem tabs. |
richtext
Pole atrybutu dla pól RichText.
{
"type": "richtext"
}
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
default |
string |
Wartość domyślna stosowana przy pierwszym dodaniu bloku. |
fallback |
string |
Wartość zastępcza wyświetlana, gdy pole jest puste. |
unit
Renderuje pole liczbowe z listą rozwijaną jednostek.
{
"type": "unit"
}
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
default |
string |
Wartość domyślna stosowana przy pierwszym dodaniu bloku. |
fallback |
string |
Wartość zastępcza wyświetlana, gdy pole jest puste. |
disableUnits |
boolean |
Jeśli wartość jest prawdziwa, pole wyboru jednostki jest ukryte. |
isPressEnterToChange |
boolean |
Jeśli wartość jest prawdziwa, naciśnięcie klawisza ENTER jest wymagane do wywołania onChange. Zmiana jest też wywoływana po przejściu do innego pola klawiszem Tab. |
isResetValueOnUnitChange |
boolean |
Jeśli wartość jest prawdziwa, a wybrana jednostka ma wartość domyślną, jest ona ustawiana przy zmianie jednostek. |
isUnitSelectTabbable |
boolean |
Określa, czy do pola wyboru jednostki można przejść klawiszem Tab. |
units |
array |
wysiwyg
Renderuje edytor WYSIWYG.
{
"type": "wysiwyg"
}
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
default |
string |
Wartość domyślna stosowana przy pierwszym dodaniu bloku. |
fallback |
string |
Wartość zastępcza wyświetlana, gdy wartość pola jest pusta. |
toolbar |
object |
Konfiguracja paska narzędzi edytora. |
mode |
string |
code otwiera pole w widoku kodu. both dodaje przycisk przełączania między widokiem wizualnym a widokiem kodu. |
Wczytywanie ikon
Edytor wczytuje zestaw ikon, gdy po raz pierwszy ustawisz fokus na selektorze lub zmienisz zestaw albo podzestaw, a nie przy wybieraniu bloku. Pola żądające tego samego zestawu współdzielą trwające żądanie. Zapisana nazwa ikony pozostaje widoczna przed wczytaniem, a ponowne ustawienie fokusu na selektorze ponawia nieudane żądanie.
tabler-icons obsługuje outline i filled. Podzestaw jawnie skonfigurowany dla wybranego zestawu ma pierwszeństwo; w przeciwnym razie selektor używa solid, jeśli jest dostępny, lub pierwszego podzestawu zestawu. Zestawy bez podzestawów pomijają subSet. Nazwy zestawów są rozpoznawane wyłącznie na podstawie dołączonych plików. Renderowanie ikon we frontendzie buforuje pojedyncze ikony zamiast przechowywać całe zestawy ikon w transientach bazy danych.
Importowane wartości opcji
Pola wyboru i listy wyboru z "multiple": true zazwyczaj przechowują tablicę obiektów { "value": "...", "label": "..." }. Akceptują też pojedynczy obiekt opcji, skalarny ciąg znaków lub liczbę albo tablicę wartości skalarnych zaimportowanych przez REST API lub narzędzia do obsługi treści. Działa to również w wierszach pól powtarzalnych.
Edytor wyświetla te wartości jako zaznaczone opcje i nie zmienia ich zapisanej struktury przy zapisie bez wprowadzania zmian. Dodanie lub usunięcie zaznaczenia zapisuje standardową tablicę obiektów opcji. Liczbowe 0 i tekstowe "0" są prawidłowymi zaznaczeniami. Szablony otrzymują skonfigurowaną dla pola wartość returnFormat, tak samo jak w przypadku wartości wybranych w edytorze. Opcje nadal muszą odpowiadać zadeklarowanym lub wypełnionym wyborom pola.
Natywna lista jednokrotnego wyboru bez zapisanej wartości ani wartości domyślnej wyświetla nieaktywny pusty symbol zastępczy, a nie pierwszą opcję. Jawny wybór pierwszej opcji zapisuje ją. Po zapisaniu wyboru symbol zastępczy znika. Użyj allowNull, gdy edytorzy powinni móc również wyczyścić zaznaczenie; pusty symbol zastępczy nie umożliwia wyczyszczenia wyboru, który w innej sytuacji jest wymagany.
Początkowe wiersze pól powtarzalnych
W edytorze wartości domyślne obejmują zagnieżdżone wiersze minimalne przed wstawieniem. Nie trzeba otwierać ustawień bloku, aby je zainicjować, a wstawienie bloku nie dodaje dla tych wierszy drugiego kroku cofania.
Gdy repeater ma min, ale nie ma zapisanej wartości ani jawnego default, serwer inicjalizuje tyle wierszy, używając wartości domyślnych pól wiersza. Dotyczy to również osadzeń PHP, znaczników bloków i źródeł stron opartych na plikach, które nigdy nie były otwierane w edytorze. Na przykład "min": 2 z polem tekstowym, którego wartością domyślną jest "New item", renderuje dwa wiersze zawierające tę wartość.
Zapisane wiersze i jawne default repeatera mają pierwszeństwo. Jawnie zapisana pusta lista, false lub null nie odtwarzają usuniętych wierszy. Renderowanie nie zapisuje tych wygenerowanych wartości domyślnych z powrotem do wpisu. min i max ograniczają kontrolki edytora; podczas renderowania nie skracają ani nie uzupełniają zapisanej listy. Użyj zgłośbs_validate_block()naruszenia ograniczeń liczby wierszy w importowanej zawartości.
Pola wiersza bez default są false w wygenerowanym wierszu, więc taki wiersz nie zawiera treści. Tak samo wyglądają wiersze dodane przez edytorów i pozostawione puste. Szablon wyświetlający kartę, nagłówek lub element listy dla każdego wiersza powinien pomijać wiersze bez treści poza edytorem i zachowywać je w edytorze, aby ich pola pozostały edytowalne:
<?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; ?>
Usuwanie repeatera
Usunięcie wiersza otwiera okno potwierdzenia edytora z przyciskami Usuń i Anuluj. Anulowanie lub naciśnięcie Escape pozostawia wiersz bez zmian. Wiersz zostaje usunięty dopiero po potwierdzeniu, także w zagnieżdżonych repeaterach.
textRemove steruje tym samym zachowaniem we wszystkich repeaterach:
| Wartość | Zachowanie |
|---|---|
Pominięta, true lub "" |
Wyświetla domyślne pytanie potwierdzające. |
| Niepusty ciąg znaków | Wyświetla to niestandardowe pytanie, używając istniejącego mechanizmu tłumaczenia własnego tekstu. |
false |
Natychmiast usuwa wiersz bez okna dialogowego. |
Na przykład "textRemove": "Remove this team member?" zmienia pytanie.
Istniejące ograniczenie min nadal uniemożliwia usuwanie wierszy poniżej minimum.
Zagnieżdżanie repeaterów
Wiersz repeatera obsługuje każdy typ pola z wyjątkiem tabs. Pole tabs w wierszu, także wewnątrz grupy bez id, wyświetla w edytorze komunikat zamiast swoich pól. Rozszerzenie rozszerzeniePHPStan zgłasza ten problem dla block.json i field.json. Zachowaj pola wiersza na jednym poziomie albo przenieś zakładki poza repeater.
Linki WYSIWYG
Domyślnie pasek narzędzi linków WYSIWYG wstawia linki otwierane w tej samej karcie, bez dodawania target ani rel. Włącz opcję nowej karty za pomocą toolbar.formats.link.opensInNewTab:
{
"id": "content",
"type": "wysiwyg",
"toolbar": {
"formats": {
"link": {
"opensInNewTab": true
}
}
}
}
Wybranie nowej karty dodaje target="_blank" i rel="noreferrer noopener".
Wyłączenie tej opcji usuwa te automatyczne atrybuty. Aby zastosować atrybuty do każdego linku w tym polu, ustaw toolbar.formats.link.attributes, na przykład
{ "class": "content-link", "rel": "nofollow" }. Jawna konfiguracja zostaje zachowana, a tokeny bezpieczeństwa dla nowej karty są dodawane do skonfigurowanego rel.
Wpisanie URL nie zamienia go automatycznie w link, a kliknięcie istniejącego linku w polu nie powoduje przejścia poza edytor. Atrybuty wcześniej zapisanych linków pozostają w istniejącej treści; nie są automatycznie migrowane.