Skip to content
master
Go to file
Code
This branch is 75 commits behind BoD:master.

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
res
 
 
 
 
 
 
 
 
 
 
 
 

README.md

Android Switch Widget Backport

A backport of the Switch widget (http://developer.android.com/reference/android/widget/Switch.html) that was introduced on Android 4.

This port works on Android 2.1+.

How to use

Switch

This is an Android library project, you have to add it as a dependency to your project (please see http://developer.android.com/guide/developing/projects/projects-eclipse.html#ReferencingLibraryProject to know how to do that.)

Once you have done that, have a theme for your application (or Activity), that declares the switchStyle item to be one of the two possible themes: either Widget.Holo.CompoundButton.Switch (dark) or Widget.Holo.Light.CompoundButton.Switch (light).

The simplest way to do that is to create a themes.xml file in your project's res/values folder with this contents:

    <?xml version="1.0" encoding="utf-8"?>
    <resources>

        <style name="Theme" parent="@android:Theme">
            <item name="switchStyle">@style/Widget.Holo.CompoundButton.Switch</item>
        </style>

    </resources>

Then in your layout xml files you can use the widget like this:

    <org.jraf.android.backport.switchwidget.Switch
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />

SwitchPreference

Add switchPreferenceStyle to your 'themes.xml'

    <?xml version="1.0" encoding="utf-8"?>
    <resources>

        <style name="Theme" parent="@android:Theme">
            <item name="switchStyle">@style/Widget.Holo.CompoundButton.Switch</item>
            <item name="switchPreferenceStyle">@style/Preference.SwitchPreference</item>
        </style>

    </resources>

Then in your preference xml file:

    <PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:switchpref="http://schemas.android.com/apk/res-auto" >

        <org.jraf.android.backport.switchwidget.SwitchPreference
            android:key="testKey"
            android:title="SwitchPreference Test"
            switchpref:switchTextOff="@string/off"
            switchpref:switchTextOn="@string/on"
            switchpref:summaryOff="@string/summary_off"
            switchpref:summaryOn="@string/summary_on" />
  
    </PreferenceScreen>

Credits

The code was copied directly from the Android 4.0.3 (API 15) source code, then slightly tweaked by myself (BoD@JRAF.org) to make it run on 2.1+. The few modifications I made are documented in the code (look for 'XXX' comments). The SwitchPreference part was added later by Intrications (intrications.com / github.com/intrications), also by taking code from Android and tweaking it a bit.

Licence

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.

About

A backport of the Switch widget (http://developer.android.com/reference/android/widget/Switch.html) that was introduced on Android 4. This port works on Android 2.1+.

Resources

Releases

No releases published

Languages

You can’t perform that action at this time.