Системные требования

Naive UI является современным UI-фреймворком для JavaScript и TypeScript, построенным поверх Vue 3. Для корректной работы и полной интеграции компонентов необходимо соблюдение определённых системных требований и условий совместимости.

Минимальные версии и совместимость

  • Node.js: минимальная поддерживаемая версия — 14.x. Рекомендуется использовать LTS-версии (16.x и выше) для стабильной работы сборщиков и плагинов.
  • npm / yarn / pnpm: рекомендуется использовать последнюю стабильную версию менеджера пакетов. Любые устаревшие версии могут вызвать конфликты при установке зависимостей.
  • Vue.js: обязательное требование — Vue 3.2+. Naive UI полностью использует Composition API и реактивную систему Vue 3, что делает несовместимым использование Vue 2.
  • Браузеры: поддерживаются современные браузеры с движком Chromium, Firefox и Safari. На Internet Explorer компоненты работать не будут, так как используется современный синтаксис ES6+ и CSS Variables.

Интеграция с TypeScript

Naive UI разработан с полной поддержкой TypeScript. Рекомендуемые версии:

  • TypeScript 4.5+.
  • Настройка проекта должна включать опцию "strict": true для обеспечения типобезопасности при работе с компонентами и пропсами.

Пример конфигурации tsconfig.json:

{
  "compilerOptions": {
    "target": "ESNext",
    "module": "ESNext",
    "moduleResolution": "Node",
    "strict": true,
    "jsx": "preserve",
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true
  }
}

Поддержка сборщиков и инструментов

Naive UI совместим с большинством современных инструментов сборки:

  • Vite: основной рекомендуемый сборщик для проектов на Vue 3. Обеспечивает оптимальную работу с модульной системой ES, горячую перезагрузку и tree-shaking.
  • Webpack 5: поддерживается, однако может потребоваться настройка для корректного tree-shaking и совместимости с CSS Variables.
  • Rollup: используется в библиотеках и плагинах для экспорта компонентов, особенно если создаются сторонние модули на базе Naive UI.

Зависимости и стили

Для корректного отображения компонентов Naive UI требуется:

  • CSS Variables для темы и цвета. Проект должен поддерживать CSS Custom Properties, иначе стили будут некорректными.
  • Опционально — Icon Libraries, например, для использования иконок внутри кнопок или таблиц. Naive UI предоставляет встроенный набор иконок, однако для расширенных проектов может потребоваться подключение внешних библиотек.

Аппаратные и производительные требования

Хотя Naive UI оптимизирован для работы в браузере, для проектов с большим количеством динамических компонентов и таблиц рекомендуется:

  • Процессор: современный двухъядерный процессор или выше.
  • ОЗУ: минимум 4 ГБ для комфортной разработки и отладки в локальном окружении.
  • GPU: не обязателен, но ускоряет рендеринг сложных анимаций и компонентов с плавными переходами.

Совместимость с мобильными устройствами

Naive UI поддерживает адаптивный дизайн и touch-события. Для корректного отображения на мобильных устройствах:

  • Использовать современные мобильные браузеры: Chrome Mobile, Safari Mobile, Firefox Mobile.
  • Включить viewport meta-тег в проекте для правильного масштабирования:
<meta name="viewport" content="width=device-width, initial-scale=1.0">

Соблюдение этих системных требований обеспечивает стабильную работу компонентов Naive UI, корректное отображение стилей и оптимальное взаимодействие с Vue 3 и современными сборщиками.

Оглавление