# AXPopoverView

**Repository Path**: 3Liang/AXPopoverView

## Basic Information

- **Project Name**: AXPopoverView
- **Description**: AXPopoverView is an iOS customizable view that displays a bubble style view with a custom view when some messages need to show from a target view or a target rect.
- **Primary Language**: Objective-C
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2015-11-19
- **Last Updated**: 2022-10-20

## Categories & Tags

**Categories**: ios-modules

**Tags**: None

## README



# AXPopoverView[![Build Status](https://travis-ci.org/devedbox/AXPopoverView.svg?branch=master)](https://travis-ci.org/devedbox/AXPopoverView)[![Version](https://img.shields.io/cocoapods/v/AXPopoverView.svg?style=flat)](http://cocoapods.org/pods/AXPopoverView)[![License](https://img.shields.io/cocoapods/l/AXPopoverView.svg?style=flat)](http://cocoapods.org/pods/AXPopoverView)[![Platform](https://img.shields.io/cocoapods/p/AXPopoverView.svg?style=flat)](http://cocoapods.org/pods/AXPopoverView)

##Summary
`AXPopoverView` is an iOS customizable view that displays a bubble style view with a custom view when some messages need to show from a target view or a target rect. `AXPopoverView` contains how to use custom view to customize the popover view. The popover view (mostly used as `Label` or `Other`) is a convenient and hommization way for developer to use.

[![sample](http://image17-c.poco.cn/mypoco/myphoto/20151225/09/1786703522015122509434309.gif?371x657_110)](http://image17-c.poco.cn/mypoco/myphoto/20151225/09/1786703522015122509434309.gif?371x657_110)
[![sample](http://image17-c.poco.cn/mypoco/myphoto/20151225/09/17867035220151225095123023.gif?371x657_110)](http://image17-c.poco.cn/mypoco/myphoto/20151225/09/17867035220151225095123023.gif?371x657_110)
[![sample](http://image17-c.poco.cn/mypoco/myphoto/20151225/09/17867035220151225095137092.gif?371x657_110)](http://image17-c.poco.cn/mypoco/myphoto/20151225/09/17867035220151225095137092.gif?371x657_110)

## Features
>* Popover animation
>* Customizable
>* Translucent blur effect support
>* Customizable animator block support
>* UI_APPEARANCE_SELECTOR configuration
>* Scrollable

## Requirements

`AXPopoverView` works on any iOS version after `iOS 7.0`. It depends on the following Apple frameworks, which should already be included with most Xcode templates:

>* Foundation.framework
>* UIKit.framework
>* CoreGraphics.framework

You will need the latest developer tools in order to build AXPopoverView. Old Xcode versions might work, but compatibility will not be explicitly maintained.

## Adding AXPopoverView to your project

### CocoaPods

[CocoaPods](http://cocoapods.org) is the recommended way to add AXPopoverView to your project.

1. Add a pod entry for AXPopoverView to your Podfile `pod 'AXPopoverView', '~> 0.2.0'`
2. Install the pod(s) by running `pod install`.
3. Include AXPopoverView wherever you need it with `#import "AXPopoverView.h"`.

### Source files

Alternatively you can directly add the `AXPopoverView.h` and `AXPopoverView.m` source files to your project.

1. Download the [latest code version](https://github.com/devedbox/AXPopoverView/archive/master.zip) or add the repository as a git submodule to your git-tracked project. 
2. Open your project in Xcode, then drag and drop `AXPopoverView.h` and `AXPopoverView.m` onto your project (use the "Product Navigator view"). Make sure to select Copy items when asked if you extracted the code archive outside of your project. 
3. Include AXPopoverView wherever you need it with `#import "AXPopoverView.h"`.

## Usage

`AXPopoverView` support `UI_APPEARANCE_SELECTOR` to configure look of popover view will display on the screen. You should add your customizable code to `configuration block` when you using the `+ instance methods`.

###Showing&hiding

Using `showInRect:animated:completion:` `hideAnimated:afterDelay:completion:` to show popover view or hide. You can also using convenient methods to show the popover label like this:
```objective-c
[AXPopoverLabel showFromView:sender animated:YES duration:2.0 title:@"Your title." detail:@"Your detail contents." configuration:nil];
```
Oh, that's easy!!!

###appearance configuration

Using the selector masked as `UI_APPEARANCE_SELECTOR` to custimize the popover view when application has started.
```objcetive-c
[[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] setPreferredArrowDirection:AXPopoverArrowDirectionTop];
[[AXPopoverView appearance] setTitleTextColor:[UIColor whiteColor]];
[[AXPopoverView appearance] setDetailTextColor:[UIColor whiteColor]];
[[AXPopoverView appearance] setArrowConstant:6];
[[AXPopoverView appearance] setTranslucentStyle:AXPopoverTranslucentDefault];
[[AXPopoverView appearance] setAnimator:[AXPopoverViewAnimator animatorWithShowing:^(AXPopoverView * _Nonnull popoverView, BOOL animated, CGRect targetRect) {
    if (animated) {
        CGRect fromFrame = CGRectZero;
        fromFrame.origin = popoverView.animatedFromPoint;
        popoverView.transform = CGAffineTransformMakeScale(0, 0);
        popoverView.layer.anchorPoint = popoverView.arrowPosition;
        [UIView animateWithDuration:0.5 delay:0.0 usingSpringWithDamping:0.5 initialSpringVelocity:0.5 options:7 animations:^{
            popoverView.transform = CGAffineTransformIdentity;
        } completion:^(BOOL finish) {
            // Call `viewDidShow:` when the animation finished.
            if (finish) [popoverView viewDidShow:animated];
        }];
    }
} hiding:nil]];
```

###block configuration

Simply using a block to customize a specific popover view will show.
```objcetive-c
[AXPopoverView showFromView:sender animated:YES duration:2.0 title:@"Your title." detail:@"Your detail contents." configuration:^(AXPopoverView *popoverView) {
popoverView.showsOnPopoverWindow = NO;
popoverView.translucent = NO;
popoverView.preferredArrowDirection = AXPopoverArrowDirectionTop;
popoverView.translucentStyle = AXPopoverTranslucentLight;
}];
```
You can also use as this:

```objective-c
AXPopoverView *popoverView = [AXPopoverView new];
popoverView.title = @"Your title.";
popoverView.detail = @"Your detail contents.";
popoverView.showsOnPopoverWindow = NO;
popoverView.translucent = NO;
popoverView.preferredArrowDirection = AXPopoverArrowDirectionTop;
popoverView.translucentStyle = AXPopoverTranslucentLight;
[popoverView showFromView:sender animated:YES duration:2.0];
```
###UI Updates

UI updates should always be done on the main thread. like `setOffsets:`, `setArrowAngle:`, `setTitleFont:`, `setDetailFont:`, `setTranslucent:`, `setArrowCornerRadius:` and so on.

If you need to run your long-running task in the main thread, you should perform it with a slight delay, so UIKit will have enough time to update the UI (i.e., draw the HUD) before you block the main thread with your task.

```objective-c
if ([NSThread isMainThread]) {
/// Do updaing.
} else {
dispatch_async(dispatch_get_main_queue(), ^{
/// Do updating.
});
}
```


## License

This code is distributed under the terms and conditions of the [MIT license](LICENSE). 

## Change-log

Updating... 

### `0.2.0`@`2015.11.27 22:34`
Deleted `AXPopoverLabel` and merged `AXPopoverLabel` to `AXPopoverView`. You can use `AXPopoverView` instead of 
`AXPopoverLabel`. Enjoy!!!
### `0.3.0`@`2015.11.28 16:00`
Added:
>* 1. indicator view.
>* 2. progress view.
>* 3. button items.
>* 4. custom header view and footer view for customization.

Updated pod spec file to `0.3.0`
### `0.4.0`@`2015.12.24 17:40`
Added animator of animation to customize a showing/hiding animation. Both are using block. See `AXPopoverView+Animator` for more details.