MDPreference - 让设置界面拥抱 Material Design使用 MDPreference 给 pre-

Introduce

Group of Preference, just like the Preference of original Android.

Easy to use and good effect in pre-Lollipop.

Sample

Import

Gradle

1. Add it in your root build.gradle at the end of repositories

allprojects {
    repositories {
        ...
        maven { url "https://jitpack.io" }
    }
}

2. Add the dependencies

dependencies {
    compile 'com.github.XhinLiang.MDPreference:mdpreference:0.3.1@aar'
    // You should add this because the 'mdpreference' depend on this
    compile 'com.github.XhinLiang.MDPreference:material:0.3.1@aar'
    // You should add these because the 'material' depend on them
    compile 'com.android.support:appcompat-v7:23.1.1'
    compile 'com.android.support:cardview-v7:23.1.1'
    compile 'com.android.support:recyclerview-v7:23.1.1'
}

Usage

1. define the xml of PreferenceFragment in "../res/xml/your_xml_name.xml"



    
        
        
        
        
            android:key="preference_key_remind_the_same_day34"
            android:summary="Alert in two weeks before the birthday"
            android:title="Alert fourth" />
        
            android:key="preference_key_alert_timess"
            android:summary="Select alert time"
            android:title="Alert time"
            app:entry_arr="@array/alert_time_entry"
            app:format_str="%s"
            app:value_arr="@array/alert_time_value" />
        
            android:key="preference_key_alert_timeddwexss"
            android:summary="Select alert time"
            android:title="Alert time"
            app:entry_arr="@array/alert_time_entry"/>

2. Create your SettingsFragment which extends io.github.xhinliang.mdpreference.PreferenceFragment

public class SettingsFragment extends PreferenceFragment {
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        getPreferenceManager().setSharedPreferencesName(getString(R.string.app_name));
        addPreferencesFromResource(R.xml.preference_settings);
    }
}

Notice

There are lots of Class in the package corresponding to the original Android
- Preference
- EditTextPreference
- ListPreference
- MultiSelectListPreference
- PreferenceCategory
- PreferenceFragment
- SwitchPreference
For MOST of Preference, you can use them just like original Android Preference.
For ListPreference you should use like this

The entry_arr is the array for entry and the value_arr is the array for the value you can get like this

listPreference.getValue();

The format_str is the format String for the summary, the %s is for the selected entry.

For MultiSelectListPreference you should use like this

The entry_arr is the array for entry. You can get the array of selected Integer like this

multiSelectListPreference.getIndexes();

ATTENTION

For ListPreference, you can get a String(MAY BE NULL) by using SharePreference which is the user selected.
For MultiSelectListPreference, You can get a int by using SharePreference which means the indexes of selected item. After that you can get a Set of Integer by using

// bit means the int you get from SharePreference.
Set set = MultiSelectListPreference.getSetByBit(bit);

Thanks

License

Copyright 2016 XhinLiang
Copyright 2014 rey5137
Copyright 2015 balysv

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.

MDPreference - 让设置界面拥抱 Material Design