当前位置：首页 > news >正文

jQuery UI 如何使用部件库（Widget Factory）

news 2026/8/15 2:16:37

jQuery UI 如何使用部件库（Widget Factory）

jQuery UI 的所有小部件（Datepicker、Tabs、Dialog 等）都基于Widget Factory（$.widget）构建。作为开发者，你可以直接使用 Widget Factory 来：

创建全新的自定义小部件。
扩展现有的 jQuery UI 小部件（最常见的使用方式）。
利用其统一的 API 和生命周期来管理复杂交互。

下面一步步说明如何在项目中使用 Widget Factory。

1. 前提：引入 jQuery UI

Widget Factory 是 jQuery UI 的一部分，必须引入 jQuery UI 的 JS 文件（它会自动在jQuery.ui命名空间下暴露$.widget）。

<scriptsrc="https://code.jquery.com/jquery-3.7.1.min.js"></script><scriptsrc="https://code.jquery.com/ui/1.14.1/jquery-ui.min.js"></script>

2. 创建一个全新自定义小部件

使用$.widget()定义一个独立的新部件。

// 定义一个简单的计数器小部件$.widget("custom.counter",{// 默认选项options:{value:0,step:1},// 创建时调用（初始化 DOM 和事件）_create:function(){this.element.addClass("custom-counter ui-widget ui-corner-all");this.display=$("<span>").addClass("counter-display").text(this.options.value).appendTo(this.element);this.incrementBtn=$("<button>").text("+").addClass("ui-button ui-state-default").on("click",()=>this._increment()).appendTo(this.element);this.decrementBtn=$("<button>").text("-").addClass("ui-button ui-state-default").on("click",()=>this._decrement()).appendTo(this.element);},// 自定义方法：增加计数_increment:function(){this.value(this.options.value+this.options.step);},// 自定义方法：减少计数_decrement:function(){this.value(this.options.value-this.options.step);},// 公共方法：获取或设置值value:function(newValue){if(newValue===undefined){returnthis.options.value;}this._setOption("value",newValue);},// 选项改变时自动调用_setOption:function(key,value){this._super(key,value);// 调用父类if(key==="value"){this.display.text(value);this._trigger("change",null,{value:value});// 触发 change 事件}},// 销毁时清理_destroy:function(){this.element.removeClass("custom-counter ui-widget ui-corner-all").empty();this._super();}});

使用自定义小部件：

<divid="myCounter"></div><script>$(function(){$("#myCounter").customCounter({value:10,step:5});// 绑定事件$("#myCounter").on("customcounterchange",function(event,ui){console.log("当前值:",ui.value);});// 调用方法$("#myCounter").customCounter("value",50);});</script>

3. 扩展现有 jQuery UI 小部件（最实用的方式）

继承官方小部件，只添加或修改需要的功能。

// 扩展 Dialog，添加默认的“帮助”按钮和标题图标$.widget("custom.helpDialog",$.ui.dialog,{options:{helpText:"点击这里获取帮助",iconClass:"ui-icon-help"},_create:function(){this._super();// 先调用父类的 _create// 添加标题图标if(this.options.iconClass){$("<span>").addClass(this.options.iconClass+" ui-dialog-title-icon").prependTo(this.uiDialogTitlebar.find(".ui-dialog-title"));}// 添加帮助按钮varbuttons=this.options.buttons||{};buttons["帮助"]=()=>alert(this.options.helpText);this.option("buttons",buttons);}});

使用扩展后的 Dialog：

<divid="helpDlg"title="使用说明">这是一个带帮助按钮的对话框。</div><script>$("#helpDlg").customHelpDialog({modal:true,helpText:"本功能用于演示 Widget Factory 扩展",iconClass:"ui-icon-info"});$("#helpDlg").customHelpDialog("open");</script>

4. 常见 Widget Factory 使用技巧

调用父类方法：始终在重写的方法中先调用this._super()或this._superApply(arguments)。
触发事件：this._trigger("eventName", event, uiData)，用户可通过.on("widgetNameeventName", handler)绑定。
访问实例：$("#elem").data("custom-counter")获取内部实例（高级用法）。
命名空间：推荐使用自定义命名空间（如custom.、ui.、myapp.）避免冲突。