FJRouter 2.0.4

FJRouter 2.0.4

×

Maintained by zgj.

FJRouter 2.0.4

  • By
  • zgj

FJRouter

安装

Swift Package Manager

使用 Swift PM 的最简单的方式是找到 Project Setting -> Swift Packages 并将 FJRouter 添加在其中。 搜索 https://github.com/zgjff/FJRouter 并

CocoaPods

在你的 Podfile 文件中添加 FJRouter:

pod 'FJRouter'

然后运行 pod install。

用法

注册路由

1: 关于路由结构FJRoute

路由的名称name: 建议注册路由的时候给路由设置名称, 原因有两点:

1: 当路由路径比较复杂,且含有参数的时候, 如果通过硬编码的方法直接手写路径, 可能会造成拼写错误,参数位置错误等

2: 在实际app中, 路由的URL格式可能会随着时间而改变, 但是一般路由名称不会去更改

设置路由的名称之后, 后续的跳转均可以通过name进行。

路由路径path: 路由路径的解析通过正则进行解析, 支持路径参数设置。eg:

路径/family/:fid, 可以匹配以/family/...开始的url, eg: /family/123, /family/456 and etc.

路径/user/:id/book/:bookId, 可以解析出参数分别需要id, bookId, 可以匹配/user/../book/...的url, eg: /user/123/book/456 and etc.

路由builder: 用于构建路由具体的控制器

路由拦截器interceptor: 这是一个路由拦截器协议, 具体要求如下：

/// 是否需要重定向
func needRedirect(state: FJRouterState) async -> Bool
    
/// 指向需要重定向的路由。
///
/// 可以携带参数.eg, 目标路由是`/family/:fid`, 则需要完整传入`fid`, 即`/family/123`
func redirectRoute(state: FJRouterState) async -> String

框架已经提供了一个通用的拦截器实现FJRouteCommonInterceptor

路由的显示逻辑displayAction: 一般用于匹配成功之后, 非自己调用push,present等自主操作行为。用于go(location: String......)等以go开头的跳转方法。 在这里可以随意的指定此路由对应控制器的配皮显示逻辑。eg:

push

displayAction: { sourceController, destController, state in
    sourceController.navigationController?.pushViewController(viewController, animated: true)
}

present

displayAction: { sourceController, destController, state in
    matchController.modalPresentationStyle = .fullScreen
    sourceController.present(viewController, animated: true)
}

设置app的rootViewController
```swift
displayAction: { sourceController, destController, state in
    UIApplication.shared.keyWindow?.rootViewController = matchController
}

自定义转场动画

displayAction: { sourceController, destController, state in
    matchController.modalPresentationStyle = .custom
    matchController.transitioningDelegate = xxx
    sourceController.present(matchController, animated: true)
}

甚至可以不用跳转至新控制器。如在观察到当前控制器与路由匹配到的是同一个控制器的情况下, 不跳转新的, 而是刷新当前的控制器内容

displayAction: { sourceController, destController, state in
    if type(of: sourceController) == type(of: destController) {
        sourceController.update(with: xxxxx)
    }
}

关联的子路由routes: 可以见同一个模块下的路由, 放在一起注册。

注意: 强烈建议子路由的path不要以/为开头

let route = try! FJRoute(path: "settings", builder: ..., routes: [
    try! FJRoute(path: "user", builder: ...),
    try! FJRoute(path: "pwd", builder: ...),
    try! FJRoute(path: "info/:id", builder: ...),
])

2: 注册

通过构建路由FJRoute对象进行注册:

FJRouter.shared.registerRoute(route: FJRoute)

直接通过路由path进行注册:

FJRouter.shared.registerRoute(path: String, ...)

设置路由

设置允许最大重定向的次数, 若是匹配的路由重定向次数超过设置值, 则会匹配失败.

FJRouter.shared.setRedirectLimit(50)

设置路由匹配失败时的显示页面, 框架内部默认使用的错误页面UI较简陋, 可以通过此方法调整设置

FJRouter.shared.setErrorBuilder { state in
    return UIViewController()
}

跳转

强烈建议跳转的时候使用以goNamed、pushNamed、presentNamed为前缀的方法进行跳转

1: 当路由路径比较复杂,且含有参数的时候, 如果通过硬编码的方法直接手写路径, 可能会造成拼写错误,参数位置错误等

2: 在实际app中, 路由的URL格式可能会随着时间而改变, 但是一般路由名称不会去更改

FJRouter.shared.goNamed("login")
FJRouter.shared.pushNamed("login")
FJRouter.shared.presentNamed("login")

go到匹配路由页面: 框架内部处理跳转到匹配路由页面的方式

会优先调用路由的displayAction方法; 若是displayAction为nil, 框架内部会先尝试push, 然后尝试present

FJRouter.shared.go(location: "/login")
FJRouter.shared.goNamed("user", params: ["id": "123"])

push到匹配路由页面

FJRouter.shared.push(location: "/login")
FJRouter.shared.pushNamed("user", params: ["id": "123"])

present到匹配路由页面

FJRouter.shared.present(location: "/login")
FJRouter.shared.presentNamed("user", params: ["id": "123"])