首页

时间和精神的房子
壹只iOS程序员的修行世界,欢迎来访

如果文章对您有所帮助
将是我最大的荣幸

开源工具 XFAssistiveTouch

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 安装

  1. 将 XFAssistiveTouch clone 或 download 到本地
  2. 将 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。用户只需直接与此类进行交互。

关注作者

分享本文

目录