vscode-ext-commands

Zbiór wytycznych ułatwiających dodawanie i aktualizowanie poleceń w rozszerzeniach VS Code. Dowiesz się, jak prawidłowo nazewać polecenia, ustawiać ich widoczność, definiować ikony i lokalizację, zgodnie z najlepszymi praktykami ekosystemu VS Code. Obejmuje zarówno polecenia zwykłe dostępne w palecie poleceń, jak i specjalne polecenia paska bocznego z własnymi regułami nazewnictwa i wymaganiami.

1. Zapoznaj się z typami poleceń dostępnymi w VS Code — każde polecenie musi zawierać pole title, niezależnie od kategorii czy lokalizacji, ale wymogi różnią się w zależności od typu.

2. Dla poleceń zwykłych (Regular commands) dodaj pole category i upewnij się, że polecenie będzie dostępne w palecie poleceń. Ikona nie jest wymagana, chyba że polecenie będzie używane na pasku bocznym.

3. Dla poleceń paska bocznego (Side Bar commands) zastosuj specjalny wzór nazewnictwa — zacznij od znaku podkreślenia (_) i dodaj sufiks #sideBar, na przykład _extensionId.someCommand#sideBar. Takie polecenia muszą zawierać pole icon.

4. Zdefiniuj warunki widoczności polecenia paska bocznego, używając pola when, aby kontrolować, kiedy polecenie powinno być dostępne. Upewnij się, że polecenia wyłączne dla paska bocznego nie pojawiają się w palecie poleceń.

5. Jeśli dodajesz polecenie do view/title lub view/item/context, określ jego pozycję za pomocą parametru order i wybierz odpowiednią grupę (group), biorąc pod uwagę położenie względem innych poleceń i przycisków.

6. Przetestuj polecenie, aby upewnić się, że jest dostępne w odpowiednim miejscu interfejsu, ma prawidłową ikonę (jeśli wymagana) i respektuje zdefiniowane warunki widoczności.