<we:userInput type="textarea"  />

ab Version	1.3.0.0
Typ	string
mögliche Werte	textarea
Standardwert	-

Bei diesem Attribut gibst Du als Wert einen eindeutigen Namen an.

ab Version	2.0.0.0
Typ	string
Standardwert	-

Dieses Attribut gibt an, ob der Name eine Eigenschaft (Dateiname, ...) des Dokuments darstellt.

ab Version	2.2.0.0
Typ	boolean
mögliche Werte	true, false
Standardwert	-

Wenn Du als Wert dieses Attributs "true" angibst oder das Attribut nicht setzt, dann ist der Inhalt des Feldes editierbar. Wenn Du als Wert dieses Attributs "false" angibst, dann wird der Inhalt des Feldes ohne Editiermöglichkeit dargestellt.

ab Version	1.3.0.0
Typ	boolean
mögliche Werte	true, false
Standardwert	true

Bei diesem Attribut gibst Du als Wert an, was als vordefinierter Text in dem Eingabefeld stehen soll.

Bitte beachte, dass value bei webEdition Objekten nur berücksichtig wird, wenn es für das neu anzulegende oder zu bearbeitene Objekt für dieses Feld (noch) keinen Wert gibt. Wenn bereits in den Feld-Eigenschaften der Objekt-Klasse ein "Defaultwert" festgelegt ist, wird value nicht mehr berücksichtigt. Wird der vorbelegte Wert aus value gelöscht, so bleibt auch das Feld auf dem Objekt leer. Es greift hier dann weder der Default der Klasse noch die value auf dem userInput. Denn mit value wird einzig das Inputfeld im Frontend (initial) vorbelegt.

ab Version	1.5.0.0
Typ	string
Standardwert	-

Bei diesem Attribut (cols>1) kann eine mehrspaltige Ausgabe der Listview-Ergebnisse erzeugt werden. Dabei kann dann mit den Tags <we:tr>..</we:tr> und <we:ifTdNotEmpty> eine Tabelle erzeugt werden, die z.B. (cols=3) drei Listview-Ergebnisse nebeneinander anzeigt.

ab Version	1.3.0.0
Typ	number
Standardwert	-

Bei diesem Attribut gibst Du als Wert eine Zahl an, die die maximale Anzahl angezeigter Einträge definiert. Werden mehr Einträge gefunden, als angezeigt werden können, dann kann man mit <we:back> und <we:next> Zurück- und Weiter-Buttons erzeugen.

ab Version	1.3.0.0
Typ	number
Standardwert	-

Wenn Du als Wert dieses Attributs "true" angibst, dann wird im oberen Teil des mehrzeiligen Eingabefeldes eine Checkbox angezeigt, mit der man die Autobreak-Funktion aus- oder einschalten kann. Ist Autobreak eingeschaltet, dann werden alle erzwungenen Zeilenumbrüche (RETURN-Taste) als <br> übersetzt. Wenn Du als Wert dieses Attributs "false" angibst oder das Attribut nicht setzt, dann wird im oberen Teil des mehrzeiligen Eingabefeldes keine Checkbox angezeigt und erzwungene Zeilenumbrüche (RETURN-Taste) werden nicht als <br> übersetzt.
Dieses Attribut hat nur Auswirkungen, wenn Du als Wert des Attributs "wysiwyg" "false" angibst oder das Attribut "wysiwyg" nicht setzt.

Wichtige Änderung ab Version 8.0

Ab Version 8.0 hat das Attribut keinerlei Auswirkungen mehr auf den Editmode: Der eingegebene Text wird unverändert in die Datenbank gespeichert.
Wird der Wert des Attributes auf "true" gesetzt, werden Zeilenumbrüche neu bei der Ausgabe durch <br/> ersetzt.

 

ab Version	1.3.0.0
Typ	boolean
mögliche Werte	true, false
Standardwert	false

Bei diesem Attribut gibst Du als Wert die Breite an.

ab Version	1.3.0.0
Typ	number
Standardwert	-

Bei diesem Attribut gibst Du als Wert die Höhe an.

ab Version	1.3.0.0
Typ	number
Standardwert	-

Bei diesem Attribut gibst Du als Wert die Hintergrundfarbe an. Diese Angabe hat nur im Edit-Mode Auswirkungen. Das Attribut akzeptiert #0000ff ebenso wie 0000ff und blue.

Hinweis: Das Attribut bgcolor überschreibt die background-color (Style des HTML-Tags body) aller mit <we:css> oder mit dem Attribut editorcss an TinyMCE übergebenen CSS-Dokumente. Auch die Eigenschaft background-image wird auf none gesetzt.

Tipp: Wenn Du im Editmode mit dem background-image der ausgespielten Seite arbeitest, setzt Du dieses Attribut auf transparent, sodass das Hintergrundbild nicht im TinyMCE (verkleinert) nochmals ausgespielt wird.

ab Version	6.3.6.0
Typ	string
Standardwert	-

Bei diesem Attribut gibst Du als Wert den Klassennamen an, den Du in einem CSS-Stylesheet definiert hast.

ab Version	2.0.0.0
Typ	string
Standardwert	-

Bei diesem Attribut gibst Du als Wert eine oder mehrere CSS-Style-Definitionen an. So lässt sich das Aussehen eines Links beeinflussen, wenn man keine CSS-Klasse definiert hat.

ab Version	2.0.0.0
Typ	string
Standardwert	-

ab Version	1.3.0.0
Typ	boolean
mögliche Werte	true, false
Standardwert	false

Wenn Du als Wert dieses Attributs "true" angibst, dann werden über dem Textarea Menüleisten zum Formatieren der Eingabe angezeigt. Wenn Du als Wert dieses Attributs "false" angibst oder das Attribut nicht setzt, dann werden über dem Textarea keine Menüleisten zum Formatieren der Eingabe angezeigt.

ab Version	2.2.0.0
Typ	boolean
mögliche Werte	true, false
Standardwert	false

Mit diesem Attribut legst Du fest, ob die Buttons des WYSIWYG-Editors über- oder unterhalb des Eingabebereichs ausgespielt werden.

ab Version	3.1.0.0
Typ	string
mögliche Werte	top, bottom
Standardwert	-

Verhindert mit der Eingabe von true, dass der WYSIWYG-Editor TinyMCE die mit <we:css> in Deine Vorlagen eingebundenen CSS-Dateien beachtet. Standardwert ist false.

ab Version	6.3.0.0
Typ	boolean
mögliche Werte	true, false
Standardwert	false

Bei diesem Attribut gibst Du als Wert die IDs von webEdition-internen CSS-Dokumenten an, die dem Wysiwyg-Editor TinyMCE als Content-CSS übergeben werden. Wähle hierzu ein Dokument über den beigefügten Button oder schreibe mehrere IDs als kommaseparierte Liste ins Eingabefeld.

Wichtig: Das mit diesem Attribut an den Editor übergebene Stylesheet wird nicht an das mit userInput generierte webEdition-Dokument bzw. -Objekt übergeben.

Beachte ebenfalls: Die hier definierten CSS-Dokument werden nach den per we:css an TinyMCE übergebenen Stylesheets eingebunden (vgl. we:css, die Attribute visibility und ifeditmode).

ab Version	6.3.0.0
Typ	csv
Standardwert	-

Bei diesem Attribut werden kommasepariert (ohne Leerzeichen) die Funktionen angegeben, die im WYSIWYG-Editor zur Verfügung stehen sollen. Wird das Attribut nicht gesetzt, sind alle Funktionen verfügbar.

Folgende, in Gruppen zusammengefasste Funktionen sind verfügbar. Sie können einzeln oder - unter Verwendung des Gruppennamens - auch gruppenweise gewählt werden.

Hinweis: Ab Version 9.0 werden einige Funktionen in kontextabhängigen, sogenannten Quickmenus ausgespielt und nicht mehr in den oberen Werkzeugleisten.

Gruppe	Command	Standard *)	Quickmenu	Funktion
full *)
	lädt alle Commands
prop
	sizeselect			Dropdownmenu Schriftgröße => ab Version 9.0.6 in Gruppe "advanced"
	blockselect			Dropdownmenu zur Zuweisung von Block-Formaten wie Headline, Code, div, etc.
	styleselect			Dropdownmenu zur Zuweisung von Klassen
	bold	x	x	Text Fett
	italic	x	x	Text Kursiv
	underline	x	x	Text Unterstrichen
	subscript		x	Text Tiefgestellt
	superscript		x	Text Hochgestellt
	strikethrough		x	Text Druchgestrichen
	removeformat		x	Formatierungen entfernen
color
	forecolor	x	x	Vordergrundfarbe
	backcolor	x	x	Hintergrundfarbe
list
	bullist	x		Ungeordnete Liste <ol> einfügen
	numlist	x		Geordnete Liste <ul> einfügen
	blockquote
	indent	x		Absatz Einrücken
	outdent	x		Absat Ausrücken
align
	alignleft	x		Absatz linksbündig ausrichten
	aligncenter	x		Absatz zentrieren
	alignright	x		Absatz rechtsbündig ausrichten
	alignjustify	x		Blocksatz
insert
	table	x		Tabelle einfügen/bearbeiten, aktiviert Buttons für sämtliche Tabellenfunktionen
	image	x		Bild einfügen/bearbeiten
	gallery			Galerie einfügen
	break			<br/> einfügen
	nonbreaking***)			&nbsp; einfügen
	hr		x	Horizontale Linie einfügen
	link	x	x	Link einfügen/bearbeiten, setzt auch den Anker- sowie den Unlink-Button
	anchor		x	Anker, wird beu Verwendung von link automatisch gesetzt
xhtmlxtras
	ltr			Text links nach rechts
	rlt			Text rechts nach links
	lang		x	Sprache: fügt ins selektierte Element ein lang-Attribut ein
	cite		x	Zitat
	acronym		x	Akronym: Umgibt den selektierten Inhalt mit einem <accronym>-Tag
	abbr		x	Abkürzung: Umgibt den selektierten Inhalt mit einem <abbr>-Tag
	del		x	Umgibt den selektierten Inhalt mit einem <del>-Tag
	ins		x	Umgibt den selektierten Inhalt mit einem <ins>-Tag
essential
	charmap			Sonderzeichen einfügen
	pastetext			Paste als Plaintext ohne alle Formatierungen. Tabellen und Links werden rudimentär erhalten => ab Version 9.0.6 in Gruppe "advanced"
	undo	x		Rückgängig
	redo	x		Wiederholen
	selectall			Alles auswählen
	search			Suchen und ersetzen
	fullscreen	x		Editor maximal vergrößern
	visualaid	x		Hilfslinien für Tabellen, Blockelemente und unsichtbare Elemente anzeigen
advanced
	sizeselect			Dropdownmenu Schriftgröße (seit Version 9.0.6 in dieser Gruppe)
	pastetext			Paste als Plaintext ohne alle Formatierungen.**) Wichtig: Tabellen und Links werden rudimentär erhalten.
	codesample			Plugin zur Eingabe und formattierten Ausgabe von Kodebeispielen
	template			Plugin Template
	editsource			HTML-Ansicht

*) Seit Version 9.0.6 werden bei fehlendem oder leerem Attribut command nicht mehr alle, sondern nur noch die hier als "Standard" ausgezeichneten Funktionen ausgespielt. Der Standard kann in den Allgemeinen Einstellungen unter "we:Tag Standards" => "Standard Einstellung für commands-Attribut in <we:textarea>" überschrieben werden: Dem bisherigen Default-Wert für das leere oder fehlende Attribut commands entspricht das neue Gruppen-command full.

**) Die Funktion paste as text ist standardmäßig aktiviert und kann nur ausgeschaltet werden, wenn das Command pastetext gesetzt ist. Beim Kopieren aus WE-TinyMCE-Instanzen wird jedoch immer das gesamte HTML eingefügt, ebenso werden beim Kopieren aus externen Quellen Tabellen und Links unabhängig von paste as text (in entsprechend bereinigter Form) übernommen.

***) Ab Version 9.0.8

 

Wichtig: Diverse Funktionsnamen wurden in webEdition Version 9.0 vereinfacht bzw. an die Bezeichnungen des verwendeten WYSIWYG-Editors TinyMCE angepasst. Die alten Bezeichnungen funktionieren vorerst noch, sind jedoch deprecated.

Folgende Funktionen wurden umbenannt oder existieren ab Version 9.0 nicht mehr: 

Alte Bezeichnung	Neue Bezeichnung	Bemerkungen
formatblock	blockselect
fontsize	sizeselect
applystyle	styleselect
justifyleft	alignleft
justifycenter	aligncenter
justifyright	alignright
justifyfull	alignjustify
insertunorderedlist	bullist
insertorderedlist	numlist
createlink	link
unlink		Funktion wird ab Version 9.0 bei "link" mitgeladen
insertimage	image
inserthorizontalrule	hr
inserttable	table
insertgallery	gallery
insertbreak	break
insertspecialchar	charmap
replace		Die Replace-Funktion wird ab Version 9.0 bei Search mit ausgespielt
visibleborders	visualaid
inserttable edittable deletetable insertcolumnright insertcolumnleft insertrowabove insertrowbelow deletecol deleterow editcell editrow increasecolspan decreasecolspan	table	Alle diese Funktionen werden ab Version 9.0 bei "table" mitgeladen: Die Funktion können nicht mehr einzeln gewählt werden. Außer dem Button "Tabelle einfügen/bearbeiten" werden alle diese Funktionen kontextabhängig ins neue Quickmenu ausgespielt.
removetags		Funktion existiert nicht mehr ab Version 9.0
fontname		Funktion existiert nicht mehr ab Version 9.0
pasteword		Funktion existiert nicht mehr ab Version 9.0
layerr insertlayer movebackward moveforward absolute		Das Layer-Plugin existiert ab Version 9.0 nicht mehr.
insertdate inserttime		Funktionen existiert nicht mehr ab Version 9.0

Auch einige Gruppen wurden ab Version 9.0 umbenannt oder existieren nicht mehr:

Alte Bezeichnung	Neue Bezeichnung	Bemerkungen
justify	align
copypaste		Die verbleibende Funktion "pastetext" gehört neu zu "essential"
link		Die Funktionen "link" (bisher "createlink") und "anchor" gehören neu zu "insert"
table		Die verbleibende Funktion "table" (bisher "inserttable") gehört neu zu "insert"
font		Die verbleibende Funktion "sizeselect" (bisher "fontsize") gehört neu zu "prop"
layer		Das Layer-Plugin existiert ab Version 9.0 nicht mehr.

 

ab Version	5.1.0.0
Typ	string
mögliche Werte	prop, color, list, align, insert, xhtmlxtras, essential, advanced, sizeselect, blockselect, styleselect, bold, italic, underline, subscript, superscript, removeformat, strikethrough, forecolor, backcolor, bullist, numlist, blockquote, indent, outdent, alignleft, aligncenter, alignright, alignjustify, table, image, gallery, break, nonbreaking, hr, link, anchor, ltr, rtl, lang, cite, acronym, abbr, del, ins, charmap, pastetext, undo, redo, selectall, search, fullscreen, visualaid, codesample, template, editsource
Standardwert	-

Bei diesem Attribut gibst Du als Wert kommasepariert Schriftnamen an, die dem Redakteur zum Formatieren zur Verfügung stehen sollen.

Hinweis: Ab Version 9.0 gibt es im WYSIWYG-Editor keine Schrift-Auswahl mehr.

ab Version	1.3.0.0
Typ	string
mögliche Werte	arial, courier, tahoma, times, verdana, wingdings
Standardwert	-

Die im webEdition WYSIWYG-Editor angezeigten CSS Klassen werden aus dem HTML Dokument geladen. Der neuere Editor TinyMCE lädt die Klassen aus den CSS-Dateien, die er entweder per we:css oder mit dem Attribut editorcss übergeben bekommt.

Das Ergebnis kann schnell unübersichtlich werden, wenn TinyMCE die Klassen automatisch ausliest. Um dies zu verhindern, kannst du die auszugebenden Klassen in dieses Attribut explizit übergeben. 

Wichtig:

1. Die Klassen aus diesem Attribut ergänzen nicht die automatisch generierte Liste, sondern sie ersetzen sie vollständig.
2. Das Command "styleselect" muss aktiviert sein, damit die Auswahl möglich ist.

Es stehen zwei Syntaxvarianten zur Verfügung: die erste ist rein string-baisert, während die zweite Array-basiert (PHP oder JSON) ist. Letztere Variante ist näher an der Tiny-Syntax und entsprechend deutlich mächtiger.

String-basierte Syntax: [NAME:][SELECTOR.]CLASS[ES][,[NAME:][SELECTOR.]CLASS[ES]...]

1. die Einträge sind kommasepariert: blue,red
   => es werden die Einträge "blue" und "red" ausgegeben
2. jeder Eintrag kann um einen Ausgabenamen ergänzt werden: Blauer Text:blue, Link: rot:red
   => der Name endet beim letzten Doppelpunkt des Eintrags. Die Ausgabe ist also: Blauer Text, Link: rot
3. jeder Eintrag kann um einen CSS-Selektor ergänzt werden: Blauer Text: span.blue, Link: rot: a.red
   => TinyMCE filtert nun die Einträge "Link rot" wird nur ausgegeben, wenn sich der Cursor auf einem Link befindet und es ist sichergestellt, dass die Klasse ins <a> eingefügt wird
   => Spezialfall "span": anders als bei Blockelementen als Selektor wird bei "span" der selektierte Text mit einem <span> umgeben, auch wenn dieses noch nicht vorhanden ist
   => Verschachtelte Selektoren sind möglich: Zelle: grün:table.gray td.green
4. es können mehrere Klassen mit einem Eintrag zugefügt werden: Link: rot.a.red.mylink
   => der Eintrag wird angeboten, wenn sich der Cursor auf einem Link befindet und es werden die Klassen "red" und "mylink" eingefügt
   => der Selektor endet also beim ersten Punkt des letzten Selektor-Segments

Array-basierte Syntax (als PHP-Variable):
Die obige Beispiele sehen als PHP-Array folgendermaßen aus:

    $classes = [
        ['name' => 'Blauer Text', 'selector' => 'span', 'classes' => ['blue']],
        ['name' => 'Link: rot', 'selector' => 'a', ['red', 'mylink'],
        ['name' => 'Zelle: grün', 'selector' => 'table.gray td', 'classes' => 'green']]
    ]

Wird das Feld "name" weggelassen, erscheint der Inhalt von "classes" im CSS-Menu ausgegeben. Wird der "selector" nicht gesetzt, wird "selector" => "span" angenommen.

Wichtig: auch hier gilt, dass der "span" als Inline-Element nicht eigentlich der Selektor ist, sondern das Element, mit welchen der selektierte Text umgeben wird (falls es noch nicht vorhanden ist). 

Das Array kann direkt als PHP-Variable ins Attribut geschrieben werden: classes="$classes". Alternativ kann auch ein entsprechender JSON-String verwendet werden. In die WYSIWYG-Konfiguration von Klassen-Feldern des Typs "Textbox" kann nur die JSON-Variante eingefügt werden

Die Array-Syntax besitzt noch wesentlich mehr Möglichkeiten, das CSS-Menu des Tiny-Editors zu bestücken:
Ausführlichere Beispiele finden sich in der Dokumentation.

ab Version	1.3.0.0
Typ	string
Standardwert	-