Dennis · 19 maja 2026
Blockstudio 7.3
Blockstudio 7.3 dodaje do frameworka nową warstwę: komponenty UI wielokrotnego użytku, które można renderować jak każdy inny blok.
Wersja 7.1 przekształciła bloki w aplikacje full-stack, a 7.2 ułatwiła inspekcję, walidację i dystrybucję większych projektów. Wersja 7.3 skupia się na codziennym tworzeniu i edytowaniu tych aplikacji.
W skrócie:
- Komponenty UI: wbudowana, opcjonalna biblioteka komponentów
bsui/*, oparta na WordPress Interactivity API. - Aplikacje: wbudowane przykłady
app/*pokazujące, jak komponenty UI łączą się w większe interfejsy. - Rozszerzony edytor: szerszy panel wysuwany do edycji pól Blockstudio, gdy pasek boczny staje się zbyt ciasny.
- Selektory zasobów o ograniczonym zakresie: zasoby CSS i SCSS mogą używać
%selector%, aby bezpośrednio wybierać klasę opakowującą blok. - Zależności wtyczek: bloki mogą wymagać aktywnych wtyczek WordPress, z opcjonalnymi ograniczeniami wersji.
- Zasady edytora:
blockstudio.jsonmogą konfigurować globalne bloki, wzorce i zachowanie multimediów za pomocą hooków edytora opartych na WordPress’ PHP. - Aliasy znaczników bloków: niestandardowe aliasy ułatwiające tworzenie znaczników bloków.
- Analiza statyczna i dokumentacja: lepsze pokrycie PHPStan zewnętrznych bibliotek bloków oraz generowana dokumentacja ustawień i hooków.
- Poprawki stron i edytora: bardziej niezawodne analizowanie stron na podstawie plików, wykrywanie kandydatów Tailwind, tryb resetowania, izolacja pamięci podręcznej renderowania i wstępne ładowanie edytora.
Biblioteka UI
Wersja 7.3 zawiera wbudowaną bibliotekę komponentów oraz przykładowe aplikacje zbudowane z jej użyciem.
Komponenty UI
Blockstudio 7.3 zawiera wbudowaną bibliotekę UI w przestrzeni nazw bsui/*. Komponenty są zwykłymi blokami Blockstudio, więc można renderować je w szablonach, na stronach opartych na plikach, we wzorcach i w treści wpisów za pomocą składni znaczników bloków, której już używasz.
Biblioteka komponentów UI jest w wersji beta, ponieważ zbieramy więcej opinii. Celem wersji 7.3 jest udostępnienie pierwszego zestawu komponentów, zebranie doświadczeń z rzeczywistych projektów i dopracowanie nazw, zachowania oraz wartości domyślnych przed uznaniem interfejsu API za stabilny.
Biblioteka jest opcjonalna:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"ui": {
"enabled": true
}
}
Po jej włączeniu można bezpośrednio renderować proste komponenty:
<block name="bsui/button" label="Save" variant="default"></block>
<block name="bsui/badge" label="Beta"></block>
<block
name="bsui/input"
nameAlt="email"
type="email"
placeholder="Email"
></block>
Działa też krótsza składnia bs::
<bs:bsui-button label="Save" variant="default" />
Celem nie jest przekształcenie Blockstudio w zestaw UI do tworzenia stron. Chodzi o udostępnienie typowych elementów interfejsu jako bloków, aby aplikacje zbudowane za pomocą Blockstudio nie musiały odtwarzać w każdym projekcie przycisków, okien dialogowych, kart, list wyboru, pól formularzy, menu, pasków narzędzi i komponentów informacji zwrotnej.
Pierwszy zestaw komponentów obejmuje podstawowe elementy układu, akcji, pól wejściowych, nakładek, nawigacji, informacji zwrotnej, formularzy i prezentacji danych:
bsui/button,bsui/button-group,bsui/toggle,bsui/toggle-group,bsui/toolbarbsui/input,bsui/textarea,bsui/select,bsui/checkbox,bsui/radio-group,bsui/slider,bsui/switch,bsui/number-field,bsui/password-input,bsui/phone-input,bsui/otp-input,bsui/date-input,bsui/time-pickerbsui/dialog,bsui/drawer,bsui/popover,bsui/menu,bsui/context-menu,bsui/menubar,bsui/tooltip,bsui/alert-dialogbsui/tabs,bsui/accordion,bsui/breadcrumb,bsui/pagination,bsui/navigation-menubsui/card,bsui/table,bsui/stack,bsui/separator,bsui/aspect-ratio,bsui/badge,bsui/avatar,bsui/progress,bsui/meter,bsui/skeleton,bsui/spinner,bsui/kbdbsui/form,bsui/field,bsui/field-group,bsui/file-upload,bsui/color-picker,bsui/rating
Wiele z nich to bloki złożone. Blok bsui/tabs zarządza interaktywnym stanem, a bloki potomne, takie jak bsui/tabs-list, bsui/tabs-trigger i bsui/tabs-panel, opisują strukturę.
<block name="bsui/tabs" defaultValue="features">
<block name="bsui/tabs-list">
<block name="bsui/tabs-trigger" value="features" title="Features"></block>
<block name="bsui/tabs-trigger" value="pricing" title="Pricing"></block>
</block>
<block name="bsui/tabs-panel" value="features">
<p>Features content.</p>
</block>
<block name="bsui/tabs-panel" value="pricing">
<p>Pricing content.</p>
</block>
</block>
Dzięki temu znacznik pozostaje czytelny, a stan i zachowanie obsługuje API Interactivity.
Przykładowe aplikacje
Przestrzeń nazw app/* zawiera przykłady zbudowane z tych samych komponentów UI.
Nie stanowią osobnego frameworka. To przykładowe implementacje większych interfejsów Blockstudio: bloków złożonych, zagnieżdżonych UI, stanu Interactivity API oraz miejsc, w których komponenty UI łączą się z funkcjami RPC lub opartymi na bazie danych.
<block name="app/kitchen-sink"></block>
<block name="app/chat">
<block name="app/chat-sidebar"></block>
<block name="app/chat-header"></block>
<block name="app/chat-messages"></block>
<block name="app/chat-input"></block>
</block>
Biblioteka UI zawiera również własną dokumentację i aktualny katalog komponentów. Zachowanie komponentów to coś więcej niż zbiór szablonów. Jest częścią umowy frameworka i pozostaje spójne w miarę rozwoju biblioteki.
Tworzenie i edycja
Kilka zmian ułatwia tworzenie i edytowanie bloków.
Rozszerzony edytor
Edycja złożonych bloków w panelu bocznym inspektora może szybko stać się niewygodna. Dotyczy to zwłaszcza powtarzających się pól, pól kodu, tekstu sformatowanego i zagnieżdżonych grup.
Blockstudio 7.3 dodaje do inspektora bloku opcję rozszerzonego edytora. Otwiera ona szerszy panel wysuwany z prawej strony edytora i wyświetla w nim te same pola Blockstudio.
Co ważne, nadal jest to ten sam system pól. Nie powiela renderowania pól ani nie wprowadza drugiej ścieżki zapisu. Zmiany wprowadzone w rozszerzonym edytorze aktualizują wybrany blok tak samo jak zmiany wprowadzone w zwykłym pasku bocznym.
Użyj go, gdy pasek boczny dobrze sprawdza się przy przeglądaniu, ale jest zbyt ciasny do wprowadzania danych.
Selektory zasobów o ograniczonym zakresie
Blockstudio już wcześniej obsługiwał %selector% dla pól kodu. W wersji 7.3 zasoby bloków CSS i SCSS mogą korzystać z tego samego wzorca tworzenia.
W pliku CSS zapis %selector% rozwija się do klasy o ograniczonym zakresie bloku:
%selector% {
--hero-gap: var(--wp--preset--spacing--space-10);
}
%selector%.hero {
border-bottom: 1px solid currentColor;
}
.hero__title {
color: red;
}
Dzięki temu można stylować właściwy element opakowujący:
<section class="hero <?php echo bs_get_scoped_class($b['name']); ?>">
<h1 class="hero__title">Hero</h1>
</section>
Zwykłe selektory w *.scoped.css nadal wybierają elementy potomne. %selector% to jawny hook wskazujący główny element bloku.
Zależności wtyczek
Bloki mogą teraz deklarować zależności od wtyczek WordPress w kluczu blockstudio pliku block.json.
Prosta forma sprawdza, czy wszystkie wymienione identyfikatory wtyczek są aktywne:
{
"blockstudio": {
"pluginDependencies": ["woocommerce"]
}
}
Forma obiektowa dodaje ograniczenia wersji:
{
"blockstudio": {
"pluginDependencies": {
"woocommerce": {
"version": ">6"
}
}
}
}
Identyfikatory to identyfikatory wtyczek WordPress, zgodne z systemem zależności wtyczek rdzenia WordPress. Blockstudio przypisuje aktywnym wtyczkom te identyfikatory i pomija rejestrację, jeśli wymaganej wtyczki brakuje, jest nieaktywna lub ma niższą wersję niż wymagana.
Ograniczenie wersji korzysta z tego samego modelu porównywania co PHP’s version_compare(). Zwykła wersja, na przykład "6", jest traktowana jako >=6.
Przydaje się to w przypadku bloków, które mają sens tylko wtedy, gdy dostępna jest wtyczka: WooCommerce karty produktów, integracje formularzy, integracje SEO, komponenty członkostwa, widżety rezerwacji lub elementy administracyjne UI powiązane z wtyczką innej firmy.
Zasady edytora
Plik blockstudio.json staje się również coraz bardziej przydatny jako plik zasad edytora na poziomie projektu.
Wersja 7.3 dodaje warstwę zasad blockEditor opartą na PHP dla ustawień już udostępnianych przez hooki po stronie serwera WordPress. Dzięki temu można definiować globalne zachowanie wstawiania bloków, wzorców i multimediów bez dodawania jednorazowego kodu łączącego w motywie.
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"blockEditor": {
"blocks": {
"allow": ["core/*", "my-theme/*"],
"deny": ["core/embed", "core/freeform"],
"directory": false,
"categories": {
"rename": {
"text": "Writing",
"design": "Layout"
},
"order": ["my-theme", "text", "media"]
}
},
"patterns": {
"core": false,
"remote": false,
"categories": {
"deny": ["gallery"],
"order": ["featured", "buttons"]
}
},
"media": {
"openverse": false,
"imageSizes": {
"allow": ["thumbnail", "large"]
}
}
}
}
Pierwsza wersja celowo ogranicza się do elementów obsługiwanych przez PHP: dozwolonych i zablokowanych bloków, ładowania katalogu bloków, etykiet i kolejności kategorii wstawiania, źródeł i kategorii wzorców, Openverse, wyboru rozmiaru obrazów, widoczności starszych widżetów oraz usuwania stylów bloków zarejestrowanych przez PHP.
Nie próbuje zmieniać dowolnych wartości domyślnych bloków rdzenia. Ustawienia takie jak core/columns.isStackedOnMobile znajdują się w przepływie rejestracji JavaScript edytora bloków, dlatego wymagają osobnego, bardziej jawnego API, zamiast udawania, że można je obsłużyć w pliku JSON.
Aliasy znaczników bloków
Do znaczników bloków dodano filtr aliasów:
add_filter('blockstudio/block_tags/tag_aliases', function ($aliases) {
$aliases['theme-button'] = 'bsui/button';
return $aliases;
});
Dzięki temu projekt może definiować przyjazne dla autorów znaczniki, które wewnętrznie nadal są rozpoznawane jako kanoniczna nazwa bloku.
<bs:theme-button label="Continue" />
Przydaje się to szczególnie podczas tworzenia szablonów pełnych UI, w których kanoniczne nazwy bloków są poprawne, ale nie zawsze najwygodniejsze w użyciu.
Narzędzia i niezawodność
Rozwijano analizę statyczną, niezawodność i narzędzia do monitorowania wydajności.
Analiza statyczna i generowana dokumentacja
Rozszerzenie PHPStan zyskało obsługę jawnie wskazanych katalogów głównych do skanowania zewnętrznych bibliotek bloków. Dzięki temu projekt może walidować znaczniki <bs:*> i <block> względem bloków spoza bieżącej wtyczki lub motywu, zachowując te katalogi wyłącznie na potrzeby rejestru podczas analizy.
Rozszerzono też sprawdzanie schematów w zakresie metadanych stron i pluginDependencies, dzięki czemu nieprawidłową konfigurację wydania łatwiej wykryć, zanim trafi do WordPress.
Generator dokumentacji uwzględnia teraz również opisy filtrów dla ustawień i hooków PHP. Jest to coraz ważniejsze, ponieważ blockstudio.json staje się rzeczywistym plikiem zasad projektu, a nie tylko miejscem na kilka rozproszonych przełączników.
Niezawodność stron i edytora
Wersja 7.3 zawiera również zestaw poprawek dotyczących stron opartych na plikach, renderowania edytora i trybu resetowania.
Parsowanie stron z plików obsługuje teraz mapowania niestandardowych kontenerów uwzględniające atrybuty podczas parsowania HTML. Tagi stron bs: poprawnie rozpoznają też przestrzenie nazw bloków zawierające łączniki, dzięki czemu nazwy takie jak custom-theme/card nie powodują już błędów parsera.
Ogólne tagi kontenerów spoza rdzenia serializują teraz poprawne innerContent, gdy nie dostarczają znaczników opakowujących. Dzięki temu zsynchronizowana zawartość stron jest bardziej przewidywalna, a serializacja bloków WordPress pozostaje poprawna.
W edytorze wprowadzono zestaw poprawek dotyczących podglądu i wstępnego ładowania:
- Tailwind editor CSS zawiera teraz kandydatów klas z szablonów stron opartych na plikach.
- Wstępne ładowanie edytora zachowuje klasy wrappera RichText dla powtarzających się bloków tego samego typu.
- Wstępne ładowanie edytora dopasowuje bloki, których domyślne wartości pól są rozwijane przez Gutenberg, ale pomijane w zapisanym znaczniku bloku.
- Zarejestrowane domyślne atrybuty rozwijane przez Gutenberg są pomijane przed porównaniem kluczy pamięci podręcznej renderowania.
- Podglądy renderowania w edytorze i wstawianiu mają teraz osobne wpisy w pamięci podręcznej, nawet gdy współdzielą identyfikator klienta.
bs_get_group()działa teraz prawidłowo z ponownie używanymi grupami pól niestandardowych, w tym z grupami, których identyfikator odpowiada nazwie pola niestandardowego, i wyodrębnia tylko dokładne prefiksy grup.- Pola odnośników z
withCreateSuggestionprawidłowo konfigurują proces tworzenia w WordPress LinkControl i tworzą strony robocze za pomocą REST API. - Szablony bloków PHP są teraz wykonywane raz na renderowanie, zamiast uruchamiać odrzucone wstępne dołączenie.
Udoskonalono też tryb resetowania. Neutralizuje teraz reguły szerokości bloków edytora Gutenberg i marginesów pionowych dla skonfigurowanych typów wpisów, w razie potrzeby usuwa style zawartości i resetowania elementu iframe WordPress oraz zapewnia czytelniejsze nakładki najechania i zaznaczenia Blockstudio.
Rozszerzono też testy regresyjne złożonych wzorców InnerBlocks o zagnieżdżone bloki Blockstudio, dzięki czemu ścieżka renderowania edytora jest sprawdzana także w przypadkach wstawiania wzorców, które najtrudniej zweryfikować ręcznie.
Narzędzia do pomiaru wydajności
Lokalne, anonimowe sondy blockstudio-perf=1 mogą teraz wysyłać nagłówki Server-Timing bez wstrzykiwania panelu debugowania.
Pomiary obejmują teraz więcej etapów cyklu budowania: wykrywanie, przetwarzanie zasobów, rejestrację i nadpisania. Dzięki temu łatwiej sprawdzić, gdzie faktycznie ucieka czas, bez włączania widocznego UI profilowania.
Dlaczego to wydanie ma znaczenie
Głównym tematem wersji 7.3 jest kompozycja.
Komponenty UI ułatwiają składanie interfejsów aplikacji. Rozszerzony edytor ułatwia edycję większych bloków. Zależności wtyczek pozwalają blokom określać wymagany kontekst wtyczki. Zasady edytora przenoszą reguły edytora bloków dotyczące całego projektu do blockstudio.json. Aliasy tagów bloków ułatwiają tworzenie szablonów. Poprawki parsera, PHPStan i edytora zwiększają niezawodność tych kompozycji podczas przechodzenia przez WordPress.
Blockstudio nadal bazuje na plikach. Bloki nadal są folderami. Szablony nadal wykonują swoją pracę. Jednak framework zyskał teraz solidniejszą warstwę UI na tej podstawie.