SuperTextView 万能android布局工具类

1、功能描述

你还在为类似设置页面的样式(图+文字+图)每次写一大堆布局文件而烦恼吗？快来看看SuperTextView吧，这里有你想要实现的任何样式，而你要做的仅仅是引入几行代码。SuperTextView是一个功能强大的布局View，可以满足日常大部分布局样式，开发者可以自行组合属性配置出属于自己风格的样式!可能描述起来没有概念，还是直接看效果图吧！

2、 效果图

image

3、如何使用

Android Studio导入方法，添加Gradle依赖

 先在项目根目录的 build.gradle 的 repositories 添加:
 allprojects {
     repositories {
        ...
        maven { url "https://jitpack.io" }
    }
}

然后在dependencies添加:

 dependencies {
    ...
    compile 'com.github.lygttpod:SuperTextView:2.0.1'
    }

3.2、项目中如何使用
3.2.1、布局中如何使用（示例中只列出部分属性，开发者可根据具体需求使用其他属性）

<com.allen.supertextviewlibrary.SuperTextView
            android:id="@+id/super_tv"
            android:layout_width="match_parent"
            android:layout_height="80dp"
            stv:sLeftBottomTextColor2="@color/colorAccent"
            stv:sLeftBottomTextString="招商银行（8888）"
            stv:sLeftBottomTextString2="限额说明>>"
            stv:sLeftIconRes="@drawable/bank_zhao_shang"
            stv:sLeftTopTextString="银行卡支付"
            stv:sRightCheckBoxRes="@drawable/circular_check_bg"
            stv:sRightCheckBoxShow="true"
            stv:sLineShow="bottom"
             />
    注意：
            1、上下的线可以通过   sLineShow 设置  有四种显示方式 none，top，bottom，both
            2、通过设置 sUseRipple=true 开启水波效果

3.2.2、代码中如何使用

/**
 * 可以通过链式设置大部分常用的属性值
 */
    superTextView.setLeftIcon(drawable)
            .setLeftString("")
            .setLeftTVColor(0)
            .setLeftTopString("")
            .setLeftTopTVColor(0)
            .setLeftBottomString("")
            .setLeftBottomTVColor(0)
            .setLeftBottomString2("")
            .setLeftBottomTVColor2(0)
            .setRightString("")
            .setRightTVColor(0)
            .setCbChecked(true)
            .setCbBackground(drawable)
            .setRightIcon(drawable)
            .setRightString("")
            .setRightTVColor(0)
            .setLeftString("")

点击事件（可根据需求选择实现单个或者多个点击事件，需要配合xml添加是否允许点击的属性，详情见属性参数的意义）

   superTextView.setOnSuperTextViewClickListener(new SuperTextView.OnSuperTextViewClickListener() {
                @Override
                public void onSuperTextViewClick() {
                    super.onSuperTextViewClick();
                    //do something
                }

                @Override
                public void onLeftTopClick() {
                    super.onLeftTopClick();
                    //do something
                }

                @Override
                public void onLeftBottomClick() {
                    super.onLeftBottomClick();
                    //do something
                }

                @Override
                public void onLeftBottomClick2() {
                    super.onLeftBottomClick2();
                    //do something
                }
            });

            注意：点击事件需要配合属性值使用
            sLeftTopViewIsClickable= true
            sLeftBottomViewIsClickable= true
            sLeftBottomView2IsClickable= true

使用第三方库(Picasso或者Glide)加载网络图片

     Picasso.with(this)
     .load(url)
     .placeholder(R.drawable.head_default)
     .into((ImageView) superTextView.getView(SuperTextView.leftImageViewId));

3.2.3、属性说明(以下属性全部可以通过xml文件配置和代码进行设置)

360截图20190427145652016.jpg

4、实现原理
4.1、需求分析

黑格尔曾说过：存在即合理。SuperTextView的出现应该就是某种需求下的产物。

在开发项目的过程中你会发现有很多页面的布局都是类似的，就比如说常见的设置页面，基本上都是图标+文字+图标的格式，而且出现的频率都很高，如果不做处理势必会写很多无用的代码降低开发效率，正因为如此我们为什么不把这一类view统一封装起来呐（其实就是程序猿的懒惰，哈哈），有了这个想法就开始调研市场上主流应用的显示样式，经过调研总结出一套显示方案涵盖了市面上90%以上的布局样式，目的是在以后的使用中快速高效的开发。

首先SuperTextView 是继承自 RelativeLayout实现，里边所有布局的添加都是通过Java代码实现的，事先定义好需要的参数名及类型

下边只列出部分参数

private int backgroundColor;//背景颜色
private int leftTVColor;//左边文字颜色
private int leftTopTVColor;//左上文字颜色
private int leftBottomTVColor;//左下文字颜色
private int leftBottomTVColor2;//左下第二个文字颜色
private int rightTVColor;//右边文字颜色
private int centerTVColor;//中间文字颜色

private boolean isSingLines = true;//是否单行显示   默认单行
private int maxLines = 1;//最多几行    默认显示一行
private int maxEms = 10;//最多几个字    默认显示10个汉子

private static final int NONE = 0;
private static final int TOP = 1;
private static final int BOTTOM = 2;
private static final int BOTH = 3;
private static final int DEFAULT = BOTTOM;

然后就是在构造方法里边去实现各个方法

public SuperTextView(Context context, AttributeSet attrs) {
    super(context, attrs);
    mContext = context;
    getAttr(attrs);
    initLayout();
}

我们知道系统控件可以从XML中拿到定义好的属性值，那么我们其实也是可以的，首先在attr中定义好相关属性名及字段类型然后通过AttributeSet去拿到相关属性值在进行设置

private void getAttr(AttributeSet attrs) {
    //获取我们在attr中定义的SuperTextView相关属性
    TypedArray typedArray = mContext.obtainStyledAttributes(attrs, R.styleable.SuperTextView);

    //下边展示的各个类型参数的获取方法，drawable、string、boolean、int、px
    leftIconRes = typedArray.getDrawable(R.styleable.SuperTextView_sLeftIconRes);
    leftTextString = typedArray.getString(R.styleable.SuperTextView_sLeftTextString);
    showCheckBox = typedArray.getBoolean(R.styleable.SuperTextView_sRightCheckBoxShow, false);
    lineType = typedArray.getInt(R.styleable.SuperTextView_sLineShow, DEFAULT);
    topLineMargin = typedArray.getDimensionPixelSize(R.styleable.SuperTextView_sTopLineMargin, defaultLinePadding);

    //获取完之后记得recycle()释放掉资源
    typedArray.recycle();
  }

接下来就拿一个view为例进行说明如何动态添加view及设置相关属性

/**
 * 初始化左边文字
 */
private void initLeftText() {
    leftTV = new TextView(mContext);
    leftTextParams = new LayoutParams(LayoutParams.WRAP_CONTENT, LayoutParams.WRAP_CONTENT);
    leftTextParams.addRule(RelativeLayout.CENTER_VERTICAL, TRUE);
    leftTextParams.addRule(RelativeLayout.RIGHT_OF, R.id.sLeftIconId);
    setMargin(leftTextParams, leftTVMarginLeft, 0, dip2px(mContext, 10), 0);
    leftTV.setId(R.id.sLeftTextId);
    leftTV.setLayoutParams(leftTextParams);
    leftTV.setText(leftTextString);
    //设置Params的方法抽离出来便于以后统一调用
    setTextViewParams(leftTV, isSingLines, maxLines, maxEms);
    //设置字体颜色的方法抽离出来便于以后统一调用
    setTextColor(leftTV, leftTVColor);
    //设置字体大小的方法抽离出来便于以后统一调用
    setTextSize(leftTV, leftTVSize);
    //调用addView方法把我们动态创建的view添加到布局中
    addView(leftTV);
}

初始化完view之后就是要暴露一些方法供外部人员使用了（部分代码示例）
在这里我们返回SuperTextView对象是为了实现链式调用

  /**
 * 获取checkbox状态
 *
 * @return 返回选择框当前选中状态
 */

 public boolean getCbisChecked() {
    boolean isChecked = false;
    if (rightCheckBox != null) {
        isChecked = rightCheckBox.isChecked();
    }
    return isChecked;
}

/**
 * 设置左边文字的颜色
 *
 * @param textColor 文字颜色值
 * @return 返回对象
 */
public SuperTextView setLeftTVColor(int textColor) {
    leftTVColor = textColor;
    if (leftTV == null) {
        initLeftText();
    } else {
        leftTV.setTextColor(textColor);
    }
    return this;
}

最后就是一些回调方法的使用，以点击事件为例
/**
* 点击事件接口
* 这里没有使用interface是因为有些方法我们不是一定要实现的
* 用到哪个方法再去重写方法就可以了
*/

   public static class OnSuperTextViewClickListener {
    public void onSuperTextViewClick() {
    }

    public void onLeftTopClick() {
    }

    public void onLeftBottomClick() {
    }

    public void onLeftBottomClick2() {
    }

}

相关的set方法拿到OnSuperTextViewClickListener对象

public SuperTextView setOnSuperTextViewClickListener(OnSuperTextViewClickListener listener) {
    onSuperTextViewClickListener = listener;
    return this;
}

初始化view的时候在各个view的点击事件中添加相应的回调方法就行了

 if (mLeftTopViewIsClickable) {
        leftTopTV.setOnClickListener(new OnClickListener() {
            @Override
            public void onClick(View view) {
                if (onSuperTextViewClickListener != null) {
                    onSuperTextViewClickListener.onLeftTopClick();
                }
            }
        });
    }

以上只是源码中的部分方法拿出来供分析使用，看了之后是不是感觉实现其实很简单，赶紧自己着手实现一个吧！