Skip to content

Latest commit

 

History

History
executable file
·
211 lines (170 loc) · 6.44 KB

README IN CHINESE.md

File metadata and controls

executable file
·
211 lines (170 loc) · 6.44 KB
Raw

ELTabScrollChontroller: 简单易用的 Tab Scroll Controller, 使用 Swift 3 开发

Build Status Apps Using Downloads CocoaPods CocoaPods Platform

**:warning: ELTabScrollChontroller 适用于 Swift 3.X 和 iOS 9.X

截图

简单易用的 Tab Scroll Controller, 使用 Swift 3 开发

screenshots_1

安装方法

使用 CocoaPods

  • 在 podfile 中添加下面一行代码 : pod 'ELTabScrollChontroller'
  • Swift 3.* 对应 3.0.0 版本的 pod
  • Swift 4.* 对应 4.* 版本的 pod
  • 使用 Terminal 运行 pod install
  • 完成!

直接添加

  • 用浏览器打开 Elenionl/ELTabScrollChontroller
  • 下载或克隆项目: https://github.com/Elenionl/ELTabScrollController.git
  • 复制项目中的 ELTabScrollChontroller.swift 与 UIKit+EL.swift文件到您的项目中
  • 完成!

如何使用

如果您想在您的 App 中使用 ELTabScrollController, 只需要简单的两步:

  • 创建
class TabScrollController: ELTabScrollController {
    // MARK: - LifeCircle
    init() {
        super.init()
    }

或者在创建时指定类型

class TabScrollController: ELTabScrollController {
    // MARK: - LifeCircle
    init() {
        super.init(width: 200, type: .equal_scrollable)
    }
  • 添加要显示的内容
override func viewDidLoad() {
  super.viewDidLoad()
  let ctrl1 = ViewController(nibName: nil, bundle: nil)
  let ctrl2 = ViewController(nibName: nil, bundle: nil)
  let ctrl3 = ViewController(nibName: nil, bundle: nil)
  let ctrl4 = ViewController(nibName: nil, bundle: nil)
  let item1 = ELTabScrollItem(title: "Tab 1", image: nil, viewController: ctrl1, view: nil)
  let item2 = ELTabScrollItem(title: "Tab 2", image: nil, viewController: ctrl2, view: nil)
  let item3 = ELTabScrollItem(title: "Tab 3", image: nil, viewController: ctrl3, view: nil)
  let item4 = ELTabScrollItem(title: "Tab 4", image: nil, viewController: ctrl4, view: nil)
  items = [item1, item2, item3, item4]
}

ELTabScrollController 的类型

ELTabScrollController 共有四种类型

  • equal_unscrollable
  • equal_scrollable
  • unequal_unscrollable
  • unequal_scrollable

equal 所有按钮宽度相等

unequal 按钮宽度由其本身的 contentSize 决定

unscrollable tab 不可滚动且宽度等于 ELTabScrollController.width

scrollable tab 可以滚动, 宽度可能大于 ELTabScrollController.width

如果你想要只显示 ChildViewController 的某一个 view, 只需要如下操作

    let ctrl1 = ViewController(nibName: nil, bundle: nil)
    let item1 = ELTabScrollItem(title: "Tab 1", image: nil, viewController: ctrl1, view: ctrl1.tableView)

滑动分页或点击按钮会产生回调

  • 设置回调
self.switchHandler = { (index, type) in
    print(index, type)
}
  • 打印内容如下
2 buttonTap
2 buttonTap
3 buttonTap
1 buttonTap
1 buttonTap
0 scroll
0 scroll
1 scroll

按钮可以定制

⚠️ 对于 button 订制优先级低于对 tabScrollController 的设置, 例如 ELTabScrollController.buttonSelectedBackgroudColor 属性会覆盖掉 ELTabScrollItem.button 的设置.

  • 设置按钮的标题和图片
let item4 = ELTabScrollItem(title: "Tab 4", image: UIImage(named: "image"), viewController: ctrl4, view: nil)
  • 完全自定义按钮
public init(button: UIButton, viewController: UIViewController, view: UIView?)

ELTabScrollController 也可以自定义

override func viewDidLoad() {
  super.viewDidLoad()
  self.title = "Demo"
  tab.backgroundColor = UIColor.orange
  sliderView.backgroundColor = .white
  container.backgroundColor = UIColor.lightGray
  tabButtonHeight = 66
  sliderViewHeight = 10
  buttonFont = UIFont.boldSystemFont(ofSize: 18)
  buttonSelectedTitleColor = UIColor.white
  buttonNormalTitleColor = UIColor.lightGray
  switchHandler = { (index, type) in
    print(index, type)
  }
}

可用的设置

// MARK: - Settings

/// Items containing buttons and viewControllers

open var tabBarType: ELTabBarType = ELTabBarType.equal_unscrollable

/// Distance between buttons. Default value: 30.0 for scrollable, 0 for unscrollable.
open var tabSpacing: CGFloat

/// The zoom factor for buttons, only available in scrollable tabs. Default value: 1.05
open var buttonHorizontalZoomFactor: CGFloat = 1.05

/// Items containing buttons and viewControllers
open var items: [ELTabScrollItem]! = []

/// The width of the base view. Default value is screen width
open var width: CGFloat! = UIScreen.main.bounds.size.width

/// Triggered by switch behavior
open var switchHandler: ELSwitchHandler?

/// Height of button
open var tabButtonHeight: CGFloat = 44

/// Hight of slider
open var sliderViewHeight: CGFloat = 5

/// Font of button
open var buttonFont: UIFont?

open var buttonSelectedBackgroudColor: UIColor?

open var buttonNormalBackgroudColor: UIColor?

open var buttonSelectedTitleColor: UIColor?

open var buttonNormalTitleColor: UIColor?

要求

  • Xcode 8.X
  • Swift 3.X
  • Using ARC
  • iOS 9.0

TODO

  • ✅ More Tab Style
  • ❎ More Slider Style

作者

Hanping Xu (Elenionl), stellanxu@gmail.com

License

ELTabScrollController is available under the MIT license, see the LICENSE file for more information.