input (type="password")NN 2 IE 3 DOM 1

Das password-Objekt ist ein Formularsteuerelement, das mit einem input-Element erstellt wird, dessen type-Attribut auf "password" gesetzt ist. Dieses Objekt ähnelt dem input-Textobjekt. Der einzige Unterschied besteht darin, dass die vom Benutzer in das Textfeld eingegebenen Zeichen aus Datenschutzgründen in Sternchen oder Listenpunkte konvertiert werden.

 
HTML-Äquivalent
 
<input type="password">
 
Objektmodellreferenz
 
[window.]document.formName.elementName
[window.]document.forms[i].elements[i]
[window.]document.getElementById("elementID")
 
Objektspezifische Eigenschaften
 
dataFlddataSrcdefaultValueformmaxLength
namereadOnlyselectionEndselectionStartsize
textLengthtypevalue
 
Objektspezifische Methoden
 
createTextRange( )handleEvent( )select( )
 
Objektspezifische Ereignisbehandlungsroutineneigenschaften
 
BehandlungsroutineNNIEDOM
onblur232
onchange232
onfocus232
onkeydown44--
onkeypress44--
onkeyup44--
onselect232
dataFldNN nicht zutreffend IE 4 DOM nicht zutreffend

Lesen/Schreiben

Wird in IE für die Datenbindung verwendet, um den Spaltennamen einer Remote-Datenquelle der value-Eigenschaft eines Kennwortobjekts zuzuweisen. Für das Element muss außerdem das Attribut datasrc gesetzt sein. Wenn sowohl dataFld als auch dataSrc auf eine leere Zeichenfolge gesetzt wird, wird die Bindung zwischen dem Element und der Datenquelle unterbrochen. Funktioniert in IE 5/Mac nur mit Textdateien als Datenquellen.

 
Beispiel
 
document.myForm.myPassword.dataFld = "userWurd";
 
Wert

Von der Groß-/Kleinschreibung abhängiger Bezeichner der Datenquellenspalte.

 
Standardwert

Keiner.

dataSrcNN nicht zutreffend IE 4 DOM nicht zutreffend

Lesen/Schreiben

Wird in IE für die Datenbindung verwendet, um die ID des object-Elements der Seite anzugeben, das das Datenquellenobjekt für den Remote-Datenzugriff lädt. Der Inhalt der Datenquelle wird mit dem datafld-Attribut angegeben. Wenn sowohl dataFld als auch dataSrc auf eine leere Zeichenfolge gesetzt wird, wird die Bindung zwischen dem Element und der Datenquelle unterbrochen. Funktioniert in IE 5/Mac nur mit Textdateien als Datenquellen.

 
Beispiel
 
document.myForm.myPassword.dataSrc = "#DBSRC3";
 
Wert

Von der Groß-/Kleinschreibung abhängiger Bezeichner der Datenquelle.

 
Standardwert

Keiner.

defaultValueNN 2 IE 3 DOM 1

Schreibgeschützt

Gibt den Standardtext für das Kennwort-Eingabeelement entsprechend der Einstellung des value-Attributs an.

 
Beispiel
 
var pwObj = document.forms[0].myPassword;
if (pwObj.value != pwObj.defaultValue ) {
    // process user-entered password
}
 
Wert

Zeichenfolgenwert.

 
Standardwert

Keiner.

formNN 2 IE 3 DOM 1

Schreibgeschützt

Gibt eine Referenz auf das form-Element zurück, in dem das aktuelle Element (sofern vorhanden) enthalten ist. Während der Verarbeitung eines von diesem Element stammenden Ereignisses hat die Ereignisbehandlungsroutinenfunktion automatisch Zugriff auf das input-Element (als target- oder srcElement-Eigenschaft des Ereignisobjekts). Durch Lesen der form-Eigenschaft kann das Skript problemlos auf andere Steuerelemente innerhalb desselben Formulars zugreifen.

 
Beispiel
 
var theForm = evt.srcElement.form;
 
Wert

form-Elementobjektreferenz

 
Standardwert

Keiner.

maxLengthNN 6 IE 4 DOM 1

Lesen/Schreiben

Legt die maximale Anzahl der Zeichen fest, die in das Kennwortfeld des input-Elements eingegeben werden kann. In der Praxis geben Browser einen Signalton oder eine andere Warnung aus, wenn ein eingegebenes Zeichen den Wert maxLength überschreitet. Zwischen den Eigenschaften maxLength und size besteht keine Wechselbeziehung. Wenn der Wert von maxLength mehr Zeichen zulässt, als für die definierte Elementgröße möglich sind, kann das Feld im Browser horizontal gerollt werden, um es zu bearbeiten bzw. Text einzugeben (dies ist für den Benutzer jedoch umständlich).

 
Beispiel
 
document.entryForm.myPassword.maxLength = 35;
 
Wert

Ganzzahliger Wert.

 
Standardwert

Unbegrenzt.

nameNN 2 IE 3 DOM 1

Lesen/Schreiben

Dies ist der dem Formularsteuerelement zugeordnete Bezeichner. Der Wert dieser Eigenschaft wird beim Senden des Formulars an den Server als eine Hälfte des Namens-/Wertpaars übertragen. Namen werden dem Benutzer nicht angezeigt, da die Beschriftungen für Steuerelemente, abhängig von der Art des Steuerelements, über andere Wege zugewiesen werden. Namen von Formularsteuerelementen können auch durch Referenzen in Skripts mit den Objekten verknüpft werden. Obwohl in modernen Standards das id-Attribut bevorzugt wird, setzen viele Browser beim Übertragen des Wertes eines Steuerelements noch immer voraus, dass dem Formularsteuerelement ein name-Attribut zugeordnet ist.

 
Beispiel
 
document.orderForm.myPassword.name = "pw";
 
Wert

Ein von der Groß-/Kleinschreibung abhängiger Bezeichner, der den Regeln der Bezeichnerbenennung folgt: Er darf keine Leerzeichen enthalten, nicht mit einer Ziffer beginnen und sollte keine Satzzeichen enthalten (mit Ausnahme des Unterstrichs).

 
Standardwert

Keiner.

readOnlyNN 6 IE 4 DOM 1

Schreibgeschützt

Legt fest, ob das Element auf der Seite vom Benutzer bearbeitet werden kann. Der Inhalt eines Formularsteuerelements, dessen readOnly-Eigenschaft auf true gesetzt ist, kann zwar nicht vom Benutzer geändert werden, Änderungen durch Skripts sind jedoch möglich.

 
Beispiel
 
if (document.forms[0].myPassword.readOnly ) {
    ...
};
 
Wert

Boolescher Wert: true | false.

 
Standardwert

false

selectionEnd, selectionStartNN 6 IE nicht zutreffend DOM nicht zutreffend

Lesen/Schreiben

Die Hilfseigenschaften selectionEnd und selectionStart wurden in Netscape 6 eingeführt. Sie ermöglichen es einem Skript, die Endpositionen einer Textauswahl innerhalb eines textorientierten Eingabeelements abzurufen und festzulegen. Ihre Werte sind bei Null beginnende ganze Zahlen, die Positionen zwischen zwei Zeichen innerhalb des Eingabetextes in einem Feld angeben. Wenn beide Eigenschaften denselben Wert aufweisen, wirkt die Textauswahl wie eine Texteinfügemarke. Wenn Sie beispielsweise den Cursor an das Ende eines Textfelds setzen möchten, setzen Sie die beiden Werte auf die Textlänge des Elements (siehe textLength-Eigenschaft). Die äquivalente IE-Funktionalität erfordert das Erstellen eines IE-Textbereichs im Element, Anpassen der Bereichsendpunkte und Auswählen des Bereichs (siehe TextRange-Objekt).

 
Beispiel
 
var elem = document.forms[0].myPassword;
elem.selectionEnd = elem.textLength;
elem.selectionStart = elem.textLength;
 
Wert

Eine positive ganze Zahl.

 
Standardwert

Keiner.

sizeNN 6 IE 4 DOM 1

Lesen/Schreiben

Grob gesagt ist dies die Zeichenbreite, für die das Eingabefeld ausgelegt werden muss. In der Praxis sagt der Browser die Breite häufig ungenau voraus, auch wenn alle Zeichen identisch sind wie z. B. im password-Objekt. Weitere Informationen finden Sie in der Abhandlung des size-Attributs für das input-Element in Kapitel 8. Bei diesem Element gibt es keine Wechselbeziehung zwischen den Eigenschaften size und maxLength.

 
Beispiel
 
document.forms[0].myPassword.size = 12;
 
Wert

Eine ganze Zahl.

 
Standardwert

20

textLengthNN 6 IE nicht zutreffend DOM nicht zutreffend

Schreibgeschützt

Die in Netscape 6 eingeführte Hilfseigenschaft textLength gibt die Länge des in das Textfeld eingegebenen Textes zurück. Der Wert entspricht der Länge der value-Eigenschaft.

 
Beispiel
 
var elem = document.forms[0].myPassword;
elem.selectionEnd = elem.textLength;
elem.selectionStart = elem.textLength;
 
Wert

Eine positive ganze Zahl.

 
Standardwert

Keiner.

typeNN 3 IE 4 DOM 1

Schreibgeschützt

Gibt den Typ des Formularsteuerelements zurück. Der Wert wird ausschließlich in Kleinbuchstaben zurückgegeben. Es kann notwendig sein, alle Formularsteuerelemente bei einer Suche nach bestimmten Typen zu durchlaufen, um eine Verarbeitung auszuführen (z. B. das Entfernen von Inhalten aus allen Formularsteuerelementen des Typs "text", während alle anderen Steuerelemente unberührt bleiben).

 
Beispiel
 
if (document.forms[0].elements[3].type == "password") {
    // process password input type here
}
 
Wert

Eine der folgenden Konstanten als Zeichenfolge: button | checkbox | file | hidden | image | password | radio | reset | select-multiple | select-one | submit | text | textarea.

 
Standardwert

password

valueNN 2 IE 3 DOM 1

Lesen/Schreiben

Gibt den aktuellen Wert an, der mit dem Formularsteuerelement verknüpft ist, das mit dem Namens-/Wertpaar des Elements gesendet wird. Alle Werte sind Zeichenfolgen. Browser geben die vom Benutzer eingegebenen Zeichen zurück (eine Ausnahme bildet Navigator 2), so dass Sie ein eingegebenes Kennwort abrufen und vor dem Abschicken weiterverarbeiten (oder im Cookie speichern) können.

 
Beispiel
 
document.forms[0].myPassword.value = "franken";
 
Wert

Zeichenfolge.

 
Standardwert

Keiner.

createTextRange( )NN nicht zutreffend IE 4(Win) DOM nicht zutreffend

Erstellt ein TextRange-Objekt, das den im Feld angegebenen Text enthält. Weitere Informationen finden Sie unter dem Objekt TextRange.

 
Parameter

Keine.

 
Zurückgegebener Wert

TextRange-Objekt.

handleEvent( )NN |4| IE nicht zutreffend DOM nicht zutreffend

handleEvent(event)

Weist das Objekt an, ein Ereignis, dessen Spezifikationen als Parameter an die Methode übergeben werden, zu akzeptieren und zu verarbeiten. Das Objekt muss eine Ereignisbehandlungsroutine für den Ereignistyp besitzen, um das Ereignis verarbeiten zu können. Nur Navigator 4.

 
Parameter
 
  • Ein event-Objekt von Navigator 4.
 
Zurückgegebener Wert

Keiner.

select( )NN 2 IE 3 DOM 1

Wählt den gesamten Text aus, der im Formularelement angezeigt wird. In der Regel muss das Element vor dem Aufruf dieser Methode den Fokus haben.

 
Parameter

Keine.

 
Zurückgegebener Wert

Keiner.