How to add documentation to custom attributes?

Question

I know how to create custom attributes for views, for example:

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

I am wondering if there is a way to add documentation to these custom attrs. While editing layouts in the XML editor, you can get tooltips that describe what the attrs are. As an example, if you are typing android:layout_width= it will give you the following information, "Specifies the basic width of the view. [dimension, enum]"

Is there a way to provide that for your own attrs?

Thanks

Did you ever find an answer for this? – drewhannay Jun 17 '13 at 17:04 — drewhannay, Jun 17 '13 at 17:04
@drewhannay I gave up looking, haven't found anything yet. – cottonBallPaws Jun 18 '13 at 16:23 — cottonBallPaws, Jun 18 '13 at 16:23
2018 and still no standard solution – Kedar Paranjape Mar 16 '18 at 00:37 — Kedar Paranjape, Mar 16 '18 at 00:37

Ralph Bergmann · Answer 1 · 2013-12-15T13:56:37.500

Add XML comment to every element:

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

And in the Java Doc in the Java source file of your view link to the attributes like this (example from TextView):

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

That's so easy! Why didn't I think of that? – SMBiggs Jul 31 '19 at 22:32 — SMBiggs, Jul 31 '19 at 22:32

score -1 · Answer 2 · edited May 23 '17 at 12:26

-1

You need to write constructors in code and then link them to the xml. Read this for more info.

edited May 23 '17 at 12:26

Community

1
1

answered Jun 24 '13 at 19:49

Steven Mann

558
3
14

How to add documentation to custom attributes?

2 Answers2