Делюсь опытом в описанных технологиях. Блог в первую очередь выполняет роль памяток для меня самого.

Комментарии в исходном коде

1 комментарий

Устал искать, в каком месте удалил лишнюю скобку. Устал определять по отступу, где закончился цикл или if. Поэтому сейчас пишу код примерно так:

Расстановка комментариев
define([
    /*
     * Главное меню приложения.
     * Обработчики событий должны устанавливаться в классе Application.
     */
    "dojo/_base/array", // array.forEach в одном месте
    "dojo/_base/declare",
    "dijit/DropDownMenu",
    "dijit/MenuBar",
    "dijit/MenuBarItem",
    "dijit/MenuItem",
    "dijit/PopupMenuBarItem"
], function(
    array,
    declare,
    DropDownMenu
    MenuBar,
    MenuBarItem,
    MenuItem,
    PopupMenuBarItem
){
    // Создает пункт главного меню с DropDown'ом
    function createMenuBarItem(label){
        return new PopupMenuBarItem({
            label: label,
            popup: new DropDownMenu({})
        });
    } // createMenuBarItem
    
    return declare(MenuBar, {
    	
        buildRendering: function(){
         this.inherited(arguments);
         
         // Какой-то код...
         
         this.fileMenu = createMenuBarItem("Файл");
         this.editMenu = createMenuBarItem("Правка");
         this.dictsMenu = createMenuBarItem("Справочники");
         
         array.forEach([
             this.fileMenu,
             this.editMenu,
             this.dictsMenu
         ], this.addChild, this); // forEach
        } // buildRendering
    }); // declare
}); // define

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

1 комментарий :