Руководство по миграции

Шаги и замечания при переходе на lh-ui-plus с других библиотек компонентов.

Миграция с Element Plus

Основные различия

Свойство	Element Plus	lh-ui-plus
Префикс	el-	lh-
Тема	SCSS-переменные	CSS-переменные (88+ токенов)
Тёмная тема	встроена (переключение классом html.dark)	полная поддержка (data-theme + useLhTheme)
Узорные фоны	нет	6 предустановок

Соответствие компонентов

Element Plus	lh-ui-plus
ElButton	LhButton
ElInput	LhInput
ElForm	LhForm
ElSelect	LhSelect
ElDialog	LhDialog

Шаги миграции

1. Замените пути импорта
2. Замените префиксы тегов компонентов
3. Проверьте настройку themeVars
4. Выполните pnpm lint и pnpm typecheck

Миграция с Ant Design Vue

Ant Design использует префикс ant-, lh-ui-plus — префикс lh-.

Ant Design Vue	lh-ui-plus
a-button	LhButton
a-input	LhInput
a-form	LhForm

Общие рекомендации по миграции

1. Сначала запустите тесты — убедитесь, что проект собирается до миграции
2. Заменять компоненты по одному — не стоит менять всё разом
3. Проверьте различия в темах — соответствие CSS-переменных и SCSS-переменных
4. Изучите документацию API — убедитесь в совместимости props / events