Przejdź do treści

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.

Przepisy na wzorce 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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

Wyświetla kontrolkę odnośnika do wyboru odnośników wewnętrznych lub zewnętrznych.

JSON
{
  "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ą.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "type": "tabs"
}

Właściwości

Właściwość Typ Opis
tabs array Karty do wyświetlenia.

tekst

Wyświetla jednoliniowe pole tekstowe.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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ć.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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
<?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.

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:

JSON
{
  "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.