Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rey5137/slidelayout
An Open Source Android library that allows developers to easily add SlideMenu feature. It supports 4 menu at each side of content view concurrently.
https://github.com/rey5137/slidelayout
Last synced: about 2 months ago
JSON representation
An Open Source Android library that allows developers to easily add SlideMenu feature. It supports 4 menu at each side of content view concurrently.
- Host: GitHub
- URL: https://github.com/rey5137/slidelayout
- Owner: rey5137
- License: gpl-2.0
- Created: 2014-02-27T14:29:12.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2015-06-11T17:19:18.000Z (over 9 years ago)
- Last Synced: 2024-04-16T12:15:15.831Z (9 months ago)
- Language: Java
- Homepage: http://rey5137.github.io/SlideLayout/
- Size: 5.71 MB
- Stars: 144
- Watchers: 22
- Forks: 50
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
SlideLayout
===========
SlideLayout is an Open Source Android library that allows developers to easily add SlideMenu feature. It supports 4 menu at each side of content view concurrently.
A demo app can be found on [Google PlayStore] (https://play.google.com/store/apps/details?id=com.rey.slidelayoutdemo)
![] (https://farm4.staticflickr.com/3761/13168480255_e216f067b5.jpg) | ![] (https://farm8.staticflickr.com/7107/13168733084_075e178019.jpg)
------------- | -------------
![] (https://farm8.staticflickr.com/7177/13168469925_7397000a02.jpg) | ![] (https://farm4.staticflickr.com/3759/13168558143_a95f0d3d31.jpg)
I would appreciate any kind of help to improve this library. Thanks
Usage
-----
####Usage in XML
You must declare SlideLayoutStyle in styles.xml:
```xml
<item name="sl_dragEnable">true</item>
<item name="sl_leftMenuStyle">@style/LeftSlideMenuStyleDemo</item>
<item name="sl_rightMenuStyle">@style/RightSlideMenuStyleDemo</item>
<item name="sl_topMenuStyle">@style/TopSlideMenuStyleDemo</item>
<item name="sl_bottomMenuStyle">@style/BottomSlideMenuStyleDemo</item>
<item name="sl_menuStyle">@style/SlideMenuStyleDemo</item>
```
######Attributes
* `sl_dragEnable`: enable drag menu from the side of content view. If disable, can only open menu by calling function
```java
public void openLeftMenu(boolean animation);
public void openRightMenu(boolean animation);
public void openTopMenu(boolean animation);
public void openBottomMenu(boolean animation);
```
* `sl_leftMenuStyle`: Left menu style
* `sl_rightMenuStyle`: Right menu style
* `sl_topMenuStyle`: Top menu style
* `sl_bottomMenuStyle`: Bottom menu style
* `sl_menuStyle`: Default menu style
and some SlideMenuStyle:
```xml
<item name="sm_overDrag">false</item>
<item name="sm_menuBorder">48dp</item>
<item name="sm_menuOverDragBorder">0dp</item>
<item name="sm_slideRatio">0.5</item>
<item name="sm_menuShadow">8dp</item>
<item name="sm_dragEdge">48dp</item>
<item name="sm_touchSlop">16dp</item>
<item name="sm_maxDim">0.7</item>
<item name="sm_velocitySlop">500</item>
<item name="sm_animDuration">800</item>
<item name="sm_closeEdge">0.75</item>
<item name="sm_animInterpolator">@android:anim/decelerate_interpolator</item>
```
######Attributes
* `sm_overDrag`: Enable drag menu out of its size
* `sm_menuBorder`: The size of content view visible when menu openned, can be dimension or percent of content view's size
* `sm_menuOverDragBorder`: The size of overdrag region when menu dragged, can be dimension or percent of content view's size
* `sm_slideRatio`: The ratio of traveling distance between menu and content view
* `sm_menuShadow`: The size of shadow
* `sm_dragEdge`: The size of drag region, can be dimension or -1 (match_content)
* `sm_touchSlop`: The distance which menu start dragging
* `sm_maxDim`: The maximum Dimming value of below view. 0 means no Dimming at all.
* `sm_velocitySlop`: The velocity of fling which menu start opening
* `sm_animDuration`: The duration of opening and closing animation
* `sm_closeEdge`: The distance which menu auto close when stop dragging, can be dimension or percent of menu's size
Declare the following view on your xml layout:
```xml
```
######Attributes
* `sl_contentChild`: index of content view in SlideLayout
* `sl_leftMenuChild`: index of left menu in SlideLayout
* `sl_rightMenuChild`: index of right menu in SlideLayout
* `sl_topMenuChild`: index of top menu in SlideLayout
* `sl_bottomMenuChild`: index of bottom menu in SlideLayout
The order of menu and content view in SlideLayout decides menu will be above (Google style) or below (Facebook style) content view.
####Usage in Code
Declare SlideLayoutStyle in styles.xml:
```xml
<item name="sl_dragEnable">true</item>
<item name="sl_leftMenuStyle">@style/LeftSlideMenuStyleDemo</item>
<item name="sl_rightMenuStyle">@style/RightSlideMenuStyleDemo</item>
<item name="sl_topMenuStyle">@style/TopSlideMenuStyleDemo</item>
<item name="sl_bottomMenuStyle">@style/BottomSlideMenuStyleDemo</item>
<item name="sl_menuStyle">@style/SlideMenuStyleDemo</item>
<item name="sl_contentChild">4</item>
<item name="sl_leftMenuChild">0</item>
<item name="sl_rightMenuChild">1</item>
<item name="sl_topMenuChild">2</item>
<item name="sl_bottomMenuChild">3</item>
```
Use the following code:
```java
SlideLayout sl = new SlideLayout(context, null, R.style.SlideLayoutStyleDemo);
sl.addView(leftMenuView);
sl.addView(rightMenuView);
sl.addView(topMenuView);
sl.addView(bottomMenuView);
sl.addView(contentView);
```
Note that you have to add view to SlideLayout in correct order specificed in style. If you want to attach SlideLayout to activity, use the followed function instead of addView(contentView)
```java
public void attachToActivity(Activity activity, boolean attachToWindow);
```
Developed By
------------
* Rey Pham -
Credits
-------
* SlideLayout is inspired by [Cyril Mottier's post](http://cyrilmottier.com/2012/05/22/the-making-of-prixing-fly-in-app-menu-part-1/ )
Contributing
------------
Want to contribute? You are welcome!