Guide de migration

Étapes et points d'attention pour migrer depuis une autre bibliothèque d'interface vers lh-ui-plus.

Migration depuis Element Plus

Différences principales

Fonctionnalité	Element Plus	lh-ui-plus
Préfixe	el-	lh-
Thème	Variables SCSS	Variables CSS (88+ jetons)
Mode sombre	Intégré (bascule de la classe html.dark)	Pris en charge complètement (data-theme + useLhTheme)
Fonds à motifs	Aucun	6 préréglages

Mappage des composants

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

Étapes de migration

1. Remplacer les chemins d'import
2. Remplacer le préfixe des balises de composant
3. Vérifier la configuration themeVars
4. Exécuter pnpm lint et pnpm typecheck

Migration depuis Ant Design Vue

Ant Design utilise le préfixe ant-, lh-ui-plus le préfixe lh-.

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

Conseils généraux de migration

1. D'abord exécuter les tests — assurez-vous que le projet se construit normalement avant la migration
2. Remplacer les composants un par un — ne remplacez pas tout d'un coup
3. Vérifier les différences de thème — correspondance entre variables CSS et variables SCSS
4. Consulter la documentation de l'API — confirmez la compatibilité des props et des événements