NYAlertViewController 使用教程

NYAlertViewController 使用教程

项目介绍

NYAlertViewController 是一个高度可配置的 iOS 弹窗视图，旨在替代 UIAlertController/UIAlertView。它支持自定义内容视图和丰富的 UI 定制选项。主要特性包括：

• 支持自定义内容视图
• 块状 API，类似于 UIAlertController/UIAlertAction
• 支持所有屏幕方向和 iPad 屏幕尺寸
• 简单 API 添加文本字段，与 UIAlertController 相同
• 可选的淡入淡出或滑动过渡动画

项目快速启动

安装

手动安装

将 NYAlertViewController 目录拖拽到你的 Xcode 项目中。

CocoaPods 安装

在你的 Podfile 中添加以下内容并运行 pod install：

pod 'NYAlertViewController'

使用示例

以下是一个简单的 Objective-C 示例，展示如何创建和显示一个自定义弹窗：

// 导入类
#import "NYAlertViewController.h"

// 创建 NYAlertViewController 实例
NYAlertViewController *alertViewController = [[NYAlertViewController alloc] init];

// 设置标题和消息
alertViewController.title = @"位置权限";
alertViewController.message = @"请允许应用访问您的位置。";

// 设置按钮
NYAlertAction *cancelAction = [NYAlertAction actionWithTitle:@"取消"
                                                       style:UIAlertActionStyleCancel
                                                     handler:^(NYAlertAction *action) {
                                                         [self dismissViewControllerAnimated:YES completion:nil];
                                                     }];

NYAlertAction *okAction = [NYAlertAction actionWithTitle:@"确定"
                                                   style:UIAlertActionStyleDefault
                                                 handler:^(NYAlertAction *action) {
                                                     [self dismissViewControllerAnimated:YES completion:nil];
                                                 }];

[alertViewController addAction:cancelAction];
[alertViewController addAction:okAction];

// 显示弹窗
[self presentViewController:alertViewController animated:YES completion:nil];

应用案例和最佳实践

自定义内容视图

你可以通过 contentView 属性添加自定义视图到弹窗中。例如，添加一个自定义的文本输入框：

// 创建一个自定义视图
UIView *customView = [[UIView alloc] initWithFrame:CGRectMake(0, 0, 200, 50)];
UITextField *textField = [[UITextField alloc] initWithFrame:CGRectMake(10, 10, 180, 30)];
textField.borderStyle = UITextBorderStyleRoundedRect;
[customView addSubview:textField];

// 设置自定义视图
alertViewController.contentView = customView;

最佳实践

• 使用 NYAlertViewController 替代系统默认的 UIAlertController，以获得更多的定制选项。
• 在需要显示复杂内容或自定义 UI 的场景中使用 contentView 属性。
• 确保在弹窗显示和隐藏时处理好视图控制器的生命周期。

典型生态项目

NYAlertViewController 可以与其他常用的 iOS 开源库结合使用，例如：

• Masonry：用于自动布局，简化自定义视图的布局代码。
• ReactiveCocoa：用于响应式编程，简化按钮点击和文本输入的处理逻辑。
• SVProgressHUD：用于显示加载指示器或简单的状态消息。

通过结合这些生态项目，你可以构建更加复杂和功能丰富的 iOS 应用。