Nemo: Interaktionstyp `BUTTONS`

Bei diesem Interationstyp werden ausschließlich Buttons gezeigt. Sie werden horizontal und vertikal zentriert.

Optionen

{
    "options": [
        {
1            "imageSource": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAV4AAAFeCAYAAADNK..."
        },
        {
2            "text": "Schnee"
        },
        {
3            "icon": "CHECK_GREEN"
        }
    ],
}

1: imageSource enthält ein Bild in base64-Kodierung
2: text liefert einen Text für den Button
3: icon erzeugt ein Bild aus einer Sammlung von vordefinierten Symbolen; zugelassen: CHECK_GREEN und CLOSE_RED

Bei den Optionen handelt es sich technisch um eine Liste (Array), und jeder Eintrag kann einen von drei Parametern haben. Die Spezifikation verhindert nicht, dass man mehrere Varianten des Parameters gleichzeitig verwendet, das ist aber in der Regel ohne Wirkung: Der zweite Parameter wird ignoriert (Reihenfolge imageSource > icon > text).

Größe und Anordnung

Die Buttons sind quadratisch. Bild, Symbol oder Text werden mittig zentriert und in einer festen Größe dargestellt. Sollte der Text zu groß sein oder das Bild nicht quadratisch, wird abgeschnitten. Die Buttons werden horizontal und vertikal zentriert. Dabei wird bei wenig Platz nicht umgebrochen, sondern notfalls abgeschnitten.

Drei Parameter steuern die Anzeige:

{
1    "size": "SMALL",
2    "gap": "BIG",
3    "numberOfRows": 2
}

1: size erlaubt für alle Buttons die Änderung der Größe. Mögliche Parameterwerte: SMALL, MEDIUM (Standard) und BIG.
2: gap erlaubt für alle Buttons die Änderung des Abstandes zueinander. Mögliche Parameterwerte: SMALL, MEDIUM (Standard) und BIG.
3: numberOfRows: wenn > 1, erzwingt dieser Parameter mehrere Zeilen der Button-Darstellung. Der verfügbare Platz spielt dabei keine Rolle. Standardwert ist 1

Auswahl und Antwortwert

Die ausgewählte Antwort wird bei Bild und Symbol durch einen fetten blauen Rand visualisiert. Bei Text erfolgt eine Farbänderung im Hintergrund (blau) und bei der Schrift (weiß). Beispiele siehe oben.

{
1    "variableId": "MK02",
2    "multiSelect": true
}

1: variableId setzt die Bezeichnung der Antwortvariablen auf einen bestimmten Wert. Standard hier ist BUTTONS.
2: multiSelect: Wenn true, dann ist das Markieren mehrerer Optionen möglich. Standardwert ist false, d. h. mit einer neuen Auswahl wird die vorherige Auswahl aufgehoben.

Die Antwortdaten folgen der Standardstruktur des IQB. Als id wird die gewählte variableId bzw. der Standard BUTTONS gesetzt, und der Status wäre zunächst VALUE_CHANGED (zur Kodierung siehe hier).

Für value muss unterschieden werden, ob multiSelect gesetzt wurde:

multiSelect true: Der Antwortwert ist ein String. Jedes Zeichen ist 0 oder 1 und steht für einen Button, ob er gewählt wurde oder nicht.
multiSelect false: Der Antwortwert ist eine Zahl mit der Position des gewählten Buttons. 1 steht für den ersten Button.

Zurück nach oben