jQuery UI 定制指南
jQuery UI 支持高度定制,主要包括两个方面:
- 组件定制:选择只包含需要的模块,减少文件体积。
- 主题定制:使用 ThemeRoller 工具自定义外观(颜色、圆角、字体、阴影等)。
当前最新版本(截至 2025 年 12 月):jQuery UI 1.14.1,ThemeRoller 和 Download Builder 工具仍正常可用。
1. 组件定制(使用 Download Builder)
访问官方下载生成器:https://jqueryui.com/download/
步骤:
- 选择版本:推荐 Stable (1.14.1),兼容 jQuery 3.7+ 和 4.0+。
- 选择组件:
- Core:核心工具(必须)。
- Interactions:拖拽(Draggable)、放置(Droppable)、调整大小(Resizable)、选择(Selectable)、排序(Sortable)。
- Widgets:小部件,如 Accordion、Autocomplete、Button、Datepicker、Dialog、Menu、Progressbar、Slider、Tabs 等。
- Effects:特效(如 fade、explode 等)。
(依赖组件会自动选中,只选需要的可显著减小 JS 文件大小。) - 选择主题:内置多个预设主题(如 smoothness、ui-lightness),或自定义(见下文)。
- 点击 Download 下载 ZIP 包,包含自定义的 jquery-ui.min.js、CSS 和 images 文件夹。
优势:自定义包体积小,加载更快。适合生产环境。
2. 主题定制(使用 ThemeRoller)
访问官方 ThemeRoller 工具:https://jqueryui.com/themeroller/
步骤:
- 打开页面,选择 Roll Your Own 标签(自定义)或 Gallery 标签(从预设主题开始修改)。
- 在左侧面板调整参数:
- Font Settings:字体家族、大小。
- Corner Radius:圆角半径(使用 CSS3 border-radius,IE8 以下不支持)。
- Header/Toolbar:头部/工具栏颜色、背景。
- Content:内容区域样式。
- Clickable States:默认、悬停、激活、焦点状态。
- Highlight & Error:高亮和错误样式。
- Overlay & Shadows:模态遮罩和阴影。
- Icons:框架图标颜色。
- 右侧预览区实时显示效果,包括 Accordion、Tabs、Datepicker、Button、Slider 等组件的预览。
- 满意后,点击 Download theme 按钮。
- 会跳转到 Download Builder,您的自定义主题已自动选中。
- 进一步选择组件和版本,然后下载完整包。
下载内容:
- 一个自定义的
jquery-ui.css(或jquery-ui.theme.css)文件。 images文件夹(包含图标和背景图,根据您的设置生成 PNG 文件)。
使用自定义主题(CDN 示例,替换为您的本地文件):
<link rel="stylesheet" href="path/to/your-custom-theme/jquery-ui.css">
<script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>
<script src="path/to/your-custom/jquery-ui.min.js"></script>
3. 高级定制方式
- 手动修改 CSS:从默认主题(如 smoothness)开始,编辑
jquery-ui.theme.css文件,进一步调整细节(如特定组件的边框、渐变)。 - 覆盖样式:在项目 CSS 中添加更高优先级的规则覆盖 jQuery UI 默认样式。
- 多个主题共存:在 Download Builder 的高级设置中配置 scope(如
.ui-custom-theme),避免全局冲突。
注意事项
- jQuery UI 已进入维护模式,主要修复兼容性问题,不添加新功能。
- 新项目推荐现代替代(如 Bootstrap 5、Tailwind UI 或 React 组件库)。
- 如果只需主题,可单独下载主题包:https://jqueryui.com/resources/download/jquery-ui-themes-1.14.1.zip
如果您想定制特定组件(如只用 Datepicker 和 Tabs)或特定主题效果(如暗黑模式),告诉我细节,我可以提供示例配置或代码!