# bx:text

Mittels des Tags `text` kann für Redakteure eine Eingabemöglichkeit in Form eines einzeiligen Textfeldes geschaffen werden.

Die einzelnen Funktionen können kombiniert werden.

<p class="callout info">Dieses Tag kann sich in der Verwaltung darstellen.</p>

## Textfeld anzeigen

```xml
<bx:text.{titel} [comment="{kommentar}"] [admin-mode="config" admin-title="{alternativer Titel}"]/>
```

| comment | Kommentar, der beim Tag z.B. als Hinweis mit ausgegeben wird |
| --- | --- |
| admin-mode | Erzwingt, daß das Tag bei den Tageinstellungen (anstatt bei Dateneingabe) angezeigt wird. |
| admin-title | In Verwaltung wird ein anderer Titel ausgeben als der beim Tag angegebene. |

<p class="callout info">Für `{titel}` und `{kommentar}` siehe die allgemeinen Hinweise zu [Redakteurs-Tags](/books/cms-handbuch-entwickler/page/redakteurs-tags).</p>

## Länge begrenzen

```xml
<bx:text.{titel} [size="{breite}"] [maxlength="{maxlänge}"] />
```

Das Eingabefeld ist hiermit `{breite}` Zeichen breit bzw. können dann nur `{maxlänge}` Zeichen in das Feld eingetragen werden.

`size` kann nicht auf kleiner als 2 gesetzt werden (wird dann auf 63 gesetzt), der Maximalwert beträgt 63. Der Standardwert ist 63.

`maxlength` kann nicht auf kleiner als 2 gesetzt werden (wird dann auf 255 gesetzt), der Maximalwert beträgt 255. Der Standardwert ist 255.

## Ausgabe maskieren

```xml
<bx:text.{titel} [encode="(html | plain | url | javascript | entitymask | xml)"] />
```

Standardmäßig wird ausgegebener Text HTML-kodiert (`html` ist also Standard für `encode`), außer der MIME-Type der Frontend-Seite beginnt mit "text/plain" (dann ist `plain` Standard).

Wenn etwas anderes benötigt wird - z.B. falls Text in JavaScript Code eingebunden ist - kann dies über `encode` gesteuert werden. Bei `plain` wird der Text unverändert ausgegeben.

Für Details zu den anderen Formaten, einfach den Links in der nachstehenden Tabelle folgen:

|  |  |
| --- | --- |
| `html` | [HtmlEncode](/books/cms-handbuch-entwickler/page/htmlencode) |
| ``` url ``` | [UrlEncode](/books/cms-handbuch-entwickler/page/urlencode)<br>mit Projekt-Zeichensatz |
| ``` javascript ``` | Non-Strict<br>[ScriptEncode](/books/cms-handbuch-entwickler/page/scriptencode) |
| ``` entitymask ``` | [HtmlMask](/books/cms-handbuch-entwickler/page/htmlmask) |
| ``` xml ``` | [XmlEncode](/books/cms-handbuch-entwickler/page/xmlencode) |

## Ausgabe maskieren (veraltet)

** Deprecated - Veraltetes Feature**
Die hier aufgeführten Informationen beziehen sich auf eine veraltete Funktion, die nicht mehr weiterentwickelt wird und ggf. in zukünftigen Versionen nicht mehr unterstützt wird. Diese Funktion sollte deshalb nicht mehr benutzt werden.

```xml
<bx:text.{titel} [urlencode | inscript | htmlmask | unmodified] />
```

Falls `encode` nicht angegeben ist, kann die Maskierung kann auch mittels Flags gesteuert werden. Dabei gelten foldende Zuordnungen zwischen den Flags hier und `encode` oben:

| Flag | `encode` |
| --- | --- |
| ``` urlencode ``` | ``` url ``` |
| ``` inscript ``` | ``` javascript ``` |
| ``` htmlmask ``` | ``` entitymask ``` |
| ``` unmodified ``` | ``` plain ``` |