LDialog
中文
(suppor Android X)
A library based on Google's recommended DialogFragment package, according to its own business extraction package, the library is written using kotlin
, java
can also be called, can meet most project needs, can Used in Activity and Fragment. The guiding principle of this project is to adhere to the maximum degree of freedom.
The library currently has the following features:
- Rotate the vertical and vertical screens to save the Dialog property state (and maintain the event state of the DialogFragment, such as a click event)
- Complete custom interface
- Rich interface property settings
- Perfect keyboard automatically pops up (not using delay method)
Recommendations: DialogFragment has many advantages over AlertDialog. However, for simple information prompts, only native styles, and no horizontal and vertical rotation is required, a simpler AlertDialog is recommended. Please don't complicate the simple question.
Source description:
If you haven't gotten started with koltin, it is recommended to learn to use it. The environment version of this library is as follows:
- kotlin 1.3.61
- AndroidX
Preview
Due to the limitations of the screen. Please download the demo experience
Demo download link
Obtain
This library is divided into the necessary LDialog`` and non-essential
CustomLDialog.
LDialogis the base library;
CustomLDialog``` contains custom styles, and you don't need to import them if you don't need them.
First add in the repositories of build.gradle :
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
Add in dependencies:
dependencies {
//Must be imported
implementation 'com.github.limuyang2.LDialog:ldialog:1.0.2'
//3 custom styles, you don't need to import them if you don't need them
implementation 'com.github.limuyang2.LDialog:custom_ldialog:1.0.2'
}
if you use Android X,Please use the following:
dependencies {
//Must be imported
implementation 'com.github.limuyang2.LDialog:ldialog:1.0.2_androidx'
//3 custom styles, you don't need to import them if you don't need them
implementation 'com.github.limuyang2.LDialog:custom_ldialog:1.0.2_androidx'
}
Simple to use
Both LDialog and CustonLDialog inherit from the BaseLDialog class.
The parameters in init(),
Activity
usesupportFragmentManager
,Fragment
usingchildFragmentManager
CustonLDialog Use
There are currently 3 custom styles:
- IOSMsgDialog
- MaterialMsgDialog
- BottomTextListDialog
The following is an example of MaterialMsgDialog
:
//koltin
MaterialMsgDialog.init(supportFragmentManager) //Freagment using childFragmentManager
.setTitle("Material Style")
.setMessage("This is Material Design dialog!")
.setNegativeButton("Decline", View.OnClickListener {
Toast.makeText(this@MainActivity, "Decline", Toast.LENGTH_SHORT).show()
})
.setPositiveButton("Accept", View.OnClickListener {
Toast.makeText(this@MainActivity, "Accept", Toast.LENGTH_SHORT).show()
})
.show()
//java
MaterialMsgDialog.Companion.init(getSupportFragmentManager())
.setTitle("Material Style")
.setMessage("This is Material Design dialog!")
.setNegativeButton("Decline", new View.OnClickListener() {
@Override
public void onClick(View v) {
Toast.makeText(JavaDemo.this, "Decline", Toast.LENGTH_SHORT).show()
}
})
.setPositiveButton("Accept", new View.OnClickListener() {
@Override
public void onClick(View v) {
Toast.makeText(JavaDemo.this, "Accept", Toast.LENGTH_SHORT).show()
}
})
.show();
LDialog use (mainly used)
Used to provide a custom layout using layoutRes.
Examples:
//kotlin
LDialog.init(supportFragmentManager)
.setLayoutRes(R.layout.ldialog_share)
.setBackgroundDrawableRes(R.drawable.shape_share_dialog_bg)
.setGravity(Gravity.BOTTOM)
.setWidthScale(0.95f)
.setVerticalMargin(0.015f)
.setAnimStyle(R.style.LDialogBottomAnimation)
.setViewHandlerListener(object : ViewHandlerListener() {
override fun convertView(holder: ViewHolder, dialog: BaseLDialog<*>) {
holder.setOnClickListener(R.id.cancelBtn, View.OnClickListener {
dialog.dismiss()
})
}
})
.show()
For Java usage, please refer to JavaDemo.java under the project.
Method description
Method name | Description |
---|---|
setLayoutRes | Set layout resources 【priority is higher than setLayoutView】【LDialog only, must】 |
setLayoutView | Set layout view (not recommended)【LDialog only,must】 |
* setViewHandlerListener | (Important) Set the properties of the controls in the layout. If need to consider horizontal and vertical rotation, the relevant properties of the control must be set here. It is recommended that the settings for the controls in the layout be written here.【LDialog only, must】 |
General method(BaseLDialog) | |
setBackgroundDrawableRes | Dialog Background resource file id |
setTag | DialogFragment tag |
setDismissListener | Dialog off Listener |
setGravity | Dialog Gravity(Examples:Gravity.CENTER Gravity.TOP) |
setWidthScale | Proportion of screen width(range 0.0 - 1.0, when it is 1.0, it is full)【Priority is higher than setWidthDp 】 |
setWidthDp | Dialog width, unit dp |
setHeightScale | Proportion of screen height (range 0.0 - 1.0)【Priority is higher than setHeightDp 】 |
setHeightDp | Dialog height, unit dp |
setKeepWidthScale | Whether to maintain the set width ratio when horizontally【Only takes effect when the width ratio setWidthScale is set】(default false) |
setKeepHeightScale | Whether to maintain the set height ratio when the screen is horizontal【Only takes effect when the height ratio setHeightScale is set】(default false) |
setVerticalMargin | Set the Margin value in the vertical direction (range 0.0 - 0.1) |
setCancelableAll | Set whether you can click outside the dialog and Back key to close the dialog |
setCancelableOutside | Set whether you can click outside the dialog to close the dialog (the Back key is not affected) |
setAnimStyle | Animated Style resource file id |
setNeedKeyboardEditTextId | Set the control id that needs to automatically pop up the keyboard. It must be a control of type EditText. |
show | Show Dialog |
Advanced use
If the above still can not meet your needs, you can directly inherit the BaseLDialog
class, and also have a general method. For details, please refer to the three Dialog classes in ```CustonLDialog``.
The basic writing is as follows:
class ExKotlinLdialog : BaseLDialog<ExKotlinLdialog>() {
override fun layoutRes(): Int = R.layout.ldialog_share
override fun layoutView(): View? = null
/**
* Must
* If [need] to consider horizontal and vertical rotation, the relevant properties of the control are set here.
* @return
*/
override fun viewHandler(): ViewHandlerListener? {
return object : ViewHandlerListener() {
override fun convertView(holder: ViewHolder, dialog: BaseLDialog<*>) {
}
}
}
/**
* Optional
* If you don't consider the horizontal and vertical rotation, you can also set the control properties here.
* @param view
*/
override fun initView(view: View) {
}
}
Java use please refer to ExJavaLdialog.java under the project
ProGuard
If you are using ProGuard you might need to add the following option:
-keep class top.limuyang2.ldialog.base.** { *; }
License
2018 limuyang
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.