mirror of
https://github.com/ArthurDanjou/ui.git
synced 2026-01-14 12:14:41 +01:00
337 lines
13 KiB
Vue
337 lines
13 KiB
Vue
<script lang="ts">
|
|
import type { ListboxRootProps, ListboxRootEmits } from 'reka-ui'
|
|
import type { FuseResult } from 'fuse.js'
|
|
import type { AppConfig } from '@nuxt/schema'
|
|
import type { UseFuseOptions } from '@vueuse/integrations/useFuse'
|
|
import _appConfig from '#build/app.config'
|
|
import theme from '#build/ui/command-palette'
|
|
import type { UseComponentIconsProps } from '../composables/useComponentIcons'
|
|
import { extendDevtoolsMeta } from '../composables/extendDevtoolsMeta'
|
|
import { tv } from '../utils/tv'
|
|
import type { AvatarProps, ButtonProps, ChipProps, KbdProps, InputProps } from '../types'
|
|
import type { DynamicSlots, PartialString } from '../types/utils'
|
|
|
|
const appConfig = _appConfig as AppConfig & { ui: { commandPalette: Partial<typeof theme> } }
|
|
|
|
const commandPalette = tv({ extend: tv(theme), ...(appConfig.ui?.commandPalette || {}) })
|
|
|
|
export interface CommandPaletteItem {
|
|
prefix?: string
|
|
label?: string
|
|
suffix?: string
|
|
icon?: string
|
|
avatar?: AvatarProps
|
|
chip?: ChipProps
|
|
kbds?: KbdProps['value'][] | KbdProps[]
|
|
active?: boolean
|
|
loading?: boolean
|
|
disabled?: boolean
|
|
slot?: string
|
|
onSelect?(e?: Event): void
|
|
}
|
|
|
|
export interface CommandPaletteGroup<T> {
|
|
id: string
|
|
label?: string
|
|
slot?: string
|
|
items?: T[]
|
|
/**
|
|
* Whether to filter group items with [useFuse](https://vueuse.org/integrations/useFuse).
|
|
* When `true`, items will not be filtered which is useful for custom filtering (useAsyncData, useFetch, etc.).
|
|
* @defaultValue false
|
|
*/
|
|
ignoreFilter?: boolean
|
|
/** Filter group items after the search happened. */
|
|
postFilter?: (searchTerm: string, items: T[]) => T[]
|
|
/** The icon displayed when an item is highlighted. */
|
|
highlightedIcon?: string
|
|
}
|
|
|
|
export interface CommandPaletteProps<G, T> extends Pick<ListboxRootProps, 'multiple' | 'disabled' | 'modelValue' | 'defaultValue' | 'highlightOnHover'>, Pick<UseComponentIconsProps, 'loading' | 'loadingIcon'> {
|
|
/**
|
|
* The element or component this component should render as.
|
|
* @defaultValue 'div'
|
|
*/
|
|
as?: any
|
|
/**
|
|
* The icon displayed in the input.
|
|
* @defaultValue appConfig.ui.icons.search
|
|
*/
|
|
icon?: string
|
|
/**
|
|
* The icon displayed when an item is selected.
|
|
* @defaultValue appConfig.ui.icons.check
|
|
*/
|
|
selectedIcon?: string
|
|
/**
|
|
* The placeholder text for the input.
|
|
* @defaultValue 'Type a command or search...'
|
|
*/
|
|
placeholder?: InputProps['placeholder']
|
|
/**
|
|
* Automatically focus the input when component is mounted.
|
|
* @defaultValue true
|
|
*/
|
|
autofocus?: boolean
|
|
/**
|
|
* Display a close button in the input (useful when inside a Modal for example).
|
|
* `{ size: 'md', color: 'neutral', variant: 'ghost' }`{lang="ts-type"}
|
|
* @emits 'update:open'
|
|
* @defaultValue false
|
|
*/
|
|
close?: ButtonProps | boolean
|
|
/**
|
|
* The icon displayed in the close button.
|
|
* @defaultValue appConfig.ui.icons.close
|
|
*/
|
|
closeIcon?: string
|
|
groups?: G[]
|
|
/**
|
|
* Options for [useFuse](https://vueuse.org/integrations/useFuse).
|
|
* @defaultValue {
|
|
fuseOptions: {
|
|
ignoreLocation: true,
|
|
threshold: 0.1,
|
|
keys: ['label', 'suffix']
|
|
},
|
|
resultLimit: 12,
|
|
matchAllWhenSearchEmpty: true
|
|
}
|
|
*/
|
|
fuse?: UseFuseOptions<T>
|
|
/**
|
|
* The key used to get the label from the item.
|
|
* @defaultValue 'label'
|
|
*/
|
|
labelKey?: string
|
|
class?: any
|
|
ui?: PartialString<typeof commandPalette.slots>
|
|
}
|
|
|
|
export type CommandPaletteEmits<T> = ListboxRootEmits<T> & {
|
|
'update:open': [value: boolean]
|
|
}
|
|
|
|
type SlotProps<T> = (props: { item: T, index: number }) => any
|
|
|
|
export type CommandPaletteSlots<G extends { slot?: string }, T extends { slot?: string }> = {
|
|
'empty'(props: { searchTerm?: string }): any
|
|
'close'(props: { ui: any }): any
|
|
'item': SlotProps<T>
|
|
'item-leading': SlotProps<T>
|
|
'item-label': SlotProps<T>
|
|
'item-trailing': SlotProps<T>
|
|
} & DynamicSlots<G, SlotProps<T>> & DynamicSlots<T, SlotProps<T>>
|
|
|
|
extendDevtoolsMeta({ example: 'CommandPaletteExample', ignoreProps: ['groups'] })
|
|
</script>
|
|
|
|
<script setup lang="ts" generic="G extends CommandPaletteGroup<T>, T extends CommandPaletteItem">
|
|
import { computed } from 'vue'
|
|
import { ListboxRoot, ListboxFilter, ListboxContent, ListboxGroup, ListboxGroupLabel, ListboxItem, ListboxItemIndicator, useForwardProps, useForwardPropsEmits } from 'reka-ui'
|
|
import { defu } from 'defu'
|
|
import { reactivePick } from '@vueuse/core'
|
|
import { useFuse } from '@vueuse/integrations/useFuse'
|
|
import { useAppConfig } from '#imports'
|
|
import { useLocale } from '../composables/useLocale'
|
|
import { omit, get } from '../utils'
|
|
import { highlight } from '../utils/fuse'
|
|
import UIcon from './Icon.vue'
|
|
import UAvatar from './Avatar.vue'
|
|
import UButton from './Button.vue'
|
|
import UChip from './Chip.vue'
|
|
import UKbd from './Kbd.vue'
|
|
import UInput from './Input.vue'
|
|
|
|
const props = withDefaults(defineProps<CommandPaletteProps<G, T>>(), {
|
|
modelValue: '',
|
|
placeholder: 'Type a command or search...',
|
|
labelKey: 'label',
|
|
autofocus: true
|
|
})
|
|
const emits = defineEmits<CommandPaletteEmits<T>>()
|
|
const slots = defineSlots<CommandPaletteSlots<G, T>>()
|
|
|
|
const searchTerm = defineModel<string>('searchTerm', { default: '' })
|
|
|
|
const { t } = useLocale()
|
|
const appConfig = useAppConfig()
|
|
|
|
const rootProps = useForwardPropsEmits(reactivePick(props, 'as', 'disabled', 'multiple', 'modelValue', 'defaultValue', 'highlightOnHover'), emits)
|
|
const inputProps = useForwardProps(reactivePick(props, 'loading', 'loadingIcon', 'placeholder'))
|
|
|
|
// eslint-disable-next-line vue/no-dupe-keys
|
|
const ui = commandPalette()
|
|
|
|
const fuse = computed(() => defu({}, props.fuse, {
|
|
fuseOptions: {
|
|
ignoreLocation: true,
|
|
threshold: 0.1,
|
|
keys: [props.labelKey, 'suffix']
|
|
},
|
|
resultLimit: 12,
|
|
matchAllWhenSearchEmpty: true
|
|
}))
|
|
|
|
const items = computed(() => props.groups?.filter((group) => {
|
|
if (!group.id) {
|
|
console.warn(`[@nuxt/ui] CommandPalette group is missing an \`id\` property`)
|
|
return false
|
|
}
|
|
|
|
if (group.ignoreFilter) {
|
|
return false
|
|
}
|
|
|
|
return true
|
|
}).flatMap(group => group.items?.map(item => ({ ...item, group: group.id })) || []) || [])
|
|
|
|
const { results: fuseResults } = useFuse<typeof items.value[number]>(searchTerm, items, fuse)
|
|
|
|
function getGroupWithItems(group: G, items: (T & { matches?: FuseResult<T>['matches'] })[]) {
|
|
if (group?.postFilter && typeof group.postFilter === 'function') {
|
|
items = group.postFilter(searchTerm.value, items)
|
|
}
|
|
|
|
return {
|
|
...group,
|
|
items: items.slice(0, fuse.value.resultLimit).map((item) => {
|
|
return {
|
|
...item,
|
|
labelHtml: highlight<T>(item, searchTerm.value, props.labelKey),
|
|
suffixHtml: highlight<T>(item, searchTerm.value, undefined, [props.labelKey])
|
|
}
|
|
})
|
|
}
|
|
}
|
|
|
|
const groups = computed(() => {
|
|
const groupsById = fuseResults.value.reduce((acc, result) => {
|
|
const { item, matches } = result
|
|
if (!item.group) {
|
|
return acc
|
|
}
|
|
|
|
acc[item.group] ||= []
|
|
acc[item.group]?.push({ ...item, matches })
|
|
|
|
return acc
|
|
}, {} as Record<string, (T & { matches?: FuseResult<T>['matches'] })[]>)
|
|
|
|
const fuseGroups = Object.entries(groupsById).map(([id, items]) => {
|
|
const group = props.groups?.find(group => group.id === id)
|
|
if (!group) {
|
|
return
|
|
}
|
|
|
|
return getGroupWithItems(group, items)
|
|
}).filter(group => !!group)
|
|
|
|
const nonFuseGroups = props.groups
|
|
?.map((group, index) => ({ ...group, index }))
|
|
?.filter(group => group.ignoreFilter && group.items?.length)
|
|
?.map(group => ({ ...getGroupWithItems(group, group.items || []), index: group.index })) || []
|
|
|
|
return nonFuseGroups.reduce((acc, group) => {
|
|
acc.splice(group.index, 0, group)
|
|
return acc
|
|
}, [...fuseGroups])
|
|
})
|
|
</script>
|
|
|
|
<!-- eslint-disable vue/no-v-html -->
|
|
<template>
|
|
<ListboxRoot v-bind="rootProps" :class="ui.root({ class: [props.class, props.ui?.root] })">
|
|
<ListboxFilter v-model="searchTerm" as-child>
|
|
<UInput
|
|
variant="none"
|
|
:autofocus="autofocus"
|
|
size="lg"
|
|
v-bind="inputProps"
|
|
:icon="icon || appConfig.ui.icons.search"
|
|
:class="ui.input({ class: props.ui?.input })"
|
|
>
|
|
<template v-if="close || !!slots.close" #trailing>
|
|
<slot name="close" :ui="ui">
|
|
<UButton
|
|
v-if="close"
|
|
:icon="closeIcon || appConfig.ui.icons.close"
|
|
size="md"
|
|
color="neutral"
|
|
variant="ghost"
|
|
:aria-label="t('commandPalette.close')"
|
|
v-bind="typeof close === 'object' ? close : undefined"
|
|
:class="ui.close({ class: props.ui?.close })"
|
|
@click="emits('update:open', false)"
|
|
/>
|
|
</slot>
|
|
</template>
|
|
</UInput>
|
|
</ListboxFilter>
|
|
|
|
<ListboxContent :class="ui.content({ class: props.ui?.content })">
|
|
<div v-if="groups?.length" :class="ui.viewport({ class: props.ui?.viewport })">
|
|
<ListboxGroup v-for="(group, groupIndex) in groups" :key="`group-${groupIndex}`" :class="ui.group({ class: props.ui?.group })">
|
|
<ListboxGroupLabel v-if="get(group, props.labelKey as string)" :class="ui.label({ class: props.ui?.label })">
|
|
{{ get(group, props.labelKey as string) }}
|
|
</ListboxGroupLabel>
|
|
|
|
<ListboxItem
|
|
v-for="(item, index) in group.items"
|
|
:key="`group-${groupIndex}-${index}`"
|
|
:value="omit(item, ['matches' as any, 'group' as any, 'onSelect', 'labelHtml', 'suffixHtml'])"
|
|
:disabled="item.disabled"
|
|
:class="ui.item({ class: props.ui?.item, active: item.active })"
|
|
@select="item.onSelect"
|
|
>
|
|
<slot :name="item.slot || group.slot || 'item'" :item="item" :index="index">
|
|
<slot :name="item.slot ? `${item.slot}-leading` : group.slot ? `${group.slot}-leading` : `item-leading`" :item="item" :index="index">
|
|
<UIcon v-if="item.loading" :name="loadingIcon || appConfig.ui.icons.loading" :class="ui.itemLeadingIcon({ class: props.ui?.itemLeadingIcon, loading: true })" />
|
|
<UIcon v-else-if="item.icon" :name="item.icon" :class="ui.itemLeadingIcon({ class: props.ui?.itemLeadingIcon, active: item.active })" />
|
|
<UAvatar v-else-if="item.avatar" :size="((props.ui?.itemLeadingAvatarSize || ui.itemLeadingAvatarSize()) as AvatarProps['size'])" v-bind="item.avatar" :class="ui.itemLeadingAvatar({ class: props.ui?.itemLeadingAvatar, active: item.active })" />
|
|
<UChip
|
|
v-else-if="item.chip"
|
|
:size="((props.ui?.itemLeadingChipSize || ui.itemLeadingChipSize()) as ChipProps['size'])"
|
|
inset
|
|
standalone
|
|
v-bind="item.chip"
|
|
:class="ui.itemLeadingChip({ class: props.ui?.itemLeadingChip, active: item.active })"
|
|
/>
|
|
</slot>
|
|
|
|
<span v-if="item.labelHtml || get(item, props.labelKey as string) || !!slots[item.slot ? `${item.slot}-label` : group.slot ? `${group.slot}-label` : `item-label`]" :class="ui.itemLabel({ class: props.ui?.itemLabel, active: item.active })">
|
|
<slot :name="item.slot ? `${item.slot}-label` : group.slot ? `${group.slot}-label` : `item-label`" :item="item" :index="index">
|
|
<span v-if="item.prefix" :class="ui.itemLabelPrefix({ class: props.ui?.itemLabelPrefix })">{{ item.prefix }}</span>
|
|
|
|
<span :class="ui.itemLabelBase({ class: props.ui?.itemLabelBase, active: item.active })" v-html="item.labelHtml || get(item, props.labelKey as string)" />
|
|
|
|
<span :class="ui.itemLabelSuffix({ class: props.ui?.itemLabelSuffix, active: item.active })" v-html="item.suffixHtml || item.suffix" />
|
|
</slot>
|
|
</span>
|
|
|
|
<span :class="ui.itemTrailing({ class: props.ui?.itemTrailing })">
|
|
<slot :name="item.slot ? `${item.slot}-trailing` : group.slot ? `${group.slot}-trailing` : `item-trailing`" :item="item" :index="index">
|
|
<span v-if="item.kbds?.length" :class="ui.itemTrailingKbds({ class: props.ui?.itemTrailingKbds })">
|
|
<UKbd v-for="(kbd, kbdIndex) in item.kbds" :key="kbdIndex" :size="((props.ui?.itemTrailingKbdsSize || ui.itemTrailingKbdsSize()) as KbdProps['size'])" v-bind="typeof kbd === 'string' ? { value: kbd } : kbd" />
|
|
</span>
|
|
<UIcon v-else-if="group.highlightedIcon" :name="group.highlightedIcon" :class="ui.itemTrailingHighlightedIcon({ class: props.ui?.itemTrailingHighlightedIcon })" />
|
|
</slot>
|
|
|
|
<ListboxItemIndicator as-child>
|
|
<UIcon :name="selectedIcon || appConfig.ui.icons.check" :class="ui.itemTrailingIcon({ class: props.ui?.itemTrailingIcon })" />
|
|
</ListboxItemIndicator>
|
|
</span>
|
|
</slot>
|
|
</ListboxItem>
|
|
</ListboxGroup>
|
|
</div>
|
|
|
|
<div v-else :class="ui.empty({ class: props.ui?.empty })">
|
|
<slot name="empty" :search-term="searchTerm">
|
|
{{ searchTerm ? t('commandPalette.noMatch', { searchTerm }) : t('commandPalette.noData') }}
|
|
</slot>
|
|
</div>
|
|
</ListboxContent>
|
|
</ListboxRoot>
|
|
</template>
|