jQuery plugin authoring - расширение объекта jQuery, а также объект jQuery.fn

Question

Я не эксперт в этом, это мой первый набег на создание плагина jQuery.

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

Например, если мой плагин к alert() то, что я хотел бы, чтобы быть в состоянии назвать оба пути ниже:

$.tcAlert('Hello World'); 
// Resulting code: 
// 
// alert('Hello World'); 
// 

$('#myDiv').tcAlert(); 
// Resulting code: 
// 
// theText = $('myDiv').text(); 
// alert(theText); 
// 

Очевидно, что это очень простой пример, но я не могу найти какой-либо документацию о том, как это сделать, чтобы создать плагин. Должен ли я, по сути, создать расширение jQuery, а затем расширение jQuery.fn ссылается на исходное расширение?

Любая помощь/указатели будет очень полезной.

Answer 1

В общем случае, если это функция, которая что-то делает с элементом, вы должны записать ее в формате плагина, например. $.fn.myPlugin = function() {};. Если это просто служебная функция, добавьте ее в глобальный объект jQuery/$, например. $.myFunction = function() {};

Ваш пример может быть записан следующим образом:

$.tcAlert = function(string) { 
    alert(string); 
}; 

$.fn.tcAlert = function() { 
    // call the `tcAlert` function, passing the .text() of the current element as the argument 
    $.tcAlert(this.text()); 
    // allow chaining 
    return this; 
}; 

Answer 2

Вы не можете всегда знать, имеет ли селектор соответствует какие-либо элементы или нет.

Чтобы справиться с этим, сделайте следующее ..

$.fn.myPlugin = function() { 

    //First check length of matched elements 

    if(this.length < 1){ 
    //standalone functionality 
    } 
    else{ 
    return this.each(function(){ 
     //do things to matched elements 
     //where, $(this) refers to current element 
    }); 
    } 

}