jQuery UI API 类别 - 方法(Methods)
2026/6/11 14:03:32 网站建设 项目流程

jQuery UI API 类别 - 方法(Methods)

Methods是 jQuery UI API 文档中一个汇总类别,它列出了所有小部件(Widgets)共有的通用方法。由于 jQuery UI 的所有小部件都基于Widget Factory(部件工厂)构建,因此它们继承了一套完全统一的公共方法。这些方法在每个小部件的 API 文档中都会出现(例如 Datepicker、Dialog、Tabs 等)。

官方文档地址:https://api.jqueryui.com/category/methods/(适用于最新版本 1.14.1)

通用方法列表(所有小部件均支持)
方法描述用法示例
destroy()完全销毁小部件,移除所有添加的类、事件绑定、DOM 修改,恢复原始元素。$("#datepicker").datepicker("destroy");
disable()禁用小部件(交互无效,通常添加ui-state-disabled类)。$("#button").button("disable");
enable()启用小部件(恢复交互)。$("#button").button("enable");
instance()返回小部件的实例对象(存储在元素 data 中的对象)。var inst = $("#dialog").dialog("instance");
option()获取或设置小部件的选项。
- 无参数:返回所有选项对象。
- 一个参数:获取指定选项值。
- 两个/多个参数:设置选项。
$("#slider").slider("option", "value", 50);
var val = $("#slider").slider("option", "value");
widget()返回小部件生成的最外层元素(通常是原元素或包装器)。var elem = $("#tabs").tabs("widget");
详细说明与示例
  1. option()– 最常用方法

    // 设置单个选项$("#datepicker").datepicker("option","dateFormat","dd/mm/yy");// 设置多个选项$("#datepicker").datepicker("option",{changeMonth:true,changeYear:true,yearRange:"1900:2030"});// 获取选项值varformat=$("#datepicker").datepicker("option","dateFormat");// 获取所有选项(对象)varoptions=$("#datepicker").datepicker("option");
  2. destroy()

    • 彻底清理小部件,常用于动态移除组件。
    $("#myDialog").dialog("destroy");// 移除所有 dialog 添加的 DOM 和事件
  3. widget()

    • 返回小部件实际操作的 DOM 元素(有些小部件会在原元素外包裹一层)。
    var$widget=$("#tabs").tabs("widget");// 返回包含 ul 和 panels 的外层 div
  4. instance()(高级用法)

    • 直接访问内部实例对象,可操作私有属性/方法(不推荐日常使用)。
    vardialogInstance=$("#myDialog").dialog("instance");console.log(dialogInstance.uuid);// 内部唯一 ID
为什么这些方法是“通用”的?

因为 Widget Factory 为所有小部件提供了统一的生命周期和状态管理:

  • 选项变更时自动调用_setOption()
  • 销毁时自动调用_destroy()
  • 禁用/启用有标准处理逻辑。

因此,无论你是用 Datepicker、Accordion、Slider 还是自定义小部件,这些方法的行为都完全一致。

小贴士

  • 这些通用方法之外,每个小部件还有自己的专属方法(如open()close()value()等),在各自的 API 页面中列出。
  • 在自定义小部件时,你可以重写这些通用方法的行为(例如重写_setOption来响应特定选项变化)。

如果您想了解某个小部件(如 Dialog 或 Tabs)的专属方法列表,或这些通用方法在实际项目中的高级用法,欢迎继续提问!

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询