Skip to content
This repository has been archived by the owner on Sep 6, 2019. It is now read-only.

Commit

Permalink
1. 添加点击与滑动手势,现在点击与向上滑动横幅可以令横幅消失啦。
Browse files Browse the repository at this point in the history
2. 在.h文件中暴露3个宏定义,方便用户使用。
3. 暴露单例方法,提供1个用于设置样式的对象方法。
4. 暴露弹出提示窗与隐藏提示窗的方法。
  • Loading branch information
rakuyoMo committed Sep 23, 2017
1 parent 9ad4044 commit 4f64727
Show file tree
Hide file tree
Showing 6 changed files with 250 additions and 67 deletions.
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -63,3 +63,4 @@ fastlane/test_output
iOSInjectionProject/
RKOTextViewManager/.Archive/README.md
.Archive/README.md
RKOTopAlertManager/.Archive/README.md
16 changes: 13 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@
### RKOTextView

<p align="left">
<a href=""><img src="https://img.shields.io/badge/pod-v1.0.1-brightgreen.svg"></a>
<a href=""><img src="https://img.shields.io/badge/pod-v1.0.3-brightgreen.svg"></a>
<a href=""><img src="https://img.shields.io/badge/ObjectiveC-compatible-orange.svg"></a>
<a href=""><img src="https://img.shields.io/badge/platform-iOS%207.0%2B-ff69b5152950834.svg"></a>
<a href="https://github.com/rakuyoMo/RKOTools/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green.svg?style=flat"></a>
Expand Down Expand Up @@ -78,7 +78,7 @@
### RKOTopAlert
<p align="left">
<a href=""><img src="https://img.shields.io/badge/pod-v1.0.0-brightgreen.svg"></a>
<a href=""><img src="https://img.shields.io/badge/pod-v1.0.1-brightgreen.svg"></a>
<a href=""><img src="https://img.shields.io/badge/ObjectiveC-compatible-orange.svg"></a>
<a href=""><img src="https://img.shields.io/badge/platform-iOS%207.0%2B-ff69b5152950834.svg"></a>
<a href="https://github.com/rakuyoMo/RKOTools/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green.svg?style=flat"></a>
Expand All @@ -89,7 +89,7 @@
#### 集成:
```shell
pod 'RKOTopAlert', '~> 1.0.0'
pod 'RKOTopAlert', '~> 1.0.1'
```

#### 使用:
Expand All @@ -98,6 +98,16 @@
[RKOTopAlert popAlertViewWithText:@"提醒文字" textColor:[UIColor redColor] ackgroundColor:[UIColor blackColor];
```
或者:
```objc
// 创建单例并设置样式。
RKOTopAlert *topAlert = [[self sharedManager] alertViewWithText:@"提醒文字" textColor:[UIColor whiteColor] ackgroundColor:[UIColor redColor]];
// 出现
[topAlert alertAppearWithDuration:0.3f];
```

---------------------------------------------------------------------

## RKOTools
Expand Down
84 changes: 66 additions & 18 deletions RKOTopAlertManager/README.md
Original file line number Diff line number Diff line change
@@ -1,43 +1,54 @@
# RKOTopAlert

自定义一个顶端的`Alert`提示窗。

<p align="center">
<a href=""><img src="https://img.shields.io/badge/pod-v1.0.0-brightgreen.svg"></a>
<a href=""><img src="https://img.shields.io/badge/pod-v1.0.1-brightgreen.svg"></a>
<a href=""><img src="https://img.shields.io/badge/ObjectiveC-compatible-orange.svg"></a>
<a href=""><img src="https://img.shields.io/badge/platform-iOS%207.0%2B-ff69b5152950834.svg"></a>
<a href="https://github.com/rakuyoMo/RKOTools/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green.svg?style=flat"></a>
</p>

## 简介

自定义一个顶端的`Alert`提示窗。弹出时从顶端向下移动。

自定义一个顶端的`Alert`提示窗。弹出时从顶端向下移动。(**在iPhone X下可用**

可以设置**提示文字****文字颜色****背景颜色**

**高度**`Status` + `NavigationBar`的高度。(不论您的`ViewController`是否添加到`NavigationController`中)

注意:该控件有以下几点**未进行测试**
1. 编写时考虑到了自定义`NavigationBar`,但因为时间原因未进行测试。
2. 自定义`NavigationBar`,但自定义`NavigationBar`隐藏时的效果。
3. 原生`NavigationBar`隐藏时的情况。
3. 隐藏`Status`时的效果。
- 注意:该控件有以下几点**未进行测试**
1. 编写时考虑到了自定义`NavigationBar`,但因为时间原因未进行测试。
2. 自定义`NavigationBar`,但自定义`NavigationBar`隐藏时的效果。
3. 原生`NavigationBar`隐藏时的情况。
4. 隐藏`Status`时的效果。

如果在您的项目中用到了以上几点未测试的功能,请将您的结果告诉我,帮助我完善该控件。

## 已知问题

该控件还**未做自动布局**,故在横屏下会出现问题。

## 集成

```shell
pod 'RKOTopAlert', '~> 1.0.0'
pod 'RKOTopAlert', '~> 1.0.1'
```

## 使用

在需要弹出该提示窗的地方调用下面的方法
在需要弹出该提示窗的地方调用下面的方法:

```objc
[RKOTopAlert popAlertViewWithText:@"提醒文字" textColor:[UIColor whiteColor] ackgroundColor:[UIColor redColor];
```
如果您的`App`需要统一多个提示窗的样式,那么推荐您使用下面的方法:
```objc
[RKOTopAlert popAlertViewWithText:@"提醒文字" textColor:[UIColor redColor] ackgroundColor:[UIColor blackColor];
// 创建单例并设置样式。
RKOTopAlert *topAlert = [[self sharedManager] alertViewWithText:@"提醒文字" textColor:[UIColor whiteColor] ackgroundColor:[UIColor redColor]];
// 出现
[topAlert alertAppearWithDuration:0.3f];
```

## 接口
Expand All @@ -46,16 +57,53 @@

```objc
/**
设置提示窗的样式
* 设置提示窗的样式,并弹出提示窗。(其对象参数均不可为nil。)
@param text 提示窗显示文字,不能为nil。为空则设置无效
@param textColor 文字颜色
@param backgroundColor 提示窗背景颜色
@param duration 横幅持续显示的时间
* @param text 提示窗显示文字。
* @param textColor 文字颜色
* @param backgroundColor 提示窗背景颜色
* @param duration 横幅持续显示的时间
*/
+ (void)popAlertViewWithText:(NSString *)text
textColor:(UIColor *)textColor
ackgroundColor:(UIColor *)backgroundColor
duration:(CGFloat)duration;
```

此外,考虑到您可以需要统一的设置多个弹窗,我们提供如下的方法进行设置:

```objc
/**
* 单例方法,创建对象。
* @return 提示窗Alert。
*/
+ (RKOTopAlert *)sharedManager;

/**
* 设置样式。(其对象参数均不可为nil。)
* @param text 提示窗显示文字。
* @param textColor 文字颜色。
* @param backgroundColor 提示窗背景颜色。
*/
- (void)alertViewWithText:(NSString *)text
textColor:(UIColor *)textColor
ackgroundColor:(UIColor *)backgroundColor;
```

此外,我们分别提供了弹窗弹窗的**弹出**方法与**消失**方法,方便您在他处动态地控制弹窗的弹出与消失:

```objc
/**
* 弹出提示窗的方法。
* @param duration 横幅持续显示的时间。
*/
- (void)alertAppearWithDuration:(CGFloat)duration;

/**
* 令顶部提示窗消失的方法。
*/
- (void)alertDisappear;
```
4 changes: 2 additions & 2 deletions RKOTopAlertManager/RKOTopAlert.podspec
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
Pod::Spec.new do |s|

s.name = "RKOTopAlert"
s.version = "1.0.0"
s.version = "1.0.1"
s.summary = "Appears at the top of the notification view"
s.description = <<-DESC
Appears at the top of the notification view
Expand All @@ -23,7 +23,7 @@ Pod::Spec.new do |s|

s.ios.deployment_target = "7.0"

s.source = { :git => "https://github.com/rakuyoMo/RKOControls.git", :tag => "1.0.0" } # #{s.version}
s.source = { :git => "https://github.com/rakuyoMo/RKOControls.git", :tag => "1.0.4" } # #{s.version}

s.requires_arc = true

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,19 +8,63 @@

#import <UIKit/UIKit.h>

// 弹出动画的持续时间。
#define ALERT_APPEAR_ANIMATE_DURATION 0.4f
// 消失动画的持续时间。
#define ALERT_DISAPPEAR_ANIMATE_DURATION 0.3f
// 提示文字的字体大小。
#define FONTSIZE 20

NS_ASSUME_NONNULL_BEGIN

@interface RKOTopAlert : UIView

#pragma mark - 分别设置每个弹窗样式。
/**
设置提示窗的样式
@param text 提示窗显示文字,不能为nil。为空则设置无效
@param textColor 文字颜色
@param backgroundColor 提示窗背景颜色
@param duration 横幅持续显示的时间
* 设置提示窗的样式,并弹出提示窗。(其对象参数均不可为nil。)
* @param text 提示窗显示文字。
* @param textColor 文字颜色
* @param backgroundColor 提示窗背景颜色
* @param duration 横幅持续显示的时间
*/
+ (void)popAlertViewWithText:(NSString *)text
textColor:(UIColor *)textColor
ackgroundColor:(UIColor *)backgroundColor
duration:(CGFloat)duration;

#pragma mark - 统一设置App所有弹窗样式
/**
* 单例方法,创建对象。
* @return 提示窗Alert。
*/
+ (RKOTopAlert *)sharedManager;

/**
设置样式。(其对象参数均不可为nil。)
@param text 提示窗显示文字。
@param textColor 文字颜色。
@param backgroundColor 提示窗背景颜色。
*/
- (void)alertViewWithText:(NSString *)text
textColor:(UIColor *)textColor
ackgroundColor:(UIColor *)backgroundColor;

/**
* 弹出提示窗的方法。
* @param duration 横幅持续显示的时间。
*/
- (void)alertAppearWithDuration:(CGFloat)duration;

/**
* 令顶部提示窗消失的方法。
*/
- (void)alertDisappear;

@end

NS_ASSUME_NONNULL_END

Loading

0 comments on commit 4f64727

Please sign in to comment.