[Swift通天遁地]九、拔剑吧-(6)使用开源类库快速搭建强大的侧边栏项目

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★
➤微信公众号：山青咏芝（shanqingyongzhi）
➤博客园地址：山青咏芝（https://www.cnblogs.com/strengthen/）
➤GitHub地址：https://github.com/strengthen/LeetCode
➤原文地址：https://www.cnblogs.com/strengthen/p/10356341.html 
➤如果链接不是山青咏芝的博客园地址，则可能是爬取作者的文章。
➤原文已修改更新！强烈建议点击原文地址阅读！支持作者！支持原创！
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★

目录：[Swift]通天遁地Swift

本文将演示给项目快速添加一个侧边栏

Github项目地址：【ENSwiftSideMenu】

下载项目，解压文件。

【Library】->【ENSwiftSideMenu.swift】

->按下【Shift】，选择【ENSwiftSideMenuController.swift】

->将选择的两个文件，拖动到项目中。

在弹出的文件导入确认窗口中，点击【Finish】完成，确认文件的导入。

接着创建用于侧边栏的三个视图控制器，

在项目文件夹上点击鼠标右键，弹出右键菜单。

【New File】->【Cocoa Touch】->【Next】->

【Class】：SubViewController1

【Subclass of】:UIViewController

【Language】：Swift

->【Next】->【Create】

点击打开【SubViewController1.swift】,现在开始编写代码，开始设置该页面的外观。

import UIKit

class SubViewController1: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view.
        
        //初始化一个图像视图，用来显示项目中的一张图片。
        let imageView = UIImageView(image: UIImage(named: "Animal"))
        //将图像视图添加到根视图，
        self.view.addSubview(imageView)
    }

    override func didReceiveMemoryWarning() {
        super.didReceiveMemoryWarning()
        // Dispose of any resources that can be recreated.
    }
}

同理创建控制器文件【SubViewController2.swift】

import UIKit

class SubViewController2: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()

        // Do any additional setup after loading the view.
        //设置根视图的背景颜色为橙色
        self.view.backgroundColor = UIColor.orange
    }

    override func didReceiveMemoryWarning() {
        super.didReceiveMemoryWarning()
        // Dispose of any resources that can be recreated.
    }
}

同理创建控制器文件【SubViewController3.swift】

import UIKit

class SubViewController3: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view.
        //初始化一个图像视图，用来显示项目中的一张图片。
        let imageView = UIImageView(image: UIImage(named: "Girl"))
        //将图像视图添加到根视图
        self.view.addSubview(imageView)
    }

    override func didReceiveMemoryWarning() {
        super.didReceiveMemoryWarning()
        // Dispose of any resources that can be recreated.
    }
}

在项目文件夹上点击鼠标右键，弹出右键菜单。

【New File】->【Cocoa Touch】->【Next】->

【Class】：MenuViewController

【Subclass of】:UITableViewController

【Language】：Swift

->【Next】->【Create】

点击打开【MenuViewController.swift】,现在开始编写代码，开始设置该页面的外观。

现在开始编写表格视图控制器，该控制器将作为项目的侧边栏。

import UIKit

class MenuViewController: UITableViewController {

    //添加一个整形属性，表示当前选择的菜单索引。
    var selectedMenuItem : Int = 0
    
    override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view.
        
        //设置根视图的背景颜色为无色
        self.view.backgroundColor = UIColor.clear
        //并设置在视图即将显示时，清除之前已有的对单元格的选择。
        self.clearsSelectionOnViewWillAppear = false
        
        //设置表格视图的内间距
        tableView.contentInset = UIEdgeInsets(top: 64.0, left: 0, bottom: 0, right: 0)
        //清除表格视图中的单元格之间的分割线
        tableView.separatorStyle = .none
        //设置当点击顶部状态栏时，表格不会滚动至顶部。
        tableView.scrollsToTop = false
        
        //初始化一个索引路径对象，并设置它的行数，为当前类的属性的值。它的段落索引为0。
        let indexPath = IndexPath(row: selectedMenuItem, section: 0)
        //使表格视图选择位于指定索引路径的单元格。
        tableView.selectRow(at: indexPath, animated: false, scrollPosition: .middle)
    }

    //添加一个代理方法，用来设置表格的段落数量为1。
    override func numberOfSections(in tableView: UITableView) -> Int
    {
        return 1
    }
    
    //添加一个代理方法，用来设置表格的行数，在此设置表格拥有4行单元格。
    override func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int
    {
        return 4
    }
    
    //添加一个代理方法，用来初始化或复用表格中的单元格。
    override func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell
    {
        //创建一个字符串常量，作为单元格的复用标识。
        let identifier = "CELL"
        //根据复用标识，从表格中获取可以复用的单元格。
        var cell = tableView.dequeueReusableCell(withIdentifier: identifier)
        
        //如果没有复用的单元格，则初始化一个自定义的单元格。
        if(cell == nil)
        {
             //并设置单元格的复用标识。
            cell = UITableViewCell(style: UITableViewCell.CellStyle.default, reuseIdentifier: identifier)
            //设置单元格的背景颜色为无色
            cell!.backgroundColor = UIColor.clear
            //以及单元格标题文字的颜色为深色
            cell!.textLabel?.textColor = UIColor.darkGray
            
            //初始化一个和单元格相同尺寸的矩形区域
            let frame = CGRect(x: 0, y: 0,  cell!.frame.size.width, height: cell!.frame.size.height)
            //创建一个指定显示区域的视图对象，作为单元格处于焦点状态时的背景视图。
            let selectedBackgroundView = UIView(frame: frame)
            //设置视图对象的背景颜色为灰色，并设置颜色的不透明度为0.2
            selectedBackgroundView.backgroundColor = UIColor.gray.withAlphaComponent(0.2)
            //设置单元格处于焦点状态时的背景视图
            cell!.selectedBackgroundView = selectedBackgroundView
        }
        
        //设置单元格的标题文字
        cell!.textLabel?.text = "ViewController #(indexPath.row+1)"
        //设置单元格标题的字体属性
        cell!.textLabel?.font = UIFont(name: "Arial", size: 12)
        
        //返回设置好的单元格
        return cell!
    }
    
    //添加一个代理方法，用来设置单元格的高度，
    override func tableView(_ tableView: UITableView, heightForRowAt indexPath: IndexPath) -> CGFloat
    {
        //这里设置单元格的高度为50
        return 50
    }
    
    //添加一个方法，用来处理单元格的触摸事件
    override func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath)
    {
        //在控制台输出当前选择的行号
        print("did select row: (indexPath.row)")
        
        //如果重复点击来处于选择状态的单元格，则不再执行方面的代码
        if (indexPath.row == selectedMenuItem)
        {
            return
        }
        
        //将处于选择状态的单元格行号，赋予该属性，
        //当用标识处于选择状态的单元格。
        selectedMenuItem = indexPath.row
        
        //添加一个视图控制器变量。
        var destViewController : UIViewController
        //根据选择的行号的不同，使用不同的类对变量进行初始化。
        switch (indexPath.row)
        {
            //当选择第一行单元格时
            case 0:
                //初始化一个自带的视图控制器
                //也就是用户点击该单元格时，显示该视图控制器下的内容。
                destViewController = UIViewController()
                break
            //当选择第二行单元格时，
            case 1:
                 //初始化第一个自定义的视图控制器。
                destViewController = SubViewController1()
                break
            //当选择第三行单元格时，
            case 2:
                //初始化第二个自定义的视图控制器。
                destViewController = SubViewController2()
                break
            //当选择第四行单元格时，
            default:
                 //初始化第三个自定义的视图控制器。
                destViewController = SubViewController3()
                break
        }
        
        //使用视图控制器的扩展方法，获得侧边栏的控制器，
        //并设置它的内容视图控制器属性。
        sideMenuController()?.setContentViewController(destViewController)
    }
    
    override func didReceiveMemoryWarning() {
        super.didReceiveMemoryWarning()
        // Dispose of any resources that can be recreated.
    }
}

在项目文件夹上点击鼠标右键，弹出右键菜单。

创建一个侧边栏导航控制器。

【New File】->【Cocoa Touch】->【Next】->

【Class】：RootNavigationViewController

【Subclass of】:ENSideMenuNavigationController

【Language】：Swift

->【Next】->【Create】

点击打开【RootNavigationViewController.swift】

现在开始编写代码，创建一个侧边栏控制器。

import UIKit

//首先给类添加一个代理协议，用来监听侧边栏的开启和关闭事件。
class RootNavigationViewController: ENSideMenuNavigationController, ENSideMenuDelegate {
    
    override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view.
        
        //设置视图的背景颜色，在此使用一幅图片，对根视图进行平铺。
        self.view.backgroundColor = UIColor(patternImage: UIImage(named: "Sample")!)
        //初始化一个侧边栏，并设置侧边栏的源视图、侧边栏控制器和侧边栏的位置。
        //侧边栏的位置共有左、右两种。
        sideMenu = ENSideMenu(sourceView: self.view, menuViewController: MenuViewController(), menuPosition:.left)
        
        //设置侧边栏的代理对象
        sideMenu?.delegate = self
        //设置侧边栏允许滑动手势
        sideMenu?.allowPanGesture = true
        //关闭侧边栏打开和关闭时的弹性动画
        sideMenu?.bouncingEnabled = false
        //设置侧边栏的宽度为180.0
        sideMenu?.menuWidth = 180.0
    }
    
    //添加一个方法，用来监听侧边栏即将打开的事件
    func sideMenuWillOpen()
    {
        print("sideMenuWillOpen")
    }
    
     //添加一个方法，用来监听侧边栏即将关闭时的事件
    func sideMenuWillClose()
    {
        print("sideMenuWillClose")
    }
    
     //添加一个方法，用来监听侧边栏关闭的事件
    func sideMenuDidClose()
    {
        print("sideMenuDidClose")
    }
    
     //添加一个方法，用来监听侧边栏打开的事件
    func sideMenuDidOpen()
    {
        print("sideMenuDidOpen")
    }
    
    func sideMenuShouldOpenSideMenu() -> Bool {
        return true
    }
    
    override func didReceiveMemoryWarning() {
        super.didReceiveMemoryWarning()
        // Dispose of any resources that can be recreated.
    }
}

打开应用程序的代理文件【AppDelegate.swift】

import UIKit

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

    var window: UIWindow?


    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        // Override point for customization after application launch.
        
        //在应用程序完成加载的方法中，创建一个导航视图控制器。
        //在初始化导航视图控制器时，依次设置它的菜单控制器属性，和内容控制器属性。
        let navVc = RootNavigationViewController(menuViewController: MenuViewController(), contentViewController: UIViewController())
        
        //将该导航视图控制器，作为当前窗口的根视图控制器。
        self.window?.rootViewController = navVc
        return true
    }

    func applicationWillResignActive(_ application: UIApplication) {
        // Sent when the application is about to move from active to inactive state. This can occur for certain types of temporary interruptions (such as an incoming phone call or SMS message) or when the user quits the application and it begins the transition to the background state.
        // Use this method to pause ongoing tasks, disable timers, and throttle down OpenGL ES frame rates. Games should use this method to pause the game.
    }

    func applicationDidEnterBackground(_ application: UIApplication) {
        // Use this method to release shared resources, save user data, invalidate timers, and store enough application state information to restore your application to its current state in case it is terminated later.
        // If your application supports background execution, this method is called instead of applicationWillTerminate: when the user quits.
    }

    func applicationWillEnterForeground(_ application: UIApplication) {
        // Called as part of the transition from the background to the inactive state; here you can undo many of the changes made on entering the background.
    }

    func applicationDidBecomeActive(_ application: UIApplication) {
        // Restart any tasks that were paused (or not yet started) while the application was inactive. If the application was previously in the background, optionally refresh the user interface.
    }

    func applicationWillTerminate(_ application: UIApplication) {
        // Called when the application is about to terminate. Save data if appropriate. See also applicationDidEnterBackground:.
    }
}