目录
#AAPopUp
##描述
AAPopUp 是一个简单易用的弹出视图控制器,设计用于以模态警报的形式展示可自定义的故事板视图控制器,使用 Swift 编写。它支持基于标签和专用视图控制器实现的实现。
##演示
要运行示例项目,请克隆仓库,然后首先从 Example 目录运行 pod install
。
##要求
- iOS 8.0+
- Xcode 8.0+
- Swift 3+
安装
AAPopUp
可以使用 CocoaPods、Carthage 或手动方式安装。
##CocoaPods
AAPopUp
通过 CocoaPods 提供。要安装 CocoaPods,运行
$ gem install cocoapods
然后创建一个包含以下内容的 Podfile
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
use_frameworks!
target '<Your Target Name>' do
pod 'AAPopUp'
// Latest (Swift 4)
pod 'AAPopUp', :git => 'https://github.com/EngrAhsanAli/AAPopUp.git', :branch => 'master'
end
最后,运行以下命令来安装它
$ pod install
##Carthage
要安装 Carthage,运行(使用 Homebrew)
$ brew update
$ brew install carthage
然后添加以下行到您的 Cartfile
github "EngrAhsanAli/AAPopUp" "master"
然后在整个使用该库的文件中导入库
import AAPopUp
##手动安装
如果您不希望使用上述提到的依赖管理器之一,您可以通过将 Classes 文件夹中的文件添加到您的项目中来手动将 AAPopUp
集成到您的项目中。
开始使用
您需要将弹出窗口(UILabels、UIButtons等)的所有内容放在Storyboard的单个视图中
##定义全局选项
let options = AAPopUp.globalOptions
options.storyboardName = "Main"
options.dismissTag = 9
options.cornerRadius = 4.0
options.animationDuration = 0.3
options.backgroundColor = UIColor.black.withAlphaComponent(0.7)
##通过标识符定义弹出窗口
您可以像下面这样定义具有相应标识符的弹出窗口控制器
extension AAPopUp {
static let demo1 = AAPopUps<String? ,String>(identifier: "DemoPopup")
static let demo2 = AAPopUps<String? ,String>("Main" ,identifier: "DemoPopup")
}
请注意,Storyboard名称是可选的,您可以在GlobalOptions
中定义。
##构建您的第一个弹出窗口!
您只需按照以下方式通过传递您的基于视图控制器的弹出窗口来调用AAPopUp
构造函数
var popup: AAPopUp = AAPopUp(popup: <View Controller>)
##访问您的对象
您可以通过使用viewWithTag
函数如下简单地访问您的UILabel
、UIButton
等
let label = popup.viewWithTag(10) as! UILabel
label.text = “Label Text“
请注意,您可以在调用弹出窗口之前在
viewDidLoad
中定义您的属性或设置您的对象。
##显示您的弹出窗口
popup.present { popup in
// MARK:- View Did Appear Here
popup.dismissWithTag(9)
}
请注意,您可以在调用弹出窗口之后在
viewDidAppear
中定义您的属性或设置您的对象。
##辅助函数
您可以通过调用以下方法来关闭构建的弹出窗口
func dismissPopUpView(completion: (() -> ())? = nil)
您可以通过调用以下方法通过Storyboard中定义的标签获取任何视图
func viewWithTag(_ tag: Int) -> UIView?
您可以通过调用以下方法将默认动作设置为按钮来关闭
func dismissWithTag(_ tag: Int?)
#贡献与许可
AAPopUp
在MIT许可下可用。有关更多信息,请参阅LICENSE
文件。
欢迎提交拉取请求!最好的贡献将是替换或配置那些在典型应用程序生命周期中阻止主线程的类和方法。
如果您想了解您是否在自己的应用程序中使用AAPopUp
,请发送电子邮件至Eng. Ahsan Ali