К основному содержанию
скилл CX Codex

floating-ui-vue-skilld — скилл для Claude Code: обзор и установка

Скилл floating-ui-vue-skilld помогает писать позиционирование всплывающих окон, тултипов и меню через @floating-ui/vue 2.0.1 во Vue 3.3+.

MIT 119 установок ★ 186 обновлён 2026-10-10

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add skilld-dev/vue-ecosystem-skills --skill floating-ui-vue-skilld -a claude-code
Открыть на GitHub

Что делает floating-ui-vue-skilld

Скилл инструктирует ИИ-агента по работе с библиотекой @floating-ui/vue версии 2.0.1. Он подсказывает корректное использование композабла useFloating, реактивных стилей floatingStyles, автоматического слежения autoUpdate и мидлваров offset, flip или shift.

В релизе 2.0.0 удалили прослойку vue-demi, поэтому код работает строго с Vue >=3.3.0. Если в проекте используется Vue 2 или старая ветка Vue 3, переходить на вторую версию нельзя — нужно оставаться на первой.

Для всплывающего блока скилл требует использовать директиву v-if при связке с whileElementsMounted: autoUpdate. Директива v-show приведёт к утечке слушателей скролла на скрытых элементах, если не очищать их вручную.

Какие задачи решает

  • позиционировать тултипы и поповеры через useFloating во Vue 3
  • настроить мидлвары flip, shift и offset для всплывающего меню
  • предотвратить утечки памяти от слушателей autoUpdate при скрытии элементов
  • перевести вызовы @floating-ui/vue с версии 1.x на 2.0.1

Примеры запросов агенту

  • Сделай тултип на @floating-ui/vue с привязкой к кнопке и автоматическим сдвигом при скролле
  • Настрой композабл useFloating с мидлварами offset и arrow для Vue 3.4
  • Обнови компонент поповера с первой версии @floating-ui/vue на 2.0.1

Как установить floating-ui-vue-skilld

1Через Skills CLI (Vercel)

npx skills add skilld-dev/vue-ecosystem-skills --skill floating-ui-vue-skilld -a claude-code

2Вручную: положить файлы

~/.claude/skills/floating-ui-vue-skilld/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/floating-ui-vue-skilld/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о floating-ui-vue-skilld

Как установить floating-ui-vue-skilld в Claude Code?

Выполните команду npx skills add skilld-dev/vue-ecosystem-skills --skill floating-ui-vue-skilld -a claude-code. Файл навыка запишется по пути ~/.claude/skills/floating-ui-vue-skilld/SKILL.md.

Для каких версий Vue подходит этот скилл?

Скилл ориентирован на @floating-ui/vue 2.0.1 и требует Vue версии не ниже 3.3.0. Для проектов на Vue 2 или старых сборках Vue 3 разработчики рекомендуют зафиксировать первую версию библиотеки.

Почему для всплывающих элементов советуют использовать v-if вместо v-show?

При связке с whileElementsMounted: autoUpdate директива v-show оставляет скрытые элементы в DOM и не сбрасывает слушатели событий. С v-if элемент размонтируется, поэтому слушатели корректно очищаются.

Исходный текст

SKILL.md · MIT
---
name: floating-ui-vue-skilld
description: "Floating UI for Vue (@floating-ui/[email protected]). ALWAYS use when writing code importing \"@floating-ui/vue\" or using useFloating, arrow, floatingStyles, or autoUpdate. Consult for middleware setup, anchoring, virtual elements, and v1 to v2 migration. Vue 3.3+ only."
license: MIT
---

# @floating-ui/vue 2.0.1

Vue 3 composable for anchor positioning. `useFloating()` computes `x`/`y` coordinates that place a floating element (tooltip, popover, menu) next to a reference element.

## Version limits

- Vue `>=3.3.0` only (peer dependency, `package.json:58`). v2.0.0 dropped the `vue-demi` layer, ending Vue 2 and Vue <3.3 support.
- Vue 2 or Vue <3.3 projects must stay on `npm install @floating-ui/vue@1` (https://floating-ui.com/docs/vue).
- Runtime dependencies: `@floating-ui/dom@^1.8.0`, `@floating-ui/utils@^0.2.12` (`package.json:46-49`).
- TypeScript with `exactOptionalPropertyTypes`: supported since v2.0.1 (optional properties are typed `T | undefined`, `dist/floating-ui.vue.d.ts:198-224`).

## Quick start

```vue
<script setup>
import {ref} from 'vue';
import {useFloating, offset, flip, shift, autoUpdate} from '@floating-ui/vue';

const reference = ref(null);
const floating = ref(null);
const open = ref(false);

const {floatingStyles, isPositioned} = useFloating(reference, floating, {
  open,
  middleware: [offset(10), flip(), shift()],
  whileElementsMounted: autoUpdate,
});
</script>

<template>
  <button ref="reference" @click="open = !open">Button</button>
  <div v-if="open" ref="floating" :style="floatingStyles">Tooltip</div>
</template>
```

Default placement is `bottom`; positioning uses `transform` by default (https://floating-ui.com/docs/vue).

## API changes since 1.x

- BREAKING (2.0.0): `vue-demi` removed. Vue 2 and Vue <3.3 no longer supported. No other breaking API changes; `useFloating`, `arrow`, and all re-exports keep their 1.1.x signatures (https://github.com/floating-ui/floating-ui/releases/tag/@floating-ui/[email protected]).
- FIX (2.0.1): optional `useFloating` options accept explicit `undefined` under `exactOptionalPropertyTypes` (https://github.com/floating-ui/floating-ui/releases/tag/@floating-ui/[email protected]).
- Unchanged behaviors carried from 1.x: `x`/`y` default to `0` (not `null`); `floatingStyles` returns ready-to-bind positioning styles; options accept refs and getters (`MaybeReadonlyRefOrGetter`) since 1.1.0 (verified in `dist/floating-ui.vue.d.ts:193-225`, `dist/floating-ui.vue.mjs:83-84`).

## Best practices

- Pass `whileElementsMounted: autoUpdate` so the floating element stays anchored during scroll, resize, and layout changes (`dist/floating-ui.vue.mjs:146-156`; https://floating-ui.com/docs/vue).
- When wrapping `autoUpdate` to pass options, always return the cleanup function (`dist/floating-ui.vue.mjs:140-145`):
```ts
useFloating(reference, floating, {
  whileElementsMounted(...args) {
    return autoUpdate(...args, {animationFrame: true});
  },
});
```
- Use `v-if` for the floating element when using `whileElementsMounted`. With `v-show`, skip `whileElementsMounted` and manage `autoUpdate` manually, or listeners leak on hidden elements (https://floating-ui.com/docs/vue).
- Pass an `open` ref and gate side effects on `isPositioned`; positioning resolves in a microtask, so the element sits at (0, 0) until then. `isPositioned` stays `false` while `open` is `false` (`dist/floating-ui.vue.mjs:137`, `dist/floating-ui.vue.mjs:157-161`):
```ts
const {isPositioned} = useFloating(reference, floating, {open});
watch(isPositioned, (positioned) => {
  if (positioned) inputRef.value?.focus();
});
```
- Pass refs or getters (`() => props.placement`) to `open`, `placement`, `strategy`, `middleware`, `transform` options for reactivity; they are watched with `flush: 'sync'` (`dist/floating-ui.vue.mjs:162-164`).
- Pass component template refs directly. Components are unwrapped via `$el`; a component that renders a comment node resolves to `null` and positioning safely no-ops (`dist/floating-ui.vue.mjs:6-15`).
- Keep the default `transform: true` and animate an inner wrapper element if you need CSS transform animations; the outer positioned node keeps `translate()` positioning (https://floating-ui.com/docs/vue).
- Use `arrow({element: arrowRef})` with a template ref. It no-ops (returns `{}`) until the arrow element mounts; read `middlewareData.arrow?.x/.y` for placement (`dist/floating-ui.vue.mjs:27-34`).

## Common tasks

- Arrow positioning example and full option defaults: [API reference](./references/api.md).
- Upgrading from 1.x or pinning for Vue 2: [Migration guide](./references/migration.md).

## Package exports

`useFloating`, `arrow`, plus re-exports from `@floating-ui/dom`: `autoPlacement`, `autoUpdate`, `computePosition`, `detectOverflow`, `flip`, `getOverflowAncestors`, `hide`, `inline`, `limitShift`, `offset`, `platform`, `shift`, `size` (`dist/floating-ui.vue.mjs:2`). Import middleware from `@floating-ui/vue`, not `@floating-ui/dom`, to keep the Vue-aware `arrow` behavior.

© skilld-dev · MIT · skilld-dev/vue-ecosystem-skills

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
vue-best-practices github.com/vuejs-ai Скилл vue-best-practices задаёт стандарты разработки на Vue 3 с Composition API и TypeScript. Пригодится при написании SFC-компонентов, composables и настройке реактивности. CX Codex +1 45 800установок vue Anthony Fu Скилл vue для Claude Code помогает писать компоненты Vue 3 и разбирать Composition API. Он подключается при работе с SFC, макросами defineProps и defineEmits, наблюдателями и встроенными компонентами. CX Codex +1 36 900установок clerk-vue-patterns clerk Скилл clerk-vue-patterns для Claude Code подсказывает, как связать Clerk с Vue 3. Он включается при работе с композаблами, защитой маршрутов и авторизацией через Pinia. CX Codex +1 14 700установок unit-test-vue-pinia официальный github Скилл unit-test-vue-pinia для GitHub Copilot — помогает писать и проверять юнит-тесты для Vue 3, TypeScript, Vitest и Pinia. Держит тесты на публичных входах, не проваливаясь во внутренности компонентов. CX Codex +1 1 800установок ionic-vue capawesome-team Скилл ionic-vue для Claude Code настраивает разработку мобильных приложений на Ionic и Vue 3. Включается при разборе маршрутизации, хуков жизненного цикла и компонентов интерфейса. CX Codex +1 1 200установок nuxtjs-vue-typescript Mindrally Скилл nuxtjs-vue-typescript для Claude Code задаёт правила разработки приложений на Nuxt 3 и Vue 3 с TypeScript и Tailwind CSS: архитектуру компонентов, типизацию и шаблоны выборки данных. CX Codex +1 880установок

Из того же набора32

Весь набор →
vueuse-shared-skilld Скилл vueuse-shared-skilld добавляет в Claude Code, Cursor и другие редакторы знание API @vueuse/shared v15.0.0 — фреймворк-агностичных реактивных утилит для Vue. CX Codex +1 137установок tanstack-vue-virtual-skilld Скилл tanstack-vue-virtual-skilld помогает писать, проверять и отлаживать виртуализированные списки и сетки во Vue с @tanstack/vue-virtual. Пригодится и для лент чата с прокруткой к концу. CX Codex +1 129установок tanstack-vue-form-skilld Скилл tanstack-vue-form-skilld помогает писать, проверять и отлаживать формы Vue на @tanstack/vue-form с актуальным API TanStack Form. CX Codex +1 125установок vueuse-math-skilld Скилл vueuse-math-skilld для работы с композаблами @vueuse/math в Vue 3: клампинг, проекция, округление, агрегация реактивных чисел. CX Codex +1 119установок vue-data-ui-skilld Скилл vue-data-ui-skilld помогает агенту работать с библиотекой графиков vue-data-ui для Vue 3: выбирать компоненты, настраивать темы и разбирать ошибки. CX Codex +1 118установок unovis-vue-skilld Скилл unovis-vue-skilld для Claude Code помогает писать и отлаживать код на Vue 3 с компонентами @unovis/vue. Используется для построения графиков и обновления интеграции с Unovis 1.7.0. CX Codex +1 112установок vitepress-skilld Скилл vitepress-skilld даёт агенту справочник по API, настройкам и CLI VitePress 1.6.4 при сборке сайтов документации. CX Codex +1 110установок tanstack-ai-vue-skilld Скилл tanstack-ai-vue-skilld помогает писать и отлаживать Vue 3-код с @tanstack/ai-vue: чат, генерация медиа и типизированные инструменты. CX Codex +1 110установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой