input (type="file")NN 3 IE 4 DOM 1

Das fileUpload-Objekt ist ein Formularsteuerelement, das mit einem input-Element erstellt wird, dessen type-Attribut auf "file" gesetzt ist. Der Begriff "fileUpload" selbst erscheint im Skript nicht, aber dies ist die Art und Weise, in der Netscape in den ersten skriptfähigen Versionen üblicherweise auf dieses Objekt verwiesen hat.

 

Zum Übertragen einer Datei sollte das method-Attribut des Formularelements auf POST und sein enctype-Attribut auf multipart/form-data gesetzt werden. Außerdem muss jedoch der Server so programmiert werden, dass er die eingehenden Daten in der richtigen Weise verarbeitet.

 
HTML-Äquivalent
 
<input type="file">
 
Objektmodellreferenz
 
[window.]document.formName.elementName
[window.]document.forms[i].elements[i]
[window.]document.getElementById("elementID")
 
Objektspezifische Eigenschaften
 
acceptdefaultValueformnamesizetypevalue
 
Objektspezifische Methoden
 
handleEvent( )select( )
 
Objektspezifische Ereignisbehandlungsroutineneigenschaften
 
BehandlungsroutineNNIEDOM
onblur342
onchange342
onclick642
onfocus342
onkeydown64--
onkeypress64--
onkeyup64--
onmousedown642
onmousemove642
onmouseout642
onmouseover642
onmouseup642
onselect342
acceptNN 6 IE 4 DOM 1

Lesen/Schreiben

Stellt eine optionale Hilfseigenschaft bereit, die aus einer Zeichenfolge mit einem oder mehreren durch Kommas voneinander getrennten MIME-Typen der hochzuladenden Dateien besteht. Die Werte haben in aktuellen Browsern keinen Einfluss auf dieses Element.

 
Beispiel
 
document.entryForm.myFileUpload.accept = "image/gif";
 
Wert

Zeichenfolge.

 
Standardwert

Keiner.

defaultValueNN 4 IE 4 DOM nicht zutreffend

Lesen/Schreiben

Gibt die dem value-Attribut des Elements im Quellcode zugewiesene Zeichenfolge zurück (außer in IE für Windows, der eine leere Zeichenfolge zurückgibt). Da der Benutzer die hochzuladende Datei von Hand auswählen muss, ist es nicht notwendig, eine Voreinstellung festzulegen oder diesen Wert zu ändern.

 
Beispiel
 
var initVal = document.entryForm.myFileUpload.defaultValue;
 
Wert

Zeichenfolge.

 
Standardwert

Keiner.

formNN 3 IE 4 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.

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.myFileChoice.name = "Win32File";
 
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.

sizeNN 6 IE 4 DOM 1

Lesen/Schreiben

Gibt grob gesagt die Textbreite in Zeichen an, für die das Eingabefeld ausgelegt werden muss. In der Praxis geben die Browser nicht immer die genaue Breite an, wenn eine Proportionalschrift verwendet wird. Ausführliche Informationen finden Sie in der Abhandlung des size-Attributs für das input-Element in Kapitel 8. Diese Eigenschaft ist in IE 4 für den Macintosh nicht verfügbar.

 
Beispiel
 
document.forms[0].myFileUpload.size = 60;
 
Wert

Eine ganze Zahl.

 
Standardwert

20

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 == "file") {
    // process file 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

file

valueNN 2 IE 3 DOM 1

Schreibgeschützt

Gibt den aktuellen Wert an, der mit dem Formularsteuerelement verknüpft ist, das mit dem Namens-/Wertpaar des Elements gesendet wird. Bei einem fileUpload-Objekt ist dieser Wert der URL-kodierte vollständige Pfadname zu einer lokalen Datei. Dies gilt auch für die Macintosh-Browserversionen, die dazu tendieren, nur den Dateinamen in der Formularelementanzeige anzuzeigen. Während dieser Eigenschaft in manchen Browsern neue Werte zugewiesen werden können, werden nur die durch eine explizite Auswahl des Benutzers im Dateimenü zugewiesenen Werte übertragen.

 
Wert

Zeichenfolge.

 
Standardwert

Keiner.

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 3 IE 4 DOM nicht zutreffend

Wählt den gesamten Text aus, der im Formularelement angezeigt wird.

 
Parameter

Keine.

 
Zurückgegebener Wert

Keiner.