AlertDialogPro: A Java repository from niuxiaowei

#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:

dependencies {
  compile 'com.github.fengdai:alertdialogpro-theme-material:0.2.6'
}

or Maven:

<dependency>
  <groupId>com.github.fengdai</groupId>
  <artifactId>alertdialogpro-theme-material</artifactId>
  <version>0.2.6</version>
</dependency>

###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:

<style name="YourAppTheme">
   ...
  <item name="alertDialogProTheme">@style/Theme.AlertDialogPro.Material.Light</item>
</style>

###Build an AlertDialogPro

Use AlertDialogPro.Builder to build an AlertDialogPro:

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 to see more usages.

###Flavor built-in themes

Built-in themes can't meet your requirement? There are several attributes that you can use to make some slight changes. Here is an example to show how to change the positive button's color:

Define your positive button's style:

<style name="YourButtonStyle" parent="Widget.AlertDialogPro.Material.Light.Button">
     <item name="android:textColor">@color/adp_positive_button_color</item>
</style>

Specify button style to your AlertDialogPro's theme with attribute adpButtonBarPositiveButtonStyle:

<style name="FlavoredMaterialLight" parent="Theme.AlertDialogPro.Material.Light">
      ...
     <item name="adpButtonBarPositiveButtonStyle">@style/YourButtonStyle</item>
</style>

Use it in your app's theme:

<item name="alertDialogProTheme">@style/FlavoredMaterialLight</item>

Look into here 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.

Define your AlertDialogPro's style:

<style name="YourAlertDialogProStyle" parent="AlertDialogPro.Material.Light">
  <!-- 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>
</style>

And add it to your AlertDialogPro's theme:

<style name="YourAlertDialogProTheme" parent="Theme.AlertDialogPro.Material.Light">
  ...
  <item name="alertDialogProStyle">@style/YourAlertDialogProStyle</item>
</style>

Use your AlertDialogPro theme in your app's theme:

<item name="alertDialogProTheme">@style/YourAlertDialogProTheme</item>

#Migrate From AlertDialog

AlertDialogPro's Java API is exactly the same as AlertDialog's. 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
Thank vbauer and his awesome site Android-Arsenal

#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.

niuxiaowei/AlertDialogPro