ML Checkbox List

Die ML Checkbox List ist für Multi-Selektions-Szenarien konzipiert. Sie ermöglicht es Benutzern, mehrere Werte aus einer vordefinierten Liste auszuwählen, die dann als getrennte Zeichenfolge synchronisiert werden.

⚙️ Konfiguration

Konfigurieren Sie den Editor in den Umbraco Datentyp-Einstellungen in der folgenden Reihenfolge:

• Selection Mode: Wählen Sie aus, wie Sie Ihre Daten bereitstellen möchten:
  • Items: Nutzt die Standard-Umbraco-"Dropdown"-Eingabekonfiguration.
  • Simple: Geben Sie eine Liste von Werten ein, einen pro Zeile (z. B. EN, DE, FR).
  • Enum: Geben Sie den vollqualifizierten Namen Ihres Enums inklusive Namespace ein (z. B. MyProject.Models.Countries).
• Translation Prefix: Fügen Sie ein Präfix hinzu (z. B. Country.), um Übersetzungen automatisch im Umbraco-Dictionary nachzuschlagen.
• Sort Alphabetically: Wenn aktiviert, werden die Checkboxen A-Z basierend auf ihren Anzeigenamen (übersetzte Namen) statt der Quellreihenfolge sortiert.
• Display Inline: Wenn aktiviert, werden die Checkboxen nebeneinander in einer flexiblen Reihe statt untereinander angezeigt.
• Display as Tags: Wenn aktiviert, werden die ausgewählten Werte als moderne UI-Tags im Umbraco Backoffice gerendert, um eine kompaktere Darstellung zu ermöglichen.

💻 C# Datenabruf (Value Converter)

Beim Abrufen von Werten in Ihrem Code stellt die Umbraco-Suite einen integrierten Value Converter bereit, der die Multi-Select-Logik automatisch verarbeitet:

// Mehrfachauswahl als Enumerable abrufen
var content = Umbraco.Content("your-node-guid");
var selectedItems = content?.Value<IEnumerable<string>>("myCheckboxList");
// Beispiel Ergebnis: ["EN", "DE"]

// Beispiel: Prüfen, ob ein bestimmter Schlüssel ausgewählt ist
if (selectedItems != null && selectedItems.Contains("DE")) 
{
    // Etwas spezifisches für Deutschland tun
}

✅ Validierung

Die ML Checkbox List ist vollständig in das Umbraco-Validierungssystem integriert:

• Unterstützt den nativen Mandatory-Toggle. Mindestens eine Checkbox muss ausgewählt sein, um die Validierung zu bestehen.
• Zeigt die in Ihren Datentyp-Einstellungen definierte benutzerdefinierte Fehlermeldung an.

📝 Speicher-Hinweis

In der Datenbank wird der Wert als semikolon-getrennter String gespeichert (z. B. EN;DE;FR). Der Value Converter teilt diesen String automatisch in ein IEnumerable<string> für Sie auf.