Zum Inhalt springen
4 Min. Lesezeit

Wie bringt ihr eigene React-Komponenten ins Staffbase-Intranet?

Native Widget-Bundles im Widget Builder: eigenen Frontend-Build als ZIP oder JS/CSS hochladen, versionieren und in Staffbase einbinden.

Wie bringt ihr eigene React-Komponenten ins Staffbase-Intranet?

Euer Team hat eine React-Komponente gebaut, die im Portal oder in der Fachanwendung längst läuft. Im Intranet war sie bisher nicht einsetzbar. Seit dem Widget-Builder-Release 3.8.0 vom 1. Juni 2026 ladet ihr den fertigen Build als natives Bundle hoch und platziert ihn in Staffbase wie jedes andere Widget.

Warum lässt sich vorhandener Frontend-Code nicht einfach ins Intranet kopieren?

Der Widget Builder erzeugte Widgets bisher aus Handlebars-Vorlagen, also aus Textbausteinen mit Platzhaltern, die beim Anzeigen mit Konfigurationswerten gefüllt werden. Für Zähler, Listen und Feeds reicht das. Eine React-Anwendung mit eigenem Zustand, eigenen Komponenten und eigenem Build passt in dieses Format nicht. Sie müsste in einer anderen Technik nachgebaut und danach doppelt gepflegt werden.

Was ist ein natives Widget-Bundle?

Ein natives Bundle ist der fertige Frontend-Build eines Widgets, also der dist-Ordner aus dem Build-Werkzeug, plus eine manifest.json mit den Metadaten. Ihr ladet beides in den Widget Builder, und Staffbase bekommt das Ergebnis als Built-in-Widget geliefert. Anders als ein Handlebars-Widget bringt ein Bundle sein eigenes JavaScript mit, dazu optional CSS und weitere Dateien. Beim Anzeigen wird es entweder als React-Komponente eingehängt oder als Web Component, also als Baustein, den der Browser selbst verwaltet. Welche der beiden Varianten vorliegt, erkennt der Server beim Hochladen an den Dateien.

Jede Einbindung bekommt eine eigene Instanz-Kennung, und Markenfarben werden als CSS-Variablen auf den jeweiligen Container gesetzt statt global. Deshalb dürfen zwei Exemplare desselben Widgets mit unterschiedlichen Einstellungen auf derselben Seite stehen.

Wie kommt das Bundle in den Widget Builder?

Im Admin-Bereich gibt es seit dem Release eine Übersicht aller Bundles. Dort ladet ihr entweder ein ZIP-Archiv hoch oder die einzelnen JS- und CSS-Dateien. Name, Version und Beschreibung lassen sich nachträglich ändern, Dateien lassen sich erneut hochladen, und Bundles lassen sich dort auch löschen. Für Release-Skripte gibt es zusätzlich einen Upload über die Kommandozeile. Es gelten feste Grenzen: höchstens 10 MB pro Datei, höchstens 256 Dateien, nur relative Pfade.

Wie steuert ihr Versionen, ohne das Intranet zu riskieren?

Pro Bundle ist genau eine Version aktiv. Eine neue Version schaltet ihr gezielt frei, die bisherige wird dabei deaktiviert. Einzelne Mandanten könnt ihr auf eine Version festhalten, damit ein Update sie nicht überrascht. Für einen Testlauf gibt es Canary-Auslieferung: Eine neue Version geht zuerst nur an einen festgelegten Anteil der Mandanten, und die Zuordnung ist deterministisch, derselbe Mandant landet also immer in derselben Gruppe. Für ein Sicherheitsupdate löst ein Schalter alle Festlegungen auf einmal. Freischaltungen und Canary-Schaltungen werden protokolliert.

Bei der Auslieferung wird das Manifest nur kurz zwischengespeichert, die Bundle-Dateien dagegen dauerhaft, weil sie sich pro Version nicht mehr ändern. Vor dem Laden prüft der Player die SHA-256-Prüfsumme, also den Fingerabdruck der Datei, gegen den Wert im Manifest.

Native Widgets sind außerdem an die Lizenz gebunden. Ohne die Freischaltung enableNativeWidgets liefert die Widget-Liste eines Mandanten nur die klassischen Widgets aus.

Wie konfigurieren Redakteure so ein Widget?

Für native Widgets zeigt der Editor die Reiter Einstellungen, Übersetzungen und Branding. Code und Layout entfallen, denn beides steckt im Bundle. Das Einstellungsformular entsteht aus dem Konfigurationsschema im Manifest, die Übersetzungen werden gegen die dort deklarierten Schlüssel geprüft. Ein Banner zeigt, welche Bundle-Version aktiv ist und ob eine neuere bereitsteht. Speichern zwei Personen gleichzeitig, meldet der Server einen Konflikt, statt die ältere Änderung still zu überschreiben.

Was prüft die Pipeline vor dem Hochladen?

Für Bundles läuft eine eigene CI-Strecke. Sie baut jedes Bundle, prüft Lint und Tests, validiert das Manifest gegen die Pflichtfelder, berechnet die Prüfsummen der Ausgabedateien und bricht ab, wenn eval-Muster im JavaScript auftauchen oder das gepackte Bundle über dem Größenlimit liegt. Der Standardwert dafür liegt bei 200 KB.

Wann lohnt sich ein natives Bundle?

Nehmt ein natives Bundle, wenn die Oberfläche eigenen Zustand, eigene Datenabrufe und echte Interaktion braucht. Für einen Countdown, eine Linkliste oder einen Feed bleibt ein konfiguriertes Widget der schnellere Weg. Mit dem Release sind zwei Beispiel-Bundles entstanden, ein Tippspiel und ein Widget fürs Pflanzengießen. Was der Widget Builder sonst noch kann, steht auf der Produktseite.

Ihr habt eine React-Komponente, die ins Staffbase-Intranet soll? Kontaktiert uns. Wir schauen uns euren Build an und klären Manifest, Einstellungen und Versionsplan mit euch.

SH
Partner & Software-Architekt

Über 20 Jahre Erfahrung mit Entwicklung, SharePoint und Microsoft 365. Sascha berät Unternehmen bei der Einführung und Optimierung digitaler Arbeitsplätze – von der Strategie bis zur technischen Umsetzung.

Mehr zum Autor →

Bereit zum Gespräch?

Lasst uns über euer Projekt sprechen – unverbindlich und kostenfrei.

Kostenfreies Erstgespräch