Android自定义视图一:扩展现有的视图,添加新的XML属性

这个系列是老外写的,干货!翻译出来一起学习。如有不妥,不吝赐教!

  1. Android自定义视图一:扩展现有的视图,添加新的XML属性
  2. Android自定义视图二:如何绘制内容
  3. Android自定义视图三:给自定义视图添加“流畅”的动画
  4. Android自定义视图四:定制onMeasure强制显示为方形

简介

这个系列详细的介绍了如何穿件Android自定义视图。主要涉及的内容有如何绘制内容,layout和measure的原理,如何继承实现view group以及如何给其子视图添加动画。第一篇主要讲述如何扩展和使用现有的视图,以及如何添加特有的XML属性。

特定的任务使用特定的视图

Android提供的view都是比较通用的,哪里都可以用。但是在开发应用的过程中需要对这些通用的view加以修改。很多时候这些代码都添加到了Activity中,这样是的Activity的代码杂乱,影响维护。

假设你在开发一个最用用户训练数据的应用。比如用户的总运动时长,总运动距离以及不同的运动类型等。为了友好的把数据展现给用户,你需要根据用户运动的时间长度做不同的处理。比如他运动了2378秒,那么显示的肯定是48分钟。18550秒,那显示的肯定是5小时9分钟。

创建一个自定义视图

处理上面的问题最好就是定义一个view。这个view里包含了处理上面时间的功能。我们来创建一个自定义view:DurationTextView

class DurationTextView : TextView {
    constructor(context: Context, attributeSet: AttributeSet) : super(context, attributeSet) {
    }
}

TextView和其他的view一样有三个构造函数:一个是只需要Context的,一个是上面给出的需要两个参数ContextAttributeSet,还有一个需要这两个参数之外的关于style的参数。一般来说,上面给出的构造方法就可以满足。下面在布局中使用上面定义的view。

<demo.customview.customviewdemo.Views.DurationTextView
    android:id="@+id/duration_view"
    android:layout_width="match_parent"
    android:layout_height="wrap_content" />

注意,这里需要给出自定义视图的全名称。

添加展示逻辑

现在这个视图和标准的TextView没什么太大的区别。我们为这个view添加一个duration属性来设置和读取duration值。

var duration: Float
get() = _duration
set(value) {
    _duration = value

    var durationInMinutes: Int = Math.round(_duration / 60)
    var hours: Int = durationInMinutes / 60
    var minutes: Int = durationInMinutes % 60

    var hourText: String = ""
    var minuteText: String = ""

    if (hours > 0) {
        hourText = "$hours ${if (hours == 1) "hour" else "hours"}"
    }

    if (minutes > 0) {
        minuteText = "$minutes ${if (minutes == 1) "minute" else "minutes"}"
    }

    if (hours == 0 && minutes == 0) {
        minuteText = "Less than 1 minute"
    }

    var durationText = TEXT_TEMPLATE.format(hourText, minuteText)

    text = durationText
}

companion object {
    val TEXT_TEMPLATE = "Duration: %s %s"
}

这个方法接受一个Float型的参数,训练时间的秒数。然后通过上面的转换逻辑把这个秒数转成用户友好的文字值。最后赋值给TextView的text。转换的逻辑非常简单,就是把秒数转为分钟数,最后转为小时和分钟的值。分钟和小时数如果大于1的时候单位就显示为minutes和hours,等于1的时候为minute和hour。

用起来

现在就可以试试效果了。在Activity的onCreate()方法里添加下面的代码:

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    var durationTextView1 = findViewById(R.id.duration_view1) as DurationTextView
    durationTextView1.duration = 2378.0f

    var durationTextView2 = findViewById(R.id.duration_view2) as DurationTextView
    durationTextView2.duration = 3670.0f

    var durationTextView3 = findViewById(R.id.duration_view3) as DurationTextView
    durationTextView3.duration = 18550.0f
}

运行结果如下图:



看起来还不错吧。

添加XML属性

如果我们能够这个view添加一个方法来设置文本展示的模板,就像设定duration一样。但是,这个template其实并不会想duration一样需要经常的设置,更多的是一个类似于常数一样的存在。所以对于添加一个方法来说,添加一个XML属性更加合适。

首先添加values/attrs.xml文件,XML属性就在这个文件中定义。我们只需要添加一个字符串类型的,名称为template的属性。添加之后attrs.xml文件看起来是这样的:

<resources>
    <declare-styleable name="TemplateTextView">
        <attr name="template" format="string" />
    </declare-styleable>
</resources>

我们声明了一个名称为TemplateTextViewdeclare-styleable节点。名字可以任意起,不过最好还是在哪个view里使用就叫做什么。这里叫做TemplateTextView是因为后面这个XML属性会用与很多其他的自定义view中。来看看是怎么使用这个属性的。

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    tools:context="demo.customview.customviewdemo.MainActivity">

    <demo.customview.customviewdemo.Views.DurationTextView
        android:id="@+id/duration_view1"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="Customized"
        android:textSize="20sp"
        app:template="%s was spent running" />
        
        <!-- ...... -->

</LinearLayout>

在格式化代码(快捷键Ctrl+Alt+L,或者Cmd+Alt+L)后在LinearLayout中会增加一行xmlns:app="http://schemas.android.com/apk/res-auto"这一句声明了一个namespace,这样APP就可以理解我们刚刚在自定义view的布局中添加的属性了。当然需要使用这条声明里指定的app为前缀:app:template="%s was spent running"

现在就需要我们在代码里读取并应用新添加的属性值了。首先添加一个var template:String? = null的属性,准备接收解析的字符串模板。

var attributes = context.obtainStyledAttributes(attributeSet, R.styleable.TemplateTextView)
template = attributes.getString(R.styleable.TemplateTextView_template)

if (template == null || !(template?.contains("%s", ignoreCase = true) ?: false)) {
    template = TEXT_TEMPLATE
}

attributes.recycle()

第一行使用了AttributeSet类型的参数attributeSet,这个参数包含了在attrs.xml文件中定义的全部的属性。 方法obtainStyledAttributes()主要做了两件事:

  1. 过滤全部的自定义属性,并把这些属性的定义和给定的值关联起来。
  2. 返回你在第二个参数所指定的属性组合。

R.styleable.TemplateTextView就是我们自己定义的属性数组,这里只有一个元素。R.styleable.TemplateTextView_template是我们自定义属性数组里的那个叫做template的元素。然后我们使用typed array来获取这个属性的值。如果没有设置模板,或者模板中不包含处理字符串的%s的话就是用我们之前定义的默认的文字模板来代替。

但是有一点需要格外注意:不管有没有获取到属性值,都要回收TypedArray对象attributes.recycle()

上下两个分别设定了不同的template,中间的不设定,运行一下看看修改后的效果如何:


对于大多数的Android视图XML属性都有对应的方法来通过代码的方式设置对应的值。对于自定义视图是否需要这么做,主要取决于你打算怎么用。添加一个方法也没什么问题。

下一篇主要简述如何绘制视图的内容,并自定义一个显示折线图的视图。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,732评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,496评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,264评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,807评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,806评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,675评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,029评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,683评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 41,704评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,666评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,773评论 1 332
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,413评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,016评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,978评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,204评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,083评论 2 350
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,503评论 2 343

推荐阅读更多精彩内容