jQuery UI API 类别 - UI 核心(UI Core)
2026/6/10 2:50:54 网站建设 项目流程

jQuery UI API 类别 - UI 核心(UI Core)

UI Core(User Interface Core)是 jQuery UI 的基础核心类别,它提供了所有其他组件(Widgets、Interactions、Effects)所依赖的最底层功能。UI Core 本身体积很小,但它是整个 jQuery UI 框架的“地基”。

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

UI Core 包含的主要组件
组件名称描述主要作用与示例
jQuery.widget()(Widget Factory)部件工厂,用于创建和管理所有状态化小部件的框架。所有官方小部件(如 Datepicker、Dialog、Tabs)都基于它构建;开发者自定义小部件也依赖它。
:focusable:tabbable选择器扩展 jQuery 的自定义选择器,用于无障碍访问(Accessibility)。精确选中可获得焦点或可通过 Tab 键导航的元素,常用于键盘焦点管理。
.position()强大的元素定位工具,支持多种定位方式(相对、碰撞检测、偏移等)。用于 Dialog、Tooltip、Autocomplete 等组件的定位。
.uniqueId().removeUniqueId()为没有 ID 的元素自动生成/移除唯一 ID。内部用于 ARIA 无障碍属性(如 aria-controls)。
.zIndex()获取或设置元素的 z-index,支持相对于父元素或兄弟元素。用于管理模态对话框、菜单等叠加顺序。
.keyCode键盘事件键码常量对象(如. u i . k e y C o d e . E N T E R 、 .ui.keyCode.ENTER、.ui.keyCode.ENTER.ui.keyCode.ESCAPE)。统一处理键盘交互,避免跨浏览器键码差异。
.scrollParent()返回最近的可滚动父元素。用于拖拽、滚动时保持可见性等场景。
.contains()安全判断一个 DOM 元素是否包含另一个元素(兼容性更好)。内部用于事件委托、焦点管理。
.escapeSelector()转义 CSS 选择器中的特殊字符。用于动态生成选择器。
关键组件详解
  1. Widget Factory($.widget)

    • 最核心部分,所有小部件的统一 API、状态管理、继承、事件系统都来自这里。
    • 详见之前章节“部件库(Widget Factory)”。
  2. .position() 方法

    $("#tooltip").position({my:"left+10 center",// 自身定位点at:"right center",// 目标元素定位点of:"#target",// 相对哪个元素collision:"flip"// 超出视口时翻转});
    • 支持丰富的选项:my、at、of、collision、using、within 等。
  3. :focusable 和 :tabbable 选择器

    • 用于键盘导航和焦点陷阱(focus trapping),在 Dialog、Menu 等组件中大量使用。
    varnext=$(":tabbable").first();// 获取第一个可 Tab 元素
  4. $.ui.keyCode

    if(event.keyCode===$.ui.keyCode.ESCAPE){$("#dialog").dialog("close");}
UI Core 的重要性
  • 体积小:单独引入 UI Core 时文件很小(几 KB)。
  • 依赖关系:Widgets、Interactions、Effects 都必须依赖 UI Core。
  • 在使用 Download Builder 自定义下载时,Core是必选项(不能取消)。

注意:jQuery UI 已进入维护模式(最新 1.14.1),UI Core 部分非常稳定,常被其他库借鉴(如 jQuery Mobile)。

如果您想深入某个核心组件(如 .position() 的所有选项详解,或 Widget Factory 的内部实现),欢迎继续提问!

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

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

立即咨询