`
xumingrencai
  • 浏览: 1172787 次
文章分类
社区版块
存档分类
最新评论

android 自定义控件 使用declare-styleable进行配置属性(源码角度)

 
阅读更多

最近在模仿今日头条,发现它的很多属性都是通过自定义控件并设定相关的配置属性进行配置,于是便查询了解了下declare-styleable,下面我把自己的使用感受和如何使用进行说明下。

declare-styleable:declare-styleable是给自定义控件添加自定义属性用的。

官方的相关内部控件的配置属性文档:http://developer.android.com/reference/android/R.styleable.html


如果不知道如何查看源码:点击这里


起初,在自定义控件的时候,会要求构造3个方法中的一个或多个,好比我自定义的控件PersonView,

public PersonView(Context context) {
		super(context);
		// TODO Auto-generated constructor stub
	}

	public PersonView(Context context, AttributeSet attrs, int defStyle) {
		super(context, attrs, defStyle);
		// TODO Auto-generated constructor stub
	}

	public PersonView(Context context, AttributeSet attrs) {
		super(context, attrs);
}
其中的AttributeSet attrs一般都没给它配置和使用,所以不知道这个东西到底怎么用,后来查看源码发现,这个配置在默认情况下使用的是系统自己的默认配置,一旦你直接设定了它的属性,默认属性就会被你的赋值所替代。

下面我们拿TextView的源码看看AttributeSet是如何进行操作的。

初始化时候,在布局文件中写android:text="拉拉";



初始化TextView的时候,它的类中的属性都会初始化;




接着往下看,你可以看到以下代码:


        TypedArray a = theme.obtainStyledAttributes(
                    attrs, com.android.internal.R.styleable.TextViewAppearance, defStyle, 0);
        TypedArray appearance = null;
        int ap = a.getResourceId(
                com.android.internal.R.styleable.TextViewAppearance_textAppearance, -1);
        a.recycle();
        if (ap != -1) {
            appearance = theme.obtainStyledAttributes(
                    ap, com.android.internal.R.styleable.TextAppearance);
这个就是系统在默认的资源文件R.styleable中去获取相关的配置。

如果appearance不为空,它就会去寻找获取相关属性,接着往下看。


此时的text = ""; 就是准备输出的字符串初始化。

之后它便会查找你布局文件XML中是否设定给了它text属性值


之前我们设定过android:text="拉拉"; 所以它便会得到相关的赋值,之后调用

<span style="font-size:18px;"> setText(text, bufferType);
 if (hint != null) setHint(hint);
</span>
输出该字符串。当资源检查赋值完毕后,调用a.recycle();释放。
同理也可以发现,像hint,textcolor这类属性都是这么初始化赋值的。


思路:

自定义控件并且自定义属性的情况下,你可以通过这样去获取判断是否配置了相关的属性,并进行赋值操作。


从源码那边我们大体知道了一个控件的属性配置和初始化流程,下面就让我们按照这个思路去自己学习下如何自定义配置。


下面我要写一个继承了TextView的PersonView类,给它设定属性配置,之后实现属性的显示。

1.首先,先写attrs.xml

在res-vlaues文件夹下创建资源文件attrs.xml或则自定义一个资源文件xx.xml,都可以。

之后在里面配置declare-styleable ,name为PersonAttr

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <declare-styleable name="PersonAttr">
        <attr name="name" format="reference" />
        <attr name="sex" format="reference" />
        <attr name="age" format="integer" />
        <attr name="weight">
            <flag name="fat" value="2" />
            <flag name="mid" value="1" />
            <flag name="thin" value="0" />
        </attr>
        <attr name="adult" format="boolean" />
        <attr name="textSize" format="dimension" />
    </declare-styleable>
</resources>

我这里设置了姓名name,性别sex,年龄age,以及特征属性weight(fat,mid,thin内部的3个属性及对应的属性值),还有是否成年adult,和TextView的字体大小textView。

可能这里有人会问,format是什么,里面的单词代表的又是什么意思。

format就是格式,里面的就是这个属性对应的格式,下面列出来大致的格式有:

1. reference:参考某一资源ID,以此类推

(1)属性定义:

<declare-styleable name = "名称">

<attr name = "background" format = "reference" />

</declare-styleable>

(2)属性使用:

<ImageView

android:layout_width = "42dip"

android:layout_height = "42dip"

android:background = "@drawable/图片ID"

/>

2. color:颜色值

<declare-styleable name = "名称">

<attr name = "textColor" format = "color" />

</declare-styleable>

3. boolean:布尔值

<declare-styleable name = "名称">

<attr name = "focusable" format = "boolean" />

</declare-styleable>

4. dimension:尺寸值。注意,这里如果是dp那就会做像素转换

<declare-styleable name = "名称">

<attr name = "layout_width" format = "dimension" />

</declare-styleable>

5. float:浮点值。

6. integer:整型值。

7. string:字符串

8. fraction:百分数。

9. enum:枚举值

10. flag:是自己定义的,类似于 android:gravity="top",就是里面对应了自己的属性值。

11.reference|color:颜色的资源文件。
12.reference|boolean:布尔值的资源文件

注意://由于reference是从资源文件中获取:所以在XML文件中写这个属性的时候必须personattr:name="@string/app_name"这种格式,否则会出错


2.设置好属性文件后,在使用的布局中写相关配置:

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:personattr="http://schemas.android.com/apk/res/com.example.declare_styleable"
    android:layout_width="match_parent"
    android:layout_height="match_parent" >

    <com.example.declare_styleable.PersonView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        personattr:name="@string/person_name" 
        personattr:weight ="fat"
        personattr:adult ="false"
        personattr:textSize="@dimen/text_size"/>

</RelativeLayout>

这里要先应用这个attr:
xmlns:personattr="http://schemas.android.com/apk/res/com.example.declare_styleable"

对应结构是:

xmlns:你自己定义的名称="http://schemas.android.com/apk/res/你程序的package包名"    (我这是com.example.declare_styleable)

包名是配置文件中 package="com.example.declare_styleable" 这样格式的

之后在布局中自定义的类中设相关属性:

你自己定义的名称:你设的属性 ="属性值";


3.最后在自定义控件的构造方法中获取你配置的属性值:

public class PersonView extends TextView {
	public PersonView(Context context) {
		super(context);
		// TODO Auto-generated constructor stub
	}

	public PersonView(Context context, AttributeSet attrs, int defStyle) {
		super(context, attrs, defStyle);
		// TODO Auto-generated constructor stub
	}

	public PersonView(Context context, AttributeSet attrs) {
		super(context, attrs);
		// TODO Auto-generated constructor stub
		TypedArray tArray = context.obtainStyledAttributes(attrs,R.styleable.PersonAttr);//获取配置属性
		String name = tArray.getString(R.styleable.PersonAttr_name);<span style="font-family: Arial, Helvetica, sans-serif;">//得到属性name</span>
		int age = tArray.getInt(R.styleable.PersonAttr_age, 15);
		Boolean adult = tArray.getBoolean(R.styleable.PersonAttr_adult, false);
		String str_adult = getAdultStatus(adult);
		int weight = tArray.getInt(R.styleable.PersonAttr_weight, 1);// 默认是中等身材,属性为:1
		String str_weight = getWeightStatus(weight);//获得肥胖属性
		float textSize = tArray.getDimension(R.styleable.PersonAttr_textSize,R.dimen.default_text_size);// 如果你设置为DP等单位,会做像素转换
		tArray.recycle();//回收资源
//		setTextSize(textSize);//设置字体大小
		setText("姓名:" + name + "\n" + "年龄:" + age + "\n" + "是否成年:" + str_adult
				+ "\n" + "体形:" + str_weight);//给自定义的控件赋值
	}
	
	/** 根据传入的值判断是否成年 */
	public String getAdultStatus(Boolean adult ){
		String str_adult = "未成年";
		if (adult) {
			str_adult = "成年";
		}
		return str_adult;
	}
	
	/** 根据传入的值判断肥胖状态 */
	public String getWeightStatus(int weight){
		String str_weight = "中等";
		switch (weight) {
		case 0:
			str_weight = "瘦";
			break;
		case 1:
			str_weight = "中等";
			break;
		case 2:
			str_weight = "肥胖";
			break;
		default:
			break;
		}
		return str_weight;
	}
}
运行后就是:



这样,以后我们就可以根据这个方法,去自定义控件并自定义配置属性了,大大提高了自定义布局的使用效率。


对应的源码下载地址:下载地址


分享到:
评论

相关推荐

    自定义控件控件的declare-styleable配置

    最近在模仿今日头条,发现它的很多属性都是通过自定义控件并设定相关的配置属性进行配置,于是便查询了解了下declare-styleable,下面我把自己的使用感受和如何使用进行说明下。 declare-styleable:declare-...

    Android中自定义控件的declare-styleable属性重用方案

    主要介绍了Android中自定义控件的declare-styleable属性重用方案,本文给出了一个终极重用解决方案,需要的朋友可以参考下

    详解Android自定义控件属性

    在Android开发中,往往要用到自定义的控件来实现我们的...-- resource是跟标签,可以在里面定义若干个declare-styleable --&gt; &lt;declare name=custom_view&gt;&lt;!-- name定义了变量的名称 --&gt; &lt;attr name=custo

    Android自定义View--01

    自定义view起步 1,新建attrs.xml文件,增加declare-styleable 2,实现android.view.View 3,在layout.xml 使用自定义view

    Android雷达图(蜘蛛网图)源码

    &lt;declare-styleable name="MyNetPic"&gt; &lt;attr name="lineColor" format="color"/&gt;&lt;!-- 线的颜色 --&gt; &lt;attr name="cotentColor" format="color"/&gt;&lt;!-- 图形的颜色 --&gt; &lt;attr name="side" format="dimension"/&gt; &lt;!-...

    Android 自定义进度条(多种效果) 源码

    water-wave-progress水波按进度上升,带环形进度条 , 支持4.0及以上版本,自定义declare-styleable name="WaterWaveProgress"样式, 全都是非必填,,布尔值默认为true

    CircularProgress-一个模仿android L中载入视图的控件.zip

     android:layout_margin="8dp"/&gt;属性说明&lt;declare-styleable name="CircularProgressView"&gt;   name="borderWidth" format="dimension" /&gt; // 圆弧边框的宽度   name="colorSequence" format="reference...

    lottie-2.7.0.jar

    在assets文件夹下放images+json文件就可以动态生成gif的android lottie jar包,需要在自己工程里面的values/attrs.xml加上自定义属性 &lt;declare-styleable name="LottieAnimationView"&gt; ...

    GifImageView.java

    &lt;declare-styleable name="GifImageView"&gt; &lt;!--gif文件引用--&gt; &lt;!--是否加载完自动播放--&gt; &lt;!--播放次放,默认永远播放--&gt; &lt;!--播放完成后是否停留在最后一帧,默认false--&gt; &lt;/declare-styleable&gt; ...

    android 自定义控件 自定义属性详细介绍

    自定义控件在android中无处不见,自定义控件给了我们很大的方便。比如说,一个视图为imageview ,imagebutton ,textview 等诸多控件的组合,用的地方有很多,我们不可能每次都来写3个的组合,既浪费时间,效率又低。...

    Android自定义组件:2、如何实现和使用自定义组件、自定义属性

    (1)declare-styleable子元素 (2)attrs.xml 文件只做属性的描述 步骤2:写自定义类 步骤3:使用自定义组件、自定义属性 三、效果展示-简单小结 1、效果展示 2、执行流程 3、可以不写 attrs.xml 文件 4、问题 四、...

    android实现图片验证码方法解析(自绘控件)

    自绘控件的内容都是自己绘制出来的 大致流程如下: 1.定义一个类继承view ...declare-styleable 声明自定义属性可以自定义一个新属性也可以引用已经存在的属性两者的区别就是新属性需要添加format进行类型的定义 3

    Android 自定义view时用到的TypedArray

    在自定义控件的时候,如果我们想额外的添加一些属性,就会用到TypedArray这个类,那么这个类是怎么得到的,以及怎么使用的,这里作个简单介绍。 创建自定义属性 首先创建values\attrs.xml,在attrs.xml中声明自定义...

    Android自定义控件属性详细介绍

    Android自定义控件属性详细介绍 1. reference:参考某一资源ID。   (1)属性定义: &lt;declare xss=removed&gt; &lt;/declare&gt;  (2)属性使用: &lt;ImageView android:layout_width = 42dip android:layout...

    Android自定义等待对话框

    最近,看了好多的APP的等待对话框,发现自己的太lower,于是就研究了一番,最后经过苦心努力,实现一个。 自定义一个LoadingIndicatorView(extends View )类 编写values/attrs.xml,在其中编写...declare-styleable n

    view自定义属性使用and more

    declare-styleable 在res/values目录下新建xml文件 自定义你的属性 2. AttributeSet和TypedArray 在view中获取这些属性对应的值,设置绑定到view上 3. xmlns申明与引用 在你要使用的地方引入命名空间并使用这些...

    Android自定义滑动解锁控件使用详解

    -- 滑动解锁控件 xml配置属性 --&gt; &lt;declare name=SlideToUnlockView&gt; &lt;attr name=slideImageViewWidth format=dimension/&gt;&lt;!-- 滑块宽度 --&gt; &lt;attr name=slideImageViewResId format=reference/&gt;&lt;!-- ...

    RainyView-Android 自定义View之下雨动画 效果.zip

     &lt;declare-styleable name="RainyView"&gt;  &lt;!--雨滴的颜色--&gt;   name="raindrop_color" format="color"&gt;  &lt;!--左边云的颜色--&gt;   name="left_cloud_color" format="color"&gt;  &lt;!--右边云...

    Android自定义View实现验证码

    首先我们定义一个declare-styleable标签declare-styleable标签的作用是给自定义控件添加自定义属性用的例如这样 (我们定义了文字的颜色,大小,长度,跟背景的颜色) &lt;declare name=CustomTitleView&gt; ...

Global site tag (gtag.js) - Google Analytics