Qwik

Das Resumability-Modell von Qwik bedeutet, dass JavaScript nur bei Benutzerinteraktion verzögert ausgeführt wird. Verwenden Sie useVisibleTask$, um Code auszuführen, der im Browser laufen muss, wenn die Komponente sichtbar wird.

@wink/elements npm package Installieren Sie das Paket und laden Sie das CDN-Bundle mit TypeScript-Typen.

Installation

npm install @wink/elements

Laden mit useVisibleTask$

useVisibleTask$ ist der Lifecycle-Hook von Qwik für browser-exklusiven, sofort ausgeführten Code. Platzieren Sie ihn in Ihrem Root-Layout:

import { component$, useVisibleTask$ } from '@builder.io/qwik';
import { load } from '@wink/elements';

export default component$(() => {
  useVisibleTask$(() => {
    load({ clientId: import.meta.env.PUBLIC_WINK_CLIENT_ID });
  });

  return (
    <main>
      <Slot />
    </main>
  );
});

Standardmäßig wird useVisibleTask$ ausgeführt, wenn die Komponente im Viewport sichtbar ist. Bei einem Root-Layout, das immer sichtbar ist, wird dies sofort beim Laden der Seite ausgelöst – vergleichbar mit onMount in anderen Frameworks.

Übergeben Sie { strategy: 'document-ready' }, wenn das Skript so früh wie möglich geladen werden soll:

useVisibleTask$({ strategy: 'document-ready' }, () => {
  load({ clientId: import.meta.env.PUBLIC_WINK_CLIENT_ID });
});

Verwendung auf einer Seite

import { component$ } from '@builder.io/qwik';

export default component$(() => {
  return (
    <main>
      <wink-content-loader layout="HOTEL" id="YOUR_LAYOUT_ID" />
      <wink-lookup />
    </main>
  );
});

TypeScript — JSX-Intrinsics deklarieren

Qwik verwendet seinen eigenen JSX-Namespace. Erweitern Sie ihn in einer Deklarationsdatei:

import type {
  WinkContentLoaderAttributes,
  WinkLookupAttributes,
  WinkSearchButtonAttributes,
  WinkAccountButtonAttributes,
  WinkItineraryButtonAttributes,
  WinkShoppingCartButtonAttributes,
  WinkAppLoaderAttributes,
} from '@wink/elements';

declare module '@builder.io/qwik' {
  namespace JSX {
    interface IntrinsicElements {
      'wink-content-loader': WinkContentLoaderAttributes;
      'wink-lookup': WinkLookupAttributes;
      'wink-search-button': WinkSearchButtonAttributes;
      'wink-account-button': WinkAccountButtonAttributes;
      'wink-itinerary-button': WinkItineraryButtonAttributes;
      'wink-shopping-cart-button': WinkShoppingCartButtonAttributes;
      'wink-app-loader': WinkAppLoaderAttributes;
    }
  }
}

Umgebungsvariablen

Qwik (Vite-basiert) stellt Variablen mit dem Präfix PUBLIC_ im Browser zur Verfügung:

PUBLIC_WINK_CLIENT_ID=your-client-id