android - 如何将文档添加到自定义属性？

Question

我知道如何为视图创建自定义属性，例如：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <declare-styleable name="SomeViewsCustomAttrs">
        <attr name="someAttr" format="dimension" />
        <attr name="anotherAttr" format="boolean" />
    </declare-styleable>
</resources>    

我想知道是否有办法向这些自定义属性添加文档。在 XML 编辑器中编辑布局时，您可以获得描述属性的工具提示。例如，如果您正在输入android:layout_width=，它将为您提供以下信息，“指定视图的基本宽度。[维度，枚举]”

有没有办法为你自己的 attrs 提供它？

谢谢

Answer 1

为每个元素添加 XML 注释：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <declare-styleable name="SomeViewsCustomAttrs">
        <!-- Default highlight color for items that are pressed. -->
        <attr name="colorPressedHighlight" format="color" />
        <!-- Default highlight color for items that are long-pressed. -->
        <attr name="colorLongPressedHighlight" format="color" />
    </declare-styleable>
</resources> 

在您的视图的 Java 源文件中的 Java Doc 中链接到这样的属性（来自TextView的示例）：

* See {@link android.R.styleable#TextView TextView Attributes}, {@link android.R.styleable#View View Attributes}

Answer 2

您需要在代码中编写构造函数，然后将它们链接到 xml。阅读此内容以获取更多信息。