material-dialogs README

The project's README from github.com/afollestad/material-dialogs. As one markdown file: README.md.

Material Dialogs

View Releases and Changelogs

Android CI Codacy Badge License


Showcase

Modules

The core module is the fundamental module that you need in order to use this library. The others are extensions to core.

Please note that since Material Dialogs 2.x.x, this library only supports Kotlin. The latest Java version is 0.9.6.0 and can be found here. Note that 0.9.6.0 is unsupported, bugs & improvements will not be made to that version.

Core

Core

Core Tutorial and Samples

The core module contains everything you need to get started with the library. It contains all core and normal-use functionality.

dependencies {
  ...
  implementation 'com.afollestad.material-dialogs:core:3.3.0'
}

Input

Input

Input Tutorial and Samples

The input module contains extensions to the core module, such as a text input dialog.

dependencies {
  ...
  implementation 'com.afollestad.material-dialogs:input:3.3.0'
}

Files

Files

Files Tutorial and Samples

The files module contains extensions to the core module, such as a file and folder chooser.

dependencies {
  ...
  implementation 'com.afollestad.material-dialogs:files:3.3.0'
}

Color

Color

Color Tutorial and Samples

The color module contains extensions to the core module, such as a color chooser.

dependencies {
  ...
  implementation 'com.afollestad.material-dialogs:color:3.3.0'
}

DateTime

DateTime

DateTime Tutorial and Samples

The datetime module contains extensions to make date, time, and date-time picker dialogs.

dependencies {
  ...
  implementation 'com.afollestad.material-dialogs:datetime:3.3.0'
}

Bottom Sheets

Bottom Sheets

Bottom Sheets Tutorial and Samples

The bottomsheets module contains extensions to turn modal dialogs into bottom sheets, among other functionality like showing a grid of items. Be sure to checkout the sample project for this, too!

dependencies {
  ...
  implementation 'com.afollestad.material-dialogs:bottomsheets:3.3.0'
}

Lifecycle

Lifecycle

Lifecycle Tutorial and Samples

The lifecycle module contains extensions to make dialogs work with AndroidX lifecycles.

dependencies {
  ...
  implementation 'com.afollestad.material-dialogs:lifecycle:3.3.0'
}

material-dialogs (afollestad/material-dialogs)

Searching Database…

19.5K ·GitHub
archived
What is this?Material Dialogs is a dialogs API for Kotlin & Android — a library for showing beautiful, fluid, extensible dialogs in your app.
Is this a library I add to my Android app, or a standalone app?It's a library, not a standalone app: you depend on its modules from your Android project and show dialogs through its API. The core module is the fundamental one; the rest extend it.
How do I add it to my Android project?Start with the core module — it contains everything you need to get started and all normal-use functionality. Every module links to its own tutorial and samples.
Does it work with Java, or is it Kotlin-only?Kotlin only — since version 2.x.x the library no longer supports Java. The last Java-compatible version is 0.9.6.0, which is unsupported and gets no fixes.
Is the project still maintained?No — the GitHub repository is archived, so development has stopped and no bugs will be fixed. It still works in your app, but expect no updates.
Do I need to be an Android developer to use this?Yes — you call it from Kotlin code inside an Android project, so it's aimed at Android (Kotlin) developers rather than end users.
Will it run anywhere besides Android, like on iOS or the web?No — it's an Android library: it lives inside Android apps, so Android is the only platform it works on.
What kinds of dialogs are available beyond plain alerts?Extension modules add a text input dialog, a file and folder chooser, a color chooser, date, time, and date-time pickers, and bottom sheets; a lifecycle module makes dialogs work with AndroidX lifecycles.
Can dialogs be shown as bottom sheets?Yes — the bottomsheets module turns modal dialogs into bottom sheets and can also display a grid of items.
Creator
afollestad
Size
259.6 MB
Stars
19.5K
Age
11y
Commits · 90 Days