Zum Inhalt springen
VelinStyle v1.3.0
⌂ Home
  1. Docs
  2. Hilfe
  3. Komponenten fehlen

Docs for VelinStyle 1.3.x · verified against 1.3.0

Komponenten fehlen 1.3.0

Bestätige, dass das Komponenten-Bundle geladen ist und die Component-APIs zu 1.3.0 passen. English

Problem

Custom Elements bleiben tot, APIs wirken unbekannt, oder Framework-Props erreichen das Element nicht.

Erste Prüfung

Führe zuerst die allgemeine Diagnose im Projektverzeichnis aus.

npx @birdapi/velinstyle doctor

Tiefer prüfen

npx @birdapi/velinstyle wc api velin-toast
npx @birdapi/velinstyle doctor

Schnellcheck

  • Im richtigen Projektverzeichnis ausführen.
  • Nur dokumentierte Profile und Flags verwenden.
  • Nach jeder Änderung erneut prüfen.

Component-Bundle ist nicht aktualisiert

Ursache: CSS und JS stammen aus unterschiedlichen Releases, oder das IIFE/Min-Bundle wird nie geladen.

  1. Lösung 1: Lade dist/velinstyle-components.min.js (oder .iife.js) aus demselben 1.3.0-Release wie das CSS.
  2. Lösung 2: Stelle sicher, dass das Script nach dem Markup der Elemente läuft.
  3. Lösung 3: Prüfe mit doctor, dass Installation und Assets übereinstimmen.
Erneut prüfen
npx @birdapi/velinstyle doctor
npx @birdapi/velinstyle check ./index.html --profile docs

Framework-Props passen nicht zur Element-API

Ursache: Der Framework-Wrapper mappt Props, die das Custom Element nicht exponiert.

  1. Lösung 1: Prüfe die Live-API mit npx @birdapi/velinstyle wc api velin-toast (Tag anpassen).
  2. Lösung 2: Mappe nur dokumentierte Attribute/Properties aus dieser API.
  3. Lösung 3: Halte eine minimale HTML-Reproduktion, bevor du die Framework-Schicht änderst.
Erneut prüfen
npx @birdapi/velinstyle doctor
npx @birdapi/velinstyle check ./index.html --profile docs

Immer noch defekt?

Kopiere diese Vorlage in einen Support-Fall und ergänze die Ausgaben.

BirdAPI Forum · VelinStyle-Support