DobSliding
DobSliding (Google Play Demo)
There are more than one horizontal sliding menu library for Android, but what about a vertical sliding?
DobSliding is an Open Source Android library that allows developers to develop applications with vertical sliding menus just like the Android notifications menu.
Here is a short video for the example application in this repository : http://youtu.be/_zOkV6nxu98
Setup
In Eclipse, just import the library as an Android library project. Project > Clean to generate the binaries you need, like R.java, etc. Then, just add DobSliding as a dependency to your existing project.
How?
In order to integrate DobSliding into your projects, take a look to the sample project, also, this is an example: dob_sliding_menu.xml
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:background="#44000000"
android:paddingBottom="@dimen/activity_vertical_margin"
android:paddingLeft="@dimen/activity_horizontal_margin"
android:paddingRight="@dimen/activity_horizontal_margin"
android:paddingTop="@dimen/activity_vertical_margin" >
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignParentTop="true"
android:layout_centerHorizontal="true"
android:text="@string/v_sliding_menu"
android:textAppearance="?android:attr/textAppearanceLarge" />
<Button
android:id="@+id/clickMe"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_centerHorizontal="true"
android:layout_centerVertical="true"
android:text="@string/click_me" />
<ToggleButton
android:id="@+id/toggleMe"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignParentBottom="true"
android:layout_centerHorizontal="true"
android:text="@string/toggle_me" /> </RelativeLayout>MainActivity.java
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// For GingerBreed and less, we must enable home button,
// else, it is up to you
if (Build.VERSION.SDK_INT <= Build.VERSION_CODES.GINGERBREAD_MR1) {
getSupportActionBar().setHomeButtonEnabled(true);
}
// Initialization
try {
// Instance of this activity as a parameter
vSlidingMenu = new DobSlidingMenu(this);
// Sliding type can be sizing or moving
vSlidingMenu.setSlidingType(SlidingType.SIZE);
// The view that will be in sliding menu
// We can assign XML layout or view
vSlidingMenu.setSlidingView(R.layout.dob_sliding_menu);
// This sentence is for handle that will be shown
// in the middle of ActionBar,
// default value is true
vSlidingMenu.setUseHandle(true);
// To access views in sliding menu
View slidingView = vSlidingMenu.getSlidingView();
slidingView.findViewById(R.id.clickMe).setOnClickListener(
new OnClickListener() {
@Override
public void onClick(View v) {
// Anything
// sliding menu finish method to
// collapse the sliding menu
vSlidingMenu.finish();
}
}
);
// Callback after collapsing
vSlidingMenu.setOnCollapsedListener(new OnCollapsedListener() {
@Override
public void onCollapsed() {
Log.i(TAG, "onCollapsed");
}
}
);
// Callback after expanding
vSlidingMenu.setOnExpandedListener(new OnExpandedListener() {
@Override
public void onExpanded() {
Log.i(TAG, "onExpanded");
}
}
);
}
catch (NoActionBarException e) {
e.printStackTrace();
}
}
For ActionBarSherlock and CompactActionBar
DobSliding works perfectly in both ActionBarSherlock and CompactActionBar. For Android GingerBread and less, don't forget to write
getSupportActionBar().setHomeButtonEnabled(true);
Properties
- slidingType - Sliding type can be SIZE, MOVE
- slidingStatus - COLLAPSED, EXPANDED, ANIMATING
- maxDuration - The maximum duration for sliding, default value is millisecond for each pixel, e.g. sliding view height is 1020 PX, the duration will be 1020 MS
- jumpLinePercentage - The percentage of screen height in which the sliding menu will be expanded on scrolling, e.g. if jumpLinePercentage is 0.6, user will scroll to 0.6 of screen to expand
- useHandle - This sentence is for handle that will be shown in the middle of ActionBar, default value is true
- handleImages - To change images for the handle in ActionBar
- OnCollapsedListener
- OnExpandedListener
Methods
- finish() - To be called on click listener for a button in the sliding menu
- collapse()
- expand()
Events
- OnCollapsedListener - Callback after collapsing
- OnExpandedListener - Callback after expanding
Developed By
Bilal Sammour - [email protected]
License
Copyright 2014 Bilal Sammour Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. Note
I developed DobSliding while I am working in Startappz company, so you can find the library in https://github.com/Startappz/DobSliding