效果样式

样式说明	Gif 图
提示警告框
上拉弹窗
菜单弹窗
日期、地址弹窗
吐司弹窗
指示器弹窗
下拉弹窗

API 说明

• 提供 6 种样式的对话框弹窗，对外接口统一，接入非常方便，对业务无侵入，可根据视觉自由定制属性参数
• 基于 UILabel、UITextView、UIPickerView、UITableView 等控件的自定义对话框
• 提醒框内容过多支持滑动显示，支持自定义视图，其中对文本框的键盘弹起期间进行了处理
• 地址选择框提供了默认的全国省份城市数据，三级联动选择，其中数据源支持外部配置
• 指示器加载框提供 2 种样式，若是不满足要求的话，外部支持自定义加载视图
• 菜单框提供 2 种样式吐司框提供 3 种样式，具体可自由配置
• 日期选择框提供 7 中样式，支持各个日期列是否联动

支持的弹窗样式

enum Style: Int {
    /// 提醒弹窗
    case alert = 0
    /// 上拉弹窗
    case actionSheet = 1
    /// 下拉弹窗
    case drop = 2
    /// 菜单弹窗
    case menu = 3
    /// 吐司弹窗
    case toast = 4
    /// 指示器弹窗
    case hud = 5
}

使用介绍

KeenAlertMsg 示例

支持的样式

/// 按钮布局方式
enum ItemAxisStyle: Int {
    /// 水平排列
    case horizontal
    /// 垂直排列
    case vertical
}

/// 自定义视图位置
enum ViewPostion: Int {
    /// 顶部
    case top
    /// 中间
    case middle
    /// 底部
    case bottom
}

属性对象 KeenAlertMsgAttributes 中可查看支持定制的参数属性

// ... 
/// 自定义视图 若控件包含文本框 需设置 observerKeyboard 属性
public var customView: UIView?
/// 自定义视图高度 必须指定 否则无效 默认 0
public var customViewHeight: CGFloat = 0
/// 自定义视图四周边距  top: 0pt left: 15pt bottom: 20pt right: 15pt
public var customViewInset = UIEdgeInsets(top:0, left:15, bottom:20, right:15)
/// 自定义视图位置 其位置相对(标题、消息)  默认 top
public var position: KeenAlertMsg.ViewPostion = .top
/// 键盘顶部间隔 默认 20pt 针对自定义视图含有文本框等控件
public var keyboardMargin: CGFloat = 20
/// 是否监听键盘事件 默认 false
public var observerKeyboard: Bool = false
// ...

使用示例

let view = UITextField()
view.backColor(.orange)
var attri = KeenAlertMsgAttributes()
attri.customView = view
attri.customViewHeight = 100
attri.position = .bottom
attri.observerKeyboard = true
showAlert(
    title: "乔巴语录",
    msg: "只要能成为你的力量，我就算变成真正的怪物也在所不惜",
    cancelTitle: "取消",
    doneTitle: "确定",
    callback: { index in
        print("index \(index)")
}, attributes: attri)

KeenActionSheet 示例

属性对象 KeenActionSheetAttributes 中可查看支持定制的参数属性

// ... 
/// 凸显 item 下标  默认 -1
public var highlightedIndex: Int = -1
/// 凸显 item 标题颜色 默认 #FF4644
public var highlightedColor: UIColor = UIColor.color(hexString: "#FF4644")
// ...

使用示例

var attri = KeenActionSheetAttributes()
attri.titleHeight = 45
// ...
showActionSheet(
    title: nil,
    items: ["拍摄\n照片或视频", "从手机相册选择", "用剪影制作视频"],
    highlightedIndex: -1,
    cancelTitle: "取消",
    callback: { index in
    print("index \(index)")
}, cancel: {
    print("cancel")
}, attributes: attri)

KeenDatePicker 示例

支持的样式

enum DateMode: String {
    /// 年月日时分
    case ymdhm = "yyyy-MM-dd HH:mm"
    /// 月日时分
    case mdhm = "MM-dd HH:mm"
    /// 年月日
    case ymd = "yyyy-MM-dd"
    /// 年月
    case ym = "yyyy-MM"
    /// 月日
    case md = "MM-dd"
    /// 时分
    case hm = "HH:mm"
    /// 年
    case y = "yyyy"
}

属性对象 KeenDatePicker 中可查看支持定制的参数属性

// ...
/// 选择结束是否自动记录数据 默认 false
public var autoRecord: Bool = false
/// 日期控件高度 默认 216pt
public var datePickerHeight: CGFloat = 216
/// 日期模式 默认 ymd
public var mode: KeenDatePicker.DateMode = .ymd
// ...

使用示例

var selectValue: String!
// ...
var attri = KeenDatePickerAttributes()
attri.autoRecord = true
// ...
showDate(
    mode: .ymd,
    title: "时间选择",
    defaultValue: selectValue,
    minDate: nil,
    maxDate: Date(),
    cancelTitle: "取消",
    doneTitle: "确定",
    callback: { value in
    print("value \(value)")
}, cancel: {
    print("cancel")
}, attributes: attri)

KeenAddressPicker 示例

属性对象 KeenAddressPickerAttributes 中可查看支持定制的参数属性

// ...
/// 选择结束是否自动记录数据 默认 false
public var autoRecord: Bool = false
/// 地址控件高度 默认 216pt
public var addressPickerHeight: CGFloat = 216
// ...

使用示例

var attri = KeenAddressPickerAttributes()
attri.autoRecord = true
// ...
showAddress(
    title: "地址选择",
    defaultValue: (self.province, self.city, self.area),
    cancelTitle: "取消",
    doneTitle: "完成",
    callback: { province, city, area in
    print("index \(province.index) \(province.name) \(province.code)")
    print("index \(city.index) \(city.name) \(city.code)")
    print("index \(area.index) \(area.name) \(area.code)")
    self.area = area
    self.city = city
    self.province = province
}, cancel: {
    print("cancel")
}, attributes: attri)

KeenMenuList 示例

支持的样式

enum ArrowPostion: Int {
    /// 顶部
    case top
    /// 底部
    case bottom
}

属性对象 KeenMenuListAttributes 中可查看支持定制的参数属性

// ...
/// 箭头宽度 默认 16pt
public var arrowWidth: CGFloat = 16
/// 箭头高度 默认 10pt
public var arrowHeight: CGFloat = 10
/// 箭头位置 默认 top
public var position: KeenMenuList.ArrowPostion = .top
// ...

使用示例

var selectIndex: Int = -1
// ...
var attri = KeenMenuListAttributes()
attri.highlightedColor = .red
// ...
showMenu(
    position: .top,
    origin: CGPoint(x: 100, y: 150),
    imgs: nil,
    items: ["唐三藏", "孙大圣", "猪八戒", "沙和尚", "如来佛", "观世音"],
    offsetX: 25,
    highlightedIndex: selectIndex,
    callback: { index in
    print("index \(index)")
    self.selectIndex = index
}, attributes: attri)

KeenToast 示例

支持的样式

enum Postion: Int {
    /// 顶部
    case top
    /// 居中
    case center
    /// 底部
    case bottom
}

属性对象 KeenToastAttributes 中可查看支持定制的参数属性

// ...
/// 视图左右的外边距 默认 40pt
public var viewMargin: CGFloat = 40
/// 视图内边距 默认 top: 8pt left: 15pt bottom: 8pt right: 15pt
public var viewInset: UIEdgeInsets = UIEdgeInsets(top:8, left:15, bottom:8, right:15)
/// 视图距离父视图顶部的偏移量 默认 100pt
public var viewOffsetTop: CGFloat = 100 + CGFloat.safeAreaTopHeight
/// 视图距离父视图底部的偏移量 默认 100pt
public var viewOffsetBottom: CGFloat = 100 + CGFloat.safeAreaBottomHeight

/// 视图位置 默认 center
public var position: KeenToast.Postion = .center
//...

使用示例

var attri = KeenToastAttributes()
attri.viewMargin = 30
// ...
showToast(
    title: "理解 swift 和 swiftUI 的编译方式",
    duration: 2,
    position: .bottom,
    attributes: attri,
    aView: nil
)

KeenHud 示例

支持的样式

enum Style: Int {
    /// 菊花
    case system
    /// 环形
    case torus
}

支持自定义加载视图，对应属性参数具体可查看KeenHudAttributes 类

// ...
/// 加载视图宽度 默认 40pt
public var itemWidth: CGFloat = 40
/// 加载视图高度 默认 40pt
public var itemHeight: CGFloat = 40
/// 自定义的加载视图
public var customView: UIView?
// ...

使用示例

/// 1.
var attri = KeenHudAttributes()
attri.viewRadius = 8
showHud(
    title: "正在加载",
    style: .torus,
    attributes: attri,
    aView: view
)
/// 模拟请求耗时
DispatchQueue.main.asyncAfter(deadline: .now() + 5) {[weak self] in
    self?.dismissHud(self?.view)
}

/// 2.
showHud()
/// 模拟请求耗时
DispatchQueue.main.asyncAfter(deadline: .now() + 5) {[weak self] in
    self?.dismissHud()
}

具体参数属性等配置可下载查看源码实现

安装方式

CocoaPods

platform :ios, '10.0'
use_frameworks!

target 'TargetName' do

pod 'KeenDialog'

end

iOS 版本要求 10.0+ Swift 版本要求 5.0+

Contact Me

QQ: 2209868966 邮箱: chongzone@163.com

若在使用过程中遇到什么问题, 请 issues 我, 看到之后会尽快修复

License

KeenDialog is available under the MIT license. See the LICENSE file for more info.