Редактирование JavaScript

IDE NetBeans обеспечивает усовершенствованные функции редактирования JavaScript, смоделированные для поддержки, уже обеспеченной для Java и других языков. Данное руководство содержит обзор этих функций.

Программное обеспечение, требуемое для работы с данным учебным курсом.

Для работы с этим учебным курсом требуются программное обеспечение и ресурсы, перечисленные ниже.

Программное обеспечение или материал Требуемая версия
IDE NetBeans 7.3
Комплект для разработчика на языке Java (JDK) Версия 6 или 7

Основные функции

В этом разделе мы представим основные функции редактирования JavaScript среды IDE.

Создание новых файлов

Новый файл JavaScript можно создать в любом проекте, посредством мастера создания файлов. Выберите 'Файл' > 'Создать файл' в главном меню и выберите файл JavaScript в категории HTML/JavaScript в мастере. Если категория HTML/JavaScript не доступна в установке, можно выбрать файл JavaScript в категории 'Другие'в мастере создания файлов. Если необходимо, чтобы файл JavaScript отображался в окне 'Проекты', создайте файл JavaScript в соответствующей подпапке проекта, такой как public_html или src.

Шаблон по умолчанию, который используется для файлов JavaScript, содержит только информацию о лицензировании. Чтобы добавить содержимое в шаблон, выберите 'Сервис' > 'Шаблоны' из главного меню, чтобы открыть 'Диспетчер шаблонов'. Выберите шаблон файлов JavaScript в категории HTML/JavaScript и нажмите 'Открыть в редакторе', чтобы изменить шаблон JavaScript.

Синтаксическая и семантическая подсветка

Редактор обеспечивает подсветку кода для методов и переменных, а также глобальных переменных и свойств объектов литералов.

на вкладке 'Навигатор' отображается структура файла JavaScript.

Свертывание кода

Код метода, комментарии и блоки кода в скобках можно свернуть или развернуть. Нажмите значки свернуть и развернуть рядом с левым полем редактора, чтобы свернуть или развернуть код. Поле с многоточием означает свернутый код, и можно поместить курсор над этим полем для просмотра свернутого кода. Можно быстро свернуть или развернуть все свернутые коды в файле, выбрав 'Вид' > 'Свернутый код' в главном меню.

свертывание кода

Также можно создавать собственные свертывания с описаниями и указать состояние по умолчанию.

// <editor-fold desc="This is my custom fold">
   Your code goes here...
// </editor-fold>

Переходы

В окне 'Навигатор' отображается структура файла JavaScript, что позволяет легко переходить к элементам в коде.

на вкладке 'Навигатор' отображается структура файла JavaScript.

Переход к объявлению

Нажмите клавишу Ctrl и удерживайте курсор на строке кода, а затем щелкните левой кнопкой мыши имя переменной, чтобы перейти к объявлению переменной.

Фоновое средство синтаксического анализа

Средство анализа работает в фоновом режиме и предоставляет подробные предупреждения и подсказки для устранения возможных неполадок. Можно настроить подсказки JavaScript , которые отображаются на вкладке 'Подсказки' в окне 'Параметры'.

снимок экрана вкладки 'Подсказки JavaScript' в окне 'Параметры'

Сопоставление скобок

Скобки закрываются автоматически. При вводе ', ", [, ( или { вставляется соответствующий символ для закрытия скобок. При вводе закрывающего символа вручную вставленный будет переписан. При удалении открывающего символа возвратом со стиранием удаляется и парный к нему символ.

Форматирование

Вкладка 'Форматирование' в окне 'Параметры' позволяет задать параметры для файлов JavaScript, в том числе отступы, пробелы и переносы строк.

снимок экрана вкладки 'Форматирование' в окне 'Параметры'

Поддержка JSON

Работа с файлами JSON осуществляется как с JavaScript. Фоновое средство синтаксического анализа работает в специальном режиме JSON, где разрешается только выражение объектного литерала без функций и т.д.

Внедрение

Функции редактирования JavaScript также работают для кода JavaScript, встроенного в файлы PHP, JSP и HTML.

Пометка вхождений и мгновенное переименование

При наведении курсора на символ будут выделены другие вхождения этой переменной или вызова. Кроме того, при наведении курсора на ключевое слово функции будет выделено всё возвращаемое этим методом (возвращаемые значения, создаваемые исключения). Это также произойдет, если навести курсор на возвращаемое значение.

выделенные возвращаемые элементы

Нажмите Ctrl-R/Command-R на локальной переменной, и символ можно будет одновременно переименовать по всему файлу.

Автозавершение и анализ типов

Автозавершение кода JavaScript предоставляет возможность выбрать между встроенными в среду IDE основными классами JavaScript, которые можно вставить в код. Например, если вы пишете следующий код:

    x = "foo";      y = x;      y.  

При автозавершении кода будут отображены методы, доступные для строк JavaScript. Автозавершение кода работает со всеми литеральными типами в JavaScript. Механизму анализа типов и автозавершения кода также известны классы в стиле прототипа (только для регулярных функций) и операция new для их конструирования.

IDE NetBeans содержит информацию о параметров типов для параметров функций и возвращаемых типов (@type, @param). Эти типы отображаются в завершении кода: в списке, в документации и в подсказках для параметров. Возвращаемые типы также показываются в диалоговом окне автозавершения кода после имени функции, отделенные двоеточием.

снимок автозавершения кода в редакторе

Если вы отметите метод с помощью @deprecated, эта отметка будет вычеркнута в окне 'Навигатор'. Сопровождающее описание нерекомендуемого метода показывается в отдельном разделе документации автозавершения, с выделением фона.

IDE NetBeans также может определить возвращаемые типы для многих функций. Это важно для поддержки JSQuery. Например, методы, возвращающие true или false, имеют тип возврата Boolean ("булево"), методы, возвращающие алгебраические числа, имеют тип возврата Number ("Число") и т. д. Среда IDE как логически выводит типы, так и прямо отслеживает заявленные типы через комментарии. Наиболее важное следствие из этого состоит в том, что среда IDE отслеживает типы, проходящие через вызовы. Если у нас есть вот такой код:

"foo".big().charCodeAt(50).toExponential(fractionDigits);

NetBeans сперва видит, что foo – это String, так что она ищет в классе String метод big(). Функция charCodeAt(50) в этой String принадлежит к типу Number, так что если здесь применить автозавершение кода к "to", можно будет увидеть только методы, доступные в Number.

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

Документирование

Автозавершение кода показывает документацию API как для основных API JavaScript, так и для API DOM. Можно также просмотреть документацию для собственноручно созданных функций. При щелчке вызова при удерживаемой клавише Ctrl также будет показана документация (в форме подсказки).

снимок экрана для подсказки с документацией

Автозавершение кода для jQuery также доступно в редакторе.

снимок экрана для подсказки с документацией

Открытие типа

Нажмите Ctrl-O/Command-O и быстро перейдите к одной из своих функций, в каком бы файле она ни находилась.

диалоговое окно 'Перейти к типу'

Поддержка JSDoc

IDE теперь поддерживает JSDoc версии 2, ScriptDoc и ExtDoc. Если аннотировать метод с помощью @private, он отображается в Навигаторе со значком замка. Если аннотировать функцию с помощью @constructor, она отображается как конструктор (и включается в автозавершение кода после "новых" ключевых слов).


Дополнительные сведения

Дополнительные сведения о работе с редактором JavaScript в IDE NetBeans см. в следующих ресурсах.

Для отправки комментариев и предложений, получения поддержки и новостей о последних разработках, связанных с Java EE IDE NetBeans присоединяйтесь к списку рассылки .

get support for the NetBeans

Support


By use of this website, you agree to the NetBeans Policies and Terms of Use. © 2015, Oracle Corporation and/or its affiliates. Sponsored by Oracle logo