SSCustomSideMenu

特性

• 高度可定制的
• 多种动画选项
• 动态菜单大小
• CocoaPods 中可用

要求

• iOS 11.0+
• Xcode 10+

安装

CocoaPods

• 您可以通过将 SSCustomSideMenu 添加到 Podfile 中来使用 CocoaPods 安装 SSCustomSideMenu

    use_frameworks!
    pod 'SSCustomSideMenu'
  

• 在 swift 文件中，导入 SSSideMenu 模块

    import UIKit
    import SSCustomSideMenu
  

手动安装

• 下载并将 SSCustomSideMenu 文件夹拖放到您的项目中。
• 恭喜！

使用示例

创建SSSideMenuContainerViewController的子类

class SideMenuViewController: SSSideMenuContainerViewController { ... }

• 在故事板中，给视图控制器分配你刚刚创建的自定义类**SideMenuViewController**。这个视图控制器将是侧菜单的容器。

  创建菜单表格

  let menuTable = SSMenuTableView()
  

  配置侧菜单选项

  let menuCellConfig = SSMenuCellConfig()
  
  menuCellConfig.cellStyle = .defaultStyle
  
  menuCellConfig.leftIconPadding = 20
  menuCellConfig.imageToTitlePadding = 10
  menuCellConfig.imageHeight = 24
  menuCellConfig.imageWidth = 24
  
  menuCellConfig.numberOfOptions = 3
  
  menuCellConfig.selectedColor = .purple
  menuCellConfig.nonSelectedColor = .black
  
  menuCellConfig.images = [UIImage(named: "first"), UIImage(named: "second"), UIImage(named: "third")]
  menuCellConfig.titles = ["First", "Second", "Thrird"]
  
  self.menuTable.config = menuCellConfig
  

  配置侧菜单

  let sideMenuConfig = SSSideMenuConfig()
  sideMenuConfig.animationType = .slideOut // Other options:  .slideIn, .compress(0.8, 20)
  sideMenuConfig.sideMenuPlacement = .left // Other options:  .right
  sideMenuConfig.menuWidth = UIScreen.main.bounds.width * 0.5
  
  let firstViewController = storyboard?.instantiateViewController(withIdentifier: "FirstViewController")
  let secondViewController = storyboard?.instantiateViewController(withIdentifier: "SecondViewController")
  let thirdViewController = storyboard?.instantiateViewController(withIdentifier: "ThirdViewController")
  
  sideMenuConfig.viewControllers = [firstViewController!, secondViewController!, thirdViewController!]
  
  sideMenuConfig.menuTable = menuTable
  
  self.ssMenuConfig = sideMenuConfig
  

  委托

  • SSCustomSideMenu提供了委托'sideMenuDelegate'，允许开发者动态决定对菜单选项选择执行哪些操作

      sideMenuDelegate = self
    

  • 通过这样做，你将被要求确认以下协议

      extension ViewController: SSSideMenuDelegate {
          func shouldOpenViewController(forMenuOption menuOption: Int) -> Bool {
              if menuOption == 1 {
                  // Perform action for custom options (i.e logout)
                  return false
              } else {
                  return true
              }
          }
      }
    

  打开和关闭侧菜单

  • SSCustomSideMenu提供自定义侧菜单按钮 - 'SSMenuButton'。你只需从Interface Builder将SSMenuButton自定义类分配到你的UIButton即可

  • 手动打开或关闭侧菜单

      SSSideMenuControls.openOrCloseSideMenu()
    

作者

• kunjalsoni-simformsolutions, [email protected]

贡献力量

• 我们非常欢迎你对SSCustomSideMenu的贡献，请检查LICENSE文件以获取更多信息。

许可

• SSCustomSideMenu遵循MIT许可证。有关更多信息，请参阅LICENSE文件。