FORM

textarea

Beschriftung | [*=erforderlich][Feldname=] textarea[,cols,rows,"wrap=[z.B. "OFF"]"] | [Vorgabewert] | Spezialauswertung, siehe unten

password

Beschriftung | [*=erforderlich][Feldname=] input[,size,max] | [Vorgabewert]

check

Beschriftung | [Feldname=] check | [checked=1]

radio

Beschriftung | [*=erforderlich][Feldname=] radio | Option[=Wert], ...

submit

Beschriftung | [Feldname=] submit | Aufschrift

property

[Intern, siehe unten]

Eigenschaft

Datentyp

Beschreibung

Standard

dataArray

[array von Formularelementen]

Einealternative Möglichkeit, die Formularelemente zu definieren. Anstelledie Syntax mit vertikalen Trennstrichen, die in der .data-Eigenschaftverwendet wird, zu benutzen, können Sie die Elemente auch in regulärenTypoScript Style-Arrays definieren.

.dataArray wird der Eingabe in .data hinzugefügt, falls vorhanden.

Jeder Eintrag im dataArray ist numerisch und hat drei Haupteigenschaften, label, type, value und required. "label" und "value" sind stdWrap-Eigenschaften.

Esgibt eine alternative Eigenschaft zu .value, nämlich .valueArray. Dasist ebenfalls ein Array der gleichen Art mit numerischen Einträgen, derdie Eigenschaften label, value und selected hat. 'label' ist eine stdWrap-Eigenschaft.

Beispiel:

dataArray {
  10.label = Name:
  10.type = name=input
  10.value = [Namen eingeben]
  10.required = 1
  20.label = Augenfarbe
  20.type = augenfarbe=select
  20.valueArray {
    10.label = Blau
    10.value = 1
    20.label = Rot
    20.value = 2
    20.selected = 1
  }
  40.type = abschicken=submit
  40.value = Abschicken
}

Das bedeutet das gleiche wie diese Zeile in der .data-Eigenschaft:

Name: | *name=input | [Namen eingeben]
Augenfarbe: | augenfarbe=select | Blau=1, *Rot=2
| abschicken=submit | Abschicken

Warumes auf diese Art machen? Gute Frage, aber ein Formular auf diese Weisezu erzeugen hat enorme Vorteile, da alle Beschriftungen vom Codegetrennt sind. Zusätzlich ist es viel einfacher, Elemente aus demFormular herauszunehmen oder neue einzufügen.
Nach dem Namen-Feld noch ein Email-Feld einzufügen ginge so:

dataArray {
  15.label = Email:
  15.type = input
  15.value = ihre@email.de
  15.specialEval = EMAIL
}

Oder das Formular auf Dänisch zu übersetzen (config.language auf 'dk' setzen):

dataArray {
  10.label.lang.dk = Navn:
  10.value.lang.dk = [Indtast dit navn]
  20.label.lang.dk = Øjenfarve
  20.valueArray {
    10.label.lang.dk = Blå
    20.label.lang.dk = Rød
  }
  40.value.lang.dk = Send
}

type

int

Ziel (action="" des Formulars):

Integer: Dies wird als normale Seite in Typo3 betrachtet.
String: Dies wird als normale URL betrachtet (z.B. "formmail.php" oder "fe_tce_db.php")
Leer: Die aktuelle Seite wird ausgewählt.

ANMERKUNG:Wenn type vom Typ Integer oder leer ist, wird das Formular an eineSeite in Typo3 weitergeleitet, und wenn diese Seite einen Wert fürtarget/noCache hat, wird dieser anstelle des Vorgabe-target/noCacheunten verwendet.

ANMERKUNG: Wenn der Weiterleitungs-Wert gesetzt ist, überschreibt das Weiterleitungsziel das durch die action-URL angegebene Ziel.

ANMERKUNG: Könnte durch das Eigenschaftenüberschreibungs-Feature der Formulardaten (siehe oben) überschrieben werden.

method

form-method

Beispiel:
GET

POST

noValueInsert

boolean

Standardmäßigwerden Werte, die an dieselbe Seite (und damit auch an dasselbeFormular) geleitet werden, anstelle irgendwelcher möglicherweiseexistierender Vorgabewerte in das Formular eingesetzt.

Das trifftjedoch NUR zu, wenn "no_cache=1" gesetzt ist! (Eine Seite, die im Cachegespeichert ist, kann natürlich keine benutzerabhänigen Vorgabewertebeinhalten)
Wenn diese Eigenschaft gesetzt ist, wird der Formularinhalt immer der Vorgabeinhalt sein.

locationData

boolean / string

Wenndieser Wert wahr ist, wird dem Formular ein verstecktes Feld mit demNamen "locationData" hinzugefügt. Dieses Feld wird einen derartaufgebauten Wert haben:
[Seiten-ID]:[Inhaltstabelle]:[Inhalts-ID]

Wennzum Beispiel ein Formular auf einer Seite mit der UID=100 alsSeiteninhalt aus der Tabelle "tt_content" mit der ID=120 eingefügtwird, wäre der Wert "100:tt_content:120".

Dieser Wert wird zumBeispiel vom Inhaltsobjekt »SEARCHRESULT verwendet. Wenn hier der Wert $GLOBALS["HTTP_POST_VARS"]["locationData"] gefunden wird, wird die Suche durchgeführt, als wäre sie auf dieser Seite gestartet worden. Das ist sehr nützlich, wenn Sie eine Suchfunktion auf einer Seite, deren "stype"-Feld auf "L1" gesetzt ist (was bedeutet, dass die Suche von der ersten Ebene der Rootline aus durchgeführt wird), einbinden wollen.

Angenommen, sie wollen die Suche an eine bestimmte Seite wo auch immer übermitteln. Diese Seite wird dann - wegen der locationData - wissen, dass die Suche von einem anderen Ort der Website aus durchgeführt wurde.

Wenn locationData nicht nur wahr ist, sondern auch in HTTP_POST_VARS gesetzt ist, wird für locationData der Inhalt aus $GLOBALS["HTTP_POST_VARS"]["locationData"] einfügt, und nicht die tatsächliche locationData der Seite. Das sollte bei Suchfeldern angewandt werden, da der Anfangspunkt der Suche mit übertragen wird.

ANMERKUNG: Könnte durch das Eigenschaftenüberschreibungs-Feature des Formulars überschrieben werden.

recipient

(Liste von string/stdWrap)

Email, an die der Formularinhalt geschickt werden soll (erzeugt das versteckte Feld "recipient")

Keine Email

badMess

string

Nachrichtfür die Formularauswertung im Falle eines oder mehrerer nichtausgefüllter Felder. Diese Nachricht wird über der Liste genannterFelder angezeigt.

ANMERKUNG: Könnte durch das Eigenschaftenüberschreibungs-Feature des Formulars überschrieben werden.

Keine Nachricht

image

»Image

Falls dies ein gültiges Bild ist, wird der Abschicken-Button als dieses Bild dargestellt.

ANMERKUNG: CurrentValue wird auf die Button-Beschriftung gesetzt, bevor das Bild erzeugt wird.

fieldWrap

»stdWrap

Wrapt die Felder

commentWrap

»stdWrap

Wrap für Kommentare, FALLS Sie ###COMMENT### benutzen.

REQ.fieldWrap

»stdWrap

Wrap für die erforderlichen Felder

Wert von .fieldWrap

REQ.layout

string

Das gleiche wie "layout" oben, allerdings nur für die erforderlichen Felder.

Wert von .layout

CHECK.layout

string

Alternatives Layout für Checkboxen

Wert von .layout

LABEL.layout

string

Alternatives Layout für Beschriftungen

Wert von .layout

hiddenFields

[Array von cObject]

Wird benutzt, um mit TypoScript versteckte Felder zu erzeugen.

Beispiel:
hiddenFields.pid = TEXT
hiddenFields.pid.value = 2

Das erzeugt ein verstecktes Feld mit dem Namen "pid" und dem Wert "2".

wrapFieldName

wrap

Das wrapt die Feldnamen, bevor sie in das Formular eingefügt werden.

Beispiel:
Wenn der Wert tx_myextension[input][ | ] ist, würde aus dem Feldnamen "email" dieser Wert: tx_myextension[input][email]

accessibility

dboolean

Wenn gesetzt, wird das Formular nach Zugänglichkeitsrichtlinien erzeugt. Das beinhaltet:

- Die Beschriftung wird mit <label for="[Feldname]">...</label> gewrapt.
-Alle Formularelemente haben ein ID-Attribut mit demselben Inhalt wiedas name-Attribut (wenn Sie einzigartige ID-Nummern brauchen, können Sie "wrapFieldName" benutzen, um für alle Feldnamen einen String irgendeiner Art als Präfix einzurichten.