android - 有人能给我解释一下这个例子中的 declare-styleable XML 标签及其使用背后的理论吗？

Question

我正在阅读 Beginning Android 4 Development，在第 5 章中讨论了 Gallery 和 ImageVievs 并介绍了 declare-styleable XML 标记没有解释它的目的..我也试图在引用资料中找到一些信息，但没有运气..例如我们有以下内容:

res/values/attrs.xml

<?xml version=”1.0” encoding=”utf-8”?> 
<resources>
    <declare-styleable name=”Gallery1”>
        <attr name=”android:galleryItemBackground” />
    </declare-styleable>
</resources>

example.java

public class GalleryActivity extends Activity {
[...]
    public void onCreate(Bundle savedInstanceState) { 
        super.onCreate(savedInstanceState);    
        setContentView(R.layout.main);
        Gallery gallery = (Gallery) findViewById(R.id.gallery1);
        gallery.setAdapter(new ImageAdapter(this)); 
        [...]
    }

    [...]

    public class ImageAdapter extends BaseAdapter {
        [...]
        int itemBackground;

        public ImageAdapter(Context c) {
            context = c;
            //---setting the style---
            TypedArray a = obtainStyledAttributes(
            R.styleable.Gallery1); 
            itemBackground = a.getResourceId(
                        R.styleable.Gallery1_android_galleryItemBackground, 0);
            a.recycle();
        }

        public View getView(int position, View convertView, ViewGroup parent) {
            ImageView imageView;
            [...]
            imageView.setBackgroundResource(itemBackground);
            return imageView; 
        }
    }
}

我已经读了几次代码，但我真的不明白用一个 attr child 定义这个样式化的 Gallery1 的目的只有一个 name 属性..你能帮我吗？这个galleryItemBackground是系统提供的还是我们定义的？我们在这段代码中做什么？

提前感谢您的帮助!

Answer 1

此标签是 R.Styleable 中定义的一组预制 Android 属性的一部分。 ，这可以与来自 android: 的自定义样式标签区分开来属性名称前的 xml 命名空间前缀。

此特定属性描述为:

The preferred background for gallery items. This should be set as the background of any Views you provide from the Adapter.

但是，您是对的，自定义属性标签不仅需要属性的名称，还需要属性的类型，例如，将自定义元素添加到您的 attrs.xml 中。文件可能如下所示:

<?xml version="1.0" encoding="utf-8"?> 
<resources> 
    <declare-styleable name="MyCustomView"> 
        <attr name=”android:galleryItemBackground” />              
        <attr name="myCustomAttr" format="string" /> 
    </declare-styleable> 
</resources>

注意缺少 android:第二个属性上的命名空间。

编辑:

Is there any official documentation page that explains in depth this Styleables?

查看 R.attr (点击链接)了解 Android 中包含的各种属性。您不需要为它们声明类型，因为它们都已经声明过了。要了解为特定属性声明的类型，请查找您感兴趣的属性的说明。galleryItemBackground如您所料，是对另一个资源的引用；其他可能性是 bool 值、 float 、颜色等。

其他引用资料:Andtoid 使用 <declare-styleable>标签创建 AttributeSet . TypedArray 用于解析 AttributeSet .

If the purpose of the code above [...] is simply get a default Drawable for the view's background, couldn't I set the variable itemBackground with getDrawable(android.R.attr.galleryItemBackground)?

在示例中，当只有一个属性时，很难看出这种模式的用处。你可以按照你的要求去做，而且可能会更容易。然而，该构造是 Android 的口头禅的一部分，它通过让您在 xml 中设置某些属性而不是必须在代码中做所有事情来将 UI 的“外观”与其“功能”分开。乘坐View类，例如。它有超过 30 个可以在 xml 文件中设置的属性(大小、填充、可点击、可聚焦等)；有人制作了 View 的自定义子类可以在 xml 中设置一些、全部或不设置这些属性，它们会在创建 View 时自动为您处理。如果需要，有等效的代码来设置属性，但想象一下每次子类化 View您必须在代码中设置所有属性，而不是在 xml 中设置它们。

为您的类创建自己的资源来做完全相同的事情也是一件微不足道的事情，但是如果您不这样做，使用内置样式将提供与 Android 框架的外观和感觉相匹配的默认资源覆盖它们。

希望这对您有所帮助。