Swift之自定义标签栏UITabBarController (Swift项目开始的第一步)_swift uitabbardelegate

自定义UITabbarController进而自定义UITabbar，这通常会是一个iOS项目开始的重要环节。在Swift的学习过程中，个人感觉虽说两种语言的相似度很大，但是Swift依然在代码风格上有着和OC很大的差异。在总结了一些基本的用法之后，我尝试使用Swift自定义UITabBarController和UITabbar，开启这Siwft项目的关键一步，首先展示一下效果图：

第一步：创建Swift工程

1.使用Xcode创建一个Swift初始项目ZSTestSwift，效果如下：

这里首先删除工程文件下的ViewController.swift、Main.StoryBoard 和TARGETS下MainInterFace中的Main，因为我们要使用纯代码的方式来创建标签栏控制器，系统自带Main.StoryBoard的xib形式的界面我们并不需要。

第二步：准备资源文件

1.在Assets.xcassets中存放标签栏按钮所需要的图片资源

2.创建标签配置Plist文件，并且在Plist文件中设置视图控制器的类名、Title、标签栏图片等信息

这里做下说明，之所以创建这个plist文件是因为在之后创建视图控制器和标签按钮时会有很大的便利性，而且也十分方便真实开发过程中的需求更改。

第三步：创建视图控制器

自定义导航控制器和视图控制器的父类，并且创建三个继承于BaseViewController的视图控制器(因为没有过多复杂操作，这里省略代码)，为之后创建标签控制器做准备。创建之后的效果如图：

第四步：创建自定义的标签视图控制器和自定义UITabbar

1.创建自定义标签控制器MainTabBarController，其关键代码如下：

  class MainTabBarController: UITabBarController, MainTabBarDelegate{

    var tarbarConfigArr:[Dictionary<String,String>]! //标签栏配置数组，从Plist文件中读取
    var mainTabBarView: MainTabBarView! //自定义的底部TabbarView

    //MARK: - Life Cycle
    override init(nibName nibNameOrNil: String?, bundle nibBundleOrNil: Bundle?){
        //1.调用父类的初始化方法
        super.init(nibName: nil, bundle: nil)
        //2.读取Plist文件,初始化标签栏配置数组
        self.tarbarConfigArr = self.getConfigArrFromPlistFile()
        //3.创建视图控制器
        self.createControllers()
        //4.创建自定义TabBarView
        self.createMainTabBarView()
    }

    required init?(coder aDecoder: NSCoder){
        fatalError("init(coder:) has not been implemented")
    }

    override func viewDidLoad(){
        super.viewDidLoad()
    }

    override func viewWillAppear(_ animated: Bool){
        super.viewWillAppear(animated)
    }


    //MARK: - Private Methods
    //读取Tabbar配置文件
    private  func  getConfigArrFromPlistFile() ->([Dictionary<String,String>]?){
        let  filePath: String? = Bundle.main.path(forResource: "TabBarConfig", ofType: "plist")
        let plistData = NSDictionary(contentsOfFile: filePath ?? "")
        let configArr = plistData?.object(forKey: "Tabbars") as? [Dictionary<String,String>]
        return configArr;
    }

    //创建视图控制器
    private func createControllers(){
        var controllerNameArray = [String]() //控制器类名数组
        var controllerTitle = [String]()     //控制器Title数组
        for dictionary in self.tarbarConfigArr{
            controllerNameArray.append(dictionary["ClassName"]!);
            controllerTitle.append(dictionary["Title"]!)

        guard controllerNameArray.count > 0 else{
            print("error:控制器数组为空")
            return
        }
        //初始化导航控制器数组
        var nvcArray = [BaseNavigationViewController]()
        //在Swift中, 通过字符串创建一个类, 那么必须加上命名空间clsName
        let clsName = Bundle.main.infoDictionary!["CFBundleExecutable"] as! String
        for i in 0...controllerNameArray.count-1 {
            //动态获取的命名空间是不包含.的, 所以需要我们自己手动拼接
            let anyClass: AnyClass? = NSClassFromString(clsName + "." + controllerNameArray[i])
            //将AnyClass类型转换为BaseViewController类型，
            //因为Swift中通过一个Class来创建一个对象, 必须告诉系统这个Class的确切类型
            if let vcClassType = anyClass as? BaseViewController.Type {
                let viewcontroller = vcClassType.init()
                viewcontroller.title = controllerTitle[i]
                let nav = BaseNavigationViewController(rootViewController:viewcontroller)
                nvcArray.append(nav)
            }
        }
        //设置标签栏数组
        self.viewControllers = nvcArray
        }
    }

    //创建自定义Tabbar
    private func createMainTabBarView(){
        //1.获取系统自带的标签栏视图的frame,并将其设置为隐藏
        let tabBarRect = self.tabBar.frame;
        self.tabBar.isHidden = true;
        //3.使用得到的frame，和plist数据创建自定义标签栏
        mainTabBarView = MainTabBarView(frame: tabBarRect,tabbarConfigArr:tarbarConfigArr!);
        mainTabBarView.delegate = self
        self.view .addSubview(mainTabBarView)
    }

    //MARK: - MainTabBarDelegate
    func didChooseItem(itemIndex: Int) {
        self.selectedIndex = itemIndex
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88

2.创建自定义的标签栏MainTabBarView，其关键代码如下：

  //自定义标签栏代理协议
protocol MainTabBarDelegate {
    func didChooseItem(itemIndex:Int)
}

class MainTabBarView: UIView {
    var delegate:MainTabBarDelegate? //代理,点击item
    var itemArray:[MainTabBarItem] = [] //标签Item数组

    init(frame: CGRect,tabbarConfigArr:[Dictionary<String,String>]) {
        super.init(frame: frame)
        self.backgroundColor = UIColor.white
        let screenW = UIScreen.main.bounds.size.width
        let itemWidth = screenW / CGFloat(tabbarConfigArr.count)
        for i in 0..<tabbarConfigArr.count{
            let itemDic = tabbarConfigArr[i];
            let itemFrame = CGRect(x: itemWidth * CGFloat(i) , y: 0, width: itemWidth, height: frame.size.height)
            //创建Item视图
            let itemView = MainTabBarItem(frame: itemFrame, itemDic:itemDic, itemIndex: i)
            self.addSubview(itemView)
            self.itemArray.append(itemView)
            //添加事件点击处理
            itemView.tag = i
            itemView.addTarget(self, action:#selector(self.didItemClick(item:))  , for: UIControlEvents.touchUpInside)
            //默认点击第一个,即首页
            if i == 0 {
                self .didItemClick(item: itemView)
            }
        }
    }

    required init?(coder aDecoder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }

    //点击单个标签视图，通过currentSelectState的属性观察器更新标签item的显示
    //并且通过代理方法切换标签控制器的当前视图控制器
    func didItemClick(item:MainTabBarItem){
        for i in 0..<itemArray.count{
            let tempItem = itemArray[i]
            if i == item.tag{
                tempItem.currentSelectState = true
            }else{
                tempItem.currentSelectState = false
            }
        }
        //执行代理方法
        self.delegate?.didChooseItem(itemIndex: item.tag)
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

3.自定义的标签栏ItemView视图

class MainTabBarItem: UIControl {
    var itemDic:Dictionary<String, String>
    let imgView: UIImageView
    let titleLabel: UILabel

    //属性观察器
    var currentSelectState = false {
        didSet{
            if currentSelectState {
                //被选中
                imgView.image = UIImage(named:itemDic["SelectedImg"]!)
                titleLabel.textColor = UIColor.red
            }else{
                //没被选中
                imgView.image = UIImage(named: itemDic["NormalImg"]!)
                titleLabel.textColor = UIColor.lightGray
            }
        }
    }

    init(frame:CGRect, itemDic:Dictionary<String, String>, itemIndex:Int) {
        self.itemDic = itemDic

        //布局使用的参数
        let defaulutLabelH:CGFloat = 20.0 //文字的高度
        var imgTop:CGFloat = 3
        var imgWidth:CGFloat = 25
        //中间的按钮的布局参数做特殊处理
        if itemIndex == 1{
            imgTop = -20
            imgWidth = 50
        }
        let imgLeft:CGFloat = (frame.size.width - imgWidth)/2
        let imgHeight:CGFloat  = frame.size.height - defaulutLabelH - imgTop
        //图片
        imgView = UIImageView(frame: CGRect(x: imgLeft, y: imgTop, width:imgWidth, height:imgHeight))
        imgView.image = UIImage(named: itemDic["NormalImg"]!)
        imgView.contentMode = UIViewContentMode.scaleAspectFit
        //title
        titleLabel = UILabel(frame:CGRect(x: 0, y: frame.height - defaulutLabelH, width: frame.size.width, height: defaulutLabelH))
        titleLabel.text = itemDic["Title"]!
        titleLabel.textAlignment = NSTextAlignment.center
        titleLabel.font = UIFont.systemFont(ofSize: 11)
        titleLabel.textColor = UIColor.lightGray

        super.init(frame: frame)
        self.addSubview(imgView)
        self.addSubview(titleLabel)
    }

    required init?(coder aDecoder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

第五步：在Appdelegate中设置Window的根视图控制器为自定义的标签控制器

 func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
        //创建App窗口
        self.window = UIWindow(frame: UIScreen.main.bounds)
        self.window?.backgroundColor = UIColor.orange
        self.window?.makeKeyAndVisible()
        //设置Window的根视图控制器为自定义的标签栏
        self.mainTabBarVC = MainTabBarController();
        self.window?.rootViewController = self.mainTabBarVC;
        return true
    }
1
2
3
4
5
6
7
8
9
10

总结：以上就是在OC代码的基础上，使用Swift来自定义标签控制器的方法和步骤。在项目前期我们以自定义的方式来创建标签栏，这也是为了后期应对更加复杂的需求做伏笔，比如增加新的控制器我们只需要修改plist配置文件的属性创建相应的视图控制器就可以，这样就避免了修改大量代码。

最后是Demo链接：https://github.com/DreamcoffeeZS/Swift_CustomTabbar.git， 希望大家多多指教！