添加方法注释，完善方法

shenbengit · May 18, 2021 · 72decdb · 72decdb
1 parent 4c48043
commit 72decdb
Show file tree

Hide file tree

Showing 4 changed files with 45 additions and 9 deletions.
diff --git a/README.md b/README.md
@@ -28,8 +28,8 @@ dependencies {
 ```kotlin
 // 创建自定义LoadingDialog
 val loadingDialog = LoadingDialog.Builder(context, R.style.LoadingDialog)
-            .setCancelable(true)//[Dialog.setCancelable]
-            .setCanceledOnTouchOutside(true)//[Dialog.setCanceledOnTouchOutside]
+            .setCancelable(false)//[Dialog.setCancelable]
+            .setCanceledOnTouchOutside(false)//[Dialog.setCanceledOnTouchOutside]
             .setHintText("加载中...")//设置显示的提示性文字内容
             .showHintText(true)//是否显示提示性文字
             .create()
@@ -40,5 +40,6 @@ val loadingDialog = LoadingDialog.Builder(context, R.style.LoadingDialog)
  loadingDialog.dismiss()//or loadingDialog.cancel()
 
  //快速创建默认配置的LoadingDialog
-val defaultLoadingDialog = LoadingDialog.createDefault(context)
+val defaultLoadingDialog1 = LoadingDialog.createDefault(context)
+val defaultLoadingDialog2 = LoadingDialog.createDefault(context, R.style.LoadingDialog)
 ```
diff --git a/app/build.gradle b/app/build.gradle
@@ -42,6 +42,6 @@ dependencies {
     androidTestImplementation 'androidx.test.ext:junit:1.1.2'
     androidTestImplementation 'androidx.test.espresso:espresso-core:3.3.0'
     implementation 'com.squareup.leakcanary:leakcanary-android:2.7'
-//    implementation project(path: ':lib')
-    implementation 'com.github.shenbengit:LoadingDialog:1.0.1'
+    implementation project(path: ':lib')
+//    implementation 'com.github.shenbengit:LoadingDialog:1.0.3'
 }
diff --git a/app/src/main/java/com/shencoder/loadingdialogdemo/MainActivity.kt b/app/src/main/java/com/shencoder/loadingdialogdemo/MainActivity.kt
@@ -8,12 +8,18 @@ import android.widget.Button
 import com.shencoder.loadingdialog.LoadingDialog
 
 class MainActivity : AppCompatActivity() {
-    private val loadingDialog by lazy { LoadingDialog.createDefault(this) }
+    private lateinit var loadingDialog: LoadingDialog
 
     private val mHandler = Handler(Looper.getMainLooper())
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         setContentView(R.layout.activity_main)
+        loadingDialog = LoadingDialog.Builder(this, R.style.LoadingDialog)
+            .setCancelable(false)
+            .setCanceledOnTouchOutside(false)
+            .setHintText("请稍后...")
+            .showHintText(true)
+            .create()
         findViewById<Button>(R.id.btnShow).setOnClickListener {
             loadingDialog.show()
             mHandler.postDelayed({ loadingDialog.dismiss() }, 3000L)

diff --git a/lib/src/main/java/com/shencoder/loadingdialog/LoadingDialog.kt b/lib/src/main/java/com/shencoder/loadingdialog/LoadingDialog.kt
@@ -13,7 +13,7 @@ import androidx.annotation.StyleRes
  * @date    2021/05/17 11:12
  * @email   714081644@qq.com
  */
-class LoadingDialog(
+class LoadingDialog internal constructor(
     builder: Builder
 ) : Dialog(builder.context, builder.themeResId) {
 
@@ -24,15 +24,32 @@ class LoadingDialog(
          * 创建默认配置的[LoadingDialog]
          */
         fun createDefault(context: Context) = Builder(context).create()
+
+        /**
+         * 创建默认配置的[LoadingDialog]
+         */
+        fun createDefault(context: Context, @StyleRes themeResId: Int) =
+            Builder(context, themeResId).create()
     }
 
     init {
         setContentView(R.layout.dialog_loading)
         setCancelable(builder.mCancelable)
         setCanceledOnTouchOutside(builder.mTouchOutsideCancelable)
         mTvHint = findViewById(R.id.tvHint)
-        mTvHint.text = builder.mHintText
-        mTvHint.visibility = if (builder.isShowHintText) View.VISIBLE else View.GONE
+        setHintText(builder.mHintText)
+        showHintText(builder.isShowHintText)
+    }
+
+    /**
+     * 动态设置提示文字
+     */
+    fun setHintText(text: String) {
+        mTvHint.text = text
+    }
+
+    fun showHintText(isShow: Boolean) {
+        mTvHint.visibility = if (isShow) View.VISIBLE else View.GONE
     }
 
     class Builder @JvmOverloads constructor(
@@ -43,16 +60,28 @@ class LoadingDialog(
             private const val DEFAULT_HINT_TEXT = "请稍后..."
         }
 
+        /**
+         * @see [Dialog.setCancelable]
+         */
         internal var mCancelable = false
         fun setCancelable(cancelable: Boolean) = apply { this.mCancelable = cancelable }
 
+        /**
+         * @see [Dialog.setCanceledOnTouchOutside]
+         */
         internal var mTouchOutsideCancelable = false
         fun setCanceledOnTouchOutside(cancelable: Boolean) =
             apply { this.mTouchOutsideCancelable = cancelable }
 
+        /**
+         * 是否显示提示性文字
+         */
         internal var isShowHintText = true
         fun showHintText(isShow: Boolean) = apply { this.isShowHintText = isShow }
 
+        /**
+         * 设置显示的提示性文字内容
+         */
         internal var mHintText = DEFAULT_HINT_TEXT
         fun setHintText(text: String) = apply { this.mHintText = text }