使用XML声明一个自定义的android UI元素
我如何使用XML声明Android UI元素?
Android开发人员指南中有一个名为“建立自定义组件” 不幸的是,关于XML属性的讨论只包括在布局文件中声明控件,而不是实际处理类初始化中的值。 步骤如下:
1.在valuesattrs.xml
声明属性
<?xml version="1.0" encoding="utf-8"?>
<resources>
<declare-styleable name="MyCustomView">
<attr name="android:text"/>
<attr name="android:textColor"/>
<attr name="extraInformation" format="string" />
</declare-styleable>
</resources>
请注意在declare-styleable
标记中使用了非限定名称。 非标准的android属性如extraInformation
需要声明其类型。 在超类中声明的标签将在子类中提供,而不必重新声明。
2.创建构造函数
由于有两个构造函数使用AttributeSet
进行初始化,因此为构造函数创建一个单独的初始化方法以方便调用。
private void init(AttributeSet attrs) {
TypedArray a=getContext().obtainStyledAttributes(
attrs,
R.styleable.MyCustomView);
//Use a
Log.i("test",a.getString(
R.styleable.MyCustomView_android_text));
Log.i("test",""+a.getColor(
R.styleable.MyCustomView_android_textColor, Color.BLACK));
Log.i("test",a.getString(
R.styleable.MyCustomView_extraInformation));
//Don't forget this
a.recycle();
}
R.styleable.MyCustomView
是一个自动生成的int[]
资源,其中每个元素是一个属性的ID。 通过将属性名称附加到元素名称,为XML中的每个属性生成属性。 例如, R.styleable.MyCustomView_android_text
包含MyCustomView
的android_text
属性。 然后可以使用各种get
函数从TypedArray
检索属性。 如果该属性未在XML中的定义中定义,则返回null
。 当然,除了返回类型是基本的,在这种情况下,第二个参数被返回。
如果您不想检索所有属性,可以手动创建此数组。标准android属性的ID包含在android.R.attr
,而此项目的属性包含在R.attr
。
int attrsWanted[]=new int[]{android.R.attr.text, R.attr.textColor};
请注意,你不应该在使用任何android.R.styleable
,按照这个线程可能在未来改变。 它仍然是在文档中查看所有这些常量在一个地方是有用的。
3.在布局文件(如layoutmain.xml
使用它
在顶层xml元素中包含名称空间声明xmlns:app="http://schemas.android.com/apk/res-auto"
。 命名空间提供了一种方法来避免当不同的模式使用相同的元素名称时有时会发生冲突(请参阅本文以获取更多信息)。 URL只是一种唯一标识模式的方式 - 实际上并不需要托管在该URL处。 如果这看起来没有做任何事情,那是因为除非需要解决冲突,否则实际上并不需要添加命名空间前缀。
<com.mycompany.projectname.MyCustomView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:background="@android:color/transparent"
android:text="Test text"
android:textColor="#FFFFFF"
app:extraInformation="My extra information"
/>
使用完全限定名称引用自定义视图。
Android LabelView示例
如果您想要一个完整的示例,请查看android标签视图示例。
LabelView.java
TypedArray a=context.obtainStyledAttributes(attrs, R.styleable.LabelView);
CharSequences=a.getString(R.styleable.LabelView_text);
attrs.xml
<declare-styleable name="LabelView">
<attr name="text"format="string"/>
<attr name="textColor"format="color"/>
<attr name="textSize"format="dimension"/>
</declare-styleable>
custom_view_1.xml
<com.example.android.apis.view.LabelView
android:background="@drawable/blue"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
app:text="Blue" app:textSize="20dp"/>
这包含在具有名称空间属性的LinearLayout
: xmlns:app="http://schemas.android.com/apk/res-auto"
链接
伟大的参考。 谢谢! 除此之外:
如果您碰巧有一个库项目已经为自定义视图声明了自定义属性,则必须声明您的项目命名空间,而不是库的项目命名空间。 例如:
鉴于该库具有“com.example.library.customview”包并且工作项目具有包“com.example.customview”,那么:
将不起作用(显示错误“错误:包'com.example.library.customview'”)中找不到属性'newAttr'的资源标识符):
<com.library.CustomView
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res/com.example.library.customview"
android:id="@+id/myView"
app:newAttr="value" />
将工作:
<com.library.CustomView
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res/com.example.customview"
android:id="@+id/myView"
app:newAttr="value" />
除了大多数投票答案。
obtainStyledAttributes()
当我们使用android:xxx prdefined属性创建自定义视图时,我想添加一些关于acquireStyledAttributes()用法的字词。 尤其是当我们使用TextAppearance。
如“2.创建构造函数”中所述,自定义视图在其创建时获得了AttributeSet。 主要用法,我们可以在TextView源代码(API 16)中看到。
final Resources.Theme theme = context.getTheme();
// TextAppearance is inspected first, but let observe it later
TypedArray a = theme.obtainStyledAttributes(
attrs, com.android.internal.R.styleable.TextView, defStyle, 0);
int n = a.getIndexCount();
for (int i = 0; i < n; i++)
{
int attr = a.getIndex(i);
// huge switch with pattern value=a.getXXX(attr) <=> a.getXXX(a.getIndex(i))
}
a.recycle();
我们可以在这里看到什么?
obtainStyledAttributes(AttributeSet set, int[] attrs, int defStyleAttr, int defStyleRes)
属性集根据文档由主题处理。 属性值逐步编译。 首先从主题填充属性,然后用样式中的值替换值,最后从XML中为特殊视图实例替换其他值。
请求的属性数组 - com.android.internal.R.styleable.TextView
它是一个普通的常量数组。 如果我们要求标准属性,我们可以手动构建这个数组。
文档中没有提到什么 - 结果的顺序TypedArray元素。
当在attrs.xml中声明定制视图时,会生成属性索引的特殊常量。 我们可以通过这种方式提取值: a.getString(R.styleable.MyCustomView_android_text)
。 但对于手动int[]
,没有常量。 我想,getXXXValue(arrayIndex)将正常工作。
还有一个问题是:“我们如何取代内部常量,并请求标准属性?” 我们可以使用android.R.attr。*值。
所以如果我们想在自定义视图中使用标准TextAppearance属性并在构造函数中读取它的值,我们可以通过以下方式从TextView中修改代码:
ColorStateList textColorApp = null;
int textSize = 15;
int typefaceIndex = -1;
int styleIndex = -1;
Resources.Theme theme = context.getTheme();
TypedArray a = theme.obtainStyledAttributes(attrs, R.styleable.CustomLabel, defStyle, 0);
TypedArray appearance = null;
int apResourceId = a.getResourceId(R.styleable.CustomLabel_android_textAppearance, -1);
a.recycle();
if (apResourceId != -1)
{
appearance =
theme.obtainStyledAttributes(apResourceId, new int[] { android.R.attr.textColor, android.R.attr.textSize,
android.R.attr.typeface, android.R.attr.textStyle });
}
if (appearance != null)
{
textColorApp = appearance.getColorStateList(0);
textSize = appearance.getDimensionPixelSize(1, textSize);
typefaceIndex = appearance.getInt(2, -1);
styleIndex = appearance.getInt(3, -1);
appearance.recycle();
}
CustomLabel定义在哪里:
<declare-styleable name="CustomLabel">
<!-- Label text. -->
<attr name="android:text" />
<!-- Label text color. -->
<attr name="android:textColor" />
<!-- Combined text appearance properties. -->
<attr name="android:textAppearance" />
</declare-styleable>
也许,我有些误解,但有关getsStyledAttributes()的Android文档非常差。
扩展标准UI组件
同时,我们可以使用所有声明的属性来扩展标准UI组件。 这种方法不太好,因为TextView为实例声明了很多属性。 在overriden onMeasure()和onDraw()中实现完整的功能是不可能的。
但是我们可以牺牲理论上广泛的定制组件的复用。 说“我确切知道我将使用哪些功能”,并且不要与任何人共享代码。
然后我们可以实现构造函数CustomComponent(Context, AttributeSet, defStyle)
。 调用super(...)
我们将通过getter方法解析和使用所有属性。