Nuxt Headless UI

Nuxt 的 Headless UI 集成。完全未经样式化的、完全可访问的 UI 组件，旨在与 Tailwind CSS 完美集成。

Vue 的 Headless UI 文档：https://headlessui.tailwind.org.cn/vue/menu

功能

自动动态导入（无全局组件）
完全类型安全
可配置组件前缀（默认为 Headless）

快速设置

将 nuxt-headlessui 依赖项添加到您的项目中

# Using pnpm
pnpm add -D nuxt-headlessui

# Using yarn
yarn add --dev nuxt-headlessui

# Using npm
npm install --save-dev nuxt-headlessui

将 nuxt-headlessui 添加到 nuxt.config.ts 文件的 modules 部分

{
    modules: [
        'nuxt-headlessui'
    ],

    // Optionally change the default prefix.
    headlessui: {
        prefix: 'Headless'
    }
}

将以下几行添加到 app.vue 文件中的 <script setup> 内

// Use SSR-safe IDs for Headless UI
provideHeadlessUseId(() => useId())

这是为了避免水合问题，因为 ID 不匹配。这两个组合式 API 将由 Nuxt 自动导入。 provideHeadlessUseId 组合式 API 是来自 @headlessui/vue 的 provideUseId 组合式 API 的别名。直接使用 import { provideUseId } from '@headlessui/vue' 无法开箱即用。

就是这样！您现在可以在您的 Nuxt 应用中使用 Headless UI ✨

用法

完成设置后，只需在您的组件和页面中使用 headless 组件并使用您最喜欢的 CSS 框架对其进行样式设置即可。您无需导入组件。以下是一个 Listbox（选择）的示例，它使用了 heroicons 和 Tailwind CSS

<template>
  <div class="container mx-auto">
    <div class="w-72">
      <HeadlessListbox v-model="selectedPerson">
        <div class="relative mt-1">
          <HeadlessListboxButton
            class="relative w-full cursor-default rounded-lg bg-white py-2 pl-3 pr-10 text-left shadow-md focus:outline-none focus-visible:border-indigo-500 focus-visible:ring-2 focus-visible:ring-white focus-visible:ring-opacity-75 focus-visible:ring-offset-2 focus-visible:ring-offset-orange-300 sm:text-sm"
          >
            <span class="block truncate">{{ selectedPerson.name }}</span>
            <span
              class="pointer-events-none absolute inset-y-0 right-0 flex items-center pr-2"
            >
              <ChevronUpDownIcon
                class="h-5 w-5 text-gray-400"
                aria-hidden="true"
              />
            </span>
          </HeadlessListboxButton>

          <transition
            leave-active-class="transition duration-100 ease-in"
            leave-from-class="opacity-100"
            leave-to-class="opacity-0"
          >
            <HeadlessListboxOptions
              class="absolute mt-1 max-h-60 w-full overflow-auto rounded-md bg-white py-1 text-base shadow-lg ring-1 ring-black ring-opacity-5 focus:outline-none sm:text-sm"
            >
              <HeadlessListboxOption
                v-for="person in people"
                v-slot="{ active, selected }"
                :key="person.name"
                :value="person"
                as="template"
              >
                <li
                  :class="[
                    active ? 'bg-amber-100 text-amber-900' : 'text-gray-900',
                    'relative cursor-default select-none py-2 pl-10 pr-4',
                  ]"
                >
                  <span
                    :class="[
                      selected ? 'font-medium' : 'font-normal',
                      'block truncate',
                    ]"
                  >{{ person.name }}</span>
                  <span
                    v-if="selected"
                    class="absolute inset-y-0 left-0 flex items-center pl-3 text-amber-600"
                  >
                    <CheckIcon class="h-5 w-5" aria-hidden="true" />
                  </span>
                </li>
              </HeadlessListboxOption>
            </HeadlessListboxOptions>
          </transition>
        </div>
      </HeadlessListbox>
    </div>
  </div>
</template>

<script setup>
import { ref } from 'vue'
import { CheckIcon, ChevronUpDownIcon } from '@heroicons/vue/20/solid'

const people = [
  { name: 'Wade Cooper' },
  { name: 'Arlene Mccoy' },
  { name: 'Devon Webb' },
  { name: 'Tom Cook' },
  { name: 'Tanya Fox' },
  { name: 'Hellen Schmidt' }
]
const selectedPerson = ref(people[0])
</script>

如果您使用的是 Tailwind CSS，您可以使用 @headlessui/tailwindcss 插件来获取诸如 ui-open:* 和 ui-active:* 之类的修饰符。

开发

# Install dependencies
pnpm install

# Generate type stubs
pnpm run dev:prepare

# Develop with the playground
pnpm run dev

# Build the playground
pnpm run dev:build

# Run ESLint
pnpm run lint