目录
#AADraggableView
##描述
AADraggableView 是一个轻量级、易于使用的可拖拽视图,可在屏幕边界内拖拽任何 UIView
,并设计有用于拖拽的选项。它允许在任何视图控制器中拖拽 UIView
。
##演示
您可以通过以下值定义拖拽后的重新定位
-- sticky
视图将粘在边缘并带有填充。
-- free
视图将可在整个屏幕中自由移动
-- edgesOnly
视图将仅粘在附近的边缘
-- topOnly
视图将粘在顶部边缘
-- bottomOnly
视图将粘在底部边缘
-- leftOnly
视图将粘在左侧边缘
-- rightOnly
视图将粘在右侧边缘
要运行示例项目,首先克隆仓库,然后从 Example 目录运行 pod install
##要求
- iOS 8.0+
- Xcode 8.0+
- Swift 3+
安装
AADraggableView
可使用 CocoaPods、Carthage 或手动安装。
##CocoaPods
AADraggableView
通过 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 'AADraggableView'
end
最后,运行以下命令进行安装
$ pod install
##Carthage
要安装 Carthage,运行(使用 Homebrew)
$ brew update
$ brew install carthage
然后将以下行添加到您的 Cartfile
github "EngrAhsanAli/AADraggableView" "master"
然后将其导入所有使用它的文件中
import AADraggableView
##手动安装
如果您不想使用上述提到任何依赖项管理器,您可以通过将类文件夹中的文件添加到您的项目中来手动将 AADraggableView
集成到您的项目中。
开始使用
##创建可拖拽视图对象
从 对象库 中将 UIView
对象拖入 Storyboard 中的 UIViewController
。
##设置为可拖拽视图
在 身份检查器 中将视图的类设置为 AADraggableView
。确保模块属性也已设置为 AADraggableView
。
##设置属性和用法
您可以在视图控制器的 viewDidLoad
方法中设置以下属性。
用法:
// IBOutlet for AADraggableView
@IBOutlet weak var view: AADraggableView
// Set options
view.delegate = self // AADraggableViewDelegate
view.respectedView = // reference view
view.reposition = // Reposition option
view.repositionIfNeeded() // Auto correct reposition
// Add delegate methods and observe changes!
func draggingDidBegan(_ sender: UIView) {
// Dragging did began of sender
}
func draggingDidEnd(_ sender: UIView) {
// Dragging did end of sender
}
##具有描述的属性
您可以使用以下属性
属性 | 类型 | 描述 |
---|---|---|
padding |
CGFloat |
重新定位时从边缘的填充 |
duration |
TimeInterval |
重新定位动画的持续时间 |
respectedView |
UIView? |
用于参考视图边界的受尊敬的 UIView |
reposition |
重新定位 |
具有选项的重新定位枚举 |
isEnabled |
Bool |
用户拖动启用或禁用 |
##贡献与许可
AADraggableView
在 MIT 许可下提供。有关更多信息,请参阅 LICENSE 文件。
欢迎提交拉取请求!最好的贡献将包括替换或配置在典型应用程序生命周期中会阻塞主线程的类/方法。
如果您在应用程序中使用 AADraggableView
,请发送邮件至 Engr. Ahsan Ali