Skip to content

CApp

CApp — корневой компонент-оболочка Vueland UI. Он должен оборачивать всё приложение. Компонент настраивает API управления прокруткой для оверлеев (диалоги, меню, тултипы) и добавляет семантический landmark role="application" для доступности.

Базовое использование

vue
<template>
  <CApp>
    <CMain>
      <!-- содержимое страницы -->
    </CMain>
  </CApp>
</template>

Управление прокруткой

CApp предоставляет ApplicationApi через provide/inject. Внутренне он используется CDialog, CMenu и COverlay для блокировки и восстановления прокрутки страницы при открытии оверлеев. Вы также можете получить доступ напрямую через композабл useApplication.

ts
import { useApplication } from '@vueland/ui/composables'

const app = useApplication()

app?.blockScroll()    // заблокировать прокрутку
app?.unblockScroll()  // восстановить прокрутку
app?.getScrollTop()   // текущая позиция прокрутки Y
app?.getScrollLeft()  // текущая позиция прокрутки X

API

Пропсы

У CApp нет пропсов.

Слоты

СлотОписание
defaultСодержимое приложения

События

CApp не эмитит событий.

Expose

CApp ничего не экспозит напрямую. Для доступа к API прокрутки используйте inject($APP_API_KEY).

CSS-классы

КлассОписание
c-appКорневой элемент
c-app__wrapperВнутренняя обёртка для контента

Доступность

Корневой элемент имеет role="application", что помечает область как интерактивное веб-приложение для программ чтения с экрана.