# 命令面板列表

## 使用方法

装结果的那个可滚动容器。单独用时它就是一个 listbox；放进 `CommandPalette` 里、并且确实有可选结果时，它也会画成 listbox。里面装的是 `CommandPaletteItem` 和 `CommandPaletteGroup`。

```ts
import { CommandPaletteList } from '@astryx-vue/core/CommandPalette'
```

## 示例

常见的用法和不同的状态。

### 行的状态

不分组的平铺列表，展示了高亮、选中和禁用三种行状态。想加小标题分组就用 CommandPaletteGroup。

```vue
<script setup lang="ts">
import { CommandPaletteItem, CommandPaletteList } from '@astryx-vue/core/CommandPalette'
</script>

<template>
  <CommandPaletteList>
    <CommandPaletteItem value="go-home">
      Go Home
    </CommandPaletteItem>
    <CommandPaletteItem is-highlighted value="open-settings">
      Open Settings
    </CommandPaletteItem>
    <CommandPaletteItem is-selected value="view-profile">
      View Profile
    </CommandPaletteItem>
    <CommandPaletteItem is-disabled value="help">
      Help (unavailable)
    </CommandPaletteItem>
  </CommandPaletteList>
</template>
```

## 属性

| 属性 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| `label` | `string` | `Commands` | 这个列表框给读屏用的名字。默认值来自语言包，会跟随当前语言。 |

## 插槽

- `default`：列表内容，一般是一行行 `CommandPaletteItem`，外面套不套 `CommandPaletteGroup` 都行。