WML - Tutorial ( Formularelemente )

[ Inhaltsverzeichnis ]	WML
Formularelemente

Auswahllisten
Eingabefelder

Auswahllisten

Eine Auswahlliste gibt dem Benutzer die Möglichkeit zwischen verschieden angebotenen Optionen zu wählen. Die Darstellung erfolgt dabei in Form einer Liste. Es kann bestimmt werden, ob nur eine Option oder mehrere Optionen innerhalb dieser Liste ausgewählt werden darf.

Auswahllisten ( Definition )

Durch das select-Tag <select> und </select> wird eine Auswahlliste innerhalb einer Card definiert. Innerhalb des select-Tags werden die einzelnen Optionen durch das option-Tag <option> und </option> definiert.

Beispiel :


<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN" "http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
<card>
<p>
<b>Auswahlliste</b>
  <select name="drink">
    <option value="Bier">Bier</option>
    <option value="Cola">Cola</option>
    <option value="Tee">Tee</option>
  </select>
</p>
</card>
</wml>

Erklärung :

Im obigen Beispiel wurde eine Auswahlliste definiert und die möglichen Optionen innerhalb des select-Tags mittels dem option-Tag definiert. Die Optionen sind hierbei Bier,Cola und Tee. Eine detaillierte Beschreibung des option-Tags erfolgt unter Auswahllisten ( Optionen ).

Auswahllisten ( Attribute )

Im folgenden select-Tag sind die Attribute des select-Tags aufgeführt, deren Beschreibung in der darunter stehenden Tabelle erfolgt.


<select title="" name="" value="" iname="" ivalue="" multiple="" tabindex="">
  <!-- Optionen -->
</select>

Attribut	Wirkung
`title`	Über dieses Attribut wird der Titel des `select`-Tags definiert.
`name`	Dieses Attribut gibt den Namen der Variablen an, die durch eine Auswahl einer oder mehrerer Optionen gesetzt werden soll. Dieser Variablen wird dann der Wert zugewiesen, der im `option`-Tag durch das Attribut `value` des `option`-Tags angegeben ist.
`value`	Es ist möglich dem Attribut `name` einen Defaultwert zuzuweisen. Dies geschieht genau über das Attribut `value`. Der Defaultwert ist solange gütig, bis eine Auswahl erfolgt ist.
`iname`	Dieses Attribut gibt den Namen der IndexVariablen an, die den Index einer oder mehrerer ausgewählter Optionen speichern soll. Dieser Variablen wird dann der Index des oder der ausgewählten `option`-Tags zugewiesen.
`ivalue`	Durch dieses Attribut wird eine Option innerhalb des `select`-Tags als 'vorausgewählt' gekennzeichnet, indem dem Attribut der gewünschte Index zugewiesen wird. Das Attribut `name` nimmt den Wert, also den Index, des Attributs `ivalue` an.
`multiple`	Dieses Attribut legt die Eigenschaft fest, ob nur eine Option oder mehrere Optionen ausgewählt werden können. Es kann die Werte true und false annehmen. Wird dem Attribut `multiple` der Wert true zugewiesen, so ist eine Mehrfachauswahl möglich. Bei false kann nur eine Option ausgewählt werden. Der Wert false ist auch die Defaulteinstellung dieses Attributes.
`tabindex`	Dieses Attribut bestimmt das Verhalten beim Weiterspringen, das sogenannte 'Tabbing', auf ein nächstes Element. Es gibt die Postion an, in welcher Reihenfolge es angesprungen werden soll.

Auswahllisten ( Optionen )

Durch das option-Tag <option> und </option> wird eine Option definiert, die später ausgewählt werden kann. Innerhalb eines select-Tags können und sollten mehrere option-Tags stehen, denn sonst macht eine Auswahlliste wenig Sinn. Innerhalb von <option> und </option> wird der Text angegeben, der auf dem Display erscheinen soll.

Beispiel :


<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN" "http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
<card>
<p>
<b>Auswahlliste</b>
  <select name="drink">
    <option value="Bier">Bier</option>
    <option value="Cola">Cola</option>
    <option value="Tee">Tee</option>
  </select>
</p>
</card>
</wml>

Erklärung :

Im obigen Beispiel wurde eine Auswahlliste definiert und die möglichen Optionen innerhalb des select-Tags mittels dem option-Tag definiert. Die Optionen sind hierbei Bier, Cola und Tee.

Das option-Tag verfügt über drei wichtige Attibute, die im folgenden option-Tag angegeben sind und in der darunter befindlichen Tabelle beschrieben werden.


<option value="" title="" onpick=""> </option>

Attribut	Wirkung
`title`	Über dieses Attribut wird der Titel des `option`-Tags definiert.
`value`	Dieses Attribut definiert den Wert des `option`-Tags, der bei der Auswahl in der Variablen name des `select`-Tags gesetzt werden soll.
`onpick`	Das Attribut `onpick` gibt eine URL an, die sofort angesprungen werden soll, falls die Option ausgewählt wurde.

Seitenanfang Inhaltsverzeichnis

Eingabefelder

Eingabefelder erlauben die Interaktion mit dem Benutzer, indem er in ein vorgesehenes Eingabefeld Werte eintragen kann, die dann z.B. durch ein CGI-Script verarbeitet werden.

In WML werden Eingabefelder über das input-Tag <input/> in eine Card eingebunden.

Beispiel :


<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN" "http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
  <card>
    <p>
      Nachname : <input type="text" name="nachname" size="15"/>
    </p>
  </card>
</wml>

Erklärung :

Im Beispiel wurde ein Eingabefeld vom Type 'text' angelegt, daß die Länge von '15' Zeichen haben soll. Die eingetragenen Zeichen des Benutzers werden in der Variablen 'nachname' abgelegt.

Das input-Tag verfügt über mehrere Attribute, die im folgenden input-Tag angegeben sind und in der darunter befindlichen Tabelle beschrieben werden.


<input type ="" name="" value="" format="" emptyok="" size="" maxlength="" tabindex="" title=""/>

Attribut	Wirkung
`type`	Diese Attribut kann den Wert text oder password annehmen, und legt damit den Type des Eingabefeldes fest.. Wird dem Attribut der Wert text zugewiesen, dann stellt das Eingabefeld ein ganz normales Feld zur Eingabe dar. Sollte aber der Wert password gewählt worden sein, dann wird jedes eingegebene Zeichen als Asterix in dem Eingabefeld angezeigt.
`name`	Dieses Attribut gibt den Namen der Variablen an, die den Inhalt des Eingabefeldes zugewiesen bekommt.
`value`	Es ist möglich dem Attribut `name` einen Defaultwert zuzuweisen. Dies geschieht genau über das Attribut `value`.
`format`	Das Attribut `format` bestimmt das Format der Zeichen, die in das Eingabefeld eingegeben werden dürfen. Eine genauere Beschreibung dieses Attributes finden Sie in Kürze hier im WML-Tutorial.
`emptyok`	Diese Attribut bestimmt, ob das Eingabefeld einen leeren Wert enthalten darf oder nicht. Es kann die Werte true oder false annehmen. Bei true darf das Eingabefeld einen leeren Wert enthalten, bei false nicht.
`size`	Durch `size` wird die Länge des Eingabefeldes festgelegt. Diese Angabe kann aber von den WAP-Browser einfach ignoriert werden.
`maxlength`	Durch `maxlength` wird die maximale Anzahl an Zeichen festgelegt, die eingegeben werden dürfen. Ohne diese Attribut kann man beliebig viele Zeichen eingeben.
`tabindex`	Dieses Attribut bestimmt das Verhalten beim Weiterspringen, das sogenannte 'Tabbing', auf ein nächstes Element. Es gibt die Postion an, in welcher Reihenfolge es angesprungen werden soll.
`title`	Über dieses Attribut wird der Titel des `input`-Tags definiert.
Seitenanfang Inhaltsverzeichnis