RWidgetHelper

Introduction: 继承基础控件 1.代替 selector 直接设置 xml 属性实现圆形,圆角,某一方向圆角 2.各个 state 状态背景/边框/文字变色
More: Author   ReportBugs   
Tags:

欢迎使用 RWidgetHelper

宗旨:专治原生控件各种不服

目标:Android UI 快速开发

说明

需求:Android UI 开发常用:圆角,边框,Gradient 背景渐变,控件 State 各个状态 UI 样式

普通解决方案缺点:代码冗余,复用性差,自由度低

RWidgetHelper 优点:优化代码,简化使用,快速开发

简介

通过继承原生控件,设置自定义属性,解决常用 Selector,Gradient,Shape 等功能

原生控件都可实现 **基础功能** ,针对具体控件还有 **个性功能**

基础功能

功能 属性值 可用 State 状态 特性
圆角 颜色 默认/按下/不可用 四周圆角/单个方向圆角
边框宽度 数值 默认/按下/不可用 实线/虚线边框
边框颜色 颜色 默认/按下/不可用 实线/虚线边框
背景 颜色/颜色数组/drawable 默认/按下/不可用 纯色/渐变/Drawable

属性介绍

属性 说明
corner_radius 圆角 四周 >=正方形宽度/2 实现圆形
corner_radius_top_left 圆角 左上
corner_radius_top_right 圆角 右上
corner_radius_bottom_left 圆角 左下
corner_radius_bottom_right 圆角 右下
border_dash_width 虚线边框 宽度
border_dash_gap 虚线边框 间隔
border_width_normal 边框宽度 默认
border_width_pressed 边框宽度 按下
border_width_unable 边框宽度 不可点击
border_width_checked 边框宽度 选中
border_color_normal 边框颜色 默认
border_color_pressed 边框颜色 按下
border_color_unable 边框颜色 不可点击
border_color_checked 边框颜色 选中
background_normal 背景 默认
background_pressed 背景 按下
background_unable 背景 不可点击
background_checked 背景 选中
gradient_orientation 渐变的方向 参考 GradientDrawable.Orientation:TOP_BOTTOM,TR_BL...
gradient_type 渐变的样式 linear 线性,radial 径向,sweep 扫描式 默认:linear
gradient_radius 渐变半径 默认:(宽或高最小值)/ 2
gradient_centerX 渐变中心点 X 坐标(0.0-1.0) 0.5 表示中间 默认:0.5
gradient_centerY 渐变中心点 Y 坐标(0.0-1.0) 0.5 表示中间 默认:0.5
 1.background_xxx         纯色   渐变   drawable
 纯色:   颜色值               app:background_normal="#74EBD5"
 渐变:   颜色数组 >=2 个       app:background_normal="@array/@colorArray"
 drawable: 资源图片          app:background_normal="@mipmap/@drawable"

 2.自定义属性对原生属性无效
   例如: `app:corner_radius="10dp"` 搭配 `app:background_normal="#74EBD5"` 而不是`background="#74EBD5"`

示例 xml

        <com.ruffian.library.widget.RView
            xmlns:app="http://schemas.android.com/apk/res-auto"
            android:layout_width="100dp"
            android:layout_height="100dp"

            //背景各个状态,支持:纯颜色   渐变   drawable
            app:background_normal="#3F51B5"
            app:background_pressed="@array/color_array"
            app:background_unable="@mipmap/icon_unable"
            app:background_checked="@mipmap/icon_checked"

            //边框颜色
            app:border_color_normal="#FF4081"
            app:border_color_pressed="#3F51B5"
            app:border_color_unable="#c3c3c3"
            app:border_color_checked="#c3c3c3"

            //边框宽度
            app:border_width_normal="3dp"
            app:border_width_pressed="3dp"
            app:border_width_unable="3dp"
            app:border_width_checked="3dp"

            //虚线边框 1.虚线边框宽度 2.虚线间隔
            app:border_dash_width="10dp"
            app:border_dash_gap="4dp"

            //圆角度数 超过 1/2 为圆形 1.四周统一值 2.四个方向各个值
            app:corner_radius="10dp"
            app:corner_radius_top_left="10dp"
            app:corner_radius_bottom_left="15dp"
            app:corner_radius_bottom_right="20dp"
            app:corner_radius_top_right="25dp"

            //渐变设置  background_xx 设置为颜色数组时有效(@array/array_color)
            app:gradient_radius="100dp"
            app:gradient_centerX="0.5"
            app:gradient_centerY="0.5"
            app:gradient_type="linear"
            app:gradient_orientation="LEFT_RIGHT"
            />

示例 java

            RView view = (RView) findViewById(R.id.view);
            //获取 Helper
            RBaseHelper helper = view.getHelper();
            helper.setBackgroundColorNormal(getResources().getColor(R.color.blue))
                    .setBorderColorNormal(getResources().getColor(R.color.red))
                    .setBorderWidthNormal(12)
                    .setCornerRadius(25);

效果图

个性功能

RTextView

  • [x] drawableLeft/Right/Top/Bottom icon 大小
  • [x] drawableLeft/Right/Top/Bottom icon 状态
  • [x] drawableLeft 和 text 一起居中
  • [x] 文字根据状态变色 默认/按下/不可点击
  • [x] 设置字体样式
属性 说明
text_color_normal 文字颜色 默认
text_color_pressed 文字颜色 按下
text_color_unable 文字颜色 不可点击
icon_src_normal drawable icon 默认
icon_src_pressed drawable icon 按下
icon_src_unable drawable icon 不可点击
icon_height drawable icon 高
icon_width drawable icon 宽
icon_direction drawable icon 位置{left,top,right,bottom}
icon_with_text 图片和文本一起居中 true/false
text_typeface 字体样式

REditText

REditText 使用方法跟 RTextView 一致

RLinearLayout / RRelativeLayout / RFrameLayout / RView

查看基础功能

RRadioButton / RCheckBox

查看基础功能

常使用选择属性 checked

属性 说明
border_width_checked 边框宽度 选中
border_color_checked 边框颜色 选中
background_checked 背景 选中
text_color_checked 文字颜色 选中

RImageView

RImageView 不再提供背景各个 state 背景颜色

1.圆形图片

2.圆角图片

3.指定某一方向圆角图片

4.边框

5.各个 state 状态的图片 默认/按下/不可点击

属性 说明
corner_radius 圆角 四周
corner_radius_top_left 圆角 左上
corner_radius_top_right 圆角 右上
corner_radius_bottom_left 圆角 左下
corner_radius_bottom_right 圆角 右下
border_width 边框宽度
border_color 边框颜色
icon_src_normal icon 默认
icon_src_pressed icon 按下
icon_src_unable icon 不可点击
is_circle 是否圆形图片

使用

Gradle (版本号根据更新历史使用最新版)

compile 'com.ruffian.library:RWidgetHelper:1.0.8'

版本历史

v1.0.8 2019.01.30 Fix bug issues#25 and issues#26

v1.0.7 2018.12.20 优化代码,Fix bug

v1.0.6 2018.12.18 版本兼容,优化代码,RFrameLayout

v1.0.5 2018.12.18 1.DrawableWithText 图片和文本一起居中 2.Fix bug

v1.0.4 2018.11.15 1.背景支持图片类型 2.添加 selector->checked状态 添加 RCheckBoxRRadioButton

v1.0.3 2018.11.09 Fix Bug issues#17

v1.0.2 2018.10.09 添加 Gradient 渐变功能

v1.0.1 2018.08.20 Fix bug setEnabled issues #7

v1.0.0 2018.04.26 发布第一版本

License

MIT License

Copyright (c) 2018 Ruffian-痞子
Support Me
Apps
About Me
Google+: Trinea trinea
GitHub: Trinea