jQueryMobile-Router 技术文档

1. 安装指南

在开始使用 jQueryMobile-Router 插件之前，请确保您的项目中已经包含了 jQuery 和 jQuery Mobile。之后，您可以通过以下方式引入 jQueryMobile-Router：

<script src="path/to/jquery.mobile.router.js"></script>

确保 jQueryMobile-Router 的脚本在 jQuery Mobile 脚本之后加载。

2. 项目的使用说明

jQueryMobile-Router 是一个用于增强 jQuery Mobile 框架的插件，它通过客户端路由器/控制器与 jQuery Mobile 事件（如 pagebeforecreate、pagecreate、pagebeforeshow 等）集成。此外，它还在 URL 的哈希部分支持客户端参数。

3. 项目API使用文档

路由定义

当 jQuery Mobile 改变 URL（通常是片段部分）时，路由器会检查该 URL 是否与您的路由之一匹配，并调用您提供的处理程序。

定义路由时，您将提供：

• 一个正则表达式，用于测试 URL/哈希
• 一个处理程序（函数）
• 处理程序必须被调用的时刻（例如，您可能决定仅在 pagecreate 和 pagebeforeshow jQM 事件发出时设置路由）

路由器类

插件导出一个类在 $.mobile.Router 中，您可以使用以下参数实例化您的路由器：

var approuter = new $.mobile.Router(myRoutes, myHandlers, options);

• myRoutes 是定义路由的对象或数组
• myHandlers 是包含您的函数处理程序的对象
• options 是包含特定配置的对象（见下文）

路由示例

var router = new $.mobile.Router([
    { "/index.html": { events: "i", handler: "index" } },
    { "/restaurant.html[?]id=(\\d+)": { events: "i", handler: "restaurantDetail" } },
    // 更多路由...
], ControllerObject, { ajaxApp: true });

配置选项

以下是一些可用的配置选项：

• ajaxApp: 布尔值，设置为 true 以匹配完整路径（pathname+search+hash）
• defaultArgsRe: 默认参数正则表达式，用于自动解析 URL 参数

4. 项目安装方式

项目的安装通常通过下载或克隆源代码到本地项目目录，然后通过 <script> 标签在 HTML 中引入相应的 JavaScript 文件。如前所述，确保 jQueryMobile-Router 脚本在 jQuery Mobile 脚本之后加载。

以上是 jQueryMobile-Router 的基本安装和使用指南。为了更深入地了解和使用该插件，请参考官方文档和 GitHub 项目的 wiki 页面。