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 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Objektspezifische Methoden | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Objektspezifische Ereignisbehandlungsroutineneigenschaften | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
accept | NN 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. |
defaultValue | NN 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. |
form | NN 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. |
name | NN 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. |
size | NN 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 |
type | NN 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 |
value | NN 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 | |
|
|
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. |