Element Plus: Eine Vue-3-UI-Bibliothek in TypeScript

Eine Vue-3-UI-Bibliothek in TypeScript

Element Plus ist eine UI-Komponentenbibliothek für Vue.js 3. Die README beschreibt es als "A Vue.js 3 UI library" und listet zwei technische Schwerpunkte auf: Es verwendet die Vue-3-Composition-API und ist in TypeScript geschrieben. Die Repository-Metadaten bestätigen, dass die Hauptsprache TypeScript ist, und die Projektbeschreibung besagt, dass es vom Element-Team erstellt wurde. Die Bibliothek wird unter der MIT-Lizenz vertrieben. Die README enthält keine Installations- oder Verwendungsbefehle; sie verweist Entwickler auf die offizielle Website für den Einstieg. Das Repository selbst dokumentiert also nicht, wie die Komponenten zu einem Projekt hinzugefügt werden. Oben in der README befindet sich eine Reihe von Abzeichen, darunter ein Paketversionsabzeichen, ein Node.js-Versionsabzeichen, ein Download-Zählerabzeichen und ein Code-Coverage-Abzeichen, aber der Text gibt die Werte dieser Abzeichen nicht an. Das Node.js-Abzeichen zeigt eine Anforderung von mindestens Version 20 an, aber die README erklärt nicht, worauf sich diese Anforderung bezieht.

Repository-Aktivität und der Entwicklungszweig

Laut den Repository-Metadaten hat das Projekt 27.656 Sterne, 19.842 Forks und 1.197 offene Issues (Stand der verwendeten Daten). Der Standardzweig heißt dev, was darauf hindeutet, dass die aktive Entwicklung dort stattfindet, aber die README erklärt weder den Release-Workflow noch das Verhältnis des dev-Zweigs zu veröffentlichten Versionen. Die README enthält ein Abzeichen für die npm-Paketversion, für Downloadzahlen und für Code Coverage auf Codecov, nennt aber keine spezifische Versionsnummer, Downloadzahlen oder Coverage-Prozentsätze. Die Abzeichenlinks sind vorhanden, aber der Text liefert keine Zahlen. Die Anzahl der offenen Issues stammt aus den Metadaten, aber die README unterteilt diese Zahl nicht in Fehler, Funktionsanfragen oder andere Kategorien. Das Projekt ist nicht archiviert, und die Homepage ist auf element-plus.org gesetzt.

Dokumentation, Spiegel-Site und Playground

Für Entwickler, die Element Plus verwenden möchten, verweist die README auf die Getting-Started-Seite auf der offiziellen Website unter element-plus.org. Es gibt auch eine Spiegel-Site für das chinesische Festland unter cn.element-plus.org, die als schnellerer Zugang für Benutzer in dieser Region gekennzeichnet ist. Das Repository bietet zwei Online-Playgrounds: einen integrierten unter element-plus.run und eine CodeSandbox-Option, obwohl die README keinen direkten Link zur CodeSandbox-Vorlage bereitstellt. Die README listet keine npm-Installationsbefehle oder Importanweisungen auf; diese befinden sich auf der Website. Das bedeutet, dass ein Entwickler, der nur das Repository liest, das Einrichtungsverfahren nicht bestimmen kann, ohne die externe Dokumentation zu besuchen. Die Getting-Started-Seite ist die einzige Setup-Anweisung in der README und wird als Link statt als Inline-Inhalt präsentiert.

Migration von Element UI mit Tool und Änderungsliste

Die README weist darauf hin, dass die erste stabile Version von Element Plus, die für die Produktion geeignet ist, am 7. Februar 2022 veröffentlicht wurde und die API nun stabil ist. Eine vollständige Liste der Breaking Changes für die Migration von Element UI zu Element Plus ist von einer GitHub-Diskussion verlinkt. Das Team hat außerdem ein Migrationstool auf Basis von gogocode erstellt und es mit Vue Element Admin getestet; der transpilierte Code aus diesem Test ist in einem separaten Repository verfügbar. Die README spezifiziert nicht, welche Transformationen das Tool genau durchführt, und garantiert auch nicht, dass die Migration vollständig ist. Für Experimente während der Migration wird ebenfalls ein Playground-Link bereitgestellt. Die Breaking-Change-Liste wird in einer GitHub-Diskussion gehostet, was darauf hindeutet, dass sie ein lebendiges Dokument sein könnte, das mit der Weiterentwicklung der Bibliothek aktualisiert wird. Das Migrationstool wird als Plugin für gogocode verteilt, aber die README enthält keine Anweisungen zur Installation oder Ausführung.

Übersetzungsstatus und Mitarbeit bei Crowdin

Element Plus wurde in mehrere Sprachen übersetzt, aber die README sagt, dass aufgrund begrenzter Ressourcen derzeit nur englische und chinesische Versionen angeboten werden. Das Projekt verwendet Crowdin zur Verwaltung von Übersetzungen, und Freiwillige können über die Crowdin-Projektseite Aktualisierungen beitragen oder sich als Korrekturleser bewerben. Ein spezieller Übersetzungsleitfaden ist auf der Website unter dem Pfad /en-US/guide/translation.html verfügbar. Die README listet weder geplante Sprachen noch einen Zeitplan für zusätzliche Übersetzungen auf; sie lädt interessierte Übersetzer lediglich ein, eine Nachricht auf der Crowdin-Seite zu hinterlassen. Die Übersetzungsarbeit wird als offene Community-Aufgabe positioniert, und die README bittet ausdrücklich um Hilfe bei der Übersetzung von Element Plus in weitere Sprachen. Der Link zum Crowdin-Projekt ist vorhanden, aber die README gibt keine Details zum Übersetzungsablauf oder zum Einstieg.

Community-Kanäle und angeforderte Expertise

Die README ermutigt Benutzer, dem Discord-Server für Kommunikation beizutreten. Für alle, die etwas beitragen möchten, verweist sie auf den CONTRIBUTING-Leitfaden und den Code of Conduct, die beide vom Repository verlinkt sind. Das Projekt sucht ausdrücklich Experten für Tests, GitHub Actions und Projektmanagement, um dem Entwicklungsteam beizutreten, und die README lädt interessierte Entwickler ein, Kontakt aufzunehmen. Der Beitragendenbereich dankt allen Unterstützern und verwendet ein Leaderboard-Bild von openomy.app und ein Beitragenden-Diagramm von contrib.rocks. Die README listet auch Platin- und Gold-Sponsoren mit Links zu ihren Websites auf, erklärt aber nicht, was Sponsoring beinhaltet oder wie es verwendet wird. Die README beschreibt kein formales Governance-Modell oder Entscheidungsprozess über diese Community-Kanäle hinaus. Das Entwicklungsteam scheint offen für neue Mitglieder zu sein, aber die README spezifiziert keinen Auswahlprozess oder erforderliche Qualifikationen über die genannten Fachbereiche hinaus.

MIT-Lizenz und was sie nicht garantiert

Die Lizenz für Element Plus ist MIT, wie sowohl in der README als auch in den Repository-Metadaten angegeben. Die MIT-Lizenz gewährt die Erlaubnis, Kopien der Software zu verwenden, zu kopieren, zu modifizieren, zu fusionieren, zu veröffentlichen, zu verteilen, zu unterlizenzieren und zu verkaufen, vorausgesetzt, dass der obige Copyright-Hinweis und der Genehmigungshinweis in allen Kopien oder wesentlichen Teilen enthalten sind. Die Software wird "wie besehen" bereitgestellt, ohne jegliche Gewährleistung, einschließlich der Gewährleistung der Marktgängigkeit, der Eignung für einen bestimmten Zweck und der Nichtverletzung von Rechten. Die Lizenz besagt außerdem, dass die Autoren oder Urheberrechtsinhaber nicht für Ansprüche, Schäden oder andere Haftungen haftbar sind, die aus der Software entstehen. Die README diskutiert keine Sicherheitsgarantien, Support-Verpflichtungen oder Wartungsrichtlinien; diese sind im Quellmaterial nicht festgelegt. Der Lizenzauszug ist der Standard-MIT-Text und schließt ausdrücklich Gewährleistung und Haftung aus, was bedeutet, dass Benutzer der Bibliothek keine impliziten Garantien über ihr Verhalten oder ihre Eignung für einen bestimmten Zweck erhalten, die über das hinausgehen, was im Code selbst geschrieben steht.

Redaktionelles Fazit

Das Repository stellt Quellcode und Dokumentationslinks für Element Plus bereit, aber Setup-Anleitungen und Governance-Details befinden sich auf externen Ressourcen.

Offizielle Quellen

1. Official documentation
2. Official README
3. Project repository
4. Release notes