¿Cómo agregar documentación a los atributos personalizados?

Question

sé cómo crear atributos personalizados para las vistas, por ejemplo:

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

Me pregunto si hay una manera de añadir documentación a estos attrs personalizados. Mientras edita los diseños en el editor XML, puede obtener información sobre herramientas que describen qué son los attrs. Como ejemplo, si está escribiendo android:layout_width= le dará la siguiente información: "Especifica el ancho básico de la vista. [Dimensión, enum]"

¿Hay alguna manera de proporcionar eso para sus propios atributos?

Gracias

Answer 1

Usted tiene que escribir constructores de código y luego vincularlos con el XML. Lea this para obtener más información.

Answer 2

Agregar comentario XML para cada elemento:

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

Y en el Java Doc en el archivo fuente de Java de la vista enlace a los atributos como esto (ejemplo de TextView):

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