Làm cách nào để tạo nhiều mức thụt lề trong Javadoc?


88

Giả sử, là một phần của việc ghi lại mã của bạn (Javadoc), bạn muốn chỉ ra rằng mối quan hệ giữa các phần tử bằng cách sử dụng thụt lề sâu.

Làm cách nào để tạo danh sách lồng nhau:

  • một số yếu tố
    • một số yếu tố khác
      • một số yếu tố khác

Câu trả lời:


132
<ul>
  <li>Element</li>
  <ul>
     <li>Subelement...</li>

Bạn có thể thoải mái sử dụng HTML bên trong các bình luận javadoc.

Cập nhật: Vì nó xuất hiện nên tôi đã thử

<ul>
    <li>one</li>
    <ul>
        <li>one point one</li>
    </ul>   
</ul>

và lấy

  • một
    • một điểm một

Tôi đồng ý làm tổ thích hợp là tốt hơn.


2
Tôi muốn nói lồng nhau <ul> phải là bên trong một số <li> phần tử, cho xem so sánh w3.org/wiki/HTML_lists#Nesting_lists
user2622016

Bạn có thể nói điều đó, nhưng thử nó sẽ nói lên điều gì đó khác biệt.
Charlie Martin

1
@Charlie Thay vì nói "Tôi đồng ý cách lồng đúng cách sẽ tốt hơn.", Có lẽ Bạn có thể viết một ví dụ cho thấy cách lồng đúng cách? Nếu không, có thể một số người mới bắt đầu sẽ không hiểu nhận xét của Bạn và sử dụng biểu mẫu nêu trên.
Rauni Lillemets

2
Tôi hiểu rằng user2622016 có nghĩa là Bạn phải viết như thế này: <ul><<ul><ul><ul><ul><ul><ul> <li> > cũng nằm trong khối <li> .. </li>.
Rauni Lillemets

1
Mặc dù tôi không thể tìm thấy nó được nêu rõ ràng (và tôi đã xem), nhưng đó là kiểu được sử dụng trong tài liệu của Oracle . Ngoài ra, NetBeans cũng phàn nàn về nó. Mặt khác, Intellij vui vẻ thêm các </li>thẻ
Mức độ nghiêm

28

Cách làm đúng như sau:

/**
 * <ul>
 *   <li>some element
 *   <li><ul>
 *     <li>some other element
 *     <li><ul>
 *       <li>yet some other element
 *     </ul>
 *   </ul>
 * </ul>
 */

Mặc dù JavaDoc vay mượn từ HTML, nhưng nó không phải là HTML và bạn nên bỏ qua các </li>thẻ, cũng như bạn nên bỏ qua </p>các thẻ.


1
Bất kỳ tài liệu tham khảo nào cho việc bỏ qua các thẻ đóng?
Friederbluemle

1
Có, đây: oracle.com/technetwork/java/javase/documentation/… - mặc dù nó ngầm chứ không phải rõ ràng.
Mức độ nghiêm trọng: Một

Không hiểu tại sao câu trả lời này không có nhiều ủng hộ hơn.
John Smith

8

Danh sách lồng nhau phải nằm trong danh sách riêng của nó <li>. <ul>không phải là một phần tử con hợp lệ của <ul>.

Vì vậy, ví dụ của bạn sẽ là:

<ul>
  <li>some element</li>
  <li>
    <ul>
      <li>some other element</li>
      <li>
        <ul>
          <li>yet some other element</li>
        </ul>
      </li>
    </ul>
  </li>
</ul>

Mã của bạn dẫn đến một danh sách với các mục trống. Mặc dù nó được lồng đúng cách trong HTML, nhưng kết quả hiển thị rất xấu.
naXa
Khi sử dụng trang web của chúng tôi, bạn xác nhận rằng bạn đã đọc và hiểu Chính sách cookieChính sách bảo mật của chúng tôi.
Licensed under cc by-sa 3.0 with attribution required.