SuperTextView 最全开发指南

时间  2019-12-05
标签 supertextview 开发 指南 繁體版
原文   原文链接

SuperTextView 最全开发指南

SuperTextView 指定官方交流群：775951525

📲 点击连接，下载体验 Demohtml

嘿，开发者您好，欢迎使用 SuperTextView ！感谢您及数万位 Android 开发者的信赖 😘 android

在过去 1 年半的时间里，SuperTextView 通过了屡次迭代和上百次的 commit，已经被普遍应用于各种型商业 App 中，经受住了千万级日活的考验。相信 SuperTextView 也能为您带来开发体验上的提高，以及协助您构建或改进出更加精美的应用。git

若是您是初次使用 SuperTextView，那么这篇文档将会向您详细的讲解 SuperTextView 的每一项功能，以便您能快速上手。
若是您是 SuperTextView 老粉，经过这篇文档您也许会发现一些以前不曾涉及到便捷功能。github

1. 获取最新版本的 SuperTextView

  • 在你的build.gradle中加入：算法

    allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

dependencies {
    compile 'com.github.chenBingX:SuperTextView:v3.1.4'
}
  • 项目地址

https://github.com/chenBingX/SuperTextViewcanvas

注：关注本项目以及时得到最新版本信息。网络

2. SuperTextView 支持的属性

对于 SuperTextView 说支持的绝大部分酷炫的效果，开发者都可以经过在 xml 布局文件中，经过简单的属性配置就可以实现。而且，借助 AndroidStudio 的 Preview 插件，能够实时的预览这些效果。 app

如下是目前 SuperTextView 所支持的全部属性。框架

<SuperTextView

//设置圆角。会同时做用于填充和边框(若是边框存在的话)。
//若是要设置为圆形，只须要把该值设置为宽或长的1/2便可。
app:stv_corner="25dp"

//设置左上角圆角
app:stv_left_top_corner="true"

//设置右上角圆角
app:stv_right_top_corner="true"

//设置左下角圆角
app:stv_left_bottom_corner="true"

//设置右下角圆角
app:stv_right_bottom_corner="true"

//设置填充颜色
app:stv_solid="@color/red"

//设置边框颜色
app:stv_stroke_color="@color/black"

//设置边框的宽度。
app:stv_stroke_width="2dp"

//放置一个drawable在背景层上。默认居中显示。
//而且默认大小为SuperTextView的一半。
app:stv_state_drawable="@drawable/emoji"

//设置drawable的显示模式。可选值以下：
// left、top、right、bottom、center(默认值)、
//leftTop、rightTop、leftBottom、rightBottom、
//fill(充满整个SuperTextView，此时会使设置drawable的大小失效)
app:stv_state_drawable_mode="center"

//设置drawable的height
app:stv_state_drawable_height="30dp"

//设置drawable的width
app:stv_state_drawable_width="30dp"

//设置drawble相对于基础位置左边的距离
app:stv_state_drawable_padding_left="10dp"

//设置drawble相对于基础位置上边的距离
app:stv_state_drawable_padding_top="10dp"

// boolean类型。是否显示drawable。
//若是你想要设置的drawable显示出来，必须设置为true。
//当不想让它显示时，再设置为false便可。
app:stv_isShowState="true"

// 是否将state_drawable做为背景图
// 将state_drawable做为背景图可让SuperTextView具有展现图片的能力
// 经过调节corner、stroke等属性，能够给图片设置圆角、边框等
app:stv_drawableAsBackground="true"

//放置一个drawable在背景层上。默认居中显示。
//而且默认大小为SuperTextView的一半。
app:stv_state_drawable2="@drawable/emoji"

//与state_drawable相似
app:stv_state_drawable2_mode="center"

//与state_drawable_height相似
app:stv_state_drawable2_height="30dp"

//与state_drawable_width相似
app:stv_state_drawable2_width="30dp"

//与state_drawable_padding_left相似
app:stv_state_drawable2_padding_left="10dp"

//与state_drawable_padding_top相似
app:stv_state_drawable2_padding_top="10dp"

//与isShowState相似
app:stv_isShow2State="true"

# 修改 drawable 的颜色
app:stv_state_drawable_tint="@color/gray"

# 修改 drawable2 的颜色
app:stv_state_drawable2_tint="@color/red"

# 修改 drawable 的旋转角度
app:stv_state_drawable_rotate="90"

# 修改 drawable2 的旋转角度
app:stv_state_drawable2_rotate="90"

//是否开启文字描边功能。
//注意，启用这个模式以后经过setTextColor()设置的颜色将会被覆盖。
//你须要经过text_fill_color来设置文字的颜色。
app:stv_text_stroke="true"

// 文字的描边颜色。默认为Color.BLACK。
app:stv_text_stroke_color="@color/black"

// 文字描边的宽度。
app:stv_text_stroke_width="1dp"

// 文字填充的颜色。默认为Color.BLACK。
app:stv_text_fill_color="@color/blue"

// boolean类型。是否启用Adjuster功能。
//具体干什么，须要在Java中为SuperTextView实现一个Adjuster。
//当你启用这个功能而没有实现本身的Adjuster时，
//SuperTextView会启用默认的Adjuster。它会按照必定的规则调整文字大小。
app:stv_autoAdjust="true"

// 必须设置为true才能启用渐变功能。这意味着你能够灵活的控制这一功能。
app:stv_shaderEnable="true"

// 设置起始颜色。
app:stv_shaderStartColor="@color/main_blue"

// 设置结尾颜色。
app:stv_shaderEndColor="@color/pink"

// 设置渐变模式。如上图可见，一共支持4中模式：
// topTopBottom, bottomToTop, leftToRight, rightToLeft
app:stv_shaderMode="rightToLeft"

// 设置按压时的背景色
app:stv_pressBgColor="@color/red"

// 设置按压时的文字颜色
app:stv_pressTextColor="@color/white"

// 修改 drawable 的颜色
app:stv_state_drawable_tint="@color/gray"

// 修改 drawable2 的颜色
app:stv_state_drawable2_tint="@color/red"

// 修改 drawable 的旋转角度
app:stv_state_drawable_rotate="90"

// 修改 drawable2 的旋转角度
app:stv_state_drawable2_rotate="90"

// 是否启用渐变色文字
app:stv_textShaderEnable="true"

// 设置文字的起始渐变色
app:stv_textShaderStartColor="@color/red"

// 设置文字的结束渐变色
app:stv_textShaderEndColor="@color/yellow"

// 设置文字的渐变的模式
// leftToRight：左 -> 右
// rightToLeft：右 -> 左
// topToBottom：上 -> 下
// bottomToTop：下 -> 上
app:stv_textShaderMode="leftToRight"


/>

3. SuperTextView Api

点击此处，查看详细的《SuperTextView Api文档》机器学习

4. 开发指南

该部分将会详细讲解目前 SuperTextView 所支持功能，以及如何使用这些能力来创造使人惊叹的应用。

4.1 SuperTextView 中的层级

在 SuperTextView 中，将绘制内容划分为了 4 个层级。了解 SuperTextView 中的层级设计，将会有助于开发者更加合理的组织 UI 逻辑。

1.Background层：View的 Background 背景层。

2.背景层：即经过 app:stv_solid 设置的纯色背景层。在 SuperTextView 中一般将该层视作背景层，而不是View的 Background。就是说，当咱们设置了背景层色后，VIew 自己的 Background 将会被覆盖。

3.Drawable层：SuperTextView 的 Drawable 所在的层级。若是你但愿经过 SuperTextView 来展现图片，就是在该层展现。从 v2.0 版本开始，SuperTextView 的 1 号 Drawable 能够被支持用于做为 SuperTextView 的背景图片，这意味着当开发者这么作时，经过 solid 属性设置的背景颜色将会被覆盖。

4.文字层：即绘制文字的层级。

理解层级的概念，对于后面将要讲述的 Adjuster 颇有帮助。

4.2 设置圆角

圆角化功能是 SuperTextView 最基本的功能，你能够在 xml 布局文件或者 Java 中进行设置。

在xml中：

app:stv_corner="25dp"

在Java中：

stv.setCorner(25);

圆角化的设置仅对 SuperTextView 的【背景层】，或者将 Drawble 用于展现图片（即：配置了app:stv_drawableAsBackground="true"）时有效。

若是你须要一个圆形的效果，只须要将corner值设置为控件最大边长度的一半，即：corner = layout_width / 2。好比：

android:layout_width="80dp"
android:layout_height="80dp"
app:stv_corner="40dp"
app:stv_solid="#008673"

将一张普通的图片圆角化：

app:stv_corner="15dp"
app:stv_state_drawable="@drawable/avatar1"
app:stv_drawableAsBackground="true"

若是你但愿实现圆形头像，或者圆角背景图的效果，那最适合不过了。

4.3 控制每个圆角

默认状况下，对 SuperTextView 设置 corner 会对控件的4个角都有效。固然，也能够单独指定那一个角才是真正须要圆角化的。

在 xml

//设置左上角圆角
app:stv_left_top_corner="true"

//设置右上角圆角
app:stv_right_top_corner="true"

//设置左下角圆角
app:stv_left_bottom_corner="true"

//设置右下角圆角
app:stv_right_bottom_corner="true"

在 Java 中

//设置左上角圆角
stv.setLeftTopCornerEnable( boolean);
// 设置左下角圆角
stv.setLeftBottomCornerEnable( boolean);
//设置右上角圆角
stv.setRightTopCornerEnable(boolean);
//设置右下角圆角
stv.setRightBottomCornerEnable(boolean);

须要注意的时候，一旦指定了任何一个圆角，app:stv_corner 将再也不对4个角都有效了，你须要一个一个的去设置。

4.4 边框

SuperTextView 能够经过简单的配置给控件加上边框，实际开发中十分的便捷。

app:stv_solid="#78C3ED"
app:stv_stroke_color="#5166ED"
app:stv_stroke_width="5dp"

只须要设置 app:stv_stroke_width 大于0即开启了边框功能，若是没有设置 app:stv_stroke_color，会有默认的黑色边框。边框的圆角化也会受到 corner 属性的影响。

边框的效果一样可以在展现图片的时候有效。

4.5 文字描边

使用 SuperTextView 可以很轻松的实现文字描边的功能。

# 开启文字描边功能
app:stv_text_stroke="true"
# 设置文字填充颜色
app:stv_text_fill_color="@color/white"
# 设置文字描边颜色
app:stv_text_stroke_color="#461B50"
# 设置文字描边宽度
app:stv_text_stroke_width="1dp"

⚠️ 注意，开启文字描边的功能后，文字颜色只可以经过 app:stv_text_fill_color 来设置，不要使用 android:textColor ！

若是想要实现空心文字的效果，只须要将 app:stv_text_fill_color 设置为透明色，或者与背景色相同便可。

4.6 状态图

SuperTextView 自带状态图功能。经过 Drawable、Drawable2 两个 Drawable 坑位，可以展现两个状态图。

不一样于系统的原生 TextView 的 Drawable，SuperTextView 的 Drawable 可以精确的控制其位置和大小。

# boolean类型。是否开启状态图1的功能。
app:stv_isShowState="true"

# 设置状态图1的图片
app:stv_state_drawable="@drawable/emoji"

# 设置状态图1的显示模式，决定了状态图1的基础位置
# 可选值以下：
# left、top、right、bottom、center(默认值)、
# leftTop、rightTop、leftBottom、rightBottom、
# fill(充满整个SuperTextView，此时会使设置drawable的大小失效)
app:stv_state_drawable_mode="center"

# 设置状态图1的height
app:stv_state_drawable_height="30dp"

# 设置状态图1的width
app:stv_state_drawable_width="30dp"

# 设置状态图1相对于基础位置的左边的距离
app:stv_state_drawable_padding_left="10dp"

# 设置状态图1相对于基础位置上边的距离
app:stv_state_drawable_padding_top="10dp"


# boolean类型。是否开启状态图2的功能。
app:stv_isShow2State="true"

# 设置状态图2的图片
app:stv_state_drawable2="@drawable/emoji"

# 设置状态图2的显示模式，决定了状态图2的基础位置
# 可选值以下：
# left、top、right、bottom、center(默认值)、
# leftTop、rightTop、leftBottom、rightBottom、
# fill(充满整个SuperTextView，此时会使设置drawable的大小失效)
app:stv_state_drawable2_mode="center"

# 设置状态图2的height
app:stv_state_drawable2_height="30dp"

# 设置状态图2的width
app:stv_state_drawable2_width="30dp"

# 设置状态图2相对于基础位置的左边的距离
app:stv_state_drawable2_padding_left="10dp"

# 设置状态图2相对于基础位置上边的距离
app:stv_state_drawable2_padding_top="10dp"

上图是一些使用一个状态图实现的功能，能够看到，你能够轻松准确的控制状态图的位置和大小。

如今，来看看两个状态图可以干什么。

  • 示例一

    <com.coorchice.library.SuperTextView
android:layout_width="100dp"
android:layout_height="100dp"
...
app:stv_corner="50dp"
app:stv_state_drawable="@drawable/avatar1"
# 将状态图1做为控件背景，以展现图片
app:stv_drawableAsBackground="true"
# state_drawable2的配置由此开始
app:stv_isShowState2="true"
app:stv_state_drawable2="@drawable/recousers"
app:stv_state_drawable2_mode="rightTop"
app:stv_state_drawable2_height="20dp"
app:stv_state_drawable2_width="20dp"
...
/>

  • 示例二

    <com.coorchice.library.SuperTextView
android:layout_width="100dp"
android:layout_height="100dp"
...
# 背景图
android:background="@drawable/avatar7"
# drawable1的配置由此开始
app:stv_isShowState="true"
app:stv_state_drawable="@drawable/triangle"
app:stv_state_drawable_mode="leftTop"
app:stv_state_drawable_width="20dp"
app:stv_state_drawable_height="20dp"
# state_drawable2的配置由此开始
app:stv_isShowState2="true"
app:stv_state_drawable2="@drawable/recousers"
app:stv_state_drawable2_mode="rightTop"
app:stv_state_drawable2_height="20dp"
app:stv_state_drawable2_width="20dp"
...
/>

如你所见，使用 SuperTextView 来处理此类 ui 需求实在是使人愉快，开发者今后能够没必要再为这种效果而费脑的想该如何经过一个个控件叠加嵌套实现了。

4.7 渐变效果

SuperTextView 支持经过配置简单的属性实现渐变色效果。

# 必须设置为true才能启用渐变功能。这意味着你能够灵活的控制这一功能。
app:stv_shaderEnable="true"

# 设置起始颜色
app:stv_shaderStartColor="@color/main_blue"

# 设置结尾颜色。
app:stv_shaderEndColor="@color/pink"

# 设置渐变模式。如上图可见，一共支持4中模式：
# topTopBottom, bottomToTop, leftToRight, rightToLeft
app:stv_shaderMode="rightToLeft"

这些属性也支持在 Java 中设置。

// 开启渐变色功能
stv.setShaderEnable(true);
// 设置起始颜色
stv.setShaderStartColor(Color.BLUE);
// 设置结束颜色
stv.setShaderEndColor(Color.RED);
// 设置模式
stv.setShaderMode(SuperTextView.ShaderMode.LEFT_TO_RIGHT);

渐变模式共有4种：

public static enum ShaderMode {
/**
* 从上到下
*/
TOP_TO_BOTTOM(0),
/**
* 从下到上
*/
BOTTOM_TO_TOP(1),
/**
* 从左到右
*/
LEFT_TO_RIGHT(2),
/**
* 从右到左
*/
RIGHT_TO_LEFT(3);
}

4.8 按压变色

SuperTextView 可以快速的支持按压变色效果，就像下图同样，文字和背景色都支持。

只需配置简单的属性：

# 设置按压时的背景色
app:stv_pressBgColor="@color/red"
# 设置按压时的文字颜色
app:stv_pressTextColor="@color/white"

在Java中：

// 设置按压背景变色
stv.setPressBgColor(Color.RED);
// 取消按压文字变色
stv.setPressTextColor(-99);
  • 若是要取消按压背景变色，只需设置 PressBgColor 为透明色，Color.TRANSPARENT。
  • 若是要取消按压文字变色，只需设置 PressTextColor 为-99。

4.9 展现图片

4.9.1 展现本地图片

前面有提到过，SuperTextView 能够经过状态图1变成一个 ImageView。在设置好状态图1后，只需开启图片展现功能便可。

<com.coorchice.library.SuperTextView
...
app:stv_state_drawable="@drawable/avatar1"
# 开启图片展现功能
app:stv_drawableAsBackground="true"
...
/>

须要注意的是，当将状态图1用于展现图片后，状态图1将再也不具有状态图的功能，直到你关闭了图片展现功能，经过 stv.setDrawableAsBackground(false)。

4.9.2 展现网络图片

stv.setUrlImage(url);

在 SuperTextView 中，经过上面简单的一句便可将 SuperTextView 做为一个能够展现网络图片的ImageView。

调用上面的方法会默认开启 SuperTextView 的图片展现功能，所以，此时状态图1的状态图功能会被停用。你也能够经过如下方法，使得可以从网络中下载状态图1：

stv.setUrlImage(url, false);

第二个参数表示关闭图片展现功能。

上图中，第一个例子是从网络中下载图片用做状态图，第二个例子是用做展现图片。

SuperTextView 为了保持依赖库的纯净和尽量小的体积，并无内置任何的图片加载框架。因此默认状况，将使用内置的一个简易图片引擎去下载图片，确保开发者可以正常使用展现网络图片的功能。

SuperTextView 具有兼容任意第三方图片下载框架的能力，建议开发者根据项目的具体状况，选择一个目前正在使用的图片加载框架，设置到 SuperTextView 中，以用来加载图片。 下面将经过几个的例子展现如何将现有的图片框架安装到 SuperTextView 中。

第一步：实现图片引擎Engine

在 SuperTextView 中，核心的图片加载引擎被抽象成接口 Engine ，开发者须要根据所用的图片框架，实现一个 Engine。

    • Glide图片加载框架
    public class GlideEngine implements Engine {

private Context context;

public GlideEngine(Context context) {
  this.context = context;
}

@Override
public void load(String url, final ImageEngine.Callback callback) {
  Glide.with(context).load(url).into(new SimpleTarget<GlideDrawable>() {
      @Override
      public void onResourceReady(GlideDrawable resource, GlideAnimation<? super              GlideDrawable> glideAnimation) {
          // 主要是经过callback返回Drawable对象给SuperTextView
          callback.onCompleted(resource);
      }
  });
  }
}
    • Picasso图片加载框架
    public class PicassoEngine implements Engine {

private Context context;

public PicassoEngine(Context context) {
this.context = context;
}

@Override
public void load(String url, final ImageEngine.Callback callback) {
Picasso.with(context).load(url).into(new Target() {
@Override
public void onBitmapLoaded(Bitmap bitmap, Picasso.LoadedFrom from) {
// 主要是经过callback返回Drawable对象给SuperTextView
callback.onCompleted(new BitmapDrawable(Resources.getSystem(), bitmap));
}

@Override
public void onBitmapFailed(Drawable errorDrawable) {

}

@Override
public void onPrepareLoad(Drawable placeHolderDrawable) {

}
});
}
}

    第二步：安装图片引擎Engine

    实现好 Engine 后，下一步就是要将其安装到 SuperTextView 中。

    建议能够在 Application的 onCreate() 中进行安装，这样当须要使用 SuperTextView 加载显示网络图片的时候，就可以用到三方图片框架了。

    public class STVApplication extends Application {

@Override
public void onCreate() {
super.onCreate();
// 安装图片引擎
ImageEngine.install(new GlideEngine(this));
// ImageEngine.install(new PicassoEngine(this));
}
}

    一行代码，轻松安装。

    须要注意的是，任什么时候候，后安装的 Engine 实例老是会替换掉先前安装的 Engine 实例，即 SuperTextView 只容许全局存在一个 Engine 实例。

    只需简单两步，便可完成任意三方图片加载框架的适配。

    当你经过 Drawable 坑位展现背景图片时，全部的圆角和边框设置都一样有效。

    4.10 Adjuster

    Adjuster 被设计用来在 SuperTextView 的绘制过程当中插入一些操做。这具备很是重要的意义。好比，实时的改变控件的状态，制做复杂的动画效果或者交互效果。

    public class YourAdjuster extends SuperTextView.Adjuster {

@Override
protected void adjust(SuperTextView v, Canvas canvas) {
    //do your business。
}

@Override
public boolean onTouch(SuperTextView v, MotionEvent event) {
    //you can get the touch event.
    //If want to get a series of touch event, you must return true here.
}

}

    经过重写 Adjuster 的 adjust() 方法，能够获取每次绘制过程当中控件的 Canvas 对象，这意味着能够在绘制过程当中从外部插入一些新的元素。固然，单单经过 SuperTextView 的实例修改其状态也是能够的。

    经过重写 Adjuster 的 onTouch() 方法，能够获取每一次控件的触摸事件，若是在该方法中返回true，代表该 Adjuster 须要获取后续的触摸事件，同时也会使得 SuperTextView 在整个控件树中回去拦截触摸事件。配合 adjust() 能够实现一些复杂的交互效果。值得注意的是，若是在 SuperTextView 以前，已经有控件拦截的触摸事件，那么其中的 Adjuster 将没法获取到触摸事件。

    当装载 Adjuster 到 SuperTextView 以后，须要调用如下方法来开启 Adjuster 的功能：

    stv.setAutoAdjust(true);

    固然，中止 Adjuster 只须要设置为false便可。

    4.10.1 如何装载Adjuster到SuperTextView

    stv.addAdjuster(mAdjuster);

    经过上面方法能够将一个 Adjuster 添加到 SuperTextView 中，最多支持添加3个 Adjuster 。超过3个的部分，将会始终覆盖最后一个 Adjuster。

    若是你想要移除一个 Adjuster，经过下面方法来实现。

    // 移除指定位置的 Adjuster
stv.removeAdjuster(index)
// 移除指定的 Adjuster
stv.removeAdjuster(adjuster)

    4.10.2 设置Adjuster的层级

    前面有描述过 SuperTextView 的层级划分，Adjuster 能够经过配置，将其插入到指定的层级。

    mAdjuster.setOpportunity(opportunity);

    层级定义了以下几个枚举变量：

    public enum Opportunity {
// 背景层和Drawable层之间
BEFORE_DRAWABLE,
// Drawable层和文字层之间
BEFORE_TEXT,
// 最上层
AT_LAST
}

    分别对应以下几种场景，其中Emoji图是StateDrawable状态图，蓝色圆形就是一个 Adjuster ：

    4.10.3 开启动画

    在 SuperTextView 中，能够经过如下方法触发 SuperTextView 的定时绘制：

    stv.startAnim();

    启动动画后， SuperTextView 将会以默认 60fps 的帧率进行刷新。配合 Adjuster 能够十分简单的实现动画效果。

    当 SuperTextView 离开屏幕后，将会自动中止正在播放的动画，当在次进入屏幕时，又会自动启动。因此开发者能够无需担忧动画在后台消耗资源。

    固然，开发者也能够随时中止动画，经过调用如下方法：

    stv.stopAnim();

    经过如下方法，开发者能够随时修改 SuperTextView 的刷新频率：

    // 每秒30帧
stv.setFrameRate(30);

    4.10.4 得到 Adjuster 的添加和移除事件

    Adjuster 中包含了两个函数：

    • onAttach()：当 Adjuster 被设置到一个 SuperTextView 中时会被调用。
    • onDetach()：当 Adjuster 被从一个 SuperTextView 中移除时会被调用。

    经过在 Adjuster 中重写这两个函数，开发者能够在正确的时机进行状态注册、初始化，或者取消注册、释放资源等操做。

    public class MyAdjuster extends SuperTextView.Adjuster{

    @Override
    protected void adjust(SuperTextView superTextView, Canvas canvas) {

    }

    @Override
    public void onAttach(SuperTextView stv) {
      // 当 Adjuster 被加入一个 SuperTextView 时会被调用
    }

    @Override
    public void onDetach(SuperTextView stv) {
      // 当 Adjuster 被从 SuperTextView 移除时会被调用
    }
}

    4.11 修改 StateDrawable 颜色

    开发者能够轻松的改变一个图标的颜色，而不用再增长一个仅仅是颜色不一样的图标到项目中。这项技术将为你的 Android 应用程序带来一次瘦身的机遇。

    # 修改 drawable 的颜色
app:stv_state_drawable_tint="@color/gray"

# 修改 drawable2 的颜色
app:stv_state_drawable2_tint="@color/red"

    只须要如此一行简单的代码，就能瞬间赋予一张图片变幻无穷的能力。想要任何色彩，固然是你说了算。而这一切的发生，无需再引进另一张图片。

    在 Java 代码中，有与之对应 set/get 函数，让开发者能够在任什么时候候都能施展魔法，改变一张图片的色彩。

    4.12 修改 StateDrawable 旋转角度

    SuperTextView 被赋予了改变 StateDrawable 形态的能力。一样的一张图，开发者能够组合出无数种可能。

    只需简单的几行代码，你即可以为所欲为的变换任何一张图片。

    # 修改 drawable 的旋转角度
app:stv_state_drawable_rotate="90"

# 修改 drawable2 的旋转角度
app:stv_state_drawable2_rotate="90"

    无需复杂的代码，SuperTextView 一如既往的简洁、优雅。

    一样，在 Java 代码中，也提供了对应的 `set/get· 函数。

    这项能力，能够有效的帮助开发者将 Android 应用的体积向着极致的方向压缩。

    经过和 Drawable 着色功能的联合使用，开发者能够将应用中本来必要存在的 .png 通通移除掉。好比，箭头等。开发者只须要一张箭头图片，就能够经过修改其颜色、旋转角度、大小等属性，组合出任何需求的箭头 icon。

    4.13 设置文字渐变

    这就是渐变文字！

    SuperTextView 所提供的多是目前为止实现渐变文字最简洁、优雅的解决方案。只须要简单的配置，就能实现酷炫的渐变文字效果。

    # 是否启用渐变色文字
app:stv_textShaderEnable="true"

# 设置文字的起始渐变色
app:stv_textShaderStartColor="@color/red"

# 设置文字的结束渐变色
app:stv_textShaderEndColor="@color/yellow"

# 设置文字的渐变的模式
# leftToRight：左 -> 右
# rightToLeft：右 -> 左
# topToBottom：上 -> 下
# bottomToTop：下 -> 上
app:stv_textShaderMode="leftToRight"

    这些属性也在 Java 中开放了 set/get 接口，便于开发者随时动态的修改它们。

    • 若是你喜欢 SuperTextView，但愿能到 Github 点个 star 🌟 哦！
    • 此外，CoorChice 会不按期的在博客平台分享干货，内容包括 Android 相关技术、机器学习、算法、新的技术，以及一些对我的发展提高的感悟和思考。快进入 CoorChice的【我的主页】 关注一波吧。

    文档结束。更多例子能够Clone项目到本地学习，祝你使用愉快！

    相关文章
    相关标签/搜索
    每日一句
      每一个你不满意的现在，都有一个你没有努力的曾经。
    本站公众号
       欢迎关注本站公众号,获取更多信息
    联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程