Javadoc에서 여러 수준의 들여 쓰기를 만드는 방법은 무엇입니까?


88

코드 (Javadoc) 문서화의 일부로 깊은 들여 쓰기를 사용하여 요소 간의 관계를 표시하려고한다고 가정하십시오.

다음과 같이 중첩 된 목록을 만들려면 어떻게해야합니까?

  • 일부 요소
    • 다른 요소
      • 아직 다른 요소

답변:


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

javadoc 주석 내에서 HTML을 자유롭게 사용할 수 있습니다.

업데이트 : 나왔기 때문에 시도했습니다

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

그리고 얻다

  • 하나
    • 1 점 1

적절한 중첩이 더 낫다는 데 동의합니다.


2
중첩 된 <ul>은 일부 <li> 요소 안에 있어야한다고 말하고 싶습니다. 비교를 위해 w3.org/wiki/HTML_lists#Nesting_lists
user2622016

당신은 그렇게 말할 수 있지만 그것을 시도하는 것은 다른 것을 말합니다.
Charlie Martin

1
@Charlie "적절한 중첩이 더 낫다는 데 동의합니다."라고 말하는 대신, 적절하게 중첩하는 방법을 보여주는 예제를 작성할 수 있습니까? 그렇지 않으면 일부 초보자는 귀하의 의견을 이해하지 못하고 위에서 언급 한 양식을 사용합니다.
Rauni Lillemets 2014

2
user2622016은 <ul> <li> <ul> ... </ ul> </ li> </ ul>와 같이 작성해야한다는 것을 이해했습니다. 따라서 가장 안쪽에있는 <ul> .. </ ul >도 <li> .. </ li> 블록 안에 있습니다.
Rauni Lillemets 2014

1
명시 적으로 언급 된 것을 찾을 수는 없지만 (그리고 살펴 봤지만) Oracle 문서에 사용 된 스타일입니다 . 또한 NetBeans는 이에 대해 불평합니다. IntelliJ에, 다른 한편으로는, 행복하게 추가 </li>태그
SeverityOne

28

올바른 방법은 다음과 같습니다.

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

JavaDoc은 HTML에서 차용하지만 HTML이 아니므 </li></p>태그 를 생략해야하는 것처럼 태그 를 생략해야 합니다.


1
닫는 태그 생략에 대한 언급이 있습니까?
friederbluemle

1
예, 여기 : oracle.com/technetwork/java/javase/documentation/…- 명시 적이기보다는 암시 적이지만.
SeverityOne

이 답변에 더 이상 찬성표가없는 이유를 이해하지 못합니다.
John Smith

8

중첩 된 목록은 자체 <li>. <ul>의 유효한 하위 요소가 아닙니다 <ul>.

따라서 귀하의 예는 다음과 같습니다.

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

코드는 빈 항목이있는 목록을 생성합니다. HTML에 적절하게 중첩되어 있지만 렌더링 된 결과는보기 흉합니다.
naXa
당사 사이트를 사용함과 동시에 당사의 쿠키 정책개인정보 보호정책을 읽고 이해하였음을 인정하는 것으로 간주합니다.
Licensed under cc by-sa 3.0 with attribution required.