1 В избранное 0 Ответвления 0

OSCHINA-MIRROR/3Liang-AXPopoverView

Клонировать/Скачать
README.md 8.1 КБ
Копировать Редактировать Web IDE Исходные данные Просмотреть построчно История
gitlife-traslator Отправлено 02.12.2024 10:30 83a4a3d

AXPopoverView

AXPopoverView — это настраиваемый вид для iOS, который отображает всплывающее окно в виде пузырька с пользовательским представлением, когда необходимо показать сообщения из целевого представления или целевой области. AXPopoverView содержит информацию о том, как использовать пользовательское представление для настройки всплывающего окна. Всплывающее окно (в основном используется как Label или Other) является удобным и привычным способом для разработчиков.

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

  • анимация всплывающего окна;
  • настраиваемость;
  • поддержка полупрозрачного эффекта размытия;
  • поддержка настраиваемого блока аниматора;
  • конфигурация UI_APPEARANCE_SELECTOR;
  • возможность прокрутки.

Требования:

AXPopoverView работает на любой версии iOS после iOS 7.0. Он зависит от следующих фреймворков Apple, которые уже должны быть включены в большинство шаблонов Xcode:

  • Foundation.framework;
  • UIKit.framework;
  • CoreGraphics.framework.

Вам понадобятся последние инструменты разработчика, чтобы создать AXPopoverView. Старые версии Xcode могут работать, но совместимость не будет поддерживаться явно.

Добавление AXPopoverView в проект:

Рекомендуется использовать CocoaPods для добавления AXPopoverView в ваш проект.

  1. Добавьте запись модуля для AXPopoverView в свой Podfile: pod 'AXPopoverView', '~> 0.2.0'.
  2. Установите модуль(ы), запустив pod install.
  3. Включите AXPopoverView везде, где вам это нужно, с помощью #import «AXPopoverView.h».

В качестве альтернативы вы можете напрямую добавить файлы AXPopoverView.h и AXPopoverView.m в свой проект.

  1. Загрузите последнюю версию кода или добавьте репозиторий в качестве подмодуля git в свой отслеживаемый проект.
  2. Откройте свой проект в Xcode, затем перетащите AXPopoverView.h и AXPopoverView.m на свой проект (используйте представление «Product Navigator»). Убедитесь, что вы выбрали «Копировать элементы», если вы извлекли архив кода за пределами своего проекта.
  3. Включите AXPopoverView везде, где вам это нужно, с помощью #import «AXPopoverView.h».

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

AXPopoverView поддерживает UI_APPEARANCE_SELECTOR для настройки внешнего вида всплывающего окна, которое будет отображаться на экране. Вы должны добавить свой настраиваемый код в блок конфигурации при использовании методов + instance.

Отображение и скрытие:

Используйте showInRect:animated:completion: или hideAnimated:afterDelay:completion:, чтобы отобразить всплывающее окно или скрыть его. Вы также можете использовать удобные методы для отображения всплывающей метки следующим образом:

[AXPopoverLabel showFromView:sender animated:YES duration:2.0 title:@"Ваш заголовок". detail:@"Содержание вашей детали". configuration:nil];

О, это просто!!!

Конфигурация внешнего вида:

Используя селектор, замаскированный как UI_APPEARANCE_SELECTOR, можно настроить всплывающее окно при запуске приложения.

[[AXPopoverView appearance] setBackgroundColor:[UIColor colorWithRed:0.165f green:0.639f blue:0.937f alpha:1.00f]];
[[AXPopoverView appearance] setBackgroundDrawingColor:[UIColor colorWithRed:0.165f green:0.639f blue:0.937f alpha:1.00f]];
[[AXPopoverView appearance]

*Примечание: перевод может содержать неточности.* **Конфигурация блока**

Простое использование блока для настройки определённого представления всплывающего окна.

[AXPopoverView showFromView:sender animated:YES duration:2.0 title:@"Ваш заголовок." detail:@"Содержимое деталей." configuration:^(AXPopoverView *popoverView) { popoverView.showsOnPopoverWindow = NO; popoverView.translucent = NO; popoverView.preferredArrowDirection = AXPopoverArrowDirectionTop; popoverView.translucentStyle = AXPopoverTranslucentLight; }];

Также можно использовать так:

AXPopoverView *popoverView = [AXPopoverView new]; popoverView.title = @"Ваш заголовок."; popoverView.detail = @"Содержимое деталей."; popoverView.showsOnPopoverWindow = NO; popoverView.translucent = NO; popoverView.preferredArrowDirection = AXPopoverArrowDirectionTop; popoverView.translucentStyle = AXPopoverTranslucentLight; [popoverView showFromView:sender animated:YES duration:2.0];

**Обновления пользовательского интерфейса**

Обновления пользовательского интерфейса всегда должны выполняться в основном потоке. Например, `setOffsets:`, `setArrowAngle:`, `setTitleFont:`, `setDetailFont:`, `setTranslucent:`, `setArrowCornerRadius:` и так далее.

Если вам нужно запустить длительную задачу в основном потоке, вы должны выполнить её с небольшой задержкой, чтобы у UIKit было достаточно времени для обновления пользовательского интерфейса (например, отрисовки HUD), прежде чем вы заблокируете основной поток своей задачей.

if ([NSThread isMainThread]) { /// Выполнить обновление. } else { dispatch_async(dispatch_get_main_queue(), ^{ /// Выполнить обновление. }); }


## Лицензия

Этот код распространяется на условиях [лицензии MIT](LICENSE).

## Журнал изменений

Обновление...

### `0.2.0`@`2015.11.27 22:34`
Удалено `AXPopoverLabel` и объединено `AXPopoverLabel` с `AXPopoverView`. Вы можете использовать `AXPopoverView` вместо `AXPopoverLabel`. Наслаждайтесь!!!
### `0.3.0`@`2015.11.28 16:00`
Добавлено:
>* 1. индикаторное представление.
>* 2. представление прогресса.
>* 3. элементы кнопок.
>* 4. настраиваемое представление заголовка и представление нижнего колонтитула для настройки.

Обновлено pod-описание до `0.3.0`.
### `0.4.0`@`2015.12.24 17:40`
Добавлен аниматор анимации для настройки показа/скрытия анимации. Оба используют блок. Подробнее см. `AXPopoverView+Animator`.

Опубликовать ( 0 )

Вы можете оставить комментарий после Вход в систему

1
https://api.gitlife.ru/oschina-mirror/3Liang-AXPopoverView.git
git@api.gitlife.ru:oschina-mirror/3Liang-AXPopoverView.git
oschina-mirror
3Liang-AXPopoverView
3Liang-AXPopoverView
master