{"id":15026664,"url":"https://github.com/yalantis/side-menu.android","last_synced_at":"2025-10-17T01:26:43.452Z","repository":{"id":25748477,"uuid":"29186327","full_name":"Yalantis/Side-Menu.Android","owner":"Yalantis","description":"Side menu with some categories to choose.","archived":false,"fork":false,"pushed_at":"2020-08-08T20:17:09.000Z","size":1048,"stargazers_count":5247,"open_issues_count":20,"forks_count":1502,"subscribers_count":288,"default_branch":"master","last_synced_at":"2025-04-11T18:18:49.274Z","etag":null,"topics":["android","animation","drawer-layout","java","menu","navigationview"],"latest_commit_sha":null,"homepage":"https://yalantis.com","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Yalantis.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}},"created_at":"2015-01-13T11:11:27.000Z","updated_at":"2025-03-27T00:34:12.000Z","dependencies_parsed_at":"2022-08-24T14:13:28.994Z","dependency_job_id":null,"html_url":"https://github.com/Yalantis/Side-Menu.Android","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yalantis%2FSide-Menu.Android","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yalantis%2FSide-Menu.Android/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yalantis%2FSide-Menu.Android/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yalantis%2FSide-Menu.Android/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Yalantis","download_url":"https://codeload.github.com/Yalantis/Side-Menu.Android/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254110374,"owners_count":22016391,"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":["android","animation","drawer-layout","java","menu","navigationview"],"created_at":"2024-09-24T20:04:51.917Z","updated_at":"2025-10-17T01:26:38.420Z","avatar_url":"https://github.com/Yalantis.png","language":"Java","readme":"[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-Side--Menu.Android-brightgreen.svg?style=flat)](https://android-arsenal.com/details/1/1388) [![Yalantis](https://github.com/Yalantis/Side-Menu.Android/blob/master/badge.png)](https://yalantis.com/?utm_source=github)\nSide Menu\n==============\n#### Side menu with some categories to choose.\nCheck this \u003ca href=\"https://dribbble.com/shots/1689922-Side-Menu-Animation?list=searches\u0026tag=yalantis\u0026offset=0\"\u003eproject on dribbble\u003c/a\u003e.\u003cbr\u003e\nCheck this \u003ca href=\"https://www.behance.net/gallery/20411445/Mobile-Animations-Interactions \"\u003eproject on Behance\u003c/a\u003e.\n\nGod bless Ukraine!\n\n![Preview](https://cdn.dribbble.com/users/125056/screenshots/1689922/events-menu_1-1-6.gif)\n\nSample\n======\n\u003ca href=\"https://github.com/Yalantis/Side-Menu.Android/releases/tag/1.0\"\u003e Sample \u0026 .aar file \u003c/a\u003e\nNote\n====\n\ndepends on \u003ca href=\"https://github.com/ozodrukh\"\u003eOzodrukh's\u003c/a\u003e animation util for CircularReveal animation for 2.3+ version\n\nUsing\n======\nFirst of all you have to upload animation submodule with `git submodule update --init` command \u003cbr\u003e\n\u003cbr\u003e\nOr you can add gradle dependency with command :\u003cbr\u003e\n```groovy\n\tdependencies {\n\t    implementation 'com.github.yalantis:Side-Menu.Android:1.0.2'\n\t}\n``` \n.\u003cbr\u003e\nand command:\u003cbr\u003e\n```groovy\n\trepositories {\n\t    maven {\n\t        url \"https://jitpack.io\"\n\t    }\n\t}\n\tdependencies {\n\t    implementation 'com.github.ozodrukh:CircularReveal:(latest-release)@aar'\n\t}\n\n```\n\nTo add gradle dependency you need to open  build.gradle (in your app folder,not in a project folder) then copy and add the dependencies there in the dependencies block;\n\n\n\u003cbr\u003e for CircularReveal module\t\n\n\nAfter you have to create special overlay layout to show in behind current `Circular Reveal` animated view.\nAnd to add all items to menu you have to add all of them into  `LinearLayout`\n\n```xml\n\u003candroid.support.v4.widget.DrawerLayout\n    xmlns:android=\"http://schemas.android.com/apk/res/android\"\n    android:id=\"@+id/drawer_layout\"\n    android:layout_width=\"match_parent\"\n    android:layout_height=\"match_parent\"\u003e\n\n    \u003cio.codetail.widget.RevealFrameLayout\n        android:id=\"@+id/conteiner_frame\"\n        xmlns:android=\"http://schemas.android.com/apk/res/android\"\n        android:layout_width=\"match_parent\"\n        android:layout_height=\"match_parent\"\u003e\n        \u003cLinearLayout\n            android:id=\"@+id/content_overlay\"\n            android:layout_width=\"match_parent\"\n            android:layout_height=\"match_parent\"\n            android:orientation=\"vertical\"/\u003e\n        \u003cLinearLayout\n            android:id=\"@+id/content_frame\"\n            android:layout_width=\"match_parent\"\n            android:layout_height=\"match_parent\"\n            android:orientation=\"vertical\"/\u003e\n\n        \u003candroid.support.v7.widget.Toolbar\n            android:id=\"@+id/toolbar\"\n            android:layout_height=\"wrap_content\"\n            android:layout_width=\"match_parent\"\n            android:minHeight=\"?attr/actionBarSize\"\n            android:background=\"?attr/colorPrimary\"/\u003e\n\n    \u003c/io.codetail.widget.RevealFrameLayout\u003e\n\n    \u003cScrollView\n        android:id=\"@+id/scrollView\"\n        android:scrollbarThumbVertical=\"@android:color/transparent\"\n        android:layout_width=\"80dp\"\n        android:layout_height=\"match_parent\"\n        android:layout_gravity=\"start|bottom\"\u003e\n\n        \u003cLinearLayout\n            android:id=\"@+id/left_drawer\"\n            android:orientation=\"vertical\"\n            android:layout_width=\"80dp\"\n            android:layout_height=\"wrap_content\"\n            android:divider=\"@android:color/transparent\"\n            android:dividerHeight=\"0dp\"\n            android:background=\"@android:color/transparent\"\u003e\n            \u003c!-- Layout of Drawer --\u003e\n        \u003c/LinearLayout\u003e\n    \u003c/ScrollView\u003e\n\u003c/android.support.v4.widget.DrawerLayout\u003e\n```\n\n```java\n\n\tViewAnimator viewAnimator = new ViewAnimator\u003c\u003e(ActionBarActivity.this,\n\t\t\t\t\t\t\t\t\tnew ArrayList\u003cResourceble\u003e(),\n\t\t\t\t\t\t\t\t\t(LinearLayout) findViewById(R.id.left_drawer), \n\t\t\t\t\t\t\t\t\tcontentFragment, drawerLayout);\n\t//to open menu you have to override ActionBarDrawerToggle method \n            @Override\n            public void onDrawerSlide(View drawerView, float slideOffset) {\n                super.onDrawerSlide(drawerView, slideOffset);\n                if (slideOffset \u003e 0.6 \u0026\u0026 viewAnimator.getLinearLayout().getChildCount() == 0)\n                    viewAnimator.showMenuContent();\n            }\n\t\t\tpublic void onDrawerClosed(View view) {\n                super.onDrawerClosed(view);\n                viewAnimator.getLinearLayout().removeAllViews();\n                viewAnimator.getLinearLayout().invalidate();\n            }\n\n```\nAll menu items should implement  `Resourceble`  interface to get menu item name and drawable res \nAnd all fragments should implement  `ScreenShotable` to get screenshot of a fragment\n\nYou can customize icons that u place in the menu,or add mor items. Simply by changing the list you parse to view animator .For example:\n\n```java\n\n\t private List\u003cSlideMenuItem\u003e list = new ArrayList\u003c\u003e(); \\\\ the list of menu items\n\t \n\tSlideMenuItem menuItem0 = new SlideMenuItem(ContentFragment.CLOSE, R.drawable.icn_close);\n        list.add(menuItem0);\n        SlideMenuItem menuItem = new SlideMenuItem(ContentFragment.BUILDING, R.drawable.icn_1);  \\\\first parameter is the id of menu item,the second is the icon resouce\n        list.add(menuItem);\n        SlideMenuItem menuItem2 = new SlideMenuItem(ContentFragment.BOOK, R.drawable.icn_2);\n        list.add(menuItem2);\n        \n        viewAnimator = new ViewAnimator\u003c\u003e(this, list, contentFragment, drawerLayout, this);\n```\t\t\n\n#### Let us know!\n\nWe’d be really happy if you sent us links to your projects where you use our component. Just send an email to github@yalantis.com And do let us know if you have any questions or suggestion regarding the animation. \n\nP.S. We’re going to publish more awesomeness wrapped in code and a tutorial on how to make UI for Android (iOS) better than better. Stay tuned!\n\n## License\n\n    Copyright 2019, Yalantis\n\n    Licensed under the Apache License, Version 2.0 (the \"License\");\n    you may not use this file except in compliance with the License.\n    You may obtain a copy of the License at\n\n       http://www.apache.org/licenses/LICENSE-2.0\n\n    Unless required by applicable law or agreed to in writing, software\n    distributed under the License is distributed on an \"AS IS\" BASIS,\n    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n    See the License for the specific language governing permissions and\n    limitations under the License.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyalantis%2Fside-menu.android","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyalantis%2Fside-menu.android","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyalantis%2Fside-menu.android/lists"}