依赖管理器

功能 | 安装 | 使用 | 定制

StatusAlert是一个iOS框架，用于显示类似于Apple系统自隐藏警告的状态提示。它非常适合以iOS方式通知用户，而不会打断用户流程。

它的外观与Podcasts、Apple Music和新闻应用中显示的警告几乎相同。

功能

• 类似系统外观和感觉
• 支持降低透明度模式
• 支持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 包管理器

使用 Swift 包管理器 安装 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 工作区中。要运行它，请克隆存储库。

用法

// 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

如果您在应用中使用此框架，请随时提交拉取请求。

作者

许可证

MIT许可证（MIT）

版权所有（c）2017-2018 LowKostKustomz [email protected]

特此允许任何获取此软件和相关文档文件（“软件”）副本的人，自由不受限制地处理该软件，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本，并允许向软件提供的人这样做，前提是遵守以下条件

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

本软件按“现状态”提供，不提供任何明示或默示的保证，包括但不限于适销性、针对特定目的的适用性和非侵权性。无论在任何行动中，无论是在合同、侵权或其他情况下，作者或版权所有人不对任何索赔、损害或其他责任负责，这些索赔、损害或其他责任源于、来自或与软件或其使用或与其他方式有关