FFToast

Очень мощное расширение для уведомлений и AlertView в iOS. Оно позволяет легко создавать всплывающие уведомления в верхней, нижней или средней части экрана. Вид всплывающего окна можно легко настроить.

Изображения:

Инструкция на английском языке

Требования:

iOS 8 или более поздняя версия;
Автоматический подсчёт ссылок (ARC).

Особенности:

Простота использования;
Лёгкая настройка.

Установка:

CocoaPods

Чтобы установить FFToast с помощью CocoaPods, интегрируйте его в существующий Podfile или создайте новый:

target 'MyApp' do
  pod 'FFToast'
end

Затем запустите pod install.

Вручную

Добавьте папку FFToast в свой проект.

Использование:

#import <FFToast/FFToast.h>

Вы можете создать уведомление по умолчанию в верхней части экрана, вызвав следующий метод:

/**
 Создать и отобразить один Toast

 @param title Заголовок сообщения
 @param message Содержание сообщения
 @param iconImage Изображение сообщения, когда toastType не FFToastTypeDefault, iconImage пуст, но будет иметь соответствующий значок
 @param duration Продолжительность показа
 */
+ (void)showToastWithTitle:(NSString *)title message:(NSString *)message iconImage:(UIImage*)iconImage duration:(NSTimeInterval)duration toastType:(FFToastType)toastType;

Где toastType:

typedef NS_ENUM(NSInteger, FFToastType) {
    //Серый фон, без значка
    FFToastTypeDefault = 0,
    //Зелёный фон + значок успеха
    FFToastTypeSuccess = 1,
    //Красный фон + значок ошибки
    FFToastTypeError = 2,
    //Оранжевый фон + предупреждающий значок
    FFToastTypeWarning = 3,
    //Серо-голубой фон + информационный значок
    FFToastTypeInfo = 4,
};

Например:

[FFToast showToastWithTitle:@"This is the title" message:@"Message content......." iconImage:[UIImage imageNamed:@"test"] duration:3 toastType:FFToastTypeDefault];

Заголовок (title), сообщение (message), изображение (icon) могут быть пустыми, FFToast будет адаптироваться к конкретному содержанию.

Если вы хотите показать сообщение под строкой состояния, в нижней части экрана или в середине экрана, вы можете задать некоторые свойства для достижения этого. Задайте положение отображения:

typedef NS_ENUM(NSInteger, FFToastPosition) {

    //Отображается в верхней части экрана
    FFToastPositionDefault = 0,
    //Отображается ниже строки состояния
    FFToastPositionBelowStatusBar = 1,
    //Отображается ниже строки состояния + закруглённые углы + поля слева и справа
    FFToastPositionBelowStatusBarWithFillet = 2,
    //Отображается в нижней части экрана
    FFToastPositionBottom = 3,
    //Отображается в нижней части экрана + скругление
    FFToastPositionBottomWithFillet = 4,
    //Отображение в центре экрана
    FFToastPositionCentre = 5,
    //Отображение в центре экрана + скругление
    FFToastPositionCentreWithFillet = 6

};

Некоторые другие атрибуты:

//цвет фона
@property (strong, nonatomic) UIColor* toastBackgroundColor;
//Цвет текста заголовка Toast
@property (strong, nonatomic) UIColor* titleTextColor;
//Цвет текста содержимого Toast
@property (strong, nonatomic) UIColor* messageTextColor;

//Шрифт текста заголовка Toast
@property (strong, nonatomic) UIFont* titleFont;
//Шрифт текста Toast
@property (strong, nonatomic) UIFont* messageFont;

//Скругление угла Toast View
@property(assign,nonatomic)CGFloat toastCornerRadius;
//Прозрачность Toast View
@property(assign,nonatomic)CGFloat toastAlpha;

//Продолжительность отображения Toast
@property(assign,nonatomic)NSTimeInterval duration; // Тост-анимация исчезновения включена
@property(assign,nonatomic)BOOL dismissToastAnimated;

// Позиция отображения тоста
@property (assign, nonatomic) FFToastPosition toastPosition;
// Тип отображения тоста
@property (assign, nonatomic) FFToastType toastType;

// Автоматически ли скрывается. AutoDismiss, enableDismissBtn, dismissBtnImage Три свойства действительны только для всплывающих тостов из центра экрана
@property(assign,nonatomic)BOOL autoDismiss;
// Отображается ли скрытая кнопка в правом верхнем углу
@property(assign,nonatomic)BOOL enableDismissBtn;
// Скрыть значок кнопки
@property (strong, nonatomic) UIImage* dismissBtnImage;

После установки свойств вы можете вызвать следующий метод для его отображения:

/**
 Показать тост
 */
- (void)show;

или:

/**
 Показать тост

 @param handler Обратный вызов при нажатии на тост
*/
- (void)show:(handler)handler;

Например:

FFToast *toast = [[FFToast alloc]initToastWithTitle:@"title" message:@"Message content......." iconImage:[UIImage imageNamed:@"fftoast_info"]];
toast.toastPosition = FFToastPositionBelowStatusBarWithFillet;
toast.toastBackgroundColor = [UIColor colorWithRed:75.f/255.f green:107.f/255.f blue:122.f/255.f alpha:1.f];
[toast show:^{
    //Тост вызывается при нажатии
}];//[toast show];

Если вы хотите настроить тост из середины, вы можете вызвать следующий метод:

/**
 Показ пользовательского тоста посередине

 @param customToastView Настроенный ToastView
 @param autoDismiss Автоматическое скрытие
 @param duration Длительность отображения (autoDismiss = НЕТ этот параметр будет недействительным)
 @param enableDismissBtn Отображать ли скрытую кнопку
 @param dismissBtnImage Скрыть изображение кнопки (enableDismissBtn = НЕТ этот параметр будет недействителен)
 @return Тост
 */
- (instancetype)initCentreToastWithView:(UIView *)customToastView autoDismiss:(BOOL)autoDismiss duration:(NSTimeInterval)duration enableDismissBtn:(BOOL)enableDismissBtn dismissBtnImage:(UIImage*)dismissBtnImage;

При настройке тоста из середины вы можете установить параметры autoDismiss и параметр enableDismissBtn в значение NO. А затем в вашем пользовательском представлении в соответствующем месте добавьте кнопку закрытия. Чтобы закрыть тост из середины, можно вызвать следующий метод:

/**
 Скрыть тост
 */
- (void)dismissCentreToast;

Вверху и внизу всплывающего тоста нельзя настроить представление, но для iconImage, Title, message можно установить в соответствии с потребностями и может быть nil, окончательный тост будет основываться на конкретном содержании, чтобы адаптироваться.

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

##О

Автор: imlifengfeng
WeiBo: @imlifengfeng

Лицензия

Использование предоставляется по лицензии MIT. См. LICENSE для получения полной информации.

中文使用说明

FFToast — это очень мощный инструмент для уведомлений о сообщениях и расширений AlertView для iOS. Он может легко реализовать всплывающие уведомления сверху, снизу и посередине экрана. Вы можете легко настроить всплывающий вид.

Требования

Поддержка iOS 8 или более поздней версии
Поддержка ARC

Особенности

Простота использования
Легко настраивается

Установка

CocoaPods

Для использования CocoaPods для установки FFToast необходимо интегрировать его в существующий файл Podfile или создать новый файл Podfile:

target 'MyApp' do
  pod 'FFToast'
end

Затем pod install.

Вручную

Добавьте папку FFToast в проект.

Использование

#import <FFToast/FFToast.h>

Вы можете создать и отобразить всплывающее уведомление по умолчанию, вызвав следующий метод:

/**
 Создать и показать тост

 @param title Заголовок
 @param message Содержание сообщения
 @param iconImage Значок сообщения, если тип тоста не FFToastTypeDefault, iconImage будет пустым, но соответствующий значок всё равно будет отображаться
 @param длительность Отображение времени
 */
+ (void)showToastWithTitle:(NSString *)title message:(NSString *)message iconImage:(UIImage*)iconImage duration:(NSTimeInterval)duration toastType:(FFToastType)toastType;

Его тип toastType:

typedef NS_ENUM(NSInteger, FFToastType) {

    //Серый фон, без значка
    FFToastTypeDefault = 0,
    //Зелёный фон + значок успеха
    FFToastTypeSuccess = 1,
    //Красный фон + значок ошибки
    FFToastTypeError = 2,
``` ```
FFToastTypeWarning = 3,
FFToastTypeInfo = 4,

Например:

[FFToast showToastWithTitle:@"Заголовок" message:@"Содержание сообщения..." iconImage:[UIImage imageNamed:@"test"] duration:3 toastType:FFToastTypeDefault];

Заголовок (title), содержание сообщения (message) и значок (iconImage) могут быть равны nil, FFToast будет адаптироваться к конкретному содержанию.

Если вы хотите отобразить сообщение в нижней части экрана или в центре экрана, вы можете настроить некоторые свойства. Настройка положения отображения:

typedef NS_ENUM(NSInteger, FFToastPosition) {
    //Отображение в верхней части экрана
    FFToastPositionDefault = 0,
    //Отображение под строкой состояния
    FFToastPositionBelowStatusBar = 1,
    //Отображение с закруглёнными углами и отступами под строкой состояния
    FFToastPositionBelowStatusBarWithFillet = 2,
    //Отображение внизу экрана
    FFToastPositionBottom = 3,
    //Отображение снизу экрана с закруглёнными углами
    FFToastPositionBottomWithFillet = 4,
    //Отображение по центру экрана
    FFToastPositionCentre = 5,
    //Отображение по центру экрана с закруглёнными углами
    FFToastPositionCentreWithFillet = 6
};

Другие свойства:

//Цвет фона
@property (strong, nonatomic) UIColor* toastBackgroundColor;
//Цвет текста заголовка
@property (strong, nonatomic) UIColor* titleTextColor;
//Цвет текста сообщения
@property (strong, nonatomic) UIColor* messageTextColor;

//Шрифт текста заголовка
@property (strong, nonatomic) UIFont* titleFont;
//Шрифт текста сообщения
@property (strong, nonatomic) UIFont* messageFont;

//Радиус скругления углов Toast View
@property(assign,nonatomic)CGFloat toastCornerRadius;
//Прозрачность Toast View
@property(assign,nonatomic)CGFloat toastAlpha;

//Время отображения Toast
@property(assign,nonatomic)NSTimeInterval duration;
//Включать ли анимацию при скрытии Toast
@property(assign,nonatomic)BOOL dismissToastAnimated;

//Положение отображения Toast
@property (assign, nonatomic) FFToastPosition toastPosition;
//Тип отображения Toast
@property (assign, nonatomic) FFToastType toastType;

//Автоматически скрывать, autoDismiss, enableDismissBtn, dismissBtnImage — эти три свойства действуют только для Toast, отображаемого по центру экрана
@property(assign,nonatomic)BOOL autoDismiss;
//Показывать ли кнопку скрытия в правом верхнем углу
@property(assign,nonatomic)BOOL enableDismissBtn;
//Изображение кнопки скрытия
@property (strong, nonatomic) UIImage* dismissBtnImage;

После настройки свойств можно вызвать следующий метод для отображения:

/**
 Отображение Toast
 */
- (void)show;

или:

/**
 Отображение Toast

 @param handler Обратный вызов при нажатии на Toast
 */
- (void)show:(handler)handler;

Например:

FFToast *toast = [[FFToast alloc]initToastWithTitle:@"Заголовок" message:@"Сообщение..." iconImage:[UIImage imageNamed:@"fftoast_info"]];
toast.toastPosition = FFToastPositionBelowStatusBarWithFillet;
toast.toastBackgroundColor = [UIColor colorWithRed:75.f/255.f green:107.f/255.f blue:122.f/255.f alpha:1.f];
[toast show:^{
    //Вызов при нажатии на сообщение уведомления
}];//[toast show];

Если вы хотите создать собственный Toast, который отображается по центру, вы можете вызвать следующий метод:

/**
 Отображение пользовательского Toast по центру

 @param customToastView Пользовательский ToastView
 @param autoDismiss Следует ли автоматически скрывать
 @param duration Время отображения (параметр не действует, если autoDismiss = NO)
 @param enableDismissBtn Следует ли показывать кнопку скрытия
 @param dismissBtnImage Изображение кнопки скрытия (параметр не действует, если enableDismissBtn = NO)
 @return Toast
 */
- (instancetype)initCentreToastWithView:(UIView *)customToastView autoDismiss:(BOOL)autoDismiss duration:(NSTimeInterval)duration enableDismissBtn:(BOOL)enableDismissBtn dismissBtnImage:(UIImage*)dismissBtnImage;

При создании собственного Toast, который отображается по центру, можно установить параметры autoDismiss и enableDismissBtn равными NO. Затем добавьте кнопку закрытия в подходящем месте в вашем пользовательском View. Чтобы скрыть Toast, который отображается по центру, вызовите следующий метод:

/**
 Скрыть Toast
 */
- (void)dismissCentreToast;

Toast, которые отображаются сверху или снизу, нельзя создать с помощью пользовательского View, но значок (iconImage), заголовок (Title) и сообщение (message) можно настроить в соответствии с требованиями, и они могут быть равны нулю, Toast будет адаптироваться к содержимому.

Уведомление о сообщении скрывается автоматически через 3 секунды или при скольжении вверх.

OSCHINA-MIRROR/LiFengfeng-FFToast

FFToast

Изображения:

Инструкция на английском языке

Требования:

Особенности:

Установка:

CocoaPods

Вручную

Использование:

Лицензия

中文使用说明

Требования

Особенности

Установка

CocoaPods

Вручную

Использование

Комментарии ( 0 )

Введение

Обновления

Участники

Недавние действия

OSCHINA-MIRROR/LiFengfeng-FFToast .gitee-modal { min-width: 500px !important; } .gitee-modal .close { right: 0.6rem !important; }

FFToast

Изображения:

Инструкция на английском языке

Требования:

Особенности:

Установка:

CocoaPods

Вручную

Использование:

Лицензия

中文使用说明

Требования

Особенности

Установка

CocoaPods

Вручную

Использование

Комментарии ( 0 )

Введение

Обновления

Участники

Недавние действия

OSCHINA-MIRROR/LiFengfeng-FFToast