Formular-Widget: Sprachauswahlelement

Geändert am Fr, 21 Jul, 2023 um 2:55 NACHMITTAGS

Funktionsbeschreibung

Das Plugin stellt ein neues Widget im Designer zur Verfügung, welches es erlaubt, auf einfache Art eine Auswahlleiste für die Formularsprache einzufügen. Das Widget verwendet individuell im Designer zu konfigurierende Einstellungen im Bezug auf die anzuzeigenden Sprachen und die für sie anzuzeigenden Namen.

Durch einen Klick im Widget auf eine Sprache wird das Formular mit bereits eingegebenen Werten in den entsprechenden Sprache neu geladen. Zu beachten ist hier, dass es aufgrund von Sicherheitsbeschränkungen der Browser nicht möglich ist, vom Nutzer ausgewählte Dateien in Upload-Elementen wieder einzutragen.

Beispiel für ein eingefügtes Sprachauswahl-Widget in einem Formular. Die aktuell verwendete Sprache wird fett dargestellt.

Installation

Das Plugin kann als Mandant-Plugin oder System-Plugin installiert werden. Eine Anleitung zur Installation von Plugins finden Sie hier.

Konfiguration

An Widgets dieses Typs können die folgenden Eigenschaften konfiguriert werden:

Optionen

Mögliche Konfiguration der zu verwendenen Auswahloptionen eines Sprachauswahl-Widgets.

Sprachauswahl-Widgets verfügen über einen zusätzlichen Bereich Optionen. Hier können die in der Sprachauswahl sichtbaren Sprachen und die für die jeweilige Sprache anzuzeigenden Namen festgelegt werden.

Für jede anzuzeigende Sprache ist eine Zeile mit dem sichtbaren Beschreibungstext und dem Kürzel der Sprache einzugeben (z.B. en für Englisch). Optional können in der Spalte Titel die Title-Attribute festgelegt werden. Die Sprachen müssen im Designer unter Formularsprache gepflegt werden, damit eine Übersetzung auch tatsächlich durchgeführt wird.

Neben der Konfiguration der Optionen direkt am Widget ist es zudem möglich, eine CSV-Datenquelle zu verwenden. Diese kann im Auswahlelement Datenquelle selektiert werden.

Word-/PDF-Export

Standardmäßig ist das Widget so konfiguriert, dass es nicht im Word-/PDF-Export auftaucht. Es ist auch nicht sinnvoll, an dieser Einstellung etwas zu ändern, da das Element in einem exportierten Formular keine Funktion hat.

Mögliche CSS-Anpassungen

Um das Aussehen des Widgets zu individualisieren, können per CSS Anpassungen vorgenommen werden.

Zum Beispiel kann das standardmäßig Unterstreichen der Spracheauswahlen entfernent werden:

.XItem.XLanguageSwich {
    text-decoration: none;
}

Die Farbe der aktiven Sprache kann wie folgt verändert werden:

.XItem.XLanguageSwich.XLanguageSwichActive {
    color: red;
}