jQuery UI API 类别 – 主题(Theming)

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)。

如果您想了解特定类的详细用法、图标列表,或如何在自定义小部件中应用这些类,请提供更多细节!

文章已创建 3318

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

相关文章

开始在上面输入您的搜索词,然后按回车进行搜索。按ESC取消。

返回顶部