jQuery 1.4.2 VSDoc - PullRequest
       68

jQuery 1.4.2 VSDoc

40 голосов
/ 24 февраля 2010

Где взять VSDoc для jQuery 1.4.2?

Ответы [ 15 ]

27 голосов
/ 25 марта 2010

Путешественник может добавить следующие строки, начиная с 2949:

delegate: function( selector, types, data, fn ) {
/// <summary>
///   Attach a handler to one or more events for all elements that match the selector, now or in the future, based on a specific set of root elements. See also "live".
/// </summary>
/// <param name="selector" type="String">
///     An expression to search with.
/// </param>
/// <param name="types" type="String">
///     A string containing a JavaScript event type, such as "click" or "keydown".
/// </param>
/// <param name="data" type="Object">
///     A map of data that will be passed to the event handler.
/// </param>
/// <param name="fn" type="Function">
///     A function to execute at the time the event is triggered.
/// </param>
    return this.live( types, data, fn, selector );
},
undelegate: function( selector, types, fn ) {
/// <summary>
///   Remove a handler from the event for all elements which match the current selector, now or in the future, based upon a specific set of root elements. See also "die".
/// </summary>
/// <param name="selector" type="String">
///     An expression to search with.
/// </param>
/// <param name="types" type="String">
///     A string containing a JavaScript event type, such as "click" or "keydown".
/// </param>
/// <param name="data" type="Object">
///     A map of data that will be passed to the event handler.
/// </param>
/// <param name="fn" type="Function">
///     A function to execute at the time the event is triggered.
/// </param>
    if ( arguments.length === 0 ) {
            return this.unbind( "live" );

    } else {
        return this.die( types, null, fn, selector );
    }
},

Эта документация в значительной степени извлечена из веб-страниц jQuery и из текущих определений "живи" и "умри", но не стесняйтесь настраивать, как вам удобно.

Также в строке 224:

// The current version of jQuery being used
    jquery: "1.4.2",
23 голосов
/ 24 февраля 2010

Вы всегда получаете его от http://docs.jquery.com/Downloading_jQuery - если его еще нет, он еще не доступен v1.4.1 существует - см. скриншот - но 1.4.2 еще не готова.

alt text

12 голосов
/ 21 апреля 2010

Просто записка об ответе Херба. Линия 2940, для меня так или иначе, была в середине метода «триггера». Я вставил код после 2949. Кроме того, поскольку мне потребовалось около 45 минут, чтобы выяснить, почему комментарии не работают для этих двух новых подпрограмм - теги "summary" содержат в себе слишком много символов!

Вот исправленная версия:

        delegate: function(selector, types, data, fn) {
    /// <summary>
    ///     Attach a handler to one or more events for all elements that match the selector, now or in the future, based on a specific set of root elements. See also "live".
    /// </summary>
    /// <param name="types" type="String">
    ///     A string containing a JavaScript event type, such as "click" or "keydown".
    /// </param>
    /// <param name="data" type="Object">
    ///     A map of data that will be passed to the event handler.
    /// </param>
    /// <param name="fn" type="Function">
    ///     A function to execute at the time the event is triggered.
    /// </param>
    /// <param name="selector" type="String">
    ///     An expression to search with.
    /// </param>

        return this.live(types, data, fn, selector);
    },

    undelegate: function(selector, types, fn) {
    /// <summary>
    ///     Remove a handler from the event for all elements which match the current selector, now or in the future, based upon a specific set of root elements. See also "die".
    /// </summary>
    /// <param name="selector" type="String">
    ///     An expression to search with.
    /// </param>
    /// <param name="types" type="String">
    ///     A string containing a JavaScript event type, such as "click" or "keydown".
    /// </param>
    /// <param name="fn" type="Function">
    ///     A function to execute at the time the event is triggered.
    /// </param>
        if (arguments.length === 0) {
            return this.unbind("live");

        } else {
            return this.die(types, null, fn, selector);
        }
    },
9 голосов
/ 26 июля 2010

Не уверен, что это «официальная версия», но теперь файл 1.4.2-vsdoc можно загрузить с Microsoft CDN: http://ajax.microsoft.com/ajax/jQuery/jquery-1.4.2-vsdoc.js

8 голосов
/ 08 февраля 2011

Последняя поддерживаемая версия VSDoc, кажется, v.1.4.4 от Microsoft и может быть найдена в http://ajax.aspnetcdn.com/ajax/jQuery/jquery-1.4.4-vsdoc.js.

Это новый MS CDN для наборов инструментов (заменяющий старый домен microsoft.com).

6 голосов
/ 27 июня 2010

Я решил создать его на основе входных данных этого вопроса и ответов и поделиться им.Вы можете скачать его из этого поста в блоге:

http://hugeonion.com/2010/06/26/here-is-the-missing-jquery-1-4-2-vsdoc-file/

Надеюсь, что поможет!

6 голосов
/ 22 марта 2010

Помимо переименования файла VSDoc (1.4.1) вам также может потребоваться изменить номер версии jQuery, используемый в файле 1.4.1-vsdoc.js, на 1.4.2.

См. Строку № 224,

// The current version of jQuery being used
    jquery: "1.4.2",
2 голосов
/ 21 декабря 2010

Джон Т сказал:

За что это стоит, и от этого вопрос:

jQuery 1.4.3 vsdoc

Кто-то обновил jQuery vsdoc для JQuery 1.4.3. Это в:

http://appendto.com/community/vsdoc

@ Джон Т .: Спасибо за ссылки!

Для пользователей предоставленного здесь файла VSDOC v1.4.4 существует небольшая ошибка, которая нарушает IntelliSense; в строке 1751 файл выглядит так:

jQuery.proxy = function(function, context){

Это приводит к тому, что Visual Studio показывает следующую ошибку:

Error updating JScript IntelliSense: <your path>\jquery-1.4.4-vsdoc.js: Expected identifier @ 1750:24 (или достаточно близко).

Обновить эту строку следующим образом:

jQuery.proxy = function(method, context){

Эта ошибка была найдена и устранена в VS2008.

2 голосов
/ 12 марта 2010

В настоящее время вы всегда можете просто переименовать "jquery-1.4.1-vsdoc.js" в "jquery-1.4.2-vsdoc.js", и когда они выпускают новую версию vsdoc, просто замените ее.

Примечание: мне пришлось изменить исходный путь скрипта, а затем снова изменить его, чтобы заставить vs забрать vsdoc. Я просто добавил косую черту в начале значения атрибута src, а затем удалил его.

1 голос
/ 28 декабря 2011

FWIW, вы можете сгенерировать для jQuery версий 1.4.2 и выше, используя онлайн-инструмент на http://damianedwards.com/vsdoc

Кроме того, пакеты jQuery в NuGet содержат файлы vsdoc, созданные с помощью этого инструмента.

Этот инструмент фактически удаляет официальную документацию API с сайта api.jquery.com и объединяет ее с реальным объектом jQuery в (браузер) памяти, а не пытается выполнить слияние исходного кода. Это не на 100% идеально, но очень близко (намного ближе, чем старый подход).

Кроме того, судя по некоторым ответам и комментариям, некоторые люди ссылаются на файл vsdoc со своих веб-страниц. Не делайте этого. Файл vsdoc специально создан для обслуживания Visual Studio IntelliSense и не будет корректно работать в браузере. Просто укажите фактический файл jQuery (или версию .min), и Visual Studio автоматически найдет рядом с ним версию файла .vsdoc (в том числе, если вы ссылаетесь на нее из CDN).

...