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

renderless-components — скилл для Claude Code и Cursor

Скилл renderless-components учит паттерну renderless-компонентов во Vue: логика отдельно, разметка — на вызывающий код через scoped slots.

MIT 194 установок ★ 259 обновлён 2026-04-15

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

Что делает renderless-components

Скилл даёт агенту паттерн, который разделяет логику и вёрстку в Vue-компонентах. Renderless-компонент инкапсулирует поведение (например, переключение состояния checked), а родитель через scoped slot решает, как это выглядит — кнопка, чекбокс или свитч. Внутри примеры реализации toggle-компонента с методом toggle() и состоянием checked, переиспользуемого в трёх разных интерфейсах.

Скилл покрывает .vue-файлы и объясняет, когда композаблы лучше renderless-компонентов (Vue 3): композабл не добавляет лишний слой в шаблоне. Renderless-компоненты полезны, если нужен компонентный API или композиция на уровне шаблона, например в UI-библиотеке.

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

  • переиспользовать логику компонента в разных UI-представлениях
  • вынести состояние и методы в компонент без жёсткой разметки
  • предоставить компонентный API для библиотеки
  • применить один и тот же toggle к кнопке, чекбоксу и свитчу

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

  • Сделай renderless-компонент Toggle с методом toggle и состоянием checked, передай их через scoped slot
  • Оберни эту форму в renderless-компонент, чтобы логика валидации жила отдельно от разметки
  • Преврати этот компонент в renderless: вынеси логику, разметку оставь вызывающему коду

Как установить renderless-components

1Через Skills CLI (Vercel)

npx skills add PatternsDev/skills --skill renderless-components -a claude-code

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

~/.claude/skills/renderless-components/SKILL.md

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

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

Вопросы о renderless-components

Как установить renderless-components в Claude Code?

Выполни npx skills add PatternsDev/skills --skill renderless-components -a claude-code, скилл появится в ~/.claude/skills/renderless-components/SKILL.md.

Что делает renderless-components?

Учит паттерну Vue-компонентов, которые отдают логику и состояние через scoped slots, а разметку оставляют родителю. Пример — компонент toggle с методом переключения, который можно отрендерить кнопкой, чекбоксом или свитчем.

Когда лучше композабл вместо renderless-компонента?

Во Vue 3 композаблы не добавляют лишний компонентный слой и яснее возвращают данные. Renderless-компонент нужен, если хочешь компонентный API или композицию на уровне шаблона, например в UI-библиотеке.

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

SKILL.md · MIT
---
name: renderless-components
description: Teaches the renderless component pattern for logic-only Vue components. Use when you want to encapsulate behavior without dictating markup, letting consumers control rendering via scoped slots.
paths:
  - "**/*.vue"
license: MIT
metadata:
  author: patterns.dev
  version: "1.1"
related_skills:
  - "composables"
  - "components"
---

# Renderless Components

## Table of Contents

- [When to Use](#when-to-use)
- [When NOT to Use](#when-not-to-use)
- [Instructions](#instructions)
- [Details](#details)
- [Source](#source)

Renderless components are a pattern in Vue that **separates the logic of a component from its presentation**. The pattern provides a way to encapsulate functionality without _dictating the visual representation of the component_. In other words, a renderless component focuses solely on the logic and behavior, while leaving the rendering to the parent component.

Renderless components are particularly useful when we need to create reusable logic that can be applied to different UI implementations. By abstracting the logic into a renderless component, we can easily reuse it in various contexts without duplicating code.

## When to Use

- Use this when you need to reuse logic across components with completely different visual representations
- This is helpful for providing a component-based API in a component library

## When NOT to Use

- When composables achieve the same logic reuse without extra component nesting (Vue 3+)
- When the renderless component wraps trivial logic that a simple function or composable handles more clearly
- When the scoped slot API becomes harder to understand than a direct composable return value

## Instructions

- Create a component that provides data and methods through a single `<slot>` with scoped slot props
- Use `v-slot` destructuring in parent components to access the provided data and methods
- Prefer composables over renderless components in Vue 3 to avoid extra component nesting
- Use renderless components when you want template-level composition or a component-based API

## Details

### Toggle, toggle, toggle

Imagine you have a toggle UI element that needs to be used in different parts of your application, but each instance may have a different visual representation. Some toggles might be displayed as buttons, while others might be checkboxes or switches.

We could just create three different toggle components, however, we can observe that each toggle element has the same logic and behavior. Each toggle has an inactive and active state that's being tracked with a component data property (e.g. `checked`). When a toggle is clicked, its component state is switched from inactive to active and vice versa (i.e. `checked = !checked`).

Right away, we can see that we can create a more reusable pattern by extracting the common logic and behavior in such a way that we don't have to repeatedly define the state and toggle methods in each individual toggle component. This is a great case to use [composables](/vue/composables) since composables will allow us to encapsulate and share the common stateful logic across the different toggle components.

**useCheckboxToggle**:

```js
import { ref } from "vue";

export function useCheckboxToggle() {
  const checkbox = ref(false);

  const toggleCheckbox = () => {
    checkbox.value = !checkbox.value;
  };

  return {
    checkbox,
    toggleCheckbox,
  };
}
```

With this composable, we can now use the `useCheckboxToggle()` function in our various toggle components to share the common state and toggle logic.

However, there's another approach we can take that leverages Vue's slot mechanism — the **renderless component** pattern.

### The Renderless Component

A renderless component in Vue is a component that encapsulates logic and provides data to its children via **scoped slots**, without rendering any markup of its own. The parent component decides how the data is presented.

Here's a simple renderless `Toggle` component:

```html
<script setup>
  import { ref } from "vue";

  const checked = ref(false);

  const toggle = () => {
    checked.value = !checked.value;
  };
</script>

<template>
  <slot :checked="checked" :toggle="toggle"></slot>
</template>
```

The `Toggle` component doesn't render any HTML of its own. It only provides data (`checked` and `toggle`) through a scoped slot. The parent component can now consume this data and render whatever UI it wants.

**Using the renderless Toggle as a button:**

```html
<template>
  <Toggle v-slot="{ checked, toggle }">
    <button @click="toggle">
      {{ checked ? "ON" : "OFF" }}
    </button>
  </Toggle>
</template>
```

**Using the renderless Toggle as a checkbox:**

```html
<template>
  <Toggle v-slot="{ checked, toggle }">
    <label>
      <input type="checkbox" :checked="checked" @change="toggle" />
      {{ checked ? "Checked" : "Unchecked" }}
    </label>
  </Toggle>
</template>
```

**Using the renderless Toggle as a switch:**

```html
<template>
  <Toggle v-slot="{ checked, toggle }">
    <div
      class="switch"
      :class="{ active: checked }"
      @click="toggle"
    >
      <div class="switch-handle"></div>
    </div>
  </Toggle>
</template>
```

In all three cases, the same `Toggle` renderless component provides the toggle logic, but the rendering is entirely different!

### Composables vs. Renderless Components

Both composables and renderless components achieve the goal of reusing logic across components. However, there are some differences:

**Composables:**
- Logic is encapsulated in a regular JavaScript function.
- Can be used directly in `<script setup>` or `setup()`.
- Don't involve any additional component layers.

**Renderless components:**
- Logic is encapsulated in a Vue component.
- Use scoped slots to pass data to children.
- Add an extra component layer in the template.

In general, composables are the preferred approach in Vue 3 since they don't add extra component nesting. However, renderless components can be useful when you want to provide a component-based API (e.g., in a component library) or when you need template-level composition.

## Source

- [patterns.dev/vue/renderless-components](https://patterns.dev/vue/renderless-components)

### References

- [Renderless Components | Vue Documentation](https://vuejs.org/guide/components/slots.html#renderless-components)
- [Composables | Vue Documentation](https://vuejs.org/guide/reusability/composables.html)

© patterns.dev · MIT · PatternsDev/skills

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

Все скиллы по теме «Фронтенд и UI» →
vuetify0 vuetifyjs Скилл vuetify0 подсказывает агенту, какие компоненты и composables из @vuetify/v0 взять вместо самописной логики — от кнопки до виртуального списка. CX Codex +1 742установок vueuse-components-skilld skilld-dev Скилл vueuse-components-skilld помогает писать и отлаживать Vue 3-шаблоны с компонентами и директивами @vueuse/components. Пригодится и при переходе от composable к компонентной или директивной форме. CX Codex +1 168установок vueuse-functions SerKo Скилл vueuse-functions подбирает функции VueUse для задач во Vue.js и Nuxt и помогает применять их вместо собственного кода. Подходит для Vue 3+ и Nuxt 3+. CX Codex +1 4 100установок nuxt-data Claude Skills Maintainers Скилл nuxt-data для работы с данными в Nuxt 4: композаблы, useFetch и useAsyncData, состояние через useState и Pinia. CX Codex +1 408установок vueuse-core-skilld skilld-dev Скилл vueuse-core-skilld с полным API @vueuse/core 15.0.0: новые composables, правила миграции с v14, устаревшие функции и требования окружения. CX Codex +1 219установок ui-design-patterns manutej Скилл ui-design-patterns для Claude Code — справочник по паттернам навигации, форм, вывода данных, обратной связи и доступности. Помогает выбрать паттерн или проверить существующий интерфейс. CX Codex +1 854установок

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

Весь набор →
async-components Скилл async-components учит агента загружать Vue-компоненты асинхронно через defineAsyncComponent(), чтобы не тянуть тяжёлые модалки и диалоги при старте. CX Codex +1 207установок container-presentational Скилл container-presentational учит разделять Vue-компоненты на контейнеры (логика, запросы) и презентационные (вёрстка). Презентационный компонент получает данные через props и не трогает состояние. CX Codex +1 205установок data-provider Объясняет паттерн data provider во Vue: логика загрузки и состояния передаётся дочерним компонентам через scoped slots. CX Codex +1 204установок state-management Скилл state-management направляет агента при проектировании реактивного состояния во Vue 3. Помогает выбрать между props, простым хранилищем на reactive() и Pinia. CX Codex +1 201установок dynamic-components Скилл dynamic-components для Claude Code переключает компоненты Vue через <component :is> и сохраняет их состояние с <KeepAlive>. Переключает вкладки и панели без роутера. CX Codex +1 198установок provide-inject Скилл provide-inject учит агента использовать provide() и inject() из Vue для передачи данных глубоко вложенным компонентам без прокидывания пропсов через каждый уровень. CX Codex +1 196установок render-functions Скилл render-functions учит ИИ-агента писать рендер-функции через h() и синтаксис JSX во Vue. Пригодится при сборке UI-библиотек и динамической разметки, где возможностей шаблонов не хватает. CX Codex +1 196установок script-setup Учит агента писать Vue 3-компоненты с <script setup> — без лишнего кода и явного return. CX Codex +1 195установок

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

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