openpencil/packages/docs/ru/programmable/sdk/api/composables/use-selection-capabilities.md

62 lines
1.7 KiB
Markdown
Raw Normal View History

---
title: useSelectionCapabilities
description: Реактивные булевы значения для UI и действий, зависящих от выделения.
---
# useSelectionCapabilities
`useSelectionCapabilities()` предоставляет реактивные булевы значения, указывающие, разрешены ли сейчас распространённые действия редактора.
Используйте при создании:
- меню
- тулбаров
- горячих клавиш
- кнопок действий
- контекстных панелей
## Использование
```ts
import { useSelectionCapabilities } from '@open-pencil/vue'
const caps = useSelectionCapabilities()
```
## Базовый пример
```vue
<script setup lang="ts">
import { useSelectionCapabilities } from '@open-pencil/vue'
const { canDelete, canDuplicate, canCreateComponent } = useSelectionCapabilities()
</script>
<template>
<div class="flex gap-2">
<button :disabled="!canDuplicate">Дублировать</button>
<button :disabled="!canDelete">Удалить</button>
<button :disabled="!canCreateComponent">Создать компонент</button>
</div>
</template>
```
## Практические примеры
### Управление доступностью пунктов меню
```ts
const { canMoveToPage, canGoToMainComponent } = useSelectionCapabilities()
```
### Включать команды зума только когда это имеет смысл
```ts
const { canZoomToSelection } = useSelectionCapabilities()
```
## Связанные API
- [useSelectionState](./use-selection-state)
- [useEditorCommands](./use-editor-commands)