input (type="file") | NN 3 IE 4 DOM 1
L'objet fileUpload est un contrôle de formulaire généré à l'aide de l'élément input dont l'attribut type est paramétré sur "file". Le terme « fileUpload » n'apparaît pas dans les scripts; c'est cependant celui que Netscape utilisait occasionnellement pour faire référence à cet objet au début de prise en charge par les scripts.
Pour envoyer un fichier, l´attribut method de l´élément doit être défini sur POST et l´attribut enctype sur multipart/form-data. Mais une programmation au niveau serveur est aussi nécessaire pour traiter les données entrantes correctement.
Equivalent HTML
    <input type="file">
Référence de modèle d'objet
    [window.]document.formName.elementName
    [window.]document.forms[i].elements[i]
    [window.]document.getElementById("elementID")
Propriétés spécifiques à l´objet
accept | defaultValue | form | name | size | type | value
Méthodes spécifiques à l´objet
handleEvent() | select()
Propriétés de gestionnaire d´événements spécifiques à l´objet
Gestionnaire | NN | IE | DOM
onblur | 3 | 4 | 2
onchange | 3 | 4 | 2
onclick | 6 | 4 | 2
onfocus | 3 | 4 | 2
onkeydown | 6 | 4 | s.o
onkeypress | 6 | 4 | s.o
onkeyup | 6 | 4 | s.o
onmousedown | 6 | 4 | 2
onmousemove | 6 | 4 | 2
onmouseout | 6 | 4 | 2
onmouseover | 6 | 4 | 2
onmouseup | 6 | 4 | 2
onselect | 3 | 4 | 2

accept | NN 6 IE 4 DOM 1
| Lecture/écriture
Fournit une propriété facultative, donnant des informations, et se composant d´une chaîne d´un ou plusieurs types de fichiers MIME séparés par des virgules en cours de chargement. Les valeurs n´ont aucun effet sur l´élément dans les navigateurs actuels.
Exemple
    document.entryForm.myFileUpload.accept = "image/gif";
Valeur
Chaîne.
Par défaut
Aucune.

defaultValue | NN 4 IE 4 DOM s.o.
| Lecture/écriture
Renvoie la chaîne affectée à l´attribut value de l´élément dans le code source (sauf dans IE pour Windows, qui renvoie une chaîne vide). Un utilisateur doit sélectionner manuellement un fichier à charger, il est donc inutile de prédéfinir ou d´essayer de modifier cette valeur.
Exemple
    var initVal = document.entryForm.myFileUpload.defaultValue;
Valeur
Chaîne.
Par défaut
Aucune.

form | NN 3 IE 4 DOM 1
| Lecture seule
Renvoie une référence à l'élément form qui contient l'élément courant (le cas échéant). Lors du traitement d´un événement à partir de cet élément, la fonction de gestionnaire d´événements a automatiquement accès à l´élément input (en tant que propriété target ou srcElement de l´objet événement). En lisant la propriété form, le script peut facilement accéder à d´autres contrôles dans le même formulaire.
Exemple
    var theForm = evt.srcElement.form;
Valeur
Référence de l'objet élément form.
Par défaut
Aucune.

name | NN 2 IE 3 DOM 1
| Lecture/écriture
Identifiant associé au contrôle du formulaire. Lors de l'envoi du formulaire au serveur, la valeur de cette propriété est envoyée comme une moitié de la paire nom / valeur. Les noms sont masqués à la vue de l'utilisateur, les étiquettes de contrôle étant affectées par d'autres moyens, en fonction du type de contrôle. Les noms de contrôle de formulaire peuvent également être utilisés dans des instructions de script faisant référence à des objets. Bien que les normes modernes préfèrent l´attribut id, de nombreux navigateurs nécessitent encore qu´un attribut name soit affecté à un contrôle de formulaire pour que la valeur de ce dernier puisse être envoyée.
Exemple
    document.orderForm.myFileChoice.name = "Win32File";
Valeur
Identifiant sensible à la casse, sous forme de chaîne, conforme aux règles de dénomination des identifiants: il ne peut pas contenir d'espace blanc ni de signe de ponctuation, à l'exception du caractère de soulignement, et ne peut pas commencer par un chiffre.
Par défaut
Aucune.

size | NN 6 IE 4 DOM 1
| Lecture/écriture
Grosso modo, indique la largeur en caractères que devrait avoir la partie du champ de texte input pour correspondre à la taille du fichier de l'élément input. Dans la pratique, le navigateur ne prévoit pas toujours la largeur correcte en cas d'utilisation d'une police proportionnelle. Reportez-vous aux détails de la section consacrée à l´attribut size dans le chapitre 8 pour l´élément input. Cette propriété n´est pas disponible dans IE 4 pour Macintosh.
Exemple
    document.forms[0].myFileUpload.size = 60;
Valeur
Nombre entier.
Par défaut
20

type | NN 3 IE 4 DOM 1
| Lecture seule
Renvoie le type de l'élément contrôle de formulaire. La valeur renvoyée s'affiche en lettres minuscules. Il peut être nécessaire de parcourir successivement tous les éléments du formulaire à la recherche de types spécifiques à traiter (par exemple vider tous les contrôles de formulaire de type "text" sans modifier les autres contrôles).
Exemple
    if (document.forms[0].elements[3].type == "file") {
        // process file input type here
    }
Valeur
L'une des constantes suivantes (sous forme de chaîne): button | checkbox | file | hidden | image | password | radio | reset | select-multiple | select-one | submit | text | textarea.
Par défaut
file

value | NN 2 IE 3 DOM 1
| Lecture seule
Fournit la valeur courante associée au contrôle de formulaire envoyé avec la paire nom/valeur de cet élément. Pour un objet fileUpload, cette valeur est le nom de chemin complet de l'adresse URL du fichier local. C'est également vrai des navigateurs pour Macintosh, qui ne présentent généralement que le nom du fichier dans l'affichage de l'élément de formulaire. Bien que dans certains navigateurs la propriété accepte des affectations de valeurs nouvelles, seules les valeurs affectées à la suite d´un choix explicite de menu fichier par l´utilisateur sont envoyées.
Valeur
Chaîne.
Par défaut
Aucune.

handleEvent() | NN |4| IE s.o. DOM n/a
handleEvent(événement) |
Indique à l'objet qu´il doit accepter et traiter l'événement dont les spécifications sont passées à la méthode sous forme de paramètre. Pour pouvoir traiter l'événement, l'objet doit disposer d'un gestionnaire d'événements pour ce type d'événement. Navigator 4 uniquement.
Paramètres
Objet event de Navigator 4.
Valeur renvoyée
Aucune.

select() | NN 3 IE 4 DOM s.o.
Sélectionne tout le texte affiché dans l'élément formulaire.
Paramètres
Aucune.
Valeur renvoyée
Aucune.