SWFUploadEs ist ein Datei-Upload-Plugin, das Flash und JavaScript kombiniert, und sein Funktionsumfang ist sehr leistungsstark. Ich habe es zuvor mehrere Male in Projekten verwendet, aber seine Konfigurationsparameter sind zu viele. Nach einmaliger Verwendung vergesse ich, wie man es benutzt, und wenn ich es später brauche, muss ich auf die offizielle Website gehen, um seine Dokumentation zu lesen, was wirklich nervig ist. Also habe ich einfach seine Verwendung aufgezeichnet, was auch für Studenten mit schlechtem Englisch praktisch zum Nachschlagen ist. Es nützt sowohl mir als auch anderen und löst das Problem ein für alle Mal.
Funktionen von SWFUpload
- 1. Upload mit Flash, kein Seitenneuladen, und der Stil des Flash-Buttons kann angepasst werden;
- 2. Die hochzuladenden Dateien können browserseitig eingeschränkt werden;
- 3. Ermöglicht das Hochladen mehrerer Dateien auf einmal, aber es gibt eine Upload-Warteschlange. Dateien in der Warteschlange werden nacheinander hochgeladen. Serverseitig werden Dateien auf die gleiche Weise empfangen wie bei einem normalen Formular-Datei-Upload;
- 4. Bietet umfangreiche Event-Schnittstellen zur Nutzung durch Entwickler;
Dateiupload-Prozess von SWFUpload:
- 1. Binden Sie die entsprechende JS-Datei ein
- 2. Instanziieren Sie das SWFUpload-Objekt und übergeben Sie ein Konfigurationsparameter-Objekt für verschiedene Konfigurationen.
- 3. Klicken Sie auf den von SWFUpload bereitgestellten Flash-Button, und ein Dateiauswahlfenster öffnet sich, um die hochzuladenden Dateien auszuwählen;
- 4. Nach der Dateiauswahl werden die Dateien, die den Anforderungen entsprechen, zur Upload-Warteschlange hinzugefügt;
- 5. Rufen Sie die Methode startUpload auf, um mit dem Hochladen der Dateien in der Warteschlange zu beginnen;
- 6. Während des Datei-Upload-Prozesses werden entsprechende Ereignisse ausgelöst. Entwickler verwenden diese Ereignisse, um die UI zu aktualisieren, Fehler zu behandeln, Hinweise anzuzeigen und so weiter;
SWFUpload besteht aus drei Teilen: SWFUpload.js, swfupload.swf, Initialisierungskonfigurationsparametern und verschiedenen Ereignisbehandlungsfunktionen. Binden Sie also zuerst SWFUpload.js in die Seite ein
<script src='SWFUpload.js.html'></script>
Instanziieren Sie dann ein SWFUpload-Objekt:
var swfu;
window.onload = function () {
var settings_object = {//定义参数配置对象
upload_url : "http://www.swfupload.org/upload.php",
flash_url : "http://www.swfupload.org/swfupload.swf",
file_post_name : "Filedata",
post_params : {
"post_param_name_1" : "post_param_value_1",
"post_param_name_2" : "post_param_value_2",
"post_param_name_n" : "post_param_value_n"
},
use_query_string : false,
requeue_on_error : false,
http_success : [201, 202],
assume_success_timeout : 0,
file_types : "*.jpg;*.gif",
file_types_description: "Web Image Files",
file_size_limit : "1024",
file_upload_limit : 10,
file_queue_limit : 2,
debug : false,
prevent_swf_caching : false,
preserve_relative_urls : false,
button_placeholder_id : "element_id",
button_image_url : "http://www.swfupload.org/button_sprite.png",
button_width : 61,
button_height : 22,
button_text : "<b>Click</b> <span class="redText">here</span>",
button_text_style : ".redText { color: #FF0000; }",
button_text_left_padding : 3,
button_text_top_padding : 2,
button_action : SWFUpload.BUTTON_ACTION.SELECT_FILES,
button_disabled : false,
button_cursor : SWFUpload.CURSOR.HAND,
button_window_mode : SWFUpload.WINDOW_MODE.TRANSPARENT,
swfupload_loaded_handler : swfupload_loaded_function,
file_dialog_start_handler : file_dialog_start_function,
file_queued_handler : file_queued_function,
file_queue_error_handler : file_queue_error_function,
file_dialog_complete_handler : file_dialog_complete_function,
upload_start_handler : upload_start_function,
upload_progress_handler : upload_progress_function,
upload_error_handler : upload_error_function,
upload_success_handler : upload_success_function,
upload_complete_handler : upload_complete_function,
debug_handler : debug_function,
};
swfu = new SWFUpload(settings_object);//实例化一个SWFUpload,传入参数配置对象
};
/*定义各种事件监听函数*/
function swfupload_loaded_function(){}
function file_dialog_start_function(){}
...等等
Wir können sehen, dass die Implementierung einer SWFUpload-Upload-Funktion sehr einfach ist: Man instanziiert einfach ein SWFUpload-Objekt. Der mühsame Teil ist jedoch das bei der Instanziierung verwendete Konfigurationsparameterobjekt sowie der Zeitpunkt verschiedener Ereignisse und die von ihnen bereitgestellten Parameter. Damit kommen wir zum entscheidenden Punkt. Die folgenden Tabellen listen die Dinge auf, die in der Entwicklung häufig verwendet werden. Obwohl es bereits ziemlich viele sind, sind sie nicht alles in SWFUpload. Ich habe nur die häufig verwendeten aufgeführt. Für die vollständige Dokumentation besuchen Sie bitte die offizielle SWFUpload-Website.
Häufige Attribute und Beschreibungen im SWFUpload-Konfigurationsparameterobjekt
| Eigenschaft | Type | Standardwert | Beschreibung |
| upload_url | String | Die URL-Adresse der serverseitigen Seite, die die hochgeladene Datei verarbeitet. Sie kann eine absolute Adresse oder eine relative Adresse sein. Wenn es sich um eine relative Adresse handelt, bezieht sie sich auf die Dokumentadresse, in der sich der aktuelle Code befindet. | |
| preserve_relative_urls | Boolean | false | Wenn false, konvertiert SWFUpload die von swfupload.swf verwendeten relativen Adressen für eine bessere Kompatibilität in absolute Adressen. |
| file_post_name | String | Filedata | Entspricht dem name-Attribut beim Hochladen von Dateien mit einem normalen Dateifeld. Die serverseitige Empfangsseite verwendet diesen Namen, um die hochgeladene Datei zu erhalten. |
| post_params | Objekt (Literal) | Ein Objektliteral. Seine Schlüssel/Wert-Paare werden zusammen mit jeder Datei hochgeladen. Es ist sehr nützlich, wenn Sie zusätzliche Informationen an Datei-Uploads anhängen müssen. | |
| use_query_string | Boolean | false | Wenn false, werden die durch das Attribut post_params definierten Parameter per POST hochgeladen; wenn true, werden sie per GET hochgeladen (das heißt, die Parameter werden als Query-String an die URL angehängt). |
| file_types | String | Dieses Attribut legt die erlaubten Dateitypen für den Upload fest. Bei mehreren Typen trennen Sie diese durch Semikolons, zum Beispiel: *.jpg;*.png. Verwenden Sie *.*, um alle Typen zuzulassen. | |
| file_types_description | String | Legt die Dateitypbeschreibung fest, die im Dateiauswahlfenster angezeigt wird und als Hinweis und Erklärung dient. | |
| file_size_limit | String | Legt die maximale Größe der hochzuladenden Datei fest. Einheiten sind erlaubt. Gültige Einheiten sind: B, KB, MB, GB. Wenn die Einheit weggelassen wird, ist der Standardwert KB. Wenn dieses Attribut 0 ist, bedeutet dies, dass es keine Begrenzung der Dateigröße gibt. | |
| file_upload_limit | Number | Legt die maximale Anzahl von Dateien fest, die hochgeladen werden können. Wenn die Anzahl der erfolgreich hochgeladenen Dateien dieses Maximum erreicht, können keine weiteren Dateien mehr hochgeladen und auch keine Dateien mehr zur Upload-Warteschlange hinzugefügt werden. Wenn dieses Attribut auf 0 gesetzt wird, bedeutet dies, dass es keine Begrenzung der Anzahl hochgeladener Dateien gibt. | |
| file_queue_limit | Number | Legt die maximale Anzahl von Dateien fest, die gleichzeitig in der Datei-Upload-Warteschlange gespeichert werden können. Wenn diese Anzahl überschritten wird, können andere Dateien erst dann hinzugefügt werden, nachdem eine entsprechende Anzahl von Dateien in der Warteschlange erfolgreich hochgeladen wurde, auf einen Fehler gestoßen ist oder abgebrochen wurde. Wenn der Wert von file_upload_limit oder die verbleibende Anzahl der Dateien, die hochgeladen werden können, kleiner als file_queue_limit ist, wird der kleinere Wert verwendet. | |
| flash_url | String | Die absolute oder relative Adresse der Datei swfupload.swf. Eine relative Adresse bezieht sich auf die Adresse der aktuellen Seite. Nach der Instanziierung von SWFUpload kann der Wert dieses Attributs nicht mehr geändert werden. | |
| prevent_swf_caching | Boolean | Wenn true, wird nach der Adresse swfupload.swf eine Zufallszahl eingefügt, um zu verhindern, dass der Flash-Film zwischengespeichert wird. Dies soll Fehler verhindern, die in einigen Versionen von IE-Browsern beim Lesen zwischengespeicherter Flash-Filme auftreten. | |
| button_placeholder_id | String | Gibt die ID eines DOM-Elements an. Dieses DOM-Element wird durch den Flash-Button ersetzt, nachdem SWFUpload instanziiert wurde. Dieses DOM-Element dient als Platzhalter. | |
| button_placeholder | DOMElement | Gibt ein DOM-Element an. Dieses DOM-Element wird durch den Flash-Button ersetzt, nachdem SWFUpload instanziiert wurde. Dieses DOM-Element dient als Platzhalter. Wenn sowohl button_placeholder_id als auch button_placeholder vorhanden sind, hat button_placeholder_id Vorrang. | |
| button_image_url | String | Gibt das Hintergrundbild des Flash-Buttons an. Sowohl eine relative als auch eine absolute Adresse ist zulässig. Diese Adresse wird vom Attribut preserve_relative_urls beeinflusst und folgt denselben Regeln wie upload_url. Das Hintergrundbild muss ein Sprite-Bild sein. Von oben nach unten enthält es die vier Zustände des Flash-Buttons: normal, Mauszeiger darüber, gedrückt und deaktiviert. Daher sollte die Höhe dieses Bildes das Vierfache der Höhe des Flash-Buttons betragen. | |
| button_width | Number | Gibt die Breite des Flash-Buttons an. | |
| button_height | Number | Gibt die Höhe des Flash-Buttons an. Sie sollte 1/4 der Höhe des durch button_image_url angegebenen Button-Hintergrundbilds betragen. | |
| button_text | String | Gibt den Text auf dem Flash-Button an. Es kann auch HTML-Code sein. | |
| button_text_style | String | Der Stil des Textes auf dem Flash-Button. Siehe das Beispiel für die Verwendung. | |
| button_text_top_padding | Number | Gibt den oberen Innenabstand des Flash-Buttons an. Negative Werte können verwendet werden. | |
| button_text_left_padding | Number | Legt den linken Innenabstand der Flash-Schaltfläche fest. Negative Werte können verwendet werden. | |
| button_disabled | Boolean | false | Wenn true, wird die Flash-Schaltfläche deaktiviert, und ein Klick darauf löst kein Verhalten aus. |
| button_cursor | Legt den Cursorstil fest, wenn die Maus über die Flash-Schaltfläche bewegt wird. Die verfügbaren Werte sind die in SWFUpload.CURSOR definierten Konstanten. | ||
| button_window_mode | Legt das WMODE-Attribut der Flash-Schaltfläche fest. Die verfügbaren Werte sind die in SWFUpload.WINDOW_MODE definierten Konstanten. | ||
| file_dialog_start_handler | Funktion | fileDialogStart-Ereignislistener-Funktion | |
| file_queued_handler | Funktion | fileQueued-Ereignislistener-Funktion | |
| file_queue_error_handler | Funktion | fileQueueError-Ereignislistener-Funktion | |
| file_dialog_complete_handler | Funktion | fileDialogComplete-Ereignislistener-Funktion | |
| upload_start_handler | Funktion | Event-Listener-Funktion für uploadStart | |
| upload_progress_handler | Funktion | Event-Listener-Funktion für uploadProgress | |
| upload_error_handler | Funktion | Event-Listener-Funktion für uploadError | |
| upload_success_handler | Funktion | Event-Listener-Funktion für uploadSuccess | |
| upload_complete_handler | Funktion | Event-Listener-Funktion für uploadComplete |
Erläuterung verschiedener SWFUpload-Ereignisse
| fileDialogStart ( ) | ||
| Wird ausgelöst, wenn das Fenster zur Dateiauswahl kurz vor dem Öffnen steht. | ||
| fileQueued ( Dateiobjekt ) | ||
| Dieses Ereignis wird ausgelöst, wenn eine Datei zur Upload-Warteschlange hinzugefügt wird. Der einzige bereitgestellte Parameter ist das Dateiobjekt, das die Dateiinformationen enthält. | ||
| fileQueueError ( Dateiobjekt, Fehlercode, Meldung ) | ||
| Dieses Ereignis wird ausgelöst, wenn eine Datei nicht zur Upload-Warteschlange hinzugefügt werden kann. Die Gründe für das Fehlschlagen können sein, dass die Dateigröße den zulässigen Wert überschreitet, die Datei leer ist oder die Dateiwarteschlange bereits voll ist usw. Dieses Ereignis stellt drei Parameter bereit. Der erste Parameter ist das Dateiobjekt, bei dem derzeit das Problem auftritt, und der zweite Parameter ist der spezifische Fehlercode; hierfür können die in SWFUpload.QUEUE_ERROR definierten Konstanten herangezogen werden. | ||
| fileDialogComplete ( Anzahl der ausgewählten Dateien, Anzahl der in die Warteschlange gestellten Dateien, Gesamtzahl der Dateien in der Warteschlange ) | ||
| Dieses Ereignis wird unmittelbar ausgelöst, nachdem die Dateiauswahl abgeschlossen und die ausgewählten Dateien verarbeitet wurden (d. h. zur Upload-Warteschlange hinzugefügt wurden). Sie können in diesem Ereignis die Methode this.startUpload() aufrufen, um einen automatischen Dateiupload zu implementieren. Der Parameter Anzahl der ausgewählten Dateien gibt die Anzahl der in diesem Durchgang im Dateiauswahldialog ausgewählten Dateien an. Der Parameter Anzahl der in die Warteschlange gestellten Dateien gibt die Anzahl der diesmal zur Upload-Warteschlange hinzugefügten Dateien an. Der Parameter Gesamtzahl der Dateien in der Warteschlange gibt an, wie viele Dateien sich derzeit in der Upload-Warteschlange befinden (einschließlich der diesmal hinzugefügten Dateien). | ||
| uploadStart ( Dateiobjekt ) | ||
| Dieses Ereignis wird ausgelöst, wenn eine Datei gerade hochgeladen werden soll. Dieses Ereignis gibt Ihnen die letzte Gelegenheit, bevor die Datei hochgeladen wird, Dateiinformationen zu validieren, zusätzliche Informationen zum Hochladen mit der Datei hinzuzufügen oder andere Arbeiten auszuführen. Sie können den Upload dieser Datei abbrechen, indem Sie false zurückgeben. Der Parameter file object ist das Informationsobjekt der Datei, die gerade hochgeladen wird. | ||
| uploadProgress ( file object, bytes complete, total bytes ) | ||
| Dieses Ereignis wird während des Datei-Upload-Prozesses wiederholt ausgelöst. Sie können dieses Ereignis verwenden, um einen Upload-Fortschrittsbalken zu implementieren. Der Parameter file object ist das Dateiinformationsobjekt. Der Parameter bytes complete ist die Anzahl der bisher hochgeladenen Bytes. Der Parameter total bytes ist die Gesamtzahl der Bytes in der Datei. | ||
| uploadError ( file object, error code, message ) | ||
| Dieses Ereignis wird ausgelöst, wenn der Datei-Upload unterbrochen wird oder die Datei nicht erfolgreich hochgeladen werden kann. Das Stoppen oder Abbrechen des Datei-Uploads oder die Rückgabe von false im uploadStart-Ereignis löst dieses Ereignis aus. Wenn eine Datei jedoch abgebrochen wird, aber weiterhin in der Warteschlange verbleibt, wird dieses Ereignis nicht ausgelöst. Der Parameter file object ist das Dateiinformationsobjekt. Der Parameter error code ist der Fehlercode. Einzelheiten finden Sie in den Konstanten, die in SWFUpload.UPLOAD_ERROR definiert sind. | ||
| uploadSuccess ( file object, server data, received response ) | ||
| Dieses Ereignis wird ausgelöst, nachdem eine Datei erfolgreich hochgeladen wurde. Der Parameter file object ist das Dateiinformationsobjekt. Die Parameter-Server-Daten sind die vom Server ausgegebenen Daten. | ||
| uploadComplete( Dateiobjekt ) | ||
| Dieses Ereignis wird ausgelöst, wenn ein Datei-Uploadvorgang abgeschlossen ist (ob erfolgreich oder nicht). Dieses Ereignis zeigt an, dass der aktuelle Upload abgeschlossen wurde und die nächste Datei in der Upload-Warteschlange mit dem Hochladen beginnen kann. Nachdem dieses Ereignis eintritt, startet der Upload der nächsten Datei in der Warteschlange. |
Methoden der SWFUpload-Instanz
Die meisten Methoden ändern dynamisch das Parameter-Konfigurationsobjekt.
| destroy ( ) | ||
| Wenn SWFUpload nicht mehr benötigt wird, können Sie diese Methode verwenden, um seine Instanz und DOM-Elemente zu zerstören. | ||
| startUpload( file_id ) | ||
| Startet das Hochladen der angegebenen Datei in der Warteschlange. Der Parameter file_id repräsentiert die ID der hochzuladenden Datei. Wenn dieser Parameter nicht angegeben wird, wird die erste Datei in der Warteschlange hochgeladen. | ||
| cancelUpload ( file_id, trigger_error_event ) | ||
| Bricht den Upload einer Datei ab. Der Parameter file_id ist die ID der abzubrechenden Datei. Wenn dieser Parameter nicht definiert oder nicht angegeben ist, wird die erste Datei in der Warteschlange abgebrochen. Der Parameter trigger_error_event akzeptiert einen booleschen Wert. Wenn er false ist, löst das Abbrechen einer Datei nicht das uploadError-Ereignis aus. Der Standardwert ist true. | ||
| stopUpload ( ) | ||
| Beendet die aktuell hochladende Datei. Dies löst das uploadError-Ereignis aus. Wenn derzeit keine Datei hochgeladen wird, bewirkt diese Methode nichts. | ||
| getStats ( ) | ||
| Ruft das Stats-Objekt der Warteschlange ab. | ||
| setStats ( stats_object ) | ||
| Ändert das stats_object der Warteschlange. Übergeben Sie das geänderte stats_object als Parameter. | ||
| getFile ( file_id|index ) | ||
| Ruft ein File-Objekt basierend auf der Datei-ID oder dem Dateiindex ab. Bei Verwendung der Datei-ID können nur Dateien in der Warteschlange abgerufen werden. Bei Verwendung des Dateiindex können alle Dateien (einschließlich solcher innerhalb und außerhalb der Warteschlange) abgerufen werden. | ||
| addPostParam ( name, value) | ||
| Fügt dem zusätzlichen Informationsobjekt, das durch post_params im Konfigurationsobjekt angegeben wird, ein Schlüssel/Wert-Paar hinzu. | ||
| removePostParam ( name) | ||
| Entfernt ein Schlüssel-Wert-Paar, das in post_params im Konfigurationsobjekt enthalten ist. Der Parameter name ist der Schlüsselname des zu entfernenden Werts. | ||
| addFileParam ( file_id, name, value) | ||
| Fügt zusätzliche Informationen hinzu, die zusammen mit einer bestimmten Datei hochgeladen werden. Beachten Sie, dass die zusätzlichen Informationen nur hochgeladen werden, wenn die angegebene Datei hochgeladen wird. Die in post_param im Konfigurationsobjekt festgelegten zusätzlichen Informationen werden zusammen mit jedem Datei-Upload gesendet. Der Parameter file_id ist die ID der angegebenen Datei. Die Parameter name und value sind der Name bzw. der Wert der zusätzlichen Informationen. | ||
| removeFileParam ( file_id, name) | ||
| Entfernt die zusätzlichen Informationen, die über die Methode addFileParam hinzugefügt wurden. Ich glaube, ich muss die beiden Parameter nicht weiter erklären. | ||
| setUploadURL ( url) | ||
| Legt den Wert von upload_url im Konfigurationsobjekt dynamisch fest. | ||
| setPostParams ( param_object) | ||
| Legt den Wert der Eigenschaft post_params im Konfigurationsobjekt dynamisch fest. Der neue Wert überschreibt den alten Wert. Der Parameter param_object muss ein Objektliteral sein, und seine Eigenschaften und Werte dürfen nur Zeichenketten sein. | ||
| setFileTypes ( types, description) | ||
| Legen Sie die Werte der Eigenschaften file_types und file_types_description im Konfigurationsobjekt dynamisch fest. Keiner der Parameter kann weggelassen werden. | ||
| setFileSizeLimit ( file_size_limit) | ||
| Legen Sie den Wert der Eigenschaft file_size_limit im Konfigurationsobjekt dynamisch fest. | ||
| setFileUploadLimit ( file_upload_limit) | ||
| Legen Sie den Wert der Eigenschaft file_upload_limit im Konfigurationsobjekt dynamisch fest. | ||
| setFileQueueLimit ( file_queue_limit) | ||
| Legen Sie den Wert der Eigenschaft file_queue_limit im Konfigurationsobjekt dynamisch fest. | ||
| setFilePostName ( file_post_name) | ||
| Legen Sie den Wert der Eigenschaft file_post_name im Konfigurationsobjekt dynamisch fest. | ||
| setUseQueryString ( use_query_string) | ||
| Legen Sie den Wert der Eigenschaft use_query_string im Konfigurationsobjekt dynamisch fest. | ||
| setButtonImageURL ( url) | ||
| Dynamisch den Wert der Eigenschaft button_image_url im Konfigurationsobjekt festlegen. | ||
| setButtonDimensions ( width, height) | ||
| Dynamisch die Breite und Höhe des Flash-Buttons festlegen. Die beiden Parameter sind die Werte für Breite und Höhe, vom numerischen Typ, und dürfen keine Einheiten enthalten. | ||
| setButtonText ( text) | ||
| Dynamisch den Wert der Eigenschaft button_text im Konfigurationsobjekt festlegen. | ||
| setButtonTextStyle ( css_style_text) | ||
| Dynamisch den Wert der Eigenschaft button_text_style im Konfigurationsobjekt festlegen. | ||
| setButtonTextPadding ( left, top ) | ||
| Dynamisch den linken und oberen Innenabstand des Flash-Buttons festlegen. | ||
| setButtonDisabled ( isDisabled ) | ||
| Den Flash-Button dynamisch aktivieren oder deaktivieren. Der Parameter ist ein boolescher Wert. | ||
| setButtonCursor ( buttonCursor ) | ||
| Den Wert von button_cursor im Konfigurationsobjekt dynamisch festlegen. |
Dateiinformationsobjekt (File Object)
In Event-Listener-Funktionen wird das Dateiinformationsobjekt häufig verwendet, um Dateiinformationen für den nächsten Schritt zu erhalten.
| Eigenschaft | Type | Beschreibung |
| id | String | Die von SWFUpload definierte Datei-ID, die zur Steuerung von Datei-Uploads verwendet wird. |
| index | Number | Der Dateiindex, der in der Methode getFile(i) verwendet wird. |
| name | String | Der ursprüngliche Name der Datei, ohne den Pfad. |
| type | String | Dateityp |
| creationdate | Date | Das Erstellungsdatum der Datei |
| modificationdate | Date | Das Datum der letzten Änderung der Datei |
| filestatus | Number | Der aktuelle Status der Datei. Einzelheiten finden Sie in den Konstanten, die in SWFUpload.FILE_STATUS definiert sind. |
Warteschlangen-Statusobjekt (Statistikobjekt)
Wird verwendet, um den aktuellen Status der Warteschlange abzurufen.
| Eigenschaft | Type | Beschreibung |
| in_progress | Number | Der Wert ist 1 oder 0 und gibt an, ob derzeit eine Datei in der Warteschlange hochgeladen wird. |
| files_queued | Number | Die Anzahl der Dateien, die sich derzeit in der Upload-Warteschlange befinden. |
| successful_uploads | Number | Die Anzahl der erfolgreich hochgeladenen Dateien (d. h., das uploadSuccess-Ereignis wurde ausgelöst). |
| upload_errors | Number | Die Anzahl der Dateien, bei denen der Upload fehlgeschlagen ist (einschließlich abgebrochener Uploads). |
| upload_cancelled | Number | Die Anzahl der Dateien, deren Uploads abgebrochen wurden. |
| queue_errors | Number | Die Anzahl der Dateien, die das fileQueueError-Ereignis ausgelöst haben. |
Einige Konstanten
Einige von SWFupload definierte Konstanten zum leichteren Verständnis.
| Konstantenname | Beschreibung |
| SWFUpload.instances | Diese Konstante ist ein Objekt, das eine Sammlung von Referenzen auf alle SWFUpload-Instanzen auf einer Seite darstellt, indiziert durch die Eigenschaft movieName der SWFUpload-Instanz. |
| SWFUpload.movieCount | Die Anzahl der auf der Seite vorhandenen SWFUpload-Instanzen. |
| SWFUpload.QUEUE_ERROR.QUEUE_LIMIT_EXCEEDED | Der Benutzer hat mehr Dateien ausgewählt als die erlaubte Anzahl. |
| SWFUpload.QUEUE_ERROR.FILE_EXCEEDS_SIZE_LIMIT | Die Dateigröße überschreitet die erlaubte Größe. |
| SWFUpload.QUEUE_ERROR.ZERO_BYTE_FILE | Die Datei ist leer. |
| SWFUpload.QUEUE_ERROR.INVALID_FILETYPE | Der Dateityp ist nicht zulässig. |
| SWFUpload.UPLOAD_ERROR.HTTP_ERROR | Der vom Server zurückgegebene Statuscode ist nicht 200. |
| SWFUpload.UPLOAD_ERROR.MISSING_UPLOAD_URL | upload_url ist nicht gesetzt. |
| SWFUpload.UPLOAD_ERROR.IO_ERROR | Beim Lesen oder Übertragen der Datei ist ein Fehler aufgetreten. |
| SWFUpload.UPLOAD_ERROR.SECURITY_ERROR | Der Upload ist aus Sicherheitsgründen eingeschränkt. |
| SWFUpload.UPLOAD_ERROR.UPLOAD_LIMIT_EXCEEDED | Die Anzahl der hochgeladenen Dateien überschreitet das zulässige Maximum. |
| SWFUpload.UPLOAD_ERROR.UPLOAD_FAILED | Ein Upload-Fehler ist aufgetreten. |
| SWFUpload.UPLOAD_ERROR.SPECIFIED_FILE_ID_NOT_FOUND | Die an die Methode startUpload() übergebene Datei-ID existiert nicht. |
| SWFUpload.UPLOAD_ERROR.FILE_VALIDATION_FAILED | In der Methode uploadStart() wurde false zurückgegeben. |
| SWFUpload.UPLOAD_ERROR.FILE_CANCELLED | Der Upload wurde abgebrochen. |
| SWFUpload.UPLOAD_ERROR.UPLOAD_STOPPED | Der Upload wurde beendet. |
| SWFUpload.FILE_STATUS.QUEUED | Die Datei wartet in der Warteschlange auf das Hochladen. |
| SWFUpload.FILE_STATUS.IN_PROGRESS | Die Datei wird hochgeladen. |
| SWFUpload.FILE_STATUS.ERROR | Beim Hinzufügen der Datei zur Warteschlange oder beim Hochladen ist ein Fehler aufgetreten. |
| SWFUpload.FILE_STATUS.COMPLETE | Die Datei wurde erfolgreich hochgeladen. |
| SWFUpload.FILE_STATUS. | Das Hochladen der Datei wurde abgebrochen. |
| SWFUpload.CURSOR.ARROW | Die Maus wird als Pfeil angezeigt. |
| SWFUpload.CURSOR.HAND | Der Mauszeiger wird als Hand angezeigt. |
| SWFUpload.WINDOW_MODE.WINDOW | Der Flash-Button wird über allen DOM-Elementen auf der Seite angezeigt. |
| SWFUpload.WINDOW_MODE.OPAQUE | Erlaubt anderen DOM-Elementen, den Flash-Button zu überdecken. |
| SWFUpload.WINDOW_MODE.TRANSPARENT | Erlaubt, den Flash-Button transparent anzuzeigen. |
Download-URL
- SWFupload Download-Adresse:https://code.google.com/p/swfupload/
- Offizielle SWFUpload-Dokumentation (Version 2.5.0):http://www.w3cschool.cc/w3cnote/swfupload-document.html