Принципы присвоения имен
Во-первых, схема присвоения имен должна быть последовательной, а имена должны быть удобными для чтения и понимания. Это означает, что имена должны быть понятными словами или фразами. Первичная функция или назначение любого объекта должны быть очевидными из его имени. Так как типы переменных в ActionScript контролируются динамически, то имя должно также содержать суффикс, определяющий тип объекта, на который ссылается имя. Самый естественный случай имен — это фразы типа "существительное-глагол" или "прилагательное-существительное". Например:
Имя клипа — "my_movie.swf";
Переменная для добавления к URL — "course_list_output" (вывод списка курсов);
Компонент или объект — "ProductInformation" (информация о продукте)
Переменная или свойство — "userName" (имя пользователя)
Имена функций и переменных должны начинаться со строчной буквы (a, b, c, ..., x, y, z). Имена объектов и конструкторов объектов должны начинаться с заглавной буквы (A, B, C, ..., X, Y, Z). Использование смешанных регистров символов рекомендуется в случае именования переменных. Другие форматы именования приемлемы, если они используются последовательно во всем проекте. Имя переменной может содержать только буквы, числа и символы подчеркивания. Не начинайте имя переменной с числа или символа подчеркивания. Неправильными именами переменных будут следующие:
_count = 5; // начинается с символа подчеркивания
5count = 0; // начинается с числа
foo/bar = true; // содержит символ "слэш"
foo bar = false; // содержит пробел
Кроме того, в качестве имен переменных нельзя использовать ключевые слова ActionScript. Также избегайте использования в качестве имен переменных слов из популярных конструкций программирования, даже если Macromedia Flash Player к настоящему времени не поддерживает эти конструкции в качестве ключевых слов. Это дает больше уверенности в том, что будущие версии проигрывателя не вступят в конфликт с вашим приложением. Например, не нужно делать так:
var = "foo";
MovieClip = "myMovieClip";
switch = "on";
case = false;
abstract = "bar";
extends = true;
implements = 5;
Так как ActionScript совместим с ECMAScript, авторы приложений могут ознакомиться со списком зарезервированных слов, приведенных в . Пока Flash MX не поддерживает константы, разработчики должны применять следующий принцип: имена переменных набирать символами нижнего регистра, а имена переменных-констант — только символами верхнего регистра. Например:
course_list_output = "foo"; // переменная
courseListOutput = "foo"; // переменная
BASEURL = http://www.foo.com; // константа
MAXCOUNTLIMIT = 10; // константа
MyObject = function{}; // функция конструктора
f = new MyObject(); // объект
Редактор кода ActionScript в среде разработки Flash MX имеет встроенную функцию "завершения кода". Эта функция помогает вам писать код, предоставляя в виде выпадающего списка возможные варианты завершения кода. Чтобы вы могли пользоваться этим преимуществом, имена ваших переменных должны соответствовать определенному формату. В этом встроенном формате суффикс имени переменной является строкой, указывающей на тип переменной. Ниже приведена таблица поддерживаемых суффиксов:
Таблица 3: Суффиксы для активации функции завершения кода
| Тип объекта |
Суффикс |
Пример |
| String |
_str |
myString_str |
| Array |
_array |
myArray_array |
| MovieClip |
_mc |
myMovieClip_mc |
| TextField |
_txt |
myTextField_txt |
| Date |
_date |
myDate_date |
| Sound |
_sound |
mySound_sound |
| XML |
_xml |
myXML_xml |
| Color |
_color |
myColor_color |
| Button[] |
_btn |
myButton_btn |
| TextFormat |
_fmt |
myTextFormat_fmt |
| XMLSocket |
_xmlsocket |
myXmlSocket_xmlsocket |
| FListBox |
_lb |
myFListBox_lb |
| FScrollBar |
_sb |
myFScrollBar_sb |
| FComboBox |
_cb |
myFComboBox_cb |
| FScrollPane |
_sp |
myFScrollPane_sp |
| FMessageBox[] |
_mb |
myFMessageBox_mb |
| FDraggablePane |
_dp |
myFDraggablePane_dp |
| FTicker |
tick_ (префикс) |
tick_myFTickerMain |
| FTree |
_tree |
myFTree_tree |
| FTreeNode |
_tn |
myFTreeNode_tn |
| FIconButton |
_ib |
myFIconButton_ib |
| FProgressBar |
_pr |
myFProgressBar_pr |
<
Вы увидите эту функцию в действии, если наберете в панели Actions один из примеров и символ точки. Например, введите myString_str. — появится выпадающий список свойств и методов для объекта String. Не забывайте о точке:
Рисунок 1: Пример действия помощника завершения кода.
Наконец, имена всех .swf-файлов должны быть набраны в нижнем регистре, а слова в именах должны быть разделены символом подчеркивания (например, "lower_case.swf"). Обсуждение соглашений об именовании включаемых файлов ActionScript см. в разделе "".
Помните, что вышеуказанные рекомендации являются общими принципами. Важнее всего, выбрав определенную схему именования, использовать ее последовательно во всем приложении или проекте.