Toimii ist im Soft Launch gestartet — der Dienst ist live und die Registrierung ist offen. Kostenlos testen →

Toimii ist im Soft Launch gestartet — diese Anleitungen beschreiben also einen Dienst, für den Sie sich schon heute registrieren und den Sie sofort nutzen können. Ein paar Teile sind noch unterwegs: Die Apps für iOS und Android erscheinen im Laufe des Jahres 2026.

Kontaktformular in React, Vue oder Angular einbetten

Web Components sind Teil des DOM. Fügen Sie den Tag direkt in JSX, Vue-Templates oder Angular-Komponenten ein — kein Wrapper erforderlich.

<!-- Fügen Sie dies an beliebiger Stelle auf Ihrer Seite ein -->
<script src="https://cdn.toimii.io/components/your-code.js" async></script>
<toimii-your-code></toimii-your-code>
Funktioniert das wirklich?

Ja — es ist ein ganz normales Custom Element: nichts zu installieren, kein Wrapper zu schreiben. React braucht überhaupt keine Konfiguration. Vue und Angular brauchen jeweils eine Zeile, die ihrem Compiler sagt, dass der Tag nicht zu ihnen gehört — beide stehen unten.

Schritt für Schritt

1
Skript laden
Fügen Sie das Script-Tag in die HTML-Basis ein, aus der Ihre App ausgeliefert wird — die index.html, von der Ihr Build ausgeht, oder das Root-Layout Ihres Frameworks.
2
Custom Element einfügen
Setzen Sie den Tag dorthin, wo das Formular erscheinen soll; JSX sowie Vue- und Angular-Templates übernehmen ihn unverändert. Kopieren Sie ihn von der Seite Ihrer Komponente in Toimii — er endet mit dem Code, der zu dieser Komponente gehört.
3
Bauen und veröffentlichen
Bauen und veröffentlichen Sie wie gewohnt und senden Sie sich dann eine Testnachricht von der veröffentlichten Seite statt vom Dev-Server — Einsendungen werden nur von der Domain akzeptiert, die Sie in Toimii hinterlegt haben.

Fallstricke

  • Vue verlangt, dass der Tag als Custom Element gekennzeichnet wird, sonst sucht es nach einer Vue-Komponente und gibt eine Warnung aus. isCustomElement erwartet eine Funktion — prüfen Sie auf das Präfix toimii-, da der Rest des Tags je nach Komponente variiert.
  • Angular benötigt CUSTOM_ELEMENTS_SCHEMA in einem schemas-Array — dem der Standalone-Komponente oder, in einer älteren Anwendung, dem ihres NgModule. Ohne das meldet der Compiler einen Fehler für den Tag, den er nicht kennt.

Häufig gefragt

Benötige ich eine React-/Vue-/Angular-Wrapper-Komponente?

Nein. Das Script definiert das Element im Browser, Ihr Framework rendert also nur den Tag — und an Ihrem Build ändert sich nichts, wenn wir eine neue Version veröffentlichen.

Wie teile ich TypeScript das Custom Element mit?

Deklarieren Sie es in den IntrinsicElements von JSX, mit dem Tag, den Ihre eigene Komponente verwendet. React 19 hat diesen Namespace verschoben, und die richtige Form hängt von der jsx-Einstellung Ihrer tsconfig ab — nehmen Sie die aktuelle deshalb aus dem Upgrade-Leitfaden von React. Das Formular funktioniert auch ohne diese Angabe.

Wie übergebe ich Props oder eine Konfiguration?

Es gibt nichts zu übergeben. Was das Formular abfragt und wohin es die Nachrichten liefert, wird in Toimii festgelegt und ist fest in das Bundle eingebaut, das das Script lädt — deshalb trägt der Tag keine Attribute.

Funktioniert das mit Next.js oder einem anderen React-Framework?

Ja. Laden Sie es in Next.js mit next/script aus dem Root-Layout — dem dokumentierten Ort für ein Script, das die gesamte Website benötigt. Eine „use client“-Grenze brauchen Sie nur, wenn Sie einen load- oder error-Handler anhängen; der Tag selbst benötigt keine.

Was ist mit serverseitigem Rendering?

Das Custom Element wird client-seitig gerendert, wie jede Web Component. SSR gibt den Tag aus, der Browser registriert das Element beim Laden des Skripts, danach erscheint das Formular. Es gibt einen kurzen Moment mit leerem Raum — der in der Regel kaum auffällt.

Einbetten auf einer anderen Plattform?

Dieselben zwei Codezeilen, für jede Plattform einzeln erklärt.

Bereit zum Ausprobieren?

30 Tage kostenlos testen. Keine Kreditkarte. In wenigen Minuten eingerichtet.

Keine Kreditkarte nötig. In 2 Minuten startklar.