ModuLabry Logo

Umbraco-Suite by ModuLabry

NuGet

ML Tag List

Die ML Tag List ist ein leichtgewichtiger Property-Editor zur Verwaltung einer einfachen Sammlung von Texteinträgen, die häufig für Tags, Schlüsselwörter oder einfache Listen verwendet werden.

⚙️ Konfiguration

Konfigurieren Sie den Editor in den Umbraco Datentyp-Einstellungen:

  • Max Items: Maximale Anzahl der in der Liste zulässigen Elemente.
  • Max Length: Maximale Zeichenanzahl pro einzelnem Element.
  • Allow Duplicates: Wenn aktiviert, kann derselbe Wert mehrfach hinzugefügt werden.
  • Sort Alphabetically: Wenn aktiviert, wird die Liste automatisch alphabetisch sortiert.
  • Display as Tags: Zeigt die Elemente als interaktive Badges/Tags anstelle einer einfachen vertikalen Liste an (Standard: true).

💻 C# Datenabruf (Value Converter)

Die ML Tag List verfügt über einen integrierten Value Converter, der eine Sammlung von Strings zurückgibt:

var tags = content?.Value<IEnumerable<string>>("myTagList");
// Beispiel Ergebnis: ["Umbraco", "CMS", "ModuLabry"]

✅ Validierung

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

  • Unterstützung für den Pflichtfeld-Status (muss mindestens ein Element enthalten).
  • Erzwingt das Limit für Max Items.
  • Einzelne Elemente werden gegen die Einstellung Max Length validiert.

📝 Speicher-Hinweis

In der Datenbank werden die Werte als semikolon-getrennter String gespeichert. Der Value Converter übernimmt die Umwandlung in IEnumerable<string> automatisch für Sie.


✨ Features

  • Schnelle Eingabe: Fügen Sie Elemente hinzu, indem Sie tippen und die Eingabetaste drücken.
  • Interaktive Badges: Stellen Sie Einträge optional als stilisierte Tags dar, um ein besseres visuelles Feedback zu geben.
  • Vermeidung von Dubletten: Konfigurierbare Option, um sicherzustellen, dass Einträge eindeutig sind.
  • Auto-Sortierung: Halten Sie Ihre Liste automatisch alphabetisch organisiert.