Создание универсального UIAlertController’а для различных версий iOS

в 15:08, , рубрики: iOS, mobile development, objective-c, uialertcontroller

Одними из самых востребованных классов в UIKit до выхода iOS версии 8 являлись UIAlertView и UIActionSheet. Наверное, каждый разработчик приложений под мобильную платформу от Apple рано или поздно сталкивался с ними. Показ сообщений или меню выбора действий — это неотъемлемая часть практически любого пользовательского приложения. Для работы с этими классами, а точнее для обработки нажатий кнопок, программисту требовалось реализовывать в своем классе методы соответствующего делегата — UIAlertViewDelegate или UIActionSheetDelegate (если не требовалось чего-то сверх, то достаточно было реализовать метод clickedButtonAtIndex). На мой взгляд это очень неудобно: если внутри объекта создавалось несколько диалоговых окон с разными наборами действий, то их обработка все равно происходила в одном методе с кучей условий внутри. С выходом 8 версии iOS в составе UIKit появился класс UIAlertController, который пришел на смену UIAlertView и UIActionSheet. И одной из его главных отличительных черт является то, что вместо делегатов он использует блочный подход:

    UIAlertController *alertController = [UIAlertController alertControllerWithTitle:@"Hello" message:@"Habr!" preferredStyle:UIAlertControllerStyleAlert];
    
    [alertController addAction:[UIAlertAction actionWithTitle:@"Action" style:UIAlertActionStyleDefault handler:^(UIAlertAction *action) {
        // код обработчика кнопки
    }]];

Такой подход позволяет писать более структурированный и логичный код. Отныне программисту больше не требуется разделять создание диалогового окна и обработку событий — UIAlertController устраняет это недоразумение, но одновременно с этим привносит историческую несправедливость из-за невозможности использования в iOS 7 и более ранних версиях. Решить эту проблему можно несколькими способами:

  • Не обращать внимание на UIAlertController и продолжать использовать устаревшие UIAlertView и UIActionSheet.
  • Использовать нестандартные диалоговые окна. Программист либо пишет собственную реализацию, что приводит к увеличению временных затрат, либо подключает сторонние компоненты (например, SIAlertView), использование которых имеет ряд недостатков:
    1. программные модули с хорошей поддержкой можно пересчитать по пальцам (зачастую их создатели быстро забрасывают это неблагодарное дело);
    2. если в проекте используются несколько компонентов от разных разработчиков, то при их взаимодействии могут возникать проблемы (редко, но это возможно).

  • Проверять версию iOS и создавать либо UIAlertController, либо UIAlertView или UIActionSheet.

Последний вариант наиболее логичен, и большинство разработчиков, я уверен, выбрали бы именно его, но данный метод имеет существенный недостаток — условие проверки версии операционной системы придется писать каждый раз, когда потребуется отобразить диалоговое окно. Столкнувшись с этим на практике, я создал специальный класс-обертку UIAlertDialog, который позволяет забыть об этой проблеме.

Идея заключается в том, чтобы удобный блочный синтаксис UIAlertController'а можно было использовать в своих проектах не ограничиваясь последними версиями iOS.

Определив стиль диалогового окна

typedef NS_ENUM(NSInteger, UIAlertDialogStyle) {
    UIAlertDialogStyleAlert = 0,
    UIAlertDialogStyleActionSheet
};

и тип блока-обработчика

typedef void(^UIAlertDialogHandler)(NSInteger buttonIndex);

можно перейти к структуре класса:

@interface UIAlertDialog : NSObject <UIAlertViewDelegate, UIActionSheetDelegate>

- (instancetype)initWithStyle:(UIAlertDialogStyle)style title:(NSString *)title andMessage:(NSString *)message;
- (void)addButtonWithTitle:(NSString *)title andHandler:(UIAlertDialogHandler)handler;
- (void)showInViewController:(UIViewController *)viewContoller;

@end

Внутри конструктора

- (instancetype)initWithStyle:(UIAlertDialogStyle)style title:(NSString *)title andMessage:(NSString *)message {
    if (self = [super init]) {
        self.style = style;
        self.title = title;
        self.message = message;
        self.items = [NSMutableArray new];
    }
    
    return self;
}

переданные параметры сохраняются во

внутренние переменные

@interface UIAlertDialog ()

@property (nonatomic) UIAlertDialogStyle style;
@property (copy, nonatomic) NSString *title;
@property (copy, nonatomic) NSString *message;
@property (strong, nonatomic) NSMutableArray *items;

@end

и инициализируется массив (items), который будет хранить действия кнопок.

Добавление новой кнопки:

- (void)addButtonWithTitle:(NSString *)title andHandler:(UIAlertDialogHandler)handler {
    UIAlertDialogItem *item = [UIAlertDialogItem new];
    
    item.title = title;
    item.handler = handler;
    
    [self.items addObject:item];
}

где UIAlertDialogItem — это

специальный внутренний класс (аналог UIAlertAction)

@interface UIAlertDialogItem : NSObject

@property (copy, nonatomic) NSString *title;
@property (copy, nonatomic) UIAlertDialogHandler handler;

@end

который хранит в себе текст кнопки и действие, связанное с ней.

И, наконец, метод showInViewController, инкапсулирующий создание диалогового окна в зависимости от версии операционной системы:

- (void)showInViewController:(UIViewController *)viewContoller {
    if ([[UIDevice currentDevice].systemVersion intValue] > 7) {
        [[NSOperationQueue mainQueue] addOperationWithBlock:^{
            [self showAlertControllerInViewController:viewContoller];
        }];
        
        return;
    }
    
    if (self.style == UIAlertDialogStyleActionSheet) {
        [[NSOperationQueue mainQueue] addOperationWithBlock:^{
            [self showActionSheetInView:viewContoller.view];
        }];
    }
    else {
        [[NSOperationQueue mainQueue] addOperationWithBlock:^{
            [self showAlert];
        }];
    }
}

Акцентирую ваше внимание на том, что каждый соответствующий метод выполняется не сразу, а добавляется в главную очередь на выполнение. Это обусловлено тем, что если в обработчике кнопки создается другое диалоговое окно, то оно будет отображено только после завершения всей анимации предыдущего диалога.

Рассмотрим подробно методы создания диалоговых окон:

UIAlertController

- (void)showAlertControllerInViewController:(UIViewController *)viewController {
    UIAlertController *alertController = [UIAlertController alertControllerWithTitle:self.title message:self.message preferredStyle:self.style == UIAlertDialogStyleActionSheet ? UIAlertControllerStyleActionSheet : UIAlertControllerStyleAlert];
    
    NSInteger i = 0;
    
    for (UIAlertDialogItem *item in self.items) {
        UIAlertAction *alertAction = [UIAlertAction actionWithTitle:item.title style:UIAlertActionStyleDefault handler:^(UIAlertAction *action) {
            NSInteger buttonIndex = i;
            
            if (item.handler) {
                item.handler(buttonIndex);
            }
        }];
        
        [alertController addAction:alertAction];
        
        i++;
    }

    UIAlertAction *closeAction = [UIAlertAction actionWithTitle:NSLocalizedString(@"close", nil) style:UIAlertActionStyleCancel handler:nil];
    
    [alertController addAction:closeAction];
    
    [viewController presentViewController:alertController animated:YES completion:nil];
}

В этом листинге хотелось бы отметить строчку

NSInteger buttonIndex = i;

а точнее ее положение в коде. Благодаря свойству блока хранить контекст, в котором он был создан, становится возможным передача индекса нажатой кнопки в блок-обработчик. Такой способ необходим: UIAlertAction не содержит в себе нужного параметра.

UIAlertView и UIActionSheet

Согласно описанию UIAlertDialog, теперь создание диалогового окна выглядит следующим образом:

- (void)showMessage:(NSString *)message
{
    UIAlertDialog *alertDialog = [[UIAlertDialog alloc] initWithStyle:UIAlertDialogStyleAlert title:message andMessage:nil];

    [alertDialog showInViewController:self];
}

а в связи с тем, что этот класс является делегатом UIAlertView и UIActionSheet

@interface UIAlertDialog : NSObject <UIAlertViewDelegate, UIActionSheetDelegate>

необходимо разъяснить один момент.

Как известно, делегаты в классе описывают как свойства с модификатором weak. Это означает, что если strong ссылок на объект-делегат больше не существует, то при попытке вызвать методы делегата возникнет исключение EXC_BAD_ACCESS.

В нашем случае именно это и произойдет — ARC удалит alertDialog, так как внешних ссылок на него нет. Проблему можно решить, если создать классы-наследники UIAlertView и UIActionSheet, добавив в них ссылку на объект диалога:

@interface UIAlertViewDialog : UIAlertView

@property (strong, nonatomic) UIAlertDialog *alertDialog;

@end

и

@interface UIActionSheetDialog : UIActionSheet

@property (strong, nonatomic) UIAlertDialog *alertDialog;

@end

Благодаря проделанным манипуляциям код создания диалоговых окон примет следующий вид:

- (void)showActionSheetInView:(UIView *)view {
    UIActionSheetDialog *actionSheet = [[UIActionSheetDialog alloc] initWithTitle:self.title delegate:self cancelButtonTitle:nil destructiveButtonTitle:nil otherButtonTitles:nil];
    
    actionSheet.alertDialog = self;
    
    for (UIAlertDialogItem *item in self.items) {
        [actionSheet addButtonWithTitle:item.title];
    }
    
    [actionSheet addButtonWithTitle:NSLocalizedString(@"close", nil)];
    
    actionSheet.cancelButtonIndex = actionSheet.numberOfButtons - 1;
    
    [actionSheet showInView:view.window];
}

аналогично для UIAlertView

- (void)showAlert {
    UIAlertViewDialog *alertView = [[UIAlertViewDialog alloc] initWithTitle:self.title message:self.message delegate:self cancelButtonTitle:nil otherButtonTitles:nil];
    
    alertView.alertDialog = self;
    
    for (UIAlertDialogItem *item in self.items) {
        [alertView addButtonWithTitle:item.title];
    }
    
    [alertView addButtonWithTitle:NSLocalizedString(@"close", nil)];
    
    alertView.cancelButtonIndex = alertView.numberOfButtons - 1;
    
    [alertView show];
}

и финальный штрих — обработка действий кнопок, происходит в методе соответствующего делегата:

- (void)actionSheet:(UIActionSheetDialog *)actionSheet clickedButtonAtIndex:(NSInteger)buttonIndex {
    if (buttonIndex == actionSheet.numberOfButtons - 1) {
        return;
    }
    
    UIAlertDialogItem *item = self.items[buttonIndex];
    
    if (item.handler) {
        item.handler(buttonIndex);
    }
}

UIAlertViewDelegate

- (void)alertView:(UIAlertViewDialog *)alertView clickedButtonAtIndex:(NSInteger)buttonIndex {
    if (buttonIndex == alertView.numberOfButtons - 1) {
        return;
    }
    
    UIAlertDialogItem *item = self.items[buttonIndex];
    
    if (item.handler) {
        item.handler(buttonIndex);
    }
}

Заключение

В итоге получилось простое и компактное решение, которое позволит значительно сократить время на работу с диалоговыми окнами (исходный код).

Спасибо за внимание!

Автор: devnseven

Источник

* - обязательные к заполнению поля


https://ajax.googleapis.com/ajax/libs/jquery/3.4.1/jquery.min.js