Github 地址：https://github.com/xiaofei86/XFAssistiveTouch
Weibo 地址：http://weibo.com/1750985774/DyST3Czzc
XFAssistiveTouch 是仿照 iOS 系统的辅助按钮 AssistiveTouch 制作的辅助按钮。你可以用在调试等场景中使用。
Getting Started
- 阅读本篇博客或 README 文档 了解 XFAssistiveTouch
- 下载 XFAssistiveTouch 运行 Examples 文件夹中的示例查看效果
- 参考 Installation 章节将 XFAssistiveTouch 集成在你的项目中
- 参考 Usage 章节或示例代码在你的项目中使用 XFAssistiveTouch
Communication
- 如果你需要使用上的帮助，请联系我 xuyafei86@163.com 。
- 如果你有使用上通用的问题，请新建 Issue。
- 如果你发现 BUG，请新建 Issue。
- 如果你对 XFAssistiveTouch 有新的需求，请新建 Issue。
- 如果你想帮助改善 XFAssistiveTouch，请提交 Pull Request。
Installation
XFAssistiveTouch 支持两种方式来安装
使用 cocoapods 安装
pod 'XFAssistiveTouch', '~>0.0.1'
通过 clone/download 安装
- 将 XFAssistiveTouch clone 或 download 到本地
- 将 XFAssistiveTouch 文件夹中的所有文件复制到你的项目中
Usage
显示 XFAssistiveTouch
- 导入头文件
#import "XFAssistiveTouch.h"
- 初始化 XFAssistiveTouch
XFAssistiveTouch *assistiveTouch = [XFAssistiveTouch sharedInstance];
assistiveTouch.delegate = self;
[assistiveTouch showAssistiveTouch];
- 实现 XFXFAssistiveTouchDelegate 来初始化 XFXFAssistiveTouch 的首页
@protocol XFXFAssistiveTouchDelegate <NSObject>
- (NSInteger)numberOfItemsInViewController:(XFATViewController *)viewController;
- (XFATItemView *)viewController:(XFATViewController *)viewController itemViewAtPosition:(XFATPosition *)position;
- (void)viewController:(XFATViewController *)viewController didSelectedAtPosition:(XFATPosition *)position;
@end
操作 XFXFAssistiveTouch
在实现 XFXFAssistiveTouchDelegate 时，你可以给首页的 XFATItemView 添加手势以便在点击的时候对 XFXFAssistiveTouch 或你项目的 UIViewController 进行交互。
XFXFAssistiveTouch 可进行的交互
- 展开 XFXFAssistiveTouch
- (void)spread;
- 收起 XFXFAssistiveTouch
- (void)shrink;
- 在 XFXFAssistiveTouch 展示下级 XFATViewController
- (void)pushViewController:(XFATViewController *)viewController atPisition:(XFATPosition *)position;
- 回到 XFXFAssistiveTouch 上级页面
- (void)popViewController;
XFXFAssistiveTouch 可与项目进行的交互
- 在 targetViewcontroller 中 push 或 present 提供的 viewController。
- (void)pushViewController:(UIViewController *)viewController atViewController:(UIViewController *)targetViewController;
- 自动找到项目中最上层的 ViewController push 或 present 提供的 viewController。
- (void)pushViewController:(UIViewController *)viewController;
Architecture
交互
文件
| 类 | 说明 |
|---|---|
| XFATLayoutAttributes | 提供方法返回某些固定的坐标和大小，用来适配 iPhone 和 iPad。 |
| XFATPosition | 对位置信息进行封装以隐藏计算细节，项目中传递位置信息的容器。 |
| XFATItemView | 项目中的基本视图，每个页面由最多 8 个组成。 |
| XFATViewController | 页面控制器，控制最多 8 个 XFATItemView |
| XFATNavigationController | 控制多个 XFATViewController 的切换、返回、展开、收起、移动、隐藏等行为及动画。 |
| XFATRootViewController | 继承自 XFATViewController，XFAssistiveTouch 的首页。 |
| XFAssistiveTouch | 用顶层 UIWindow 展示 XFATNavigationController。用户只需直接与此类进行交互。 |
