Form (SP-Tag): Unterschied zwischen den Versionen

Version vom 7. Juni 2008, 17:47 Uhr

Name

<sp:form> - Erzeugt ein HTML-Form-Tag

Syntax

<sp:form command="command" enctype="multipart/form-data" method="post">
   ...
</sp:form>

Beschreibung

Erzeugt eine HTML-Form. Diese Tag wird benötigt, um Eingabe-Maken zu erstellen, mit denen Daten des Servers bearbeitet werden sollen.

Attribute

Name	Type	Required	Default	ab IES Version
`command` (deprecated)	Expression	Ja oder `uri`	None	1
`uri`	Text	Ja oder `command`	None	1
`handler`	Text	Nein	None	1
`enctype`	Text	Nein	None	1
`method`	Text	Nein	None	1
`locale`	Locale	Nein	None	1
`name`	Text	Nein	None	1

command (deprecated): Name des Command. Aus dem Command erstellt der Tag die richtige URL. Dieses Attribut ist veraltet und wird in zukünftigen Versionen des IES nicht mehr unterstüzt werden. Verwenden Sie anstelle dieses Attributes die Attribute uri und handler.

uri: URI zu der Seite, die aufgerufen werden soll.

handler: Handler, der die mitgesendeten Parameter auswerten soll.

enctype

Bestimmt den Typ der zu übertragenden Daten:

text/plain: text/plain ist die default Einstellung.
multipart/form-data: Für Datei uploads muss multipart/form-data angegeben werden.

method: Bestimmt die Übertragungsmethode: get oder post. Bei get werden die Parameter offen über die aufzurufende URL übermittelt, bei post verborgen im HTTP-Protokoll. Für Datei-uploads ist post Pflicht.

locale: Dieses Attribut dient zur Auswahl der zu verwendende Sprache bei mehrsprachiger Variablen.

name: Optionaler Name für das erzeugte Formular.

Beispiele

Neuen Artikel anlegen

Template Quelltext

<sp:form uri="mytest/test.spml" handler="com.sitepark.ies.control.jsp.handler.InformationHandler" method="post">

  <input type="hidden" name="SYS_INFE_action" value="create"/>
  <input type="hidden" name="SYS_INFE_target" value="<sp:print name="${targetPool}"/>"/>
  <input type="hidden" name="SYS_INFE_type" value="resouce"/>

  Name<br>
  <input type="text" name="SYS_INFE_name"/><br>
  <br>

  Titel<br>
  <sp:text name="sp_title"/><br>
  Text<br>
  <sp:textarea name="sp_body"/><br>

</sp:form>

@@ Zeile 1: / Zeile 1: @@
 ==Name==
-<sp:form> - xxx-Tag
+<sp:form> - Erzeugt ein HTML-Form-Tag
 ==Syntax==
 <source lang="xml">
-<sp:xxx name="variable" encoding="html"/>
+<sp:form command="command" enctype="multipart/form-data" method="post">
+   ...
+</sp:form>
 </source>
 ==Beschreibung==
-xxx
+Erzeugt eine HTML-Form. Diese Tag wird benötigt, um Eingabe-Maken zu erstellen, mit denen Daten des Servers bearbeitet werden sollen.
 ==Attribute==
@@ Zeile 15: / Zeile 17: @@
 ! Name || Type || Required || Default || ab IES Version
 |-
-| <code>xxx</code>
+| <code>command</code> (deprecated)
-| [[Attribute]]
+| [[Expression]]
-| Ja
+| Ja oder <code>uri</code>
+| None
+| 1
+|-
+| <code>uri</code>
+| [[Text]]
+| Ja oder <code>command</code>
+| None
+| 1
+|-
+| <code>handler</code>
+| [[Text]]
+| Nein
 | None
 | 1
 |-
-| <code>xxx</code>
+| <code>enctype</code>
 | [[Text]]
 | Nein
@@ Zeile 27: / Zeile 41: @@
 | 1
 |-
-| <code>xxx</code>
+| <code>method</code>
-| [[Expression]]
+| [[Text]]
 | Nein
 | None
 | 1
 |-
-| <code>xxx</code>
+| <code>locale</code>
 | [[Locale]]
+| Nein
+| None
+| 1
+|-
+| <code>name</code>
+| [[Text]]
 | Nein
 | None
@@ Zeile 40: / Zeile 60: @@
 |}
-;<code>xxx</code>
+;<code>command</code> (deprecated)
-:xxx.
+:Name des Command. Aus dem Command erstellt der Tag die richtige URL. Dieses Attribut ist veraltet und wird in zukünftigen Versionen des IES nicht mehr unterstüzt werden. Verwenden Sie anstelle dieses Attributes die Attribute <code>uri</code> und <code>handler</code>.
+;<code>uri</code>
+:URI zu der Seite, die aufgerufen werden soll.
+;<code>handler</code>
+:Handler, der die mitgesendeten Parameter auswerten soll.
+;<code>enctype</code>
+:Bestimmt den Typ der zu übertragenden Daten:
+:;text/plain
+::text/plain ist die default Einstellung.
+:;multipart/form-data
+::Für Datei uploads muss multipart/form-data angegeben werden.
+;<code>method</code>
+:Bestimmt die Übertragungsmethode: get oder post. Bei get werden die Parameter offen über die aufzurufende URL übermittelt, bei post verborgen im HTTP-Protokoll. Für Datei-uploads ist post Pflicht.
+;<code>locale</code>
+:Dieses Attribut dient zur Auswahl der zu verwendende Sprache bei mehrsprachiger Variablen.
-;<code>xxx</code>
+;<code>name</code>
-:xxx.
+:Optionaler Name für das erzeugte Formular.
 ==Beispiele==
-====Beispiel A====
+====Neuen Artikel anlegen====
 Template Quelltext
 <source lang="xml">
-xxx
+<sp:form uri="mytest/test.spml" handler="com.sitepark.ies.control.jsp.handler.InformationHandler" method="post">
-</source>
+  <input type="hidden" name="SYS_INFE_action" value="create"/>
+  <input type="hidden" name="SYS_INFE_target" value="<sp:print name="${targetPool}"/>"/>
+  <input type="hidden" name="SYS_INFE_type" value="resouce"/>
-Ausgabe
+  Name<br>
-<source lang="text">
+  <input type="text" name="SYS_INFE_name"/><br>
-xxx
+  <br>
-</source>
-====Beispiel B====
+  Titel<br>
+  <sp:text name="sp_title"/><br>
+  Text<br>
+  <sp:textarea name="sp_body"/><br>
-Template Quelltext
+</sp:form>
-<source lang="xml">
-xxx
 </source>
-Ausgabe
-<source lang="text">
-xxx
-</source>
-<!--
-bitte die passenden Kategorien auswählen und Kommentar entfernen
---------------------------------------------------------------
 <noinclude>
 [[Category:SP-Tags]]
-[[Category:SPT-Tags]]
 [[Category:Qualität_des_Inhalts_prüfen]]
 [[Category:Qualität_der_Sprache_prüfen]]
 [[Category:Qualität_des_Codes_prüfen]]
 </noinclude>
- -->