Android declare styleable 中 format详解

我们在做项目的时候,由于

  • android View style 自带的属性不能满足需求
  • 或者,封装自定义 Widget 可以直接在 xml 直接配置属性使用

android 提供了自定义属性的方法,其中的 format 是定义 xml数据类型的

下面列出一些常用的类型定义方法,及其使用方法

1
2
3
<declare-styleable name = "名称">
    <attr name = "background" format = "reference" />
</declare-styleable>
1
2
3
4
5
<ImageView
    android:layout_width = "42dip"
    android:layout_height = "42dip"
    android:background = "@drawable/图片ID"
/>
1
2
3
<declare-styleable name = "名称">
    <attr name = "textColor" format = "color" />
</declare-styleable>
1
2
3
4
5
<ImageView
    android:layout_width = "42dip"
    android:layout_height = "42dip"
    android:textColor = "#00FF00"
/>
1
2
3
<declare-styleable name = "名称">
      <attr name = "focusable" format = "boolean" />
</declare-styleable>
1
2
3
4
5
<ImageView
    android:layout_width = "42dip"
    android:layout_height = "42dip"
    android:focusable = "true"
/>
1
2
3
<declare-styleable name = "名称">
      <attr name = "layout_width" format = "dimension" />
</declare-styleable>
1
2
3
4
<ImageView
    android:layout_width = "42dip"
    android:layout_height = "42dip"
/>
1
2
3
4
<declare-styleable name = "AlphaAnimation">
    <attr name = "fromAlpha" format = "float" />
    <attr name = "toAlpha" format = "float" />
</declare-styleable>
1
2
3
4
<alpha
    android:fromAlpha = "1.0"
    android:toAlpha = "0.7"
/>
1
2
3
4
5
6
7
8
<declare-styleable name = "AnimatedRotateDrawable">
    <attr name = "visible" />
    <attr name = "frameDuration" format="integer" />
    <attr name = "framesCount" format="integer" />
    <attr name = "pivotX" />
    <attr name = "pivotY" />
    <attr name = "drawable" />
</declare-styleable>
1
2
3
4
5
6
7
8
<animated-rotate
    xmlns:android = "http://schemas.android.com/apk/res/android"
    android:drawable = "@drawable/图片ID"
    android:pivotX = "50%"
    android:pivotY = "50%"
    android:framesCount = "12"
    android:frameDuration = "100"
/>
1
2
3
<declare-styleable name = "MapView">
    <attr name = "apiKey" format = "string" />
</declare-styleable>
1
2
3
4
5
<com.google.android.maps.MapView
    android:layout_width = "fill_parent"
    android:layout_height = "fill_parent"
    android:apiKey = "0jOkQ80oD1JL9C6HAja99uGXCRiS2CGjKO_bc_g"
/>
1
2
3
4
5
6
7
8
<declare-styleable name="RotateDrawable">
    <attr name = "visible" />
    <attr name = "fromDegrees" format = "float" />
    <attr name = "toDegrees" format = "float" />
    <attr name = "pivotX" format = "fraction" />
    <attr name = "pivotY" format = "fraction" />
    <attr name = "drawable" />
</declare-styleable>
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
<rotate
    xmlns:android = "http://schemas.android.com/apk/res/android"
    android:interpolator = "@anim/动画ID"
    android:fromDegrees = "0"
    android:toDegrees = "360"
    android:pivotX = "200%"
    android:pivotY = "300%"
    android:duration = "5000"
    android:repeatMode = "restart"
    android:repeatCount = "infinite"
/>
1
2
3
4
5
6
<declare-styleable name="名称">
    <attr name="orientation">
    <enum name="horizontal" value="0" />
    <enum name="vertical" value="1" />
    </attr>
</declare-styleable>
1
2
3
4
5
6
7
 <LinearLayout
    xmlns:android = "http://schemas.android.com/apk/res/android"
    android:orientation = "vertical"
    android:layout_width = "fill_parent"
    android:layout_height = "fill_parent"
    >
</LinearLayout>
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
<declare-styleable name="名称">
	<attr name="windowSoftInputMode">
		<flag name = "stateUnspecified" value = "0" />
		<flag name = "stateUnchanged" value = "1" />
		<flag name = "stateHidden" value = "2" />
		<flag name = "stateAlwaysHidden" value = "3" />
		<flag name = "stateVisible" value = "4" />
		<flag name = "stateAlwaysVisible" value = "5" />
		<flag name = "adjustUnspecified" value = "0x00" />
		<flag name = "adjustResize" value = "0x10" />
		<flag name = "adjustPan" value = "0x20" />
		<flag name = "adjustNothing" value = "0x30" />
	</attr>
</declare-styleable>
1
2
3
4
5
6
7
8
9
<activity
	android:name = ".StyleAndThemeActivity"
	android:label = "@string/app_name"
	android:windowSoftInputMode = "stateUnspecified | stateUnchanged | stateHidden">
	<intent-filter>
		<action android:name = "android.intent.action.MAIN" />
		<category android:name = "android.intent.category.LAUNCHER" />
	</intent-filter>
</activity>

属性定义时可以指定多种类型值,通过 | 来分隔多种类型

1
2
3
<declare-styleable name = "名称">
    <attr name = "background" format = "reference|color" />
</declare-styleable>
1
2
3
4
5
<ImageView
    android:layout_width = "42dip"
    android:layout_height = "42dip"
    android:background = "@drawable/图片ID|#00FF00"
/>