← Wszystkie wpisy

API i helpers

window.JZ jako mini-framework — własny panel narzędzi z akcji

15 maja 2026 · autor JustZix Team

Pojedyncza akcja to przycisk i kod. Ale akcje mogą się nawzajem wołać — i z tego momentu masz w ręku mały framework. window.JZ pozwala budować z przycisków złożone, wielokrokowe workflow.

Czym jest window.JZ

W kodzie dowolnej reguły lub akcji dostępny jest obiekt window.JZ — API do sterowania paskiem akcji JustZix:

• JZ.click('LBL') — kliknij programatycznie akcję o etykiecie „LBL".
• JZ.action('LBL') — pobierz element DOM przycisku.
• JZ.actions() — tablica wszystkich widocznych akcji.
• JZ.labels() — tablica etykiet.

Lookup ignoruje wielkość liter: JZ.click('save') równa się JZ.click('SAVE').

Wzorzec 1 — akcja-orkiestrator

Trzy akcje robią po jednej rzeczy, czwarta składa je w sekwencję:

// Akcja "AUTO" — uruchamia trzy inne po kolei
JZ.click('LOAD');
setTimeout(() => JZ.click('PROC'), 500);
setTimeout(() => JZ.click('SAVE'), 1500);

Każdą z trzech akcji składowych testujesz osobno; „AUTO" tylko je dyryguje. To ta sama zasada, co funkcje wywołujące funkcje.

Wzorzec 2 — akcja warunkowa

// Akcja "SMART" — zachowanie zależne od stanu strony
if (document.querySelector('.logged-in')) {
  JZ.click('EXPORT');
} else {
  JZ.click('LOGIN');
}

Wzorzec 3 — pętla po akcjach

JZ.actions() i JZ.labels() pozwalają traktować pasek jak dane:

// Akcja "ALL" — odpala wszystkie akcje zaczynające się od "T"
JZ.labels()
  .filter(l => l.startsWith('T'))
  .forEach(l => JZ.click(l));

Dlaczego to działa jak framework

Masz jednostki (akcje), sposób ich wywoływania (JZ.click), introspekcję (JZ.actions/labels) i kompozycję (akcja wołająca akcje). To wystarczy, by z paska przycisków zbudować narzędzie wielokrokowe — bez żadnej zewnętrznej biblioteki.

Pułapki

• Timing. JZ.click jest natychmiastowy, ale efekt akcji (np. fetch) — nie. Dlatego orkiestrator używa setTimeout; lepiej, gdy akcje sygnalizują zakończenie przez wspólną zmienną.
• Etykiety to kontrakt. Akcja-orkiestrator woła inne po etykiecie — zmiana etykiety „LOAD" rozłączy „AUTO". Traktuj etykiety jak nazwy funkcji.

Zobacz też

• window.JZ helpers — pełne API akcji
• Akcja BUTTON — jednostka, którą orkiestrujesz
• Trzy akcje warte miejsca — gotowe akcje do złożenia

Zainstaluj JustZix — i zbuduj z przycisków coś większego niż przycisk.