{"id":13485379,"url":"https://github.com/SimformSolutionsPvtLtd/SSCustomSideMenu","last_synced_at":"2025-03-27T19:31:02.006Z","repository":{"id":52113093,"uuid":"261735576","full_name":"SimformSolutionsPvtLtd/SSCustomSideMenu","owner":"SimformSolutionsPvtLtd","description":"Side Menu Custom Control for iOS apps","archived":false,"fork":false,"pushed_at":"2023-10-09T12:13:42.000Z","size":56,"stargazers_count":59,"open_issues_count":0,"forks_count":5,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-02-20T15:04:27.961Z","etag":null,"topics":["cocoapod","ios","ios13","sidemenu","swift","swift5","xcode11"],"latest_commit_sha":null,"homepage":null,"language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SimformSolutionsPvtLtd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2020-05-06T11:16:21.000Z","updated_at":"2025-02-14T07:52:46.000Z","dependencies_parsed_at":"2024-01-18T22:05:26.142Z","dependency_job_id":"4266c039-eb48-4f02-8132-c28f9119388a","html_url":"https://github.com/SimformSolutionsPvtLtd/SSCustomSideMenu","commit_stats":null,"previous_names":["simformsolutions/sscustomsidemenu"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimformSolutionsPvtLtd%2FSSCustomSideMenu","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimformSolutionsPvtLtd%2FSSCustomSideMenu/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimformSolutionsPvtLtd%2FSSCustomSideMenu/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimformSolutionsPvtLtd%2FSSCustomSideMenu/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SimformSolutionsPvtLtd","download_url":"https://codeload.github.com/SimformSolutionsPvtLtd/SSCustomSideMenu/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245910742,"owners_count":20692497,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cocoapod","ios","ios13","sidemenu","swift","swift5","xcode11"],"created_at":"2024-07-31T18:00:21.115Z","updated_at":"2025-03-27T19:31:01.718Z","avatar_url":"https://github.com/SimformSolutionsPvtLtd.png","language":"Swift","funding_links":[],"categories":["iOS Guides","iOS"],"sub_categories":["Swift"],"readme":"# SSCustomSideMenu\n\n[![Version](https://img.shields.io/cocoapods/v/SSCustomSideMenu.svg?style=flat)](https://cocoapods.org/pods/SSCustomSideMenu)\n[![License](https://img.shields.io/cocoapods/l/SSCustomSideMenu.svg?style=flat)](https://cocoapods.org/pods/SSCustomSideMenu)\n[![Platform](https://img.shields.io/cocoapods/p/SSCustomSideMenu.svg?style=flat)](https://cocoapods.org/pods/SSCustomSideMenu)\n\n![Alt text](http://files.simformsolutions.com.s3.amazonaws.com/simformscreen/screencast_2020-05-06_18-39-40.gif)\n![Alt text](http://files.simformsolutions.com.s3.amazonaws.com/simformscreen/screencast_2020-05-06_18-42-41.gif)\n![Alt text](http://files.simformsolutions.com.s3.amazonaws.com/simformscreen/screencast_2020-05-06_18-52-40.gif)\n![Alt text](http://files.simformsolutions.com.s3.amazonaws.com/simformscreen/screencast_2020-05-06_18-59-57.gif)\n\n\n## Features\n  - Highly customizable\n  - Multiple options of animations\n  - Dynamic menu size\n  - Available through CocoaPods\n\n## Requirements\n  - iOS 11.0+\n  - Xcode 10+\n\n## Installation\n **CocoaPods**\n \n- You can use CocoaPods to install SSCustomSideMenu by adding it to your Podfile:\n\n        use_frameworks!\n        pod 'SSCustomSideMenu'\n\n- In the swift file, import SSSideMenu module:\n            \n        import UIKit\n        import SSCustomSideMenu\n\n**Manually**\n-   Download and drop **SSCustomSideMenu** folder in your project.\n-   Congratulations!\n\n## Usage example\n\n **Create a subclass of SSSideMenuContainerViewController**\n\n    class SideMenuViewController: SSSideMenuContainerViewController { ... }\n\n\n-   In the storyboard assign a custom class **SideMenuViewController** you just created to a viewController. This viewController will be the container for Side menu.\n   ![Alt text](http://files.simformsolutions.com.s3.amazonaws.com/simformscreen/Main.storyboard_2020-04-23_10-22-17.png)\n   \n    **Create Menu Table**\n\n        let menuTable = SSMenuTableView()\n   \n    \n    **Configure Side Menu Options**\n    \n        let menuCellConfig = SSMenuCellConfig()\n        \n        menuCellConfig.cellStyle = .defaultStyle\n        \n        menuCellConfig.leftIconPadding = 20\n        menuCellConfig.imageToTitlePadding = 10\n        menuCellConfig.imageHeight = 24\n        menuCellConfig.imageWidth = 24\n        \n        menuCellConfig.numberOfOptions = 3\n        \n        menuCellConfig.selectedColor = .purple\n        menuCellConfig.nonSelectedColor = .black\n        \n        menuCellConfig.images = [UIImage(named: \"first\"), UIImage(named: \"second\"), UIImage(named: \"third\")]\n        menuCellConfig.titles = [\"First\", \"Second\", \"Thrird\"]\n        \n        self.menuTable.config = menuCellConfig\n        \n    \n    **Configure Side Menu**\n    \n        let sideMenuConfig = SSSideMenuConfig()\n        sideMenuConfig.animationType = .slideOut // Other options:  .slideIn, .compress(0.8, 20)\n        sideMenuConfig.sideMenuPlacement = .left // Other options:  .right\n        sideMenuConfig.menuWidth = UIScreen.main.bounds.width * 0.5\n        \n        let firstViewController = storyboard?.instantiateViewController(withIdentifier: \"FirstViewController\")\n        let secondViewController = storyboard?.instantiateViewController(withIdentifier: \"SecondViewController\")\n        let thirdViewController = storyboard?.instantiateViewController(withIdentifier: \"ThirdViewController\")\n        \n        sideMenuConfig.viewControllers = [firstViewController!, secondViewController!, thirdViewController!]\n        \n        sideMenuConfig.menuTable = menuTable\n        \n        self.ssMenuConfig = sideMenuConfig\n        \n        \n    **Delegates**\n    \n    - SSCustomSideMenu provides delegate 'sideMenuDelegate' which lets developers dynamically decide which operations to perform on menu option selection\n        \n            sideMenuDelegate = self\n    \n    - By doing this, you will be asked to confirm to following protocol:\n    \n            extension ViewController: SSSideMenuDelegate {\n                func shouldOpenViewController(forMenuOption menuOption: Int) -\u003e Bool {\n                    if menuOption == 1 {\n                        // Perform action for custom options (i.e logout)\n                        return false\n                    } else {\n                        return true\n                    }\n                }\n            }\n\n\n    **Open and Close Side Menu**\n    \n    - SSCustomSideMenu Provides custom side menu button - 'SSMenuButton'. \n       You only need to assign SSMenuButton custom class to your UIButton from Interface Builder\n    \n    - Manually open or close side menu :\n    \n            SSSideMenuControls.openOrCloseSideMenu()\n    \n#  Contribute\n-   We would love you for the contribution to SSCustomSideMenu, check the LICENSE file for more info.\n\n# License\n\n-  SSCustomSideMenu is available under the MIT license. See the LICENSE file for more info.\n \n[![License](https://img.shields.io/cocoapods/l/SSCustomSideMenu.svg?style=flat)](https://cocoapods.org/pods/SSCustomSideMenu)\n[![Platform](https://img.shields.io/cocoapods/p/SSCustomSideMenu.svg?style=flat)](https://cocoapods.org/pods/SSCustomSideMenu)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSimformSolutionsPvtLtd%2FSSCustomSideMenu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FSimformSolutionsPvtLtd%2FSSCustomSideMenu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSimformSolutionsPvtLtd%2FSSCustomSideMenu/lists"}