<we:userInput type="textarea" />
Erzeugt ein mehrzeiliges HTML-Eingabefeld zur Eingabe von Daten aus dem Frontend.
ab Version | 2.2.0.0 |
Endtag erforderlich | nein |
Pflichtattribute |
Attribute
- type
- name
- property
- editable
- value
- cols
- rows
- autobr
- width
- height
- bgcolor
- class
- style
- hideautobr
- wysiwyg
- buttonpos
- ignoredocumentcss
- editorcss
- commands
- fontnames
- classes
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 | - |
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 | - |
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 | - |
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***) | 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 |
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 |
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. |
- Plugin zur Eingabe und formattierten Ausgabe von Kodebeispielen)
- template (Plugin Template)
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.
Wenn Du die verfügbare Auswahl selber festlegen möchtest, gibst Du hier eine kommaseparierte Liste der CSS Klassen an.
Wichtig:
- Die Klassen aus diesem Attribut ergänzen nicht die automatisch generierte Liste, sondern sie ersetzen sie vollständig.
- Das Command "styleselect" muss aktiviert sein, damit die Auswahl möglich ist.
ab Version | 1.3.0.0 |
Typ | string |
Standardwert | - |
Syntax
<we:userInput type="textarea" name="" property="true|false" editable="true|false" value="" cols="" rows="" autobr="true|false" width="" height="" bgcolor="" class="" style="" hideautobr="true|false" wysiwyg="true|false" ignoredocumentcss="true|false" editorcss="" commands="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" classes=""/>
Siehe auch
- <we:userInput />
- <we:userInput type="binary" />
- <we:userInput type="checkbox" />
- <we:userInput type="choice" />
- <we:userInput type="country" />
- <we:userInput type="date" />
- <we:userInput type="flashmovie" />
- <we:userInput type="hidden" />
- <we:userInput type="img" />
- <we:userInput type="language" />
- <we:userInput type="password" />
- <we:userInput type="quicktime" />
- <we:userInput type="radio" />
- <we:userInput type="select" />
- <we:userInput type="textinput" />
Hilf mit!
Hast Du eine Ergänzung für die Tag-Referenz, dann werde bitte aktiv.
Entweder über einen Eintrag unter qa.webedition.org oder
einfach formlos per E-Mail an
websites@webedition.org.
Fehler oder Erweiterungswünsche zu webEdition selbst bitte über qa.webedition.org melden.