Flash - статьи

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


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

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


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