API компонента Палитра команд

Импорт

import-command.ts

import { type NuiCommand, NuiCommandPalette } from '@needless-ui/angular/command';

NuiCommandPalette

Модальный диалог с полем поиска по вашим командам.

Селектор: nui-command-palette

NuiCommandPalette: Свойства
Имя	Тип	По умолчанию	Описание
`commands`Input	`NuiCommand[]`		Команды в виде объектов `NuiCommand`.
`open`Двусторонний	`boolean`	`false`	Открыта ли палитра.
`hotkey`Input	`string \| null`	`'mod+k'`	Сочетание клавиш, которое открывает и закрывает палитру из любого места, или `null`, если оно не нужно. `mod` — это ⌘ на устройствах Apple и Ctrl на остальных.
`bindShortcuts`Input	`boolean`	`false`	Выполняет команды и по их собственным сочетаниям клавиш в любом месте страницы.
`loop`Input	`boolean`	`true`	Стрелка вниз на последней команде ведёт к первой, а вверх на первой — к последней.
`filtering`Input	`boolean`	`true`	Фильтрует по мере ввода. Отключите, если команды фильтрует сервер.
`loading`Input	`boolean`	`false`	Показывает строку загрузки, пока результаты не пришли.
`hints`Input	`boolean`	`true`	Показывает внизу подсказки по клавишам.
`virtual`Input	`boolean \| 'auto'`	`'auto'`	Рендерит только видимые строки: всегда, никогда или `auto` — свыше 200 строк.
`label`Input	`string`	`'Command palette'`	Доступное имя диалога и его поля поиска.
`placeholder`Input	`string`	`'Type a command or search…'`	Текст в пустом поле поиска.
`run`Output	`NuiCommand`		Передаёт каждую выполненную команду.
`queryChange`Output	`string`		Передаёт текст по мере ввода — для поиска на сервере.
`show`Метод	`() => void`		Открывает палитру.
`hide`Метод	`() => void`		Закрывает палитру.
`toggle`Метод	`() => void`		Открывает или закрывает палитру.
`back`Метод	`() => void`		Возвращает на предыдущую страницу.

Все видимые и озвучиваемые тексты — тоже входные свойства, так что их можно перевести: emptyLabel loadingLabel backLabel closeLabel moveLabel chooseLabel

NuiCommand

Одна команда или страница команд.

NuiCommand: Свойства
Имя	Тип	Описание
`label`Свойство	`string`	Видимый текст, по которому идёт поиск.
`description`Свойство	`string`	Второстепенный текст под подписью.
`group`Свойство	`string`	Команды с одинаковой группой выводятся под её заголовком.
`keywords`Свойство	`string[]`	Дополнительные слова для поиска, например синонимы.
`shortcut`Свойство	`string`	Клавиши, показанные рядом с командой, например `mod+shift+p`.
`disabled`Свойство	`boolean`	Показывается, но не выполняется.
`children`Свойство	`NuiCommand[]`	Команды уровнем ниже: выбор этой команды открывает их как страницу.
`run`Свойство	`() => void`	Вызывается при выборе, после закрытия палитры.
`id`Свойство	`string`	Для ваших нужд, например чтобы различать команды в `(run)`.