<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 Pflichtfeld: ja
ab Version 1.3.0.0
Typ string
mögliche Werte textarea
Standardwert -
name Pflichtfeld: ja

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

ab Version 2.0.0.0
Typ string
Standardwert -
property Pflichtfeld: nein
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 -
editable Pflichtfeld: nein

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
value Pflichtfeld: nein

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 -
cols Pflichtfeld: nein
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 -
rows Pflichtfeld: nein

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 -
autobr Pflichtfeld: nein
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
width Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert die Breite an.

ab Version 1.3.0.0
Typ number
Standardwert -
height Pflichtfeld: nein

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

ab Version 1.3.0.0
Typ number
Standardwert -
bgcolor Pflichtfeld: nein

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 -
class Pflichtfeld: nein

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 -
style Pflichtfeld: nein

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 -
hideautobr Pflichtfeld: nein
ab Version 1.3.0.0
Typ boolean
mögliche Werte true, false
Standardwert false
wysiwyg Pflichtfeld: nein

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
buttonpos Pflichtfeld: nein
deprecated bis Version 8.1.2 (Ahlberg)

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 -
ignoredocumentcss Pflichtfeld: nein

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
editorcss Pflichtfeld: nein

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 -
commands Pflichtfeld: nein

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.

 

  • 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 -
fontnames Pflichtfeld: nein
deprecated bis Version 8.1.2 (Ahlberg)

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 -
classes Pflichtfeld: nein

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:

  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.
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

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.

powered by webEdition CMS