Guía de migración

Pasos y consideraciones a tener en cuenta al migrar desde otra biblioteca de UI a lh-ui-plus.

Migrar desde Element Plus

Diferencias principales

Característica	Element Plus	lh-ui-plus
Prefijo	el-	lh-
Tema	Variables SCSS	Variables CSS (88+ tokens)
Modo oscuro	Integrado (conmutación mediante la clase html.dark)	Soporte completo (data-theme + useLhTheme)
Fondos con patrón	Sin	6 presets

Correspondencia de componentes

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

Pasos de la migración

1. Sustituir las rutas de importación
2. Sustituir el prefijo de las etiquetas de los componentes
3. Revisar la configuración de themeVars
4. Ejecutar pnpm lint y pnpm typecheck

Migrar desde Ant Design Vue

Ant Design usa el prefijo ant-, mientras que lh-ui-plus usa el prefijo lh-.

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

Recomendaciones generales de migración

1. Ejecuta primero las pruebas — asegúrate de que el proyecto se compila correctamente antes de la migración
2. Sustituye los componentes uno a uno — no lo hagas todo de una vez
3. Revisa las diferencias de tema — la correspondencia entre variables CSS y variables SCSS
4. Consulta la documentación de la API — confirma la compatibilidad de props y events