1，完善功能

Author: FlyJingFish

FormatTextView/src/main/java/com/flyjingfish/formattextview/FormatTextView.kt

@@ -33,6 +33,7 @@ class FormatTextView : BaseTextView {
     private var isClickSpanItem = false
     var isSetOnClick = false
     private var isDrawGradient = false
+    private var isClearTexts = true
     private val underLineTexts: ArrayList<LineText> = ArrayList()
     private val deleteLineTexts: ArrayList<LineText> = ArrayList()
     private val gradientTexts: ArrayList<LineText> = ArrayList()
@@ -52,10 +53,10 @@ class FormatTextView : BaseTextView {
         setFormatTextBean(resources.getString(formatTextRes), *args)
     }
 
-    fun setFormatTextBean(formatTextValue: String, vararg args: BaseFormat?) {
-        var textValue = formatTextValue.replace("\\r\\n".toRegex(), "<br>")
-        textValue = textValue.replace("\\n".toRegex(), "<br>")
-        textValue = textValue.replace("\\r".toRegex(), "<br>")
+    fun setFormatTextBean(formatTextValue: String?, vararg args: BaseFormat?) {
+        var textValue = formatTextValue?.replace("\\r\\n".toRegex(), "<br>")
+        textValue = textValue?.replace("\\n".toRegex(), "<br>")
+        textValue = textValue?.replace("\\r".toRegex(), "<br>")
         val strings = arrayOfNulls<String>(args.size)
         var isContainGradient = false
         for (i in args.indices) { //%1$s
@@ -84,28 +85,48 @@ class FormatTextView : BaseTextView {
 
 
         }
-        val richText = String.format(textValue, *strings)
-        formatArgs = args
-        this.richText = richText
+        if (textValue == null){
+            isClearTexts = true
+            text = ""
+            return
+        }
         isDrawGradient = !isContainGradient
         underLineTexts.clear()
         deleteLineTexts.clear()
         gradientTexts.clear()
         gradientDrawTexts.clear()
+        val richText = String.format(textValue, *strings)
+        formatArgs = args
+        this.richText = richText
+        isClearTexts = false
         text = getCustomStyleHtml(richText, *args)
         highlightColor = Color.TRANSPARENT
         autoLinkMask = Linkify.WEB_URLS
     }
 
+    override fun setText(text: CharSequence?, type: BufferType?) {
+        if (isClearTexts){
+            isDrawGradient = true
+            underLineTexts.clear()
+            deleteLineTexts.clear()
+            gradientTexts.clear()
+            gradientDrawTexts.clear()
+            formatArgs = null
+            this.richText = null
+        }
+        super.setText(text, type)
+    }
+
     private fun resetText(){
+        isClearTexts = false
         text = richText?.let { formatArgs?.let { it1 -> getCustomStyleHtml(it, *it1) } }
     }
 
     fun setFormatText(@StringRes formatTextRes: Int, vararg args: Int) {
         setFormatText(resources.getString(formatTextRes), *args)
     }
 
-    fun setFormatText(formatTextValue: String, vararg args: Int) {
+    fun setFormatText(formatTextValue: String?, vararg args: Int) {
         val formatTexts: Array<FormatText?> = arrayOfNulls(args.size)
         for (i in args.indices) {
             formatTexts[i] = FormatText().setResValue(args[i])
@@ -117,7 +138,7 @@ class FormatTextView : BaseTextView {
         setFormatText(resources.getString(formatTextRes), *args)
     }
 
-    fun setFormatText(formatTextValue: String, vararg args: String) {
+    fun setFormatText(formatTextValue: String?, vararg args: String) {
         val formatTexts: Array<FormatText?> = arrayOfNulls(args.size)
         for (i in args.indices) {
             formatTexts[i] = FormatText().setStrValue(args[i])
@@ -492,6 +513,7 @@ class FormatTextView : BaseTextView {
         drawUnderline(canvas)
         drawDeleteLine(canvas)
         getGradient()
+        isClearTexts = true
     }
     private fun getGradient() {
         if (gradientTexts.size == 0 || isDrawGradient) {

README-zh.md

@@ -236,6 +236,14 @@ ALIGN_CENTER 为当前库新增对齐方式旨解决在小图标和文本中心
 | ignorePaintShader  |    boolean     | 文字是否忽略TextView的Shader |
 | gradient           |    Gradient    |        文字渐变色配置        |
 
+## Gradient 参数一览
+
+| 属性                |      参数类型       |                                                      描述                                                       |
+|-------------------|:---------------:|:-------------------------------------------------------------------------------------------------------------:|
+| gradientColors    | @ColorInt int[] |                                            渐变色（颜色值为ColorInt 类型）数组                                             |
+| gradientPositions |     float[]     |                                       渐变色分布配置（此数组需与gradientColors长度一致）                                        |
+| orientation       |   Orientation   | LEFT_TO_RIGHT （从左到右）/TOP_TO_BOTTOM （从上到下）/LEFT_TOP_TO_RIGHT_BOTTOM （从左上到右下）/LEFT_BOTTOM_TO_RIGHT_TOP （从左下到右上） |
+
 ## FormatImage 参数一览
 | 属性                |       参数类型       |                        描述                        |
 |-------------------|:----------------:|:------------------------------------------------:|

README.md

@@ -238,6 +238,14 @@ ALIGN_CENTER adds an alignment method to the current library to solve the alignm
 | ignorePaintShader  |    boolean     |        Whether the text ignores the Shader of the TextView         |
 | gradient           |    Gradient    |                 Text Gradient Color Configuration                  |
 
+## Gradient parameter list
+
+| Attribute | Parameter Type | Description |
+|--------------------|:---------------:|:---------- -------------------------------------------------- --------------------------------------------------: |
+| gradientColors | @ColorInt int[] | array of gradient colors (color values are of type ColorInt) |
+| gradientPositions | float[] | Gradient color distribution configuration (this array needs to be consistent with the length of gradientColors) |
+| orientation | Orientation | LEFT_TO_RIGHT (left to right)/TOP_TO_BOTTOM (top to bottom)/LEFT_TOP_TO_RIGHT_BOTTOM (top left to bottom right)/LEFT_BOTTOM_TO_RIGHT_TOP (bottom left to top right) |
+
 ## FormatImage parameter list
 | property          |  parameter type  |                        description                         |
 |-------------------|:----------------:|:----------------------------------------------------------:|