Cách thêm tài liệu vào thuộc tính tùy chỉnh?

Question

tôi biết làm thế nào để tạo ra các thuộc tính tùy chỉnh cho quan điểm, ví dụ:

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

tôi tự hỏi nếu có một cách để thêm tài liệu hướng dẫn cho những attrs tùy chỉnh. Trong khi chỉnh sửa các bố trí trong trình soạn thảo XML, bạn có thể nhận được các chú giải công cụ mô tả những gì là attrs. Ví dụ: nếu bạn đang nhập android:layout_width=, nó sẽ cung cấp cho bạn thông tin sau, "Chỉ định chiều rộng cơ bản của chế độ xem. [Dimension, enum]"

Có cách nào để cung cấp cho người gác của riêng bạn không?

Cảm ơn

Answer 1

Bạn cần viết các hàm tạo trong mã và sau đó liên kết chúng với xml. Đọc this để biết thêm thông tin.

Answer 2

Add XML comment để mọi yếu tố:

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

Và trong Doc Java trong các tập tin nguồn Java của liên kết của bạn để xem các thuộc tính như thế này (ví dụ từ TextView):

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