jQuery UI API 类别 – 主题(Theming)
Theming 是 jQuery UI API 文档中的一个独立类别,它主要聚焦于 CSS Framework(CSS 框架),提供了一套语义化的类名,用于确保所有小部件(Widgets)在视觉上保持一致,并支持通过 ThemeRoller 工具轻松自定义主题。
官方文档地址:https://api.jqueryui.com/category/theming/
核心子页面:https://api.jqueryui.com/theming/css-framework/(适用于最新版本 1.14.1)
Theming 类别概述
jQuery UI 的主题系统设计目的是:
- 创建视觉一致性。
- 允许开发者自定义外观(颜色、字体、背景、圆角等)。
- 支持社区插件共享样式规范。
CSS 类分为两部分:
- 结构性类(固定布局,如清除浮动、隐藏元素)。
- 可主题类(颜色、背景等,可通过 ThemeRoller 修改)。
这些类自动应用于所有官方小部件,自定义小部件也推荐使用它们以获得主题支持。
CSS Framework 类列表
以下是主要类分类(完整列表见官方文档):
| 分类 | 示例类名 | 描述 |
|---|---|---|
| 布局辅助 | .ui-helper-hidden、.ui-helper-clearfix | 隐藏元素、清除浮动等。 |
| 小部件容器 | .ui-widget、.ui-widget-header、.ui-widget-content | 所有小部件的外层容器、头部、内容区。 |
| 交互状态 | .ui-state-default、.ui-state-hover、.ui-state-active | 默认、悬停、激活状态(用于按钮等)。 |
| 交互提示 | .ui-state-highlight、.ui-state-error、.ui-state-disabled | 高亮、错误、禁用状态。 |
| 优先级 | .ui-priority-primary、.ui-priority-secondary | 主/次按钮样式。 |
| 图标 | .ui-icon + 子类(如 .ui-icon-circle-close) | 内置精灵图图标(上百种)。 |
| 圆角 | .ui-corner-all、.ui-corner-top 等 | 控制圆角(支持 CSS3 border-radius)。 |
| 叠加与阴影 | .ui-widget-overlay、.ui-widget-shadow | 模态遮罩和阴影。 |
| 层叠管理 | .ui-front | 管理多个小部件的 z-index。 |
示例:一个主题化按钮
<button class="ui-button ui-widget ui-state-default ui-corner-all ui-button-text-only">
<span class="ui-button-text">点击我</span>
</button>
ThemeRoller 与 Theming 的关系
ThemeRoller(https://jqueryui.com/themeroller/)是官方在线工具,用于可视化设计和下载自定义主题。它会生成对应的 CSS 文件,自动更新上述类的样式。
示例:自定义类应用效果
注意:jQuery UI 已进入维护模式(最新 1.14.1),主题系统稳定。新项目推荐现代 CSS 框架(如 Tailwind CSS 或 Bootstrap)。
如果您想了解特定类的详细用法、图标列表,或如何在自定义小部件中应用这些类,请提供更多细节!