2016-07-30 3 views
2

В следующем XML, какой альтернативный способ разместить комментарий по атрибутам элемента?XML Comment Inside Element

<!-- I can comment here --> 

    <TextView 
     android:layout_width="wrap_content" 
     android:layout_height="wrap_content" 
     android:id="@+id/textView_ben" 

     <!-- Cannot place a comment here --> 

     android:layout_centerHorizontal="true"/> 
+1

См. Http://stackoverflow.com/questions/26461869/how-to-comment-attributes-inside-xml-tag – DAB

ответ

1

Комментарий может появиться только до или после открывающего тега (независимо от того, является ли это пустой тег).

Комментарий может не появляются в start-tag из XML-элемента:

[40] STag ::= '<' Name (S Attribute)* S? '>'

Nor может комментарий появится внутри закрывающего тега:

[44] EmptyElemTag ::= '<' Name (S Attribute)* S? '/>'

В общем, в разделе 2.5 Comments:

[Определение: Комментарии могут появляться в любом месте документа вне другой markup; кроме того, они могут появляться в документе декларации типа в местах, разрешенных грамматикой. ...]


Вот один из способов документирования элемента атрибутов:

<TextView 
     android:layout_width="wrap_content" 
     android:layout_height="wrap_content" 
     android:id="@+id/textView_ben" 
     android:layout_centerHorizontal="true"/> 
    <!-- 
     android:id="@+id/textView_ben" 
      addresses defect #123 
     android:layout_centerHorizontal="true" 
      blah blah blah --> 

В качестве альтернативы, такой комментарий может появиться перед тем по тегу; он просто не может появиться в пределах тег.