ElegantDialog 使用教程
项目介绍
ElegantDialog 是一个为 Android 平台设计的美丽、可定制且交互式的对话框库,支持 Kotlin 和 Java。该库提供了丰富的自定义选项,包括顶部和底部背景颜色、自定义布局、图标、颜色、文本和字体等。ElegantDialog 旨在帮助开发者快速创建优雅的用户界面元素。
项目快速启动
添加依赖
首先,在项目的 build.gradle
文件中添加 JitPack 仓库:
allprojects {
repositories {
maven { url 'https://jitpack.io' }
}
}
然后在应用的 build.gradle
文件中添加依赖:
dependencies {
implementation 'com.github.muigukenneth:ElegantDialog:${LATEST_VERSION}'
}
基本使用
以下是一个简单的使用示例:
val dialog = ElegantDialog(context)
dialog.setTitleIcon(titleIcon) // 设置标题图标
dialog.setTitleIconBackgroundColor(backgroundIconColor) // 设置标题图标背景颜色
dialog.setBackgroundTopColor(backgroundTopColor) // 设置顶部背景颜色
dialog.setBackgroundBottomColor(backgroundBottomColor) // 设置底部背景颜色
dialog.setCustomView(R.layout.custom_image_layout) // 设置自定义布局
dialog.setCornerRadius(50f) // 设置对话框圆角半径
dialog.setCanceledOnTouchOutside(false) // 点击外部不关闭对话框
dialog.setTitleHidden(false) // 隐藏标题
dialog.setElegantActionClickListener(object : ElegantActionListeners {
override fun onPositiveListener(dialog: ElegantDialog) {
dialog.dismiss()
}
override fun onNegativeListener(dialog: ElegantDialog) {
dialog.dismiss()
}
override fun onGotItListener(dialog: ElegantDialog) {
dialog.dismiss()
}
override fun onCancelListener(dialog: DialogInterface) {
dialog.dismiss()
}
})
dialog.show() // 显示对话框
应用案例和最佳实践
自定义图标和颜色
你可以通过以下方式自定义对话框的图标和颜色:
dialog.setTitleIcon(R.drawable.custom_icon)
dialog.setTitleIconBackgroundColor(Color.RED)
dialog.setBackgroundTopColor(Color.BLUE)
dialog.setBackgroundBottomColor(Color.GREEN)
隐藏按钮
如果需要隐藏某些按钮,可以使用以下代码:
dialog.getPositiveButtonIconView().visibility = View.GONE
dialog.getPositiveButtonTextView().visibility = View.GONE
典型生态项目
ElegantDialog 可以与其他流行的 Android 库结合使用,例如 Glide 和 Picasso 用于图片加载,以及 RecyclerView 用于自定义布局。以下是一个结合 Glide 的示例:
Glide.with(context)
.load(imageUrl)
.into(dialog.getTitleIconView())
通过这些组合,你可以创建出更加丰富和动态的用户界面。