Philosophie de conception
lh-ui-plus adopte pour philosophie de design « la beauté de la tradition, la fondation du code » et intègre l'esthétique traditionnelle chinoise dans les pratiques modernes de l'ingénierie frontend.
Esthétique de style chinois
Palette de couleurs
| Couleur | Origine | Valeur | Usage |
|---|---|---|---|
| Indigo | Émail de la porcelaine bleue et blanche (青花瓷) | #2B4C7C | Couleur primaire (--lh-primary-color) |
| 松花绿 (vert pin) | Vert bambou | #5B8C5A | Couleur de succès (--lh-success-color) |
| 藤黄 (gamboge) | Or des feuilles d'automne | #C4A35A | Couleur d'avertissement (--lh-warning-color) |
| 朱砂 (cinabre) | Rouge de la pâte à tampon | #B23A3A | Couleur de danger (--lh-danger-color) |
| Dai (gris ardoise) | Teintes d'encre légère | #7A7A7A | Couleur d'information (--lh-info-color) |
| 水墨 (encre de Chine) | Les cinq nuances de l'encre | #2C2C2C | Couleur du texte (--lh-text-color-primary) |
| 宣纸 (blanc papier de riz) | Blanc du papier de riz antique | #FAF6F0 | Couleur de fond (--lh-bg-color) |
Pour la palette complète et ses niveaux, voir Personnalisation du thème.
Fonds à motifs
La bibliothèque intègre 6 fonds SVG à motifs traditionnels (appliqués via --lh-bg-pattern, dont la valeur est la variable CSS correspondante) :
- willow — motif feuille de saule (léger et élégant,
--lh-pattern-willow) - cloud — motif nuage auspicieux (heureux et gracieux,
--lh-pattern-cloud) - water — motif ondulations (fluide et naturel,
--lh-pattern-water) - snow — motif flocon de neige (hexagonal et cristallin,
--lh-pattern-snow) - plum — motif fleur de prunier (noble et raffiné,
--lh-pattern-plum) - bamboo — motif feuille de bambou (résilient et inflexible,
--lh-pattern-bamboo)
Architecture multi-framework
La logique cœur est extraite en fonctions pures, découplées du framework :
@lh-ui/share Couche logique pure + source des styles (sans dépendance framework, importée en dépendance npm)
packages/components/ Couche d'encapsulation des composants Vue 3
packages/composables/ Composables spécifiques à VueTypé avec TypeScript
Sécurité des types TypeScript de bout en bout :
- Définition fortement typée des Props et des Emit
- Signatures des rappels d'événement portant le type de leur charge utile
- Complétion intelligente dans l'IDE
- Couverture des types garantie par
pnpm typecheck(les types utilitaires dynamiques tels queLhSxPropsconservent des signatures d'index contrôlées)
Système de thème à variables CSS
Plus de 88 jetons de conception CSS, préfixés --lh-*. Prise en charge du changement de thème en temps réel, du mode sombre et de la configuration globale via ConfigProvider.
Internationalisation
Le système de configuration ConfigProvider intégré permet une gestion unifiée de plusieurs langues. Paquets linguistiques intégrés et complets : zh-CN, en-US ; ja-JP, ko-KR, de-DE et fr-FR sont enregistrés en tant qu'espaces réservés structurels (les parties non traduites basculent provisoirement sur l'anglais) et peuvent être complétés en suivant le guide Internationalisation.
Accessibilité
- Navigation au clavier
- Attributs ARIA
- Contraste des couleurs WCAG 2.1 AA
La beauté de la tradition, la fondation du code.