воскресенье, 13 января 2013 г.

jQuery documentation

С недавнего времени перешел от Desktop разработки к Web и сейчас я познаю все прелести JavaScript'a и jQuery. После WPF и C# очень сложно привыкнуть к не типизированному языку, но никуда не деться :)
jQuery в современном WEB'e стала неотъемлемой частью разработки, без этой библиотеки вместо 2-3 строчек кода - приходится, порой, писать десяток. Сегодня я напишу о том, как облегчить использование этой библиотеки в Visual Studio, а именно - о документации, которая предоставляется с этой библиотекой и о которой не все в курсе.
WEB проекты созданные в VS2010 или VS2012 сразу имеют подключенные файлы jquery и jquery-vsdoc. Однако, если Вы мигрировали проект с восьмой студии или изначально вам не нужен был jQuery, а потом захотели его использовать, то Вам помимо самого файла - нужна документация, с помощью которой можно активировать нормальный IntelliSense.
Скачать документацию для конкретной версии jQuery можно отсюда:
http://appendto.com/community/jquery-vsdoc/ 
Нужно создать JS файл вида jquery-1.8.3-vsdoc.js
Вуаля, можно наслаждаться подробным описанием функций и их параметров.

И безусловно удобный способ подключения - через nuget, он установит и сам jQuery и документацию к нему.

В некоторых случаях, этого может оказаться недостаточно. Тогда на странице, к которой Вы хотите подключить документацию необходимо дописать:

<% if(false) 
{ %>
    <script src="/path/to/vsdoc.js" type="text/javascript"></script>
<% } %>
или же в .js файле:
/// <reference path="/path/to/vsdoc.js" />

Комментариев нет:

Отправить комментарий