🎈 什么是 Hover?
Hover (/ˈhɒv.ər/),动词
"在空中停留一个位置"
Hover 是一个可拖动的 悬浮操作按钮 (FAB),灵感来自苹果的会议 设计流体界面 & Nathan Gitter 的 流体界面。Hover 会始终粘附到最近的角落,避免遮挡内容,并允许用户通过一次轻扫将其发送到任何其他角落。
📦 安装
CocoaPods
将以下行添加到您的 podfile
pod 'Hover'
然后在终端中运行以下命令
pod install
Carthage
将以下行添加到您的 cartfile
github "pedrommcarrasco/Hover"
然后在终端中运行以下命令
carthage update
Swift Package Manager
要将 Hover 添加到 Swift Package Manager 包中,请将其添加到您的 Package.swift
文件中定义的 dependencies
属性。例如
dependencies: [
.package(url: "https://github.com/pedrommcarrasco/Hover.git", from: <version>),
]
🖱️ 使用示例
安装 Hover 后,您应该首先导入框架
import Hover
导入后,您可以像以下这样开始使用 Hover
// Create Hover's Configuration (all parameters have defaults)
let configuration = HoverConfiguration(image: UIImage(named: "add"), color: .gradient(top: .blue, bottom: .cyan))
// Create the items to display
let items = [
HoverItem(title: "Drop it Anywhere", image: UIImage(named: "anywhere")) { print("Tapped 'Drop it anywhere'") },
HoverItem(title: "Gesture Driven", image: UIImage(named: "gesture")) { print("Tapped 'Gesture driven'") },
HoverItem(title: "Give it a Star", image: UIImage(named: "star")) { print("Tapped 'Give it a star'") }
]
// Create an HoverView with the previous configuration & items
let hoverView = HoverView(with: configuration, items: items)
// Add to the top of the view hierarchy
view.addSubview(hoverView)
hoverView.translatesAutoresizingMaskIntoConstraints = false
// Apply Constraints
// Never constrain to the safe area as Hover takes care of that
NSLayoutConstraint.activate(
[
hoverView.topAnchor.constraint(equalTo: view.topAnchor),
hoverView.bottomAnchor.constraint(equalTo: view.bottomAnchor),
hoverView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
hoverView.trailingAnchor.constraint(equalTo: view.trailingAnchor)
]
)
有关您可以配置的所有参数的详细信息,请参阅 HoverConfiguration.swift
。
📱 示例项目
此存储库中有一个名为 Example 的示例项目,其中包含 Hover 的几个示例。
❤️ 支持 Hover
大家好
我是 Pedro,自 2017 年 2 月以来的一位葡萄牙 iOS 工程师。我是一个热衷于 OSS 并贡献者 - 通过分享来帮助,通过分享来学习。
我已经构建并开源了多个框架和应用程序,包括 Brooklyn 和 CocoaHub。
我还是一名会议和聚集的组织者,是 SwiftAveiro 和 CocoaHeads Porto 的成员。
如果您喜欢我的工作并且想要帮助我继续它,请考虑以下方式
- https://github.com/users/pedrommcarrasco/sponsorship
- https://www.buymeacoffee.com/pedrommcarrasco
- https://www.paypal.me/pedrommcarrasco
🙌 贡献
您可以非常自由地向该项目贡献,通过 报告错误 或打开 拉取请求。
Hover 是为了个人使用而创建的,但足够灵活,可以成为一个开源框架。因此,尽管它功能齐全,可能还需要一些额外的定制。如果您缺少某些内容,或者需要其他帮助,请随时在这里或 Twitter 上询问我。
⛔ 许可证
Hover 可在 MIT 许可证下使用。有关更多信息,请参阅 LICENSE 文件。