Webgate Anywhere 4.1 - WebTML Tag-Referenz
item editor

<tml:item editor ="text|textarea|textblock|number|rtf|date|file|upload|custom">

Verwendung:

Definiert, welcher Editor im Browserinterface für das Item verwendet wird. Die Editoren werden nur angezeigt, wenn sich der Content im Status "draft" befindet, und der User die entsprechenden Zugriffsrechte hat.

Wert(e):

text: Normales Textfeld
textarea: Textarea Feld
textblock: Mini RTF-Editor. Erlaubt einfache Formatierungen wie Zeilenumbruch.
number: Normales Textfeld. Werte werden als Number gespeichert.
rtf: Rich Text Field. Erlaubt umfangreiche Formatierungen.
date: Datumsfeld
file oder upload: Erlaubt das uploaden von Dateien
custom: Erlaubt das codieren eines eigenen Editors (siehe Beispiel)

Beispiele:

Text:

<tml:item name="_headline" editor="text"/>

Erzeugt ein Standard HTML-Text Feld.


Textarea:

<tml:item name="_headline" editor="textarea"></tml:item>

Erzeugt ein Standard HTML-Textarea Feld.


Textblock:

<tml:item name="_headline" editor="textblock">test</tml:item>

Erzeugt einen Mini- Richtexteditor, ähnlich dem Editor "rtf".
Hier sind einfache Formatierungen, wie z.B. ein Zeilenumbruch möglich.

RTF:

<tml:item name="Body" editor="rtf"/>

Erzeugt einen so genannten "Richt Text"-Editor, welcher die komfortable WYSIWYG-Eingabe von formatiertem HTML-Code ermöglicht. Hier sind umfangreiche Formatierungen möglich:

Ausserdem ist es möglich Dateien hochzuladen, Formatierungen per Knopfdruck zu entfernen, und direkt das erzeugte HTML zu bearbeiten.
Soll ein per RTF-Editor bearbeitetes Feld über einem Tag ausgegeben werden, welcher kein <tml:item>-Tag mit Attribut encode="rtf" ist, so werden WebTML-Scriptlets - dynamische Bestandteile des Textes welche der Editor eventuell automatisch einfügt - nicht mehr korrekt aufgelöst. Es kommt dann evtl. zu nicht darstellbaren eingebetteten Grafiken.

In diesem Fall sollte der betroffene Tag das Attribut encode="rtf" verwenden, damit RTF-typische dynamische Elemente wieder korrekt aufgelöst werden.

Falls einige dieser Funktionen nicht gewünscht sind, können sie über die option "hideoptions" deaktiviert werden (die Buttons werden dann nicht angezeigt).

<tml:item name="Body" editor="rtf"> </tml:item>

In diesen Fall währe das hochladen von Dateien nicht möglich.
Mögliche Anzeigeoptionen sind:

Textformatierung:

bold: Fettdruck
italic: Kursivdruck
underline: Text unterstreichen
indent: Text einrücken
outdent: Text ausrücken
justifyleft: Text links ausrichten
justifyright: Text rechts ausrichten
justifycenter: Text zentral ausrichten
FormatBlock: Auswahl von Heading-Formatierungen

Listen:

InsertUnorderedList: Liste mit Aufzählungszeichen (Bullets) einfügen
InsertOrderedList: Liste mit Nummerierung einfügen

Tabellen:

InsertTable: Tabelle einfügen
TableProperties: Tabelleneigenschaften bearbeiten (nur bei Verwendung von tableStyleList verfügbar)
tableStyleList: Kommaseparierte Liste von CSS-Styles für Tabellen
trStyleList: Kommaseparierte Liste von CSS-Styles für Tabellenzeilen
tdStyleList: Kommaseparierte Liste von CSS-Styles für Tabellenzellen
InsertTableRow: Tabellenzeile hinzufügen
DeleteTableRow: Tabellenzeile löschen
InsertTableCol: Tabellenspalte hinzufügen
DeleteTableCol: Tabellenspalte löschen
MergeTableCells: Tabellenzellen zusammefügen
SplitTableCell: Tabellenzellen spalten

Links und Bilder

InsertLink: WGA-Interne Links einfügen
InsertSimpleLink: Links einfügen generell
InsertImg: Datei aus Datei-Container einfügen
InsertSimpleImg: Bild einfügen generell

Sonstiges

UploadFile: Datei hochladen
Paste: Einfügen der Zwischenablage (nur Firefox)
removeformat: Formatierungen von Text entfernen
all: Alle Optionen ausblenden

Hierbei ist es egal, ob die Schlüsselwörter untereinander, in einer Reihe, durch Komma oder Semikolon getrennt werden.
Wichtig ist nur das sie korrekt geschrieben sind.

Andere mögliche Anzeigeoptionen sind für gewöhnlich ausgeschaltet, es sei denn sie werden über TML-Option "showoptions" aktiviert

<tml:item name="Body" editor="rtf"> </tml:item>

Hiermit wird die direkte Editierung des HTML-Quellcodes, auswählbar als Anzeigemodus in der Buttonleiste, aktivier.

Optionen die explizit aktiviert werden müssen sind:

edithtml: Editieren des HTML-Quellcodes
forecolor: Textfarbe
fontname: Schriftname
fontsize: Schriftgröße

Date:

<tml:item name="_myDate" format="dd.MM.yyyy" editor="date"/>

Erzeugt einen Datumseditor.
Das Datum kann entweder direkt in das vorgesehene Feld eingegeben werden, oder über das erzeugte Kalender-Widget.
Das Format-Attribut dient hier nur der Ausgabe.

Number:

<tml:item name="_myNumber" format="0.#" editor="number"/>

Erzeugt ein Standard HTML-Text Feld.
Hierbei wird zusätzlich geprüft, ob es sich bei der Eingabe tatsächlich um eine Zahl handelt.
Falls nicht, bekommt der User eine Meldung.
Ausserdem wird der Wert als Number gespeichert.

File:

<tml:case iseditmode="true"> </tml:case>

Alternativ: editor="upload"
Erzeugt einen Datei - Upload Editor.
Hierüber ist es möglich Dateien an den Content anzuhängen, oder zu löschen.
Im Beispiel wird zusätzlich abgefragt, ob man sich im "editmode" befindet, sprich ob der content sich im status "draft" befindet.


Custom:

<tml:item label="Custom Editor" name="Dummy" editor="custom">
<table border="1">
<tr>
<td>Meta Title:</td>
<td><tml:input meta="true" type="text" name="title"/></td>
</tr>
<tr>
<td>Text:</td>
<td><tml:input type="text" name="_field1"/></td>
</tr>
<tr>
<td>Textarea:</td>
<td><tml:input type="textarea" name="_field4">rows="4" cols="30"</tml:input></td>
</tr>
<tr>
<td>Radio:</td>
<td><tml:input type="radio" name="_field2" options="Yes,No"/></td>
</tr>
<tr>
<td>Multiple Values:</td>
<td><tml:input type="checkbox" multiple="true" name="_field3" options="Value1,Value2,Value3"/></td>
</tr>
<tr>
<td>Number:</td>
<td><tml:input type="number" name="_field5"/></td>
</tr>
<tr>
<td>Date(dd.MM.yyyy):</td>
<td><tml:input type="date" format="dd.MM.yyyy" name="_field6"/></td>
</tr>
<tr>
<td>Fileupload:</td>
<td><tml:input type="file" name="_upload"/></td>
</tr>
</table>
</tml:item>

Bei Angabe von editor="custom" ist es möglich einen eigenen Editor innerhalb des Bodies des <tml:item>-Tags zu definieren.
Dabei kann das Tag <tml:input> verwendet werden.
Alle angegebenen Felder werden im Content gespeichert.


<< item label >>