Принципы присвоения имен

Во-первых, схема присвоения имен должна быть последовательной, а имена должны быть удобными для чтения и понимания. Это означает, что имена должны быть понятными словами или фразами. Первичная функция или назначение любого объекта должны быть очевидными из его имени. Так как типы переменных в 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 см. в разделе "".

Помните, что вышеуказанные рекомендации являются общими принципами. Важнее всего, выбрав определенную схему именования, использовать ее последовательно во всем приложении или проекте.


Содержание раздела

---

---