如何使用 declare-styleable

时间:2022-02-15 15:20:00

如何使用 declare-styleable

  1. 在创建 xml 到 objectName/res/values/ 命名为 attrs.xml
  2. 编辑文件内容为(示例)
    <?xml version="1.0" encoding="utf-8"?>
    <resources>
       <declare-styleable name="test1">
           <attr name="test" format = "float"></attr>
       </declare-styleable>
    </resources>
  3. 在 layout 文件夹中的定义文件中,在使用处引用
        <org.xiaoyunduo.MyText
              xmlns:app="http://schemas.android.com/apk/res/org.xiaoyunduo"
            android:id="@+id/add"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            app:test="100"
            android:text="@string/log_text_box_1_add_text"/>
    //我记得以前不需要定义 xmlns 现在必须要定义可以直接使用android:test 的形式,现在必须要定义 xmlns 了。
  4. 在代码中获取 layout 文件中的值(最好是在构造方法中调用)
            TypedArray a = context.obtainStyledAttributes(attrs, R.styleable.test1);//TypedArray是一个数组容器  
            float textSize = a.getFloat(R.styleable.test1_test, 30);//防止在XML文件里没有定义,就加上了默认值30
  5. 将获取到的值初始化到控件中
    这里就不写了 在构造方法中值已经拿到,后面的爱怎么用就怎么用。

declare-styleable 定义说明:

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:颜色值。

(1)属性定义:

<declare-styleable name = "名称">

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

</declare-styleable>

(2)属性使用:

<TextView

android:layout_width = "42dip"
android:layout_height = "42dip"
android:textColor = "#00FF00"

/>

3. boolean:布尔值。

(1)属性定义:

<declare-styleable name = "名称">

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

</declare-styleable>

(2)属性使用:

<Button

android:layout_width = "42dip"
android:layout_height = "42dip"

android:focusable = "true"

/>

4. dimension:尺寸值。

(1)属性定义:

<declare-styleable name = "名称">

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

</declare-styleable>

(2)属性使用:

<Button

android:layout_width = "42dip"
android:layout_height = "42dip"

/>

5. float:浮点值。

(1)属性定义:

<declare-styleable name = "AlphaAnimation">

<attr name = "fromAlpha" format = "float" />
<attr name = "toAlpha" format = "float" />

</declare-styleable>

(2)属性使用:

<alpha
android:fromAlpha = "1.0"
android:toAlpha = "0.7"

/>

6. integer:整型值。

(1)属性定义:

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

(2)属性使用:

<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"

/>

7. string:字符串。

(1)属性定义:

<declare-styleable name = "MapView">
<attr name = "apiKey" format = "string" />
</declare-styleable>

(2)属性使用:

<com.google.android.maps.MapView
android:layout_width = "fill_parent"
android:layout_height = "fill_parent"
android:apiKey = "0jOkQ80oD1JL9C6HAja99uGXCRiS2CGjKO_bc_g"

/>

8. fraction:百分数。

(1)属性定义:

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

(2)属性使用:

<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"

/>

9. enum:枚举值。

(1)属性定义:

<declare-styleable name="名称">
<attr name="orientation">
<enum name="horizontal" value="0" />
<enum name="vertical" value="1" />
</attr>

</declare-styleable>

(2)属性使用:

<LinearLayout

xmlns:android = "http://schemas.android.com/apk/res/android"
android:orientation = "vertical"
android:layout_width = "fill_parent"
android:layout_height = "fill_parent"
>
</LinearLayout>

10. flag:位或运算。

(1)属性定义:

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

(2)属性使用:

<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)属性定义:

<declare-styleable name = "名称">

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

</declare-styleable>

(2)属性使用:

<ImageView

android:layout_width = "42dip"
android:layout_height = "42dip"
android:background = "@drawable/图片ID|#00FF00"

/>

定义命名空间

在自定义扩展的时候还可以自定义命名空间,但是我仿照 demo 的时候感觉不对。命名空间中的属性不能通过提示(alt+/)打出来,但 demo 的可以。

命名空间定义语法如下:(由于自己没整对此次贴的 drag_layout.xml 中的代码)
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:dot="http://schemas.android.com/apk/res/com.example.android.apis"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:orientation="vertical"
    >