API của Bảng lệnh

Import

import-command.ts

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

NuiCommandPalette

Hộp thoại modal có ô tìm kiếm trên các lệnh của bạn.

Selector: nui-command-palette

NuiCommandPalette: Thuộc tính
Tên	Kiểu	Mặc định	Mô tả
`commands`Input	`NuiCommand[]`		Các lệnh, dưới dạng đối tượng `NuiCommand`.
`open`Hai chiều	`boolean`	`false`	Bảng lệnh có đang mở hay không.
`hotkey`Input	`string \| null`	`'mod+k'`	Phím tắt mở và đóng bảng lệnh từ bất kỳ đâu, hoặc `null` nếu không dùng. `mod` là ⌘ trên thiết bị Apple và Ctrl trên các thiết bị khác.
`bindShortcuts`Input	`boolean`	`false`	Chạy cả các lệnh bằng phím tắt riêng của chúng, ở bất kỳ đâu trên trang.
`loop`Input	`boolean`	`true`	Nhấn xuống ở lệnh cuối sẽ về lệnh đầu, và nhấn lên ở lệnh đầu sẽ về lệnh cuối.
`filtering`Input	`boolean`	`true`	Lọc khi bạn gõ. Hãy tắt đi khi máy chủ lọc các lệnh.
`loading`Input	`boolean`	`false`	Hiển thị một dòng đang tải trong lúc chờ kết quả.
`hints`Input	`boolean`	`true`	Hiển thị gợi ý phím ở phía dưới.
`virtual`Input	`boolean \| 'auto'`	`'auto'`	Chỉ render các dòng đang hiển thị: luôn luôn, không bao giờ, hoặc `auto` khi quá 200 dòng.
`label`Input	`string`	`'Command palette'`	Accessible name của hộp thoại và ô tìm kiếm của nó.
`placeholder`Input	`string`	`'Type a command or search…'`	Văn bản hiển thị trong ô tìm kiếm còn trống.
`run`Output	`NuiCommand`		Phát ra mỗi lệnh được chạy.
`queryChange`Output	`string`		Phát ra văn bản trong lúc gõ, để tìm kiếm trên máy chủ.
`show`Phương thức	`() => void`		Mở bảng lệnh.
`hide`Phương thức	`() => void`		Đóng bảng lệnh.
`toggle`Phương thức	`() => void`		Mở hoặc đóng bảng lệnh.
`back`Phương thức	`() => void`		Quay về trang trước đó.

Mọi văn bản mà component hiển thị hoặc đọc lên cũng là input, nên bạn có thể dịch chúng: emptyLabel loadingLabel backLabel closeLabel moveLabel chooseLabel

NuiCommand

Một lệnh, hoặc một trang gồm nhiều lệnh.

NuiCommand: Thuộc tính
Tên	Kiểu	Mô tả
`label`Thuộc tính	`string`	Văn bản được hiển thị và dùng để tìm kiếm.
`description`Thuộc tính	`string`	Văn bản phụ bên dưới nhãn.
`group`Thuộc tính	`string`	Các lệnh cùng nhóm được liệt kê dưới tiêu đề của nhóm đó.
`keywords`Thuộc tính	`string[]`	Các từ khác mà tìm kiếm sẽ khớp, chẳng hạn từ đồng nghĩa.
`shortcut`Thuộc tính	`string`	Các phím hiển thị kèm lệnh, chẳng hạn `mod+shift+p`.
`disabled`Thuộc tính	`boolean`	Vẫn hiển thị nhưng không chạy được.
`children`Thuộc tính	`NuiCommand[]`	Các lệnh ở cấp dưới: chọn lệnh này sẽ mở chúng thành một trang.
`run`Thuộc tính	`() => void`	Chạy khi lệnh được chọn, sau khi bảng lệnh đã đóng.
`id`Thuộc tính	`string`	Để bạn tự dùng, chẳng hạn để phân biệt các lệnh trong `(run)`.