https://github.com/xiaopin/iOS-Modal

iOS模态窗口
https://github.com/xiaopin/iOS-Modal

Last synced: 2 months ago
JSON representation

iOS模态窗口

• Host: GitHub
• URL: https://github.com/xiaopin/iOS-Modal
• Owner: xiaopin
• License: mit
• Created: 2018-04-18T03:48:33.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2020-06-28T00:38:34.000Z (over 4 years ago)
• Last Synced: 2024-08-03T18:21:42.367Z (6 months ago)
• Language: Objective-C
• Size: 480 KB
• Stars: 58
• Watchers: 3
• Forks: 5
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• Awesome-iOS - iOS-Modal - iOS 模态窗口，内置类似淘宝添加购物车的模态视图动画，内部使用 iOS8 推出的UIPresentationController来实现模态窗口功能。 (UI Effects)

README

        
# iOS-Modal

[![Build](https://img.shields.io/badge/build-passing-green.svg?style=flat)]()

[![Platform](https://img.shields.io/badge/platform-iOS-brown.svg?style=flat)]()

[![Language](https://img.shields.io/badge/language-Swift%20&%20Objective%20C-blue.svg?style=flat)]()

[![License](https://img.shields.io/badge/license-MIT-orange.svg?style=flat)]()

iOS 模态窗口，内置类似淘宝添加购物车的模态视图动画，内部使用 iOS8 推出的`UIPresentationController`来实现模态窗口功能。

该项目是[`SemiModal`](https://github.com/xiaopin/SemiModal.git)的增强版，在SemiModal的基础上增加了指定模态窗口出现的位置方向（参看`ModalDirection`枚举），以适应更多的使用场景。

## TODO

- 完善交互手势对滚动视图的支持

- ~~提供Objective-C版本（已提供）~~

## 特性

- 丰富的配置，适应多种使用场景

- 支持交互式转场动画（当启动背景动画时，建议关闭该功能）

- 简单易用的API，使用者只需关心 UIViewController 通过 extension 所提供的方法

## 环境要求

- iOS8.0+

- Swift4.0+ (Swift版本)

- Xcode9.0+

## 用法

- 将`UIViewController+Modal.swift`或`Modal-ObjC`文件夹拖入你的项目即可

- 示例代码

1. 弹出控制器

```Swift

let vc = UIViewController()

vc.view.backgroundColor = .cyan

presentModalViewController(vc, contentSize: CGSize(width: 200.0, height: 300.0), configuration: .default, completion: nil)

```

2. 弹出自定义视图

```Swift

let view = UIView()

view.backgroundColor = .brown

presentModalView(view, contentSize: CGSize(width: 200.0, height: 300.0), configuration: .default, completion: nil)

```

## 演示

[![GIF](./snapshot/preview.gif)]()

[![left](./snapshot/left.png)]()

[![right](./snapshot/right.png)]()

[![bottom](./snapshot/bottom.png)]()

[![center](./snapshot/center.png)]()

## 致谢

- [KNSemiModalViewController](https://github.com/kentnguyen/KNSemiModalViewController)

- [SemiModal](https://github.com/xiaopin/SemiModal.git)

- [Custom View Controller Presentations and Transitions](https://developer.apple.com/library/content/samplecode/CustomTransitions/Introduction/Intro.html#//apple_ref/doc/uid/TP40015158)

感谢他们对开源社区做出的贡献。

## 协议

被许可在 MIT 协议下使用，查阅`LICENSE`文件来获得更多信息。