news 2026/6/15 7:39:20

jQuery UI API 类别 - 方法(Methods)

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
jQuery UI API 类别 - 方法(Methods)

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)的专属方法列表,或这些通用方法在实际项目中的高级用法,欢迎继续提问!

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/6/12 4:24:06

jQuery UI API 类别 - 选择器(Selectors)

jQuery UI API 类别 - 选择器(Selectors) Selectors 是 jQuery UI API 中的一个独立类别,它扩展了 jQuery 的选择器功能,主要用于无障碍访问(Accessibility)场景,帮助开发者精确选中那些可以获…

作者头像 李华
网站建设 2026/6/15 19:36:32

jQuery UI API 类别 - 主题(Theming)

jQuery UI API 类别 - 主题(Theming) Theming 是 jQuery UI API 文档中的一个独立类别,它主要聚焦于 CSS Framework(CSS 框架),提供了一套语义化的类名,用于确保所有小部件(Widgets…

作者头像 李华
网站建设 2026/6/13 17:24:10

Langchain-Chatchat向量化存储原理及优化建议

Langchain-Chatchat向量化存储原理及优化建议 在金融、医疗和法律等行业,知识分散、检索困难、数据敏感等问题长期困扰着企业的智能化转型。传统的关键词搜索难以理解“年假申请流程”与“休假制度说明”之间的语义关联,而依赖公有云API的AI问答系统又存…

作者头像 李华
网站建设 2026/6/15 20:12:31

8个AI论文工具,继续教育学员轻松写毕业论文!

8个AI论文工具,继续教育学员轻松写毕业论文! AI 工具如何成为论文写作的得力助手 在当今学术环境中,越来越多的继续教育学员开始借助 AI 工具来提升论文写作效率。这些工具不仅能够帮助用户快速生成初稿,还能在降低 AIGC 率、保持…

作者头像 李华