loadVariables
Завантажує в кліп або фільм зовнішні змінні
синтаксис:
аргументи:
Зазвичай змінні всередині фільмів визначаються за допомогою ActionScript. Однак за допомогою loadVariables () можна також імпортувати в кліп змінні з текстового файлу або виконуваного на сервері додатка - наприклад, сценарію PHP. Областю видимості для змінних, що завантажуються через loadVariables (). є кліп або рівень, зазначені в target. а типом даних завжди є string. Для прикріплення завантажених змінних до поточної тимчасової діаграмі потрібно використовувати в якості значення аргументу target порожній рядок.
Приклад: Прикріплення змінних до поточної тимчасової діаграмі.
Незалежно від того, чи будуть завантажуються змінні перебувати в текстовому файлі, або з створює сценарій, вони повинні мати формат, відповідний кодуванні URL:
- Ім'я кожної змінної повинно відділятися від її значення знаком рівності, без пробілів: firstName = Jon.
- Пари імен / значень повинні розділятися амперсандами (): firstName = JonlastName = Smit.
- Прогалини повинні бути замінені знаками плюс (+).
- Будь-який символ, який не є пропуском, цифрою (1-9) або латинською буквою (a-z, A-Z), повинен бути замінений шестнадцатеричной escape-послідовністю виду% xx, де xx є кодової позицією символу в Latin 1 в шістнадцятковому вигляді.
Наступний приклад покаже вміст текстового файлу, що імпортується в Flash за допомогою loadVariables ().
Приклад: Імпорт з файлу змінних name і address.
Текстовий файл, який використовується в loadVariables (). є звичайним текстовим файлом, що містить змінні в кодуванні URL, як показано вище. Для завантаження змінних із зовнішнього текстового файлу шлях до файлу вказується як аргумент URL у виклику функції loadVariables ().
Приклад: Завантаження змінних в головну тимчасову діаграму.
loadVariables () також можна використовувати зі сценарієм або додатком сервера, що виводить змінні в кодуванні URL. Коли сценарій посилає змінні в фільм Flash в відповідь на виклик функції loadVariables (). він повинен задати MIME-тип даних як "application / x-www-urlform-encoded".
На рівні з прийомом змінних, функція loadVariables () також може передавати змінні в сценарій на стороні сервера. Щоб відправити в сценарій всі змінні, визначені в поточній тимчасової діаграмі, аргумент method при виконанні функції loadVariables () задається рівним "GET" або "POST". Змінні пересилаються в форматі кодування URL.
Якщо method заданий як "GET", змінні передаються як рядок запиту в URL сценарію.
Якщо method встановлений як "POST", змінні посилаються після заголовка HTTP POST.
Оскільки для більшості веб-серверів максимальна довжина URL лежить між 255 і 1024 символами, при передачі великих обсягів даних використовуйте "POST", а не "GET".
З міркувань безпеки loadVariables () діє тільки з хостами домену, з якого був завантажений фільм. Правила, яким підкоряється loadVariables (). перераховані в наступній таблиці.
Вихідний домен фільму
Ці заходи безпеки впливають тільки на модулі і на елементи ActiveX браузера Flash Player; автономний програвач може завантажувати змінні з будь-якого домену.
Результати багаторазових звернень loadVariables () по одному і тому ж URL сценарію можуть деякими браузерами кешуватися, в результаті чого нові дані з сервера не завантажуються. Щоб уникнути цієї проблеми, додавайте в кожен виклик loadVariables () фіктивну змінну, щоб URL виявився унікальним.
Приклад: Генерація унікального URL.
Використання обробника події data з функцією loadVariables ().
Якщо у сервера запитується ряд змінних за допомогою функції loadVariables (). необхідно дочекатися їх повного завантаження, перш ніж використовувати містяться в них дані.
Коли кліп отримує всю групу завантажуються змінних, генерується подія data. яке вказує, що можна виконувати код, що залежить від цих змінних.
У наведеному нижче прикладі наведено уривок коду гостьової книги, який показує використання обробника події data з функцією loadVariables (). У цьому прикладі є кнопка, за допомогою якої дві змінні в кодуванні URL завантажуються з текстового файлу в кліп. У кліпі є обробник події data. який виконується, коли ці дві змінні завантажені. Оброблювач відображає значення цих двох змінних. Безпека виведення цих двох змінних гарантується тим, що код обробника виконується тільки при генерації події data (тобто після отримання даних).
Приклад: Очікування події data.
Помилки в реалізації:
Метод POST не підтримуються в Internet Explorer 4.5 для Macintosh. Ця проблема була виправлена у версії 5 браузера.
сумісність:
Використовується з 4-ої версії Flash