khalidelsayed / actionscontentview

ActionsContentView is an standalone library implements actions/content swiping view (AKA Side Navigation UI Pattern, AKA Facebook side menu). The library doesn't use any specific code introduced in new Android SDK versions. This allows develop an application with an action/content swiping view for every version of Android from 2.2 and up.

ActionsContentView

ActionsContentView is an standalone library implements actions/content swiping view.

The library doesn't use any specific code introduced in new Android SDK versions. This allows develop an application with an action/content swiping view for every version of Android from 2.2 and up.

Some advantages of this library:

• ability to slide view by touch
• it is easy to adjust size of actions bar in XML
• support of all Android SDK version starting from 2.0 and up

There is one limitation:

• all horizontal scrolling views will not work at bounds of this view

Here is exmple of usage ActionsContentView as element of XML layout:

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent" >

...

    <shared.ui.actionscontentview.ActionsContentView
        android:id="@+id/content"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout_above="@id/divider"
        app:actions_layout="@layout/actions"
        app:actions_spacing="0dp"
        app:content_layout="@layout/content"
        app:shadow_drawable="@drawable/shadow"
        app:shadow_width="8dip"
        app:spacing="64dip"
        app:spacing_type="right_offset" />

...

</RelativeLayout>

Features included

• Slide view by touch
• Shadow dropped by content view to actions one
• Offset for content view to show part actions view. Useful to hint user that there are actions under content.

Feature to be implemented in future

• Add shading for actions view while scrolling content
• Left side or both side actions support
• Swipe from the bezel to the screen so horizontal scrolling will be possible

Example

Try out the example application on the Android Market: ActionsContentView Example.

Developed By

• Steven Rudenko - [email protected]

License

Copyright 2012 Steven Rudenko

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.