MDPreference
Introduce
Group of Preference, just like the Preference of original Android.
[DEPPERCATED] You should not support pre-Lollipop in 2018.
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.2@aar'
// You should add this because the 'mdpreference' depend on this
compile 'com.github.XhinLiang.MDPreference:material:0.3.2@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"
<?xml version="1.0" encoding="utf-8"?>
<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto">
<io.github.xhinliang.mdpreference.PreferenceCategory android:title="Alert Settings">
<io.github.xhinliang.mdpreference.CheckBoxPreference
android:key="preference_key_remind_the_same_day1"
android:summary="Alert in the birthday"
android:title="Alert first" />
<io.github.xhinliang.mdpreference.SwitchPreference
android:key="preference_key_remind_the_same_day3"
android:summary="Alert in three day before birthday"
android:title="Alert second" />
<io.github.xhinliang.mdpreference.EditTextPreference
android:key="preference_key_remind_the_same_daywwwd2"
android:summary="Alert in a week before the birthday"
android:positiveButtonText="OK"
android:negativeButtonText="Cancel
android:dialogTitle="Dialog"
android:title="Alert third" />
<io.github.xhinliang.mdpreference.SwitchPreference
android:key="preference_key_remind_the_same_day34"
android:summary="Alert in two weeks before the birthday"
android:title="Alert fourth" />
<io.github.xhinliang.mdpreference.ListPreference
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" />
<io.github.xhinliang.mdpreference.MultiSelectListPreference
android:key="preference_key_alert_timeddwexss"
android:summary="Select alert time"
android:title="Alert time"
app:entry_arr="@array/alert_time_entry"/>
</io.github.xhinliang.mdpreference.PreferenceCategory>
</PreferenceScreen>
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 originalAndroid Preference
. -
For
ListPreference
you should use like this<io.github.xhinliang.mdpreference.ListPreference 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" />
The
entry_arr
is the array for entry and thevalue_arr
is the array for the value you can get like thislistPreference.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<io.github.xhinliang.mdpreference.MultiSelectListPreference android:key="preference_key_alert_timeddwexss" android:summary="Select alert time" android:title="Alert time" app:entry_arr="@array/alert_time_entry"/>
The
entry_arr
is the array for entry. You can get the array of selectedInteger
like thismultiSelectListPreference.getIndexes();
ATTENTION
- For
ListPreference
, you can get aString
(MAY BE NULL) by usingSharePreference
which is the user selected. - For
MultiSelectListPreference
, You can get a int by usingSharePreference
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<Integer> set = MultiSelectListPreference.getSetByBit(bit);
More
Thanks
License
Copyright 2016 XhinLiang
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.