Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fengdai/AlertDialogPro
[Deprecated] This project can make it easy to theme and custom Android's dialog. Also provides Holo and Material themes for old devices.
https://github.com/fengdai/AlertDialogPro
android dialog material-theme
Last synced: 3 months ago
JSON representation
[Deprecated] This project can make it easy to theme and custom Android's dialog. Also provides Holo and Material themes for old devices.
- Host: GitHub
- URL: https://github.com/fengdai/AlertDialogPro
- Owner: fengdai
- License: other
- Created: 2014-09-01T09:43:12.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2020-04-14T11:02:21.000Z (almost 5 years ago)
- Last Synced: 2024-07-31T18:16:01.214Z (6 months ago)
- Topics: android, dialog, material-theme
- Language: Java
- Homepage:
- Size: 4.46 MB
- Stars: 468
- Watchers: 29
- Forks: 122
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
- -awesome-android-ui - AlertDialogPro - 2.0) | <img src="/art/AlertDialogPro.png" width="49%"> <img src="/art/AlertDialogPro2.png" width="49%"> <img src="/art/AlertDialogPro3.png" width="49%"> <img src="/art/AlertDialogPro4.png" width="49%"> (Index `(light-weight pages)`)
- awesome-android-ui - AlertDialogPro - 2.0) | <img src="/art/AlertDialogPro.png" width="49%"> <img src="/art/AlertDialogPro2.png" width="49%"> <img src="/art/AlertDialogPro3.png" width="49%"> <img src="/art/AlertDialogPro4.png" width="49%"> (Index `(light-weight pages)`)
- awesome-android-ui - AlertDialogPro - 2.0) | <img src="/art/AlertDialogPro.png" width="49%"> <img src="/art/AlertDialogPro2.png" width="49%"> <img src="/art/AlertDialogPro3.png" width="49%"> <img src="/art/AlertDialogPro4.png" width="49%"> (Index)
README
[](https://travis-ci.org/fengdai/AlertDialogPro)
[](https://android-arsenal.com/details/1/1178)
# Deprecated
Please use `android.support.v7.app.AlertDialog` of support-v7.
# AlertDialogPro
Why AlertDialogPro?
Theming Android's AlertDialog is not an easy thing. Because some of its attributes are not avaliable on old platform. Even on newer you still can't use ```android:layout``` to specify your own layout, since your views' ids should be consistant with Android's, some of which are not public... AlertDialogPro can make theming a lot easier.
# Structure
### alertdialogpro-core
Contains core codes for building an AlertDialogPro. Most of it's codes are ported from the latest Android Platform. It doesn't contain any resource file. If you want to implement a brand new theme, use this project directly. Otherwise, you should use alertdialogpro-theme-material or alertdialogpro-theme-holo.
### alertdialogpro-theme-material
Based on alertdialogpro-core, gives AlertDialogPro a Material theme.
### alertdialogpro-theme-holo (Obsolete)
Also based on alertdialogpro-core, gives AlertDialogPro a Holo theme.
# Quick Start
Take **alertdialogpro-theme-material** for example.
### Download
Grab latest version via Gradle:
```groovy
dependencies {
compile 'com.github.fengdai:alertdialogpro-theme-material:0.2.6'
}
```
or Maven:
```xml
com.github.fengdai
alertdialogpro-theme-material
0.2.6
```
### Specify AlertDialogPro's theme
In your app's xml file, use attribute ```alertDialogProTheme``` to specify your AlertDialogPro's theme. **alertdialogpro-theme-material** contains two built-in theme: ```Theme.AlertDialogPro.Material``` and ```Theme.AlertDialogPro.Material.Light```. Here, we use the light version:
```xml
...
<item name="alertDialogProTheme">@style/Theme.AlertDialogPro.Material.Light</item>
```
### Build an AlertDialogPro
Use ```AlertDialogPro.Builder``` to build an AlertDialogPro:
```java
AlertDialogPro.Builder builder = new AlertDialogPro.Builder(getContext());
builder.setIcon(R.drawable.icon).
setTitle("Title").
setMessage("Message Body").
setNeutralButton("Neutral", null).
setPositiveButton("Positive", null).
setNegativeButton("Negative", null).
show();
```
With the example codes above, you can create an AlertDialogPro which has an icon, a title, a message body and three option buttons. Look into the [sample](https://github.com/fengdai/AlertDialogPro/blob/master/alertdialogpro-demo/src/main/java/com/alertdialogpro/demo/MainActivity.java) to see more usages.
### Flavor built-in themes
Built-in themes can't meet your requirement? There are [several attributes](https://github.com/fengdai/AlertDialogPro/blob/master/alertdialogpro-core/src/main/res/values/adp_core_attrs.xml) that you can use to make some slight changes. Here is an example to show how to change the positive button's color:
1. Define your positive button's style:
```xml
<item name="android:textColor">@color/adp_positive_button_color</item>
```
2. Specify button style to your AlertDialogPro's theme with attribute ```adpButtonBarPositiveButtonStyle```:
```xml
...
<item name="adpButtonBarPositiveButtonStyle">@style/YourButtonStyle</item>
```
3. Use it in your app's theme:
```xml
@style/FlavoredMaterialLight
```
Look into [here](https://github.com/fengdai/AlertDialogPro/blob/master/alertdialogpro-core/src/main/res/values/adp_core_attrs.xml) to see all attributes.
### Advanced customization
You can specify your own layout to AlertDialogPro. This can be very useful when you want to use custom views or you want a special dialog layout. Remember to keep your views' ids consistant with [AlertDialogPro's ids](https://github.com/fengdai/AlertDialogPro/blob/master/alertdialogpro-core/src/main/res/values/adp_core_ids.xml).
1. Define your AlertDialogPro's style:
```xml
<!-- Specify your AlertDialogPro's layout -->
<item name="adpLayout">@layout/your_alert_dialog</item>
<!-- Specify your AlertDialogPro's ListView layout. -->
<item name="adpListLayout">@layout/your_list_layout</item>
<!-- Specify your AlertDialogPro's list item layout. -->
<item name="adpListItemLayout">@layout/your_dialog_item</item>
<!-- Specify your AlertDialogPro's multi choice list item layout. -->
<item name="adpMultiChoiceItemLayout">@layout/your_multichoice_dialog_item</item>
<!-- Specify your AlertDialogPro's single choice list item layout. -->
<item name="adpSingleChoiceItemLayout">@layout/your_singlechoice_dialog_item</item>
```
2. And add it to your AlertDialogPro's theme:
```xml
...
<item name="alertDialogProStyle">@style/YourAlertDialogProStyle</item>
```
3. Use your AlertDialogPro theme in your app's theme:
```xml
@style/YourAlertDialogProTheme
```
# Migrate From AlertDialog
AlertDialogPro's Java API is exactly the same as [AlertDialog's](http://developer.android.com/reference/android/app/AlertDialog.Builder.html). In fact, most of AlertDialogPro's codes are ported from the latest AlertDialog. So the only thing you need to do in your Java codes is replacing ```AlertDialog.Builder``` with ```AlertDialogPro.Builder```.
# Requirements
AlertDialogPro requires at minimum Android 2.1 (API level 7).
# Thanks
* This project contains some code ported from The Android Open Source Project. [Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0)
* Thank [vbauer](https://github.com/vbauer) and his awesome site [Android-Arsenal](https://android-arsenal.com/)
# License
Copyright (C) 2014 Feng Dai
Copyright (C) 2007 The Android Open Source Project
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.