这真的多是最好用的按钮了

背景

按钮应该是咱们的App里面最广泛的组件之一了，特别经常使用。
一般咱们写一个按钮的套路很简单也很固定。大概分为如下几个步骤：

1. 在xml布局里面按照设计稿的尺寸位置写一个Textview
2. 按照设计稿规定的颜色和圆角在drawable目录下建立一个shape文件
3. 将这个shape文件做为Textview的背景

这样一个很标准的按钮就诞生了，而后就能够继续愉快的开发了。这原本没有什么问题，也比让UI妹纸切图高级了不少，可是随着开发的进行你会发现，UI妹纸的想法不少，不一样的界面有各类不一样圆角和不一样背景颜色的按钮，这个时候你须要把上面的三个步骤再进行N次。

最后你会发现你的drawable目录下有各类各样的按钮背景资源，难以管理。特别是假若有的按钮要求有点击效果时须要使用selector，这个时候可能就会产生三个文件用来知足需求，因此总得来讲很繁琐。

想法

基于以上缘由以及按钮使用的广泛程度，感受颇有必要写一个使用简单且能知足平常各类需求的按钮。咱们先梳理下按钮须要达到的效果：

1. 使用简单(便可以利用属性对按钮进行各类设置)
2. 能够支持设置按钮文字、按钮文字颜色、按钮文字大小
3. 能够支持统一设置圆角大小，也能够单独设置按钮每一个圆角的大小
4. 能够支持设置按钮背景颜色
5. 能够支持selector
6. 能够支持圆形按钮
7. 能够支持渐变色按钮，能够支持各个方向设置渐变色
8. 能够支持设置带边框的按钮，能够设置边框的颜色和宽度
9. 能够支持设置按钮是否能够点击
10. 能够设置带图标的按钮，支持自定义按钮大小，和自动缩放，图标支持设置在文字上下左右四个方向，支持自定义文字距离图标的距离

引入

implementation 'top.androidman:superbutton:1.0.1'
复制代码

Github传送门

实现效果

基本使用	单独设置每一个圆角	Selector	圆形按钮
渐变背景的按钮	有边框按钮	按钮不可点击	带图标按钮

代码解释

0x1 基本使用

效果

代码

<top.androidman.SuperButton
        android:layout_width="match_parent"
        android:layout_height="60dp"
        android:layout_margin="20dp"
        app:color_normal="@color/color_accent"
        app:corner="10dp"
        app:text="@string/poetry_1"
        app:textColor="@color/color_white"
        app:textSize="22sp" />
复制代码

属性解释

• 按钮文字
  app:text="床前明月光"
• 按钮文字颜色
  app:textColor="@color/color_white"
• 按钮文字大小
  app:textSize="22sp"
• 按钮背景颜色
  app:color_normal="@color/color_accent"

0x2 单独设置每一个圆角

效果

代码

<top.androidman.SuperButton
    android:layout_width="match_parent"
    android:layout_height="60dp"
    android:layout_margin="20dp"
    app:color_normal="@color/color_6596ff"
    app:corner="40dp"
    app:corner_left_bottom="0dp"
    app:text="单独设置左下角为0dp"
    app:textColor="@color/color_white"
    app:textSize="22sp" />
复制代码

属性解释

• 单独设置左下角角度
  app:corner_left_bottom="0dp"
• 单独设置左上角角度
  app:corner_left_top="5dp"
• 单独设置右上角角度
  app:corner_right_top="22dp"
• 单独设置右下角角度
  app:corner_right_bottom="0dp"
• 按钮四个角的圆角角度
  app:corner="10dp"

注意：单独设置角度会覆盖corner属性

0x3 Selector

效果

代码

<top.androidman.SuperButton
    android:layout_width="match_parent"
    android:layout_height="60dp"
    android:layout_margin="20dp"
    android:onClick="test"
    app:color_normal="@color/color_accent"
    app:color_pressed="@color/color_ffB419"
    app:corner="10dp"
    app:text="点击会变色哦"
    app:textColor="@color/color_white"
    app:textSize="22sp" />
复制代码

属性解释

• 当按钮点下时会显示设置的颜色效果
  app:color_normal="@color/color_accent"

0x4 圆形按钮

效果

代码

<top.androidman.SuperButton
    android:layout_width="160dp"
    android:layout_height="160dp"
    android:layout_margin="20dp"
    android:onClick="test"
    app:color_normal="@color/color_accent"
    app:drawable_middle="@mipmap/icon_like"
    app:drawable_middle_height="50dp"
    app:drawable_middle_width="50dp"
    app:shape="CIRCLE" />
复制代码

属性解释

• 按钮上只有图标没有文字
  app:drawable_middle="@mipmap/icon_like"
• 按钮上图标高度
  app:drawable_middle_height="50dp"
• 按钮上图标宽度
  app:drawable_middle_width="50dp"

注意：当设置此属性时，文字的相关属性将会失效

0x5 渐变背景的按钮

效果

代码

<top.androidman.superbutton.SuperButton
    android:layout_width="match_parent"
    android:layout_height="60dp"
    android:layout_margin="20dp"
    app:color_direction="RIGHT_LEFT"
    app:color_end="@color/color_14c7de"
    app:color_start="@color/color_red"
    app:corner="20dp"
    app:text="从右到左渐变"
    app:textColor="@color/color_white"
    app:textSize="22sp" />
复制代码

属性解释

• 开始颜色
  app:color_start="@color/color_14c7de"
• 结束颜色
  app:color_end="@color/color_red"
• 颜色渐变方向
  app:color_direction="RIGHT_LEFT"
  • TOP_BOTTOM
    从上到下
  • BOTTOM_TOP
    从下到上
  • LEFT_RIGHT
    从左到右
  • RIGHT_LEFT
    从右到左
  • TR_BL
    从右上到左下
  • BL_TR
    从左下到右上
  • BR_TL
    从右下到左上
  • TL_BR
    从左上到右下

注意：当设置颜色渐变时，color_normal，color_pressed设置将失效

0x6 有边框按钮

效果

代码

<top.androidman.SuperButton
    android:layout_width="match_parent"
    android:layout_height="60dp"
    android:layout_margin="20dp"
    app:border_color="@color/color_red"
    app:border_width="2dp"
    app:color_normal="@color/color_accent"
    app:corner="10dp"
    app:text="@string/poetry_1"
    app:textColor="@color/color_white"
    app:textSize="22sp" />
复制代码

属性解释

• 边框宽度
  app:border_width="2dp"
• 边框颜色
  app:border_color="@color/color_red"

0x7 按钮不可点击

效果

代码

<top.androidman.SuperButton
    android:layout_width="match_parent"
    android:layout_height="60dp"
    android:layout_margin="20dp"
    android:onClick="test"
    app:button_click_able="false"
    app:color_normal="@color/color_accent"
    app:corner="10dp"
    app:singleLine="false"
    app:text="app:button_click_able=false\n也能够代码设置"
    app:textColor="@color/color_white"
    app:textSize="22sp" />
复制代码

属性解释

• 按钮是否能够点击，默认为true能够点击
  app:button_click_able="false"
• 按钮文字是否单行，默认为true单行
  app:singleLine="false"

注意：按钮提供有方法对点击事件进行控制，请参考高级使用里面相关方法

0x8 带图标按钮

效果

代码

<top.androidman.superbutton.SuperButton
    android:layout_width="match_parent"
    android:layout_height="60dp"
    android:layout_margin="20dp"
    app:color_normal="@color/color_red"
    app:corner="20dp"
    app:drawable_padding="20dp"
    app:drawable_right="@mipmap/icon_like"
    app:text="图标在右边"
    app:textColor="@color/color_white"
    app:textSize="22sp" />
复制代码

属性解释

• 图标在文字右边
  app:drawable_right="@mipmap/icon_like"
• 图标在文字左边
  app:drawable_left="@mipmap/icon_like"
• 图标在文字上边
  app:drawable_top="@mipmap/icon_like"
• 图标在文字下边
  app:drawable_bottom="@mipmap/icon_like"
• 图标距文字距离
  app:drawable_padding="20dp"
• 根据文字大小缩放图标，默认为true,当为false时显示原图标大小
  app:drawable_auto="true"

按钮支持的全部属性

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <declare-styleable name="SuperButton">
        <!--默认配置-->
        <attr name="text" format="reference|string" />
        <!--按钮文字颜色-->
        <attr name="textColor" format="reference|color" />
        <!--按钮文字大小-->
        <attr name="textSize" format="dimension" />
        <!--文字是否单行，默认单行-->
        <attr name="singleLine" format="boolean" />

        <!--默认背景颜色-->
        <attr name="color_normal" format="reference|color" />
        <!--按压时的背景颜色-->
        <attr name="color_pressed" format="reference|color" />

        <!--图片在文字左边-->
        <attr name="drawable_left" format="reference|color" />
        <!--图片在文字右边-->
        <attr name="drawable_right" format="reference|color" />
        <!--图片在文字上边-->
        <attr name="drawable_top" format="reference|color" />
        <!--图片在文字下边-->
        <attr name="drawable_bottom" format="reference|color" />
        <!--图片距文字的距离-->
        <attr name="drawable_padding" format="dimension" />
        <!--图标根据文字大小自动缩放图标-->
        <attr name="drawable_auto" format="boolean" />

        <!--只有图片的状况,此时会忽略文字，即使设置-->
        <attr name="drawable_middle" format="reference|color" />
        <!--图片在中间时宽-->
        <attr name="drawable_middle_width" format="dimension" />
        <!--图片在中间时高-->
        <attr name="drawable_middle_height" format="dimension" />

        <!--形状-->
        <attr name="shape" format="enum">
            <!--圆形-->
            <enum name="CIRCLE" value="1" />
            <!--矩形-->
            <enum name="RECT" value="2" />
        </attr>

        <!--按钮背景是渐变色时设置-->
        <!--开始颜色-->
        <attr name="color_start" format="color" />
        <!--结束颜色-->
        <attr name="color_end" format="color" />
        <!--颜色方向-->
        <attr name="color_direction" format="enum">
            <!--从上到下-->
            <enum name="TOP_BOTTOM" value="0x1" />
            <!--从右上到左下-->
            <enum name="TR_BL" value="0x2" />
            <!--从右到左-->
            <enum name="RIGHT_LEFT" value="0x3" />
            <!--从右下到左上-->
            <enum name="BR_TL" value="0x4" />
            <!--从下到上-->
            <enum name="BOTTOM_TOP" value="0x5" />
            <!--从左下到右上-->
            <enum name="BL_TR" value="0x6" />
            <!--从左到右-->
            <enum name="LEFT_RIGHT" value="0x7" />
            <!--从左上到右下-->
            <enum name="TL_BR" value="0x8" />
        </attr>

        <!--按钮圆角，若是单独设置会覆盖此设置-->
        <attr name="corner" format="dimension" />
        <!--左上角圆角半径-->
        <attr name="corner_left_top" format="dimension" />
        <!--左下角圆角半径-->
        <attr name="corner_left_bottom" format="dimension" />
        <!--右上角圆角半径-->
        <attr name="corner_right_top" format="dimension" />
        <!--右下角圆角半径-->
        <attr name="corner_right_bottom" format="dimension" />

        <!--边框宽度-->
        <attr name="border_width" format="dimension" />
        <!--边框颜色-->
        <attr name="border_color" format="color" />
        <!--按钮是否能够点击-->
        <attr name="button_click_able" format="boolean" />

    </declare-styleable>
</resources>

复制代码

高级应用

1.想修改按钮相关调用以下方法：

/**
     * 修改文字
     */
    superButton.setText(CharSequence text);

    /**
     * 修改文字颜色
     */
    superButton.setTextColor(@ColorInt int textColor);

    /**
     * 修改按钮背景颜色
     */
    superButton.setColorNormal(@ColorInt int colorNormal);

复制代码

当某些状态下须要代码控制，将按钮置灰而后不可点击，能够直接调用以下方法：

/**
     * 调用此方法后按钮颜色被改变，按钮没法点击
     */
    superButton.setUnableColor(@ColorInt int color);
复制代码

若是只是想设置按钮不可点击，不须要改变按钮颜色，能够使用以下方法

/**
     * 设置按钮是否能够点击
     */
    superButton.setButtonClickable(boolean buttonClickable);
复制代码

将来展望

将来准备把按钮阴影加入进来，这样这个按钮的使用就更加方便啦！ 因此若是你们有好的想法和需求，欢迎你们提issue。