Przejdź do treści

Blockstudio vs create-block

To samo block.json bez edytora React i procesu kompilacji.

@wordpress/create-block to oficjalnie wspierane narzędzie do tworzenia bloków: wtyczki, block.json, komponentu edycji React i kompilacji webpack. Blockstudio zachowuje block.json oraz blok WordPress API, a komponent edycji zastępuje polami, które sam renderuje, i szablonem renderowanym przez serwer, bez konieczności kompilacji.

Co się zmienia bez kompilacji

Blok Blockstudio to folder: block.json dla pól, szablon dla kodu znaczników i opcjonalne zasoby obok nich.

Pola zamiast kontrolek

Zadeklaruj pole w block.json, a pojawi się jego kontrolka. 27 wbudowanych typów, od tekstu po pola powtarzalne.

Jeden szablon

Ten sam szablon PHP, Twig lub Blade renderuje podgląd w edytorze i stronę.

Komponenty edytora jako znaczniki

Umieść w szablonie znaczniki RichText lub InnerBlocks; edytor zastąpi je przez React.

Zasoby według nazwy pliku

style.scss jest kompilowany na serwerze, a importy npm w script.js są pobierane do bloku.

Kiedy lepiej wybrać create-block

Gdy edycja jest sednem produktu: potrzebujesz niestandardowych pasków narzędzi, interakcji przeciągania, płócien lub czegokolwiek, co wymaga stanu React w edytorze. Gdy blok musi zapisywać statyczny kod znaczników, renderowany bez PHP. Także wtedy, gdy Twój zespół już pisze React i chce korzystać z pełnej biblioteki @wordpress/components.

Core również zmierza w kierunku PHP. Od wersji WordPress 7.0 blok zarejestrowany za pomocą autoRegister i funkcji renderującej otrzymuje generowane kontrolki dla atrybutów typu string, number, integer i boolean — bez JavaScript. W tym przypadku tekst sformatowany, bloki wewnętrzne i multimedia nadal wymagają komponentu edycji.

Mogą działać obok siebie

Blockstudio rejestruje dowolny block.json bez klucza blockstudio za pośrednictwem register_block_type(). Skompiluj blok create-block za pomocą wp-scripts, umieść folder wynikowy w katalogu Blockstudio, a załaduje się obok Twoich bloków Blockstudio.

Rejestr Blockstudio kopiuje foldery bloków między projektami, więc udostępnianie działa tak samo: folder create-block można przenieść jak każdy inny blok.

Porównanie obok siebie

Ten sam blok API, dwa sposoby tworzenia części edytora.

Edytor UI
create-blockNie: Komponent edycji React napisany przez Ciebie
BlockstudioTak: Generowane z pól w block.json
Etap kompilacji
create-blockNie: Kompilacja wp-scripts przed załadowaniem bloku
BlockstudioTak: Brak; szablony i zasoby są ładowane jako pliki
Podgląd w edytorze
create-blockNie: Twój komponent edycji, oddzielony od wyniku
BlockstudioTak: Ten sam szablon renderowany przez serwer
Późniejsza zmiana kodu znaczników
create-blockNie: Domyślnie statyczny; zmiany save() wymagają mechanizmu deprecjacji
BlockstudioTak: Istniejące bloki są renderowane ponownie z szablonu
Interactivity API
create-blockTak: Szablon interaktywny, flaga kompilacji modułów
BlockstudioTak: Jedna flaga; script.js ładuje się jako moduł
Niestandardowe interakcje w edytorze
create-blockTak: Wszystko, co potrafi React
BlockstudioNie: Pola, niestandardowe kontrolki pól, RichText, InnerBlocks, multimedia
Licencja
create-blockTak: Darmowy, GPL-2.0-or-later
BlockstudioTak: Darmowy, GPLv2 lub nowsza

Pytania o create-block

O co pytają twórcy bloków, którzy chcą zrezygnować z kompilacji.

Czy nadal potrzebuję Node?

Nie w przypadku bloków Blockstudio: szablony, SCSS i importy modułów ES są obsługiwane w PHP. Projekt create-block wymaga Node do obsługi wp-scripts, a @wordpress/scripts 36.1.0 wymaga Node 22.22.2 lub nowszego 22.x, 24.15.0 lub nowszego 24.x albo Node 26 i nowszego.

Czy to ten sam block.json?

Tak. Blockstudio odczytuje standardowy block.json i dodaje klucz blockstudio dla pól i ustawień. Nazwa, tytuł, kategoria, obsługiwane funkcje i pozostałe elementy znaczą to, co określa WordPress.

Czy mogę zachować moje bloki create-block?

Tak. Umieść wynik kompilacji w katalogu Blockstudio, a Blockstudio zarejestruje blok za pomocą register_block_type(); możesz też pozostawić go we własnej wtyczce. Przepisz blok tylko wtedy, gdy wygodniej będzie użyć w nim generowanych pól.

Kiedy lepiej wybrać create-block?

Gdy potrzebujesz zachowania w edytorze, którego nie da się uzyskać za pomocą pól i szablonów, statycznego wyniku zapisu albo gdy Twój zespół już pracuje w React. Blockstudio sprawdza się w wielu blokach składających się z pól i kodu znaczników, gdzie komponent edycji to głównie powtarzalny kod.

A co z API interaktywności?

Oba rozwiązania go obsługują. Interaktywny szablon create-block konfiguruje supports.interactivity, viewScriptModule i eksperymentalną flagę kompilacji modułów. W Blockstudio ustawiasz interaktywność pod kluczem blockstudio, a script.js ładuje się jako moduł z automatycznie generowaną mapą importów.

Napisz blok, pomiń kompilację

Pola w block.json, szablon w PHP, Twig lub Blade, a blok pojawia się w edytorze od razu po utworzeniu folderu.

Źródła, zaznaczone

Plus

Oficjalny zestaw rozszerzeń

Wysokiej jakości szablony witryn, systemowe instrukcje AI i prywatna społeczność Discord. Jednorazowy zakup, dożywotnie aktualizacje.

  • 500+ szablonów stron
  • Instrukcje systemowe AI
  • Dożywotnie aktualizacje
  • Prywatna społeczność Discord