RWidgetHelper

欢迎使用 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

drawableLeft/Right/Top/Bottom icon大小
drawableLeft/Right/Top/Bottom icon状态
drawableLeft 和 text 一起居中
文字根据状态变色默认/按下/不可点击
设置字体样式

属性	说明
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

查看基础功能

查看 RTextView 所有功能

常使用选择属性 checked

支持 RTextView 的基础功能自定义各个状态 drawableLeft 以及 icon与文本居中等

属性	说明
border_width_checked	边框宽度选中
border_color_checked	边框颜色选中
background_checked	背景选中
text_color_checked	文字颜色选中
icon_src_normal	图标未选中
icon_src_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.1.0'

版本历史

v1.1.0 2019.06.27 RCheckBox 和 RRadioButton 支持选中图片，支持继承 RTextView 的基础功能

v1.0.10 2019.06.26 Fix bug issues#33

v1.0.9 2019.06.21 RImageView支持ScaleType

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状态添加 RCheckBox 和 RRadioButton

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-痞子

xiongshanxi / RWidgetHelper