依赖管理器

功能 | 安装 | 使用 | 自定义

StatusAlert 是一个 iOS 框架，用于显示类似于 Apple 系统自隐藏提示的通知。它非常适合在不中断用户流程的情况下以类似 iOS 的方式通知用户。

它看起来与 Podcasts、Apple Music 和 News 应用中显示的提示非常相似。

功能

系统级的观感
支持降低透明度模式
支持 VoiceOver
支持安全区域
通用 (iPhone & iPad)
支持 Objective-C

要求

Xcode 9.0 或更高版本
iOS 9.0 或更高版本
Swift 3.2 或更高版本

安装

CocoaPods

要使用 CocoaPods 安装 StatusAlert，请将以下行添加到您的 Podfile 中

pod 'StatusAlert', '~> 1.1.1'

Carthage

要使用 Carthage 安装 StatusAlert，请将以下行添加到您的 Cartfile 中

github "LowKostKustomz/StatusAlert" ~> 1.1.1

Swift Package Manager

要使用 Swift Package Manager 安装 StatusAlert，请将其添加到 Package.swift 文件中的依赖项中

dependencies: [
    .package(url: "https://github.com/LowKostKustomz/StatusAlert.git", .exact("1.1.1"))
]

手动安装

您还可以添加此项目

作为 git 子模块
只需下载并将源文件复制到您的项目中

Objective-C 集成

StatusAlert 与 Objective-C 完全兼容。要将其导入到您的项目中，只需添加以下行

@import StatusAlert;

演示

演示应用程序包含在 StatusAlert 工作区中。要运行它，请克隆 repo。

使用

// Importing framework
import StatusAlert

// Creating StatusAlert instance
let statusAlert = StatusAlert()
statusAlert.image = UIImage(named: "Some image name")
statusAlert.title = "StatusAlert title"
statusAlert.message = "Message to show beyond title"
statusAlert.canBePickedOrDismissed = isUserInteractionAllowed

// Presenting created instance
statusAlert.showInKeyWindow()

所有警报组件（image、title、message）都是可选的，但至少应存在一个。否则，show() 方法将被忽略。

重要提示

警报必须仅从主线程显示，否则应用程序将崩溃并显示相应的错误。

自定义

Wiki 包含更多内容和示例

不同的配置

显示具有任何图像、标题和消息的警报

垂直位置

在您想要的任何位置显示警报，无论是在视图的顶部、中心还是底部，以及任何偏移量。

外观

您可以通过 StatusAlert 的 appearance 属性自定义单个警报的外观，或者使用 StatusAlert.Appearance 的 common 属性一次性自定义所有警报的外观

var titleFont: UIFont
var messageFont: UIFont
var tintColor: UIColor
var backgroundColor: UIColor
var blurStyle: UIBlurEffect.Style

取消

警报将在 2 秒超时后自动隐藏。

您可以通过设置 alertShowingDuration 属性来更改警报显示持续时间。您还可以将 canBePickedOrDismissed 属性设置为 true。之后，您将能够通过点击警报手动取消警报，并通过长按警报延迟取消。

使用 StatusAlert 的应用

Bitxfy

NotifyMe

如果您在您的应用中使用此框架，请随时提交 pull request。

作者

许可证

MIT 许可证 (MIT)

版权所有 (c) 2017-2018 LowKostKustomz mierosh@gmail.com

特此授予任何人免费许可，以获取本软件及其相关文档文件（“软件”）的副本，以无限制地处理本软件，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或出售本软件的副本，并允许向其提供本软件的人员这样做，但须遵守以下条件

上述版权声明和本许可声明应包含在本软件的所有副本或主要部分中。

本软件按“原样”提供，不附带任何明示或暗示的保证，包括但不限于适销性、特定用途的适用性和不侵权的保证。在任何情况下，作者或版权持有人均不对任何索赔、损害或其他责任负责，无论是在合同、侵权行为或其他方面，由软件或软件的使用或其他处理引起或与之相关。

功能

要求

安装