# FormatTextViewLib

[![](https://jitpack.io/v/FlyJingFish/FormatTextViewLib.svg)](https://jitpack.io/#FlyJingFish/FormatTextViewLib)
[![GitHub stars](https://img.shields.io/github/stars/FlyJingFish/FormatTextViewLib.svg)](https://github.com/FlyJingFish/FormatTextViewLib/stargazers)
[![GitHub forks](https://img.shields.io/github/forks/FlyJingFish/FormatTextViewLib.svg)](https://github.com/FlyJingFish/FormatTextViewLib/network)
[![GitHub issues](https://img.shields.io/github/issues/FlyJingFish/FormatTextViewLib.svg)](https://github.com/FlyJingFish/FormatTextViewLib/issues)
[![GitHub license](https://img.shields.io/github/license/FlyJingFish/FormatTextViewLib.svg)](https://github.com/FlyJingFish/FormatTextViewLib/blob/master/LICENSE)

## 多数app登陆首页都需要显示用户协议和隐私政策并且需要能够点击，遇到需要翻译多个国家语言的，多个TextView拼接会导致语序不对，而且换行也是个问题

支持切换语言  | 更有支持渐变色字体
 ------ | ------   
<img src="https://github.com/FlyJingFish/FormatTextViewLib/blob/master/screenshot/Screenrecording_20230116_164552.gif" width="320px" height="640px" alt="show" />|<img src="https://github.com/FlyJingFish/FormatTextViewLib/blob/master/screenshot/Screenshot_20230511_154759.jpg" width="320px" height="640px" alt="show" />|

# 特色功能

## 新增继承 [PerfectTextView](https://github.com/FlyJingFish/PerfectTextView)

**继承[PerfectTextView](https://github.com/FlyJingFish/PerfectTextView) 可使用其所有功能，您可前往查看如何使用[点这里查看](https://github.com/FlyJingFish/PerfectTextView)**

## FormatTextView 功能介绍

**1、支持设置字体颜色甚至渐变色，加粗，斜体，下划线，删除线，字体大小**

**2、支持下划线设置线宽，距离文字距离，颜色**

**3、支持删除线设置线宽，颜色**

**4、支持设置图片，图片的大小，左右距离，加载本地、网络图片**

**5、支持给每个位置的富文本添加点击事件**

**6、支持给每个位置的富文本设置背景色**

## HtmlTextView 功能介绍

**1、支持加载网络图片**

**2、支持为存在链接的标签添加点击事件**


## 第一步，根目录build.gradle

```gradle
    allprojects {
        repositories {
            ...
            maven { url 'https://jitpack.io' }
        }
    }
```
## 第二步，需要引用的build.gradle （最新版本[![](https://jitpack.io/v/FlyJingFish/FormatTextViewLib.svg)](https://jitpack.io/#FlyJingFish/FormatTextViewLib)）

```gradle
    dependencies {
        implementation 'com.github.FlyJingFish:FormatTextViewLib:2.2.8'
    }
```
## 第三步，使用说明

## 一、FormatTextView 使用说明

### Kotlin调用示例

```kotlin
  //如果包含网络图片必须先设置以下方法
  textView.setOnInflateImageListener(object : FormatTextView.OnInflateImageListener {
    override fun onInflate(
        formatImage: FormatImage?,
        drawableListener: FormatTextView.OnReturnDrawableListener?
    ) {
        val requestBuilder: RequestBuilder<Drawable> =
            Glide.with(this@MainActivity).asDrawable().load(
                formatImage!!.imageUrlValue
            )
        if (formatImage.width > 0 && formatImage.height > 0) {
            val imageWidth = dp2px(this@DemoActivity, formatImage.width)
            val imageHeight = dp2px(this@DemoActivity, formatImage.height)
            requestBuilder.apply(
                RequestOptions().override(
                    imageWidth.toInt(),
                    imageHeight.toInt()
                ).centerCrop()
            )
        }
        requestBuilder.into(object : CustomTarget<Drawable?>() {
            override fun onResourceReady(resource: Drawable, transition: Transition<in Drawable?>?) {
                drawableListener?.onReturnDrawable(resource)
            }

            override fun onLoadCleared(placeholder: Drawable?) {}
        })
    }
})
  //设置数据
 textView.setFormatText("%1\$s欢迎欢迎欢迎欢迎欢迎欢迎%3\$s欢迎欢迎欢迎%2\$s",
            FormatText().apply {
                textSize = 30f
                textColor = R.color.colorAccent
                bold = false
                italic = true
                underline = true
                underlineColor = R.color.color_red
                underlineMarginTop = 10f
                underlineWidth = 2f
                resValue = R.string.we
                gradient = Gradient(intArrayOf(Color.GREEN,Color.RED),null,Gradient.Orientation.LEFT_TO_RIGHT)
            },
            FormatImage().apply {
                imagePlaceHolder = R.mipmap.ic_launcher_round
                imageUrlValue = "https://gimg2.baidu.com/image_search/src=http%3A%2F%2Fp0.itc.cn%2Fq_70%2Fimages03%2F20210227%2F6687c969b58d486fa2f23d8488b96ae4.jpeg&refer=http%3A%2F%2Fp0.itc.cn&app=2002&size=f9999,10000&q=a80&n=0&g=0n&fmt=auto?sec=1661701773&t=19043990158a1d11c2a334146020e2ce"
                verticalAlignment = FormatImage.ALIGN_CENTER
                width = 25f
                height = 25f
                marginStart = 10f
                marginEnd = 10f
            },
            FormatImage().apply {
                imagePlaceHolder = R.mipmap.ic_launcher_round
                imageUrlValue = "https://pics4.baidu.com/feed/50da81cb39dbb6fd95aa0c599b8d0d1e962b3708.jpeg?token=bf17224f51a6f4bb389e787f9c487940"
                verticalAlignment = FormatImage.ALIGN_CENTER
                width = 25f
                height = 25f
                marginStart = 10f
                marginEnd = 10f
            })
// 设置点击的监听
 textView.setOnFormatClickListener(object : OnFormatClickListener{
            override fun onLabelClick(position: Int) {//position就是设置数据的顺序
                Toast.makeText(this@MainActivity,"onItemClick-item"+position,Toast.LENGTH_SHORT).show()
            }
        })
```

### 特别说明

OnFormatClickListener 的 onLabelClick 返回的 position 就是设置数据的下标

**举个例子**

有这样一段文本  str = "我已阅读并同意%1$s和%2$s" 或者 "我已阅读并同意%2$s和%1$s"

当使用以上两个字符串调用 setFormatText(str,"隐私政策","用户协议") 时

以上两种字符串的结果分别是

1、我已阅读并同意**隐私政策**和**用户协议**

2、我已阅读并同意**用户协议**和**隐私政策**

出现以上两种结果是只是因为 **%1$s** 和 **%2$s** 调换了顺序，但是调用**setFormatText**设置数据的顺序并没有变化，所以当点击**隐私政策**时position两种情况都是0，当点击**用户协议**时position两种情况都是1

**简单来说 setFormatText(str,"隐私政策","用户协议") 中 "隐私政策" 对应 position 是0， "用户协议" 对应 position 是1**

### Java调用示例

```java
textView.setOnInflateImageListener(new FormatTextView.OnInflateImageListener() {
    @Override
    public void onInflate(FormatImage formatImage, final FormatTextView.OnReturnDrawableListener drawableListener) {
        RequestBuilder<Drawable> requestBuilder = Glide.with(SecondActivity.this).asDrawable().load(formatImage.imageUrlValue);
        if (formatImage.width > 0 && formatImage.height > 0) {
            requestBuilder.apply(new RequestOptions().override(((int) formatImage.width), ((int) formatImage.height)).centerCrop());
        }
        requestBuilder.into(new CustomTarget<Drawable>() {
            @Override
            public void onResourceReady(@NonNull Drawable resource, @Nullable Transition<? super Drawable> transition) {
                drawableListener.onReturnDrawable(resource);
            }

            @Override
            public void onLoadCleared(@Nullable Drawable placeholder) {

            }
        });
    }
});
textView.setFormatText("%1$s欢迎欢迎欢迎欢迎欢迎欢迎欢迎%3$s欢迎欢迎欢迎%2$s",
        new FormatText().setTextColor(R.color.colorAccent).setBold(false)
                .setUnderlineColor(R.color.color_red).setUnderlineMarginTop(10f).setUnderlineWidth(2f)
                .setUnderline(true).setItalic(true).setResValue(R.string.we)
                .setGradient(new Gradient(new int[]{Color.BLUE,Color.RED},null,Gradient.Orientation.LEFT_TO_RIGHT)),
        new FormatImage().setImagePlaceHolder(R.mipmap.ic_launcher_round)
                .setImageUrlValue("https://gimg2.baidu.com/image_search/src=http%3A%2F%2Fp0.itc.cn%2Fq_70%2Fimages03%2F20210227%2F6687c969b58d486fa2f23d8488b96ae4.jpeg&refer=http%3A%2F%2Fp0.itc.cn&app=2002&size=f9999,10000&q=a80&n=0&g=0n&fmt=auto?sec=1661701773&t=19043990158a1d11c2a334146020e2ce")
                .setVerticalAlignment(FormatImage.ALIGN_CENTER)
                .setWidth(30f)
                .setHeight(40f)
                .setMarginStart(20f)
                .setMarginEnd(20f),
        new FormatImage().setImagePlaceHolder(R.mipmap.ic_launcher_round)
                .setImageUrlValue("https://pics4.baidu.com/feed/50da81cb39dbb6fd95aa0c599b8d0d1e962b3708.jpeg?token=bf17224f51a6f4bb389e787f9c487940")
                .setVerticalAlignment(FormatImage.ALIGN_CENTER)
                .setWidth(30f)
                .setHeight(40f)
                .setMarginStart(20f)
                .setMarginEnd(20f));
```

### 下划线常见问题
如果您设置了下划线以下样式：

**underlineColor、underlineMarginTop、underlineWidth**

那么下划线将采用绘制下划线方案，**underlineMarginTop**不设置（即为0）绘制在默认的删除线位置，如果设置数值过大并且文本长到换行，则需要设置行间距，否则会出现下滑线压在下一行的问题，你可通过设置lineSpacingExtra或lineSpacingMultiplier来解决问题

如果设置渐变色字体后 在您不设置 **underlineColor、underlineMarginTop、underlineWidth** 这3项的情况下，下划线也将会是渐变色的

### 删除线常见问题
如果您设置了删除线以下样式：

**deleteLineColor、deleteLineWidth**

那么删除线将采用绘制删除线方案，如果设置渐变色字体后 在您不设置 **deleteLineColor、deleteLineWidth** 这2项的情况下，删除线也将会是渐变色的

### verticalAlignment 常见问题

ALIGN_CENTER 为当前库新增对齐方式旨解决在小图标和文本中心对齐问题，在图片设置超过行高时将会出现裁剪问题，如果您图片很大还是建议使用ALIGN_BASELINE

## FormatText 参数一览
| 属性                 |      参数类型      |          描述           |
|--------------------|:--------------:|:---------------------:|
| textColor          | @ColorRes int  |       文字资源颜色Id        |
| bold               |    boolean     |        文字是否加粗         |
| italic             |    boolean     |        文字是否斜体         |
| strValue           |     String     |      文字String类型值      |
| resValue           | @StringRes int |       文字文本资源Id        |
| textSize           |     float      |     文字字体大小(单位：SP)     |
| underline          |    boolean     |        文字是否下划线        |
| underlineColor     | @ColorRes int  |        文字下划线颜色        |
| underlineWidth     |     float      |    文字下划线线宽(单位：DP)     |
| underlineMarginTop |     float      |  文字下划线向下偏移的距离(单位：DP)  |
| deleteLine         |    boolean     |        文字是否删除线        |
| deleteLineColor    | @ColorRes int  |        文字删除线颜色        |
| deleteLineWidth    |     float      |    文字删除线线宽(单位：DP)     |
| backgroundColor    | @ColorRes int  |        文字区域背景色        |
| ignorePaintShader  |    boolean     | 文字是否忽略TextView的Shader |
| gradient           |    Gradient    |        文字渐变色配置        |

## Gradient 参数一览

| 属性                |      参数类型       |                                                      描述                                                       |
|-------------------|:---------------:|:-------------------------------------------------------------------------------------------------------------:|
| gradientColors    | @ColorInt int[] |                                            渐变色（颜色值为ColorInt 类型）数组                                             |
| gradientPositions |     float[]     |                              渐变色分布配置（传入null表示颜色均匀分布，否则需要此数组与gradientColors长度一致）                               |
| orientation       |      enum       | LEFT_TO_RIGHT （从左到右）/TOP_TO_BOTTOM （从上到下）/LEFT_TOP_TO_RIGHT_BOTTOM （从左上到右下）/LEFT_BOTTOM_TO_RIGHT_TOP （从左下到右上） |

## FormatImage 参数一览
| 属性                |       参数类型       |                        描述                        |
|-------------------|:----------------:|:------------------------------------------------:|
| imageUrlValue     |      String      |                     网络图片Url                      |
| imageResValue     | @DrawableRes int |                     本地图片资源Id                     |
| imagePlaceHolder  | @DrawableRes int |                  网络图片加载时图片资源Id                   |
| width             |      float       |                   图片宽度(单位：DP)                    |
| height            |      float       |                   图片高度(单位：DP)                    |
| verticalAlignment |       int        | 图片对齐方式(ALIGN_BASELINE/ALIGN_CENTER/ALIGN_BOTTOM) |
| marginLeft        |      float       |                 图片距离左侧距离(单位：DP)                  |
| marginRight       |      float       |                 图片距离右侧距离(单位：DP)                  |
| marginStart       |      float       |             图片距离左侧(Rtl:右侧)距离(单位：DP)              |
| marginEnd         |      float       |             图片距离右侧(Rtl:左侧)距离(单位：DP)              |
| backgroundColor   |  @ColorRes int   |                     图片区域背景色                      |

## 二、HtmlTextView 使用说明

### Kotlin调用示例

```kotlin
 //如果包含网络图片必须先设置以下方法
 text7.setOnInflateImageListener(object : HtmlTextView.OnInflateImageListener{
    override fun onInflate(
        source: String?,
        drawableListener: HtmlTextView.OnReturnDrawableListener?
    ) {
        val requestBuilder: RequestBuilder<Drawable> =
            Glide.with(this@MainActivity).asDrawable().load(
                source
            )
        requestBuilder.into(object : CustomTarget<Drawable?>() {
            override fun onResourceReady(resource: Drawable, transition: Transition<in Drawable?>?) {
                drawableListener?.onReturnDrawable(resource)
            }

            override fun onLoadCleared(placeholder: Drawable?) {}
        })
    }
})
text7.setHtmlText("哈哈哈<a>lala</a>啦啦<a href=\"haha\">haha</a>哈哈哈<img src=\"https://gimg2.baidu.com/image_search/src=http%3A%2F%2Fp0.itc.cn%2Fq_70%2Fimages03%2F20210227%2F6687c969b58d486fa2f23d8488b96ae4.jpeg&refer=http%3A%2F%2Fp0.itc.cn&app=2002&size=f9999,10000&q=a80&n=0&g=0n&fmt=auto?sec=1661701773&t=19043990158a1d11c2a334146020e2ce\"></img>",
    HtmlImage().apply
    {
        maxWidth = 160f
        maxHeight = 160f
        verticalAlignment = ImageSpan.ALIGN_BASELINE
        imagePlaceHolder = R.mipmap.ic_launcher
    }
)
```

### Java调用示例

```java
text7.setOnInflateImageListener(new HtmlTextView.OnInflateImageListener() {
    @Override
    public void onInflate(@Nullable String source, @Nullable final HtmlTextView.OnReturnDrawableListener drawableListener) {
        RequestBuilder<Drawable> requestBuilder = Glide.with(SecondActivity.this).asDrawable().load(source);
        requestBuilder.into(new CustomTarget<Drawable>() {
            @Override
            public void onResourceReady(@NonNull Drawable resource, @Nullable Transition<? super Drawable> transition) {
                drawableListener.onReturnDrawable(resource);
            }

            @Override
            public void onLoadCleared(@Nullable Drawable placeholder) {

            }
        });
    }
});

text7.setHtmlText("哈哈哈<a>lala</a>啦啦<a href=\"haha\">haha</a>哈哈哈<img src=\"https://gimg2.baidu.com/image_search/src=http%3A%2F%2Fp0.itc.cn%2Fq_70%2Fimages03%2F20210227%2F6687c969b58d486fa2f23d8488b96ae4.jpeg&refer=http%3A%2F%2Fp0.itc.cn&app=2002&size=f9999,10000&q=a80&n=0&g=0n&fmt=auto?sec=1661701773&t=19043990158a1d11c2a334146020e2ce\"></img>",
        new HtmlImage().setMaxHeight(100).setMaxWidth(100));
```

## HtmlImage 参数一览
| 属性                |       参数类型       |                        描述                        |
|-------------------|:----------------:|:------------------------------------------------:|
| imagePlaceHolder  | @DrawableRes int |                  网络图片加载时图片资源Id                   |
| maxWidth          |      float       |                  图片最大宽度(单位：DP)                   |
| maxHeight         |      float       |                  图片最大高度(单位：DP)                   |
| verticalAlignment |       int        | 图片对齐方式(ALIGN_BASELINE/ALIGN_CENTER/ALIGN_BOTTOM) |

# 我的更多开源库推荐

## 最后推荐我写的另外一些库

- [OpenImage 轻松实现在应用内点击小图查看大图的动画放大效果](https://github.com/FlyJingFish/OpenImage)

- [AndroidAOP 一个注解就可请求权限，禁止多点，切换线程等等，更可定制出属于你的 Aop 代码](https://github.com/FlyJingFish/AndroidAOP)

- [主页查看更多开源库](https://github.com/FlyJingFish)