SWFUploadЭто плагин для загрузки файлов, объединяющий Flash и JavaScript, и его функциональность очень мощная. Раньше я несколько раз использовал его в проектах, но у него слишком много параметров конфигурации. После одного использования забываешь, как им пользоваться, и когда он снова нужен, приходится идти на официальный сайт читать документацию, что действительно раздражает. Поэтому я просто записал его использование, что также удобно для студентов со слабым английским для справки. Это приносит пользу и мне, и другим, и решает проблему раз и навсегда.

Возможности SWFUpload

• 1. Загрузка с помощью Flash, без обновления страницы, а стиль кнопки Flash можно настроить;
• 2. Файлы для загрузки можно ограничивать на стороне браузера;
• 3. Позволяет загружать несколько файлов сразу, но существует очередь загрузки. Файлы в очереди загружаются по одному. Серверная сторона принимает файлы так же, как при обычной загрузке файлов через форму;
• 4. Предоставляет разработчикам богатые интерфейсы событий;

Процесс загрузки файлов в SWFUpload:

• 1. Подключите соответствующий JS-файл
• 2. Создать экземпляр объекта SWFUpload, передав объект параметров конфигурации для различных настроек.
• 3. Нажмите кнопку Flash, предоставленную SWFUpload, и появится окно выбора файлов, где можно выбрать файлы для загрузки;
• 4. После выбора файлов файлы, соответствующие требованиям, будут добавлены в очередь загрузки;
• 5. Вызовите метод startUpload, чтобы начать загрузку файлов из очереди;
• 6. В процессе загрузки файла запускаются соответствующие события. Разработчики используют эти события для обновления интерфейса, обработки ошибок, показа подсказок и т. д.;

SWFUpload состоит из трёх частей: SWFUpload.js, swfupload.swf, параметры конфигурации инициализации и различные функции обработки событий. Поэтому сначала подключите SWFUpload.js на страницу

<script src='SWFUpload.js.html'></script>

Затем создайте экземпляр объекта SWFUpload:

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(){}
...等等

Мы видим, что реализовать функцию загрузки SWFUpload очень просто: достаточно создать экземпляр объекта SWFUpload. Но сложность вызывает объект параметров конфигурации, используемый при создании экземпляра, а также моменты срабатывания различных событий и предоставляемые ими параметры. Вот здесь и наступает ключевой момент. В следующих таблицах перечислено то, что часто используется при разработке. Хотя их уже довольно много, это не всё, что есть в SWFUpload. Я перечислил только часто используемые. За полной документацией обратитесь на официальный сайт SWFUpload.

Часто используемые атрибуты и описания в объекте параметров конфигурации SWFUpload

Объяснение различных событий SWFUpload

Методы экземпляра SWFUpload

Большинство методов динамически изменяют объект конфигурации параметров.

Объект информации о файле (File Object)

В функциях-обработчиках событий объект информации о файле часто используется для получения информации о файле для следующего шага.

Объект состояния очереди (объект статистики)

Используется для получения текущего состояния очереди.

Некоторые константы

Некоторые константы, определённые SWFupload для облегчения понимания.

URL загрузки

• Адрес для скачивания SWFupload:https://code.google.com/p/swfupload/
• Официальная документация SWFUpload (версия 2.5.0):http://www.w3cschool.cc/w3cnote/swfupload-document.html