Как добавить документацию к пользовательским атрибутам?

Я знаю, как создавать пользовательские атрибуты для представлений, например:

<?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 вы можете получить подсказки, описывающие, что такое attrs. В качестве примера, если вы набираете android:layout_width=, он предоставит вам следующую информацию: "Определяет базовую ширину представления. [Измерение, перечисление]"

Есть ли способ обеспечить это для ваших собственных attrs?

Спасибо

Ответ 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 Doc в исходном файле Java ссылка вашего вида на такие атрибуты (пример из TextView):

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

Ответ 2

Вам нужно написать конструкторы в коде, а затем связать их с xml. Подробнее читайте .