Jak dodać dokumentację do niestandardowych atrybutów?

Question

wiem, jak tworzyć własne atrybuty dla widoków, na przykład:

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

Zastanawiam się, czy istnieje sposób, aby dodać dokumentację do tych niestandardowych attrs. Podczas edycji układów w edytorze XML można uzyskać podpowiedzi, które opisują, czym są atrsy. Na przykład, jeśli wpisujesz android:layout_width=, otrzymasz następujące informacje: "Określa podstawową szerokość widoku. [Wymiar, wyliczenie]"

Czy istnieje sposób na zapewnienie tego dla własnych attrów?

Dzięki

Answer 1

Musisz napisać konstruktorów w kodzie, a następnie połączyć je z XML. Przeczytaj this, aby uzyskać więcej informacji.

Answer 2

dodawania XML komentarz do każdego elementu:

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

A w Java Doc w pliku źródłowym Java linku celu atrybutów tak (przykład z TextView):

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