javascript - 如何扩展现有的 jQuery UI 小部件？

Question

我使用的是 jQuery v1.8.3 和 jQuery UI v1.9.2。我想扩展现有的 jQuery UI 小部件(在我的例子中是 Autocomplete 小部件)，方法是添加和覆盖一些选项和方法，但保留其他功能，如官方版本中所示。我怎样才能使它成为“正确的”(也许是“标准的”)方式？

---

P.S.:我在网上搜索(1、2、...)，我发现文档大多与创建新 jQuery UI 小部件相关但不是扩展现有的。

Answer 1

在 jQuery UI 1.9+ 中，扩展小部件的方式与创建新小部件的方式相同。小部件工厂 ($.widget()) 支持以下几种情况:

使用基本小部件 ($.Widget) 作为起点创建一个新小部件:

$.widget( "ns.widget", { ... } )

创建一个继承自现有小部件的新小部件:

$.widget( "ns.widget", $.ns.existingWidget, { ... } )

扩展一个小部件:

$.widget( "ns.widget", $.ns.widget, { ... } )

您会注意到扩展语法和继承语法是相同的。小部件工厂足够聪明，可以注意到您正在创建的小部件和您从中继承的小部件是相同的并适本地处理它。

在继承或扩展一个widget时，你只需要定义你想要改变或添加的东西。基本小部件上还存在一些新方法，可以更轻松地处理继承和更改上下文的方法。阅读 jQuery.Widget documentation有关方法及其描述的完整列表。您肯定想阅读有关 _super() 的内容如果您要扩展小部件。

这是一个将默认 delay 选项更改为 500 并添加一个新选项 prefix 的示例，该选项将添加到所有建议中:

$.widget( "ui.autocomplete", $.ui.autocomplete, {
    options: {
        delay: 500,
        prefix: ""
    },

    _renderItem: function( ul, item ) {
        var label = item.label;
        if ( this.options.prefix ) {
            label = this.options.prefix + " " + label;
        }
        return $( "<li>" )
            .append( $( "<a>" ).text( label ) )
            .appendTo( ul );
    },
});