Как добавить документацию к пользовательским атрибутам?
Я знаю, как создавать пользовательские атрибуты для представлений, например:
<?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. Подробнее читайте .