Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/minmao-hub/mmactionsheet

An actionSheet view implement with pure swift
https://github.com/minmao-hub/mmactionsheet

selectionmenu spm swift-package-manager swift4 swift5 uiactionsheet uialertaction uialertview-blocks

Last synced: 2 months ago
JSON representation

An actionSheet view implement with pure swift

Host: GitHub
URL: https://github.com/minmao-hub/mmactionsheet
Owner: MinMao-Hub
License: mit
Created: 2017-10-11T03:08:23.000Z (about 7 years ago)
Default Branch: master
Last Pushed: 2021-09-20T09:56:06.000Z (over 3 years ago)
Last Synced: 2024-10-12T15:01:39.969Z (2 months ago)
Topics: selectionmenu, spm, swift-package-manager, swift4, swift5, uiactionsheet, uialertaction, uialertview-blocks
Language: Swift
Homepage:
Size: 6.67 MB
Stars: 26
Watchers: 2
Forks: 6
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        

[![Building](https://img.shields.io/wercker/ci/wercker/docs.svg?style=flat)](https://cocoapods.org/pods/MMActionSheet) 

[![Language](https://img.shields.io/badge/language-Swift-orange.svg?style=flat)](https://github.com/MinMao-Hub/MMActionSheet)

[![CocoaPods compatible](https://img.shields.io/badge/pod-v1.3.1-blue.svg?style=flat)](https://cocoapods.org/pods/MMActionSheet) 

[![Platform](https://img.shields.io/badge/platform-ios-lightgrey.svg?style=flat)](https://github.com/MinMao-Hub/MMActionSheet)

[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg?style=flat)](http://opensource.org/licenses/MIT)

### Introduction

MMActionSheet 是一个简单的弹出选择框，使用纯swift编写，类似于微信的actionsheet

MMActionSheet is an simple pop-up selection box(ActionSheet) written in pure Swift. Similar to the wechat actionsheet

### Rquirements

* iOS 8.0+

* swift 4.0+

### Installation

#### Swift Package Manager

To install with Swift Package Manager, add this package to your project’s 'Swift Packages' section. Or add the following line to your Package.swift:

```

 .package(url: "https://github.com/MinMao-Hub/MMActionSheet.git", from: "2.0.0")

```

#### Install with  Cocoapods

* To install MMActionSheet using CocoaPods, integrate it in your existing Podfile, or create a new Podfile:

	```

	platform :ios, '8.0'

	use_frameworks!

	

	target 'MyApp' do

	  pod 'MMActionSheet', '~> 2.0'

	end

	```

* Execute command：  

	* `pod repo update master`

	* `pod install` 

* Import  MMActionSheet in you code

	*  `import MMActionSheet`

#### Manual import

Just [clone](https://github.com/MinMao-Hub/MMActionSheet.git) and add components dir to your project.

### Example

|desc|preview|

|:--:|:--:|

|Has `Cancel` buttons and `Title`
【有标题和取消按钮】|![](gifs/mmactionsheet_1.gif)|

|Has a `Cancel` button but no `Title`
【无标题有取消按钮】|![](gifs/mmactionsheet_2.gif)|

|No `Cancel` button and no `Title`
【无标题无取消按钮】|![](gifs/mmactionsheet_3.gif)|

|Has a `Title` but no `Cancel` button
【有标题无取消按钮】|![](gifs/mmactionsheet_4.gif)|

|Customize text color
【自定义文本颜色】|![](gifs/mmactionsheet_5.gif)|

|Customize title background color, etc
【自定义背景色、选中背景色等】|![](gifs/mmactionsheet_6.gif)|

|Multi data scrolling
【多数据滚动】|![](gifs/mmactionsheet_7.gif)|

|Set top CornerRadius
【设置顶部圆角】|![](gifs/mmactionsheet_8.gif)|

### Usage

```swift

let buttons = [

	MMButtonItem(title: "拍照", titleColor: .default, buttonType: .default(index: 0)),

	MMButtonItem(title: "相册", titleColor: .default, buttonType: .default(index: 1)),

]

let titleItem = MMTitleItem(title: "请选择照片", titleColor: .red)

let cancelButton = MMButtonItem(title: "取消", titleColor: .default, buttonType: .cancel)

let mmActionSheet = MMActionSheet(title: titleItem, buttons: buttons, duration: nil, cancelButton: cancelButton)

mmActionSheet.selectionClosure = { item in

    if let currentItem = item, let type = currentItem.buttonType {

        switch type {

        case let .default(index):

            print("== default index \(index) ==")

        case .cancel:

            print("cancel")

        }

    }

}

mmActionSheet.present()

```

*PS:注释*

* create actionsheet && init 【创建并初始化】

`MMActionSheet(title: titleItem, buttons: buttons, duration: nil, cancelButton: cancelButton)`

* argument【参数描述】

 

	* `title` 头部标题,类型为 `MMTitleItem `

	* `buttons` 事件按钮数组，类型为`Array`，里面包含每一个按钮的具体属性：

		

		```

		public var title: String?

		public var titleColor: MMButtonTitleColor? = .default

		public var titleFont: UIFont? = .systemFont(ofSize: 16.0)

		public var buttonType: MMButtonType?

		public var backgroudImageColorNormal: MMButtonTitleColor? = .custom(MMTools.DefaultColor.normalColor)

		public var backgroudImageColorHighlight: MMButtonTitleColor? = .custom(MMTools.DefaultColor.highlightColor)

		```

		* `title`   按钮标题

		* `titleColor ` 按钮颜色

		* `titleFont ` 按钮字体

		* `type`    按钮类型（展示不同的标题颜色）【枚举类型 - `default`,`blue`,`danger`, `custom`】

		* `backgroudImageColorNormal`   正常背景色

		* `backgroudImageColorHighlight`   选中背景色

	* `duration ` 动画时长

	* `cancelBtn `  取消按钮属性，属性跟上述buttons内部button属性一致；若设置为`nil`则不显示该按钮

* callback【回调】

```

mmActionSheet.selectionClosure = { item in

	if let currentItem = item, let type = currentItem.buttonType {

        switch type {

        case let .default(index):

            print("== default index \(index) ==")

        case .cancel:

            print("cancel")

        }

    }

}

```

 `item ` 该handler即为buttons里面的`MMButtonItem`，对应的回调过来

* present【弹出actionsheet】

`mmActionSheet.present()`

### Contribution

You are welcome to fork and submit pull requests.

### License

MMActionSheet is open-sourced software licensed under the MIT license.