Skip to content

리스트 (List)

리스트 컴포넌트는 여러개의 아이템을 효율적으로 나타내주는 컴포넌트로, 사용자에게 목록 형태의 정보를 제공합니다.

Overview

리스트 레이아웃과 리스트 아이템 스타일 조정, 모서리 둥글기, 패딩 조절 등 다양한 옵션을 지원합니다,

Usage

리스트 컴포넌트는 ul 요소에 n-list 클래스를 적용하고, 각 아이템은 li 요소로 표현합니다. 이 구조를 통해 리스트를 구현할 수 있습니다.

사용법

  • content
  • content
  • content
html
<ul class="n-list">
  <li>content</li>
  <li>content</li>
  <li>content</li>
</ul>

Bar List

가로 방향으로 배열된 리스트입니다. n-list 클래스와 함께 n-bar-list 클래스를 사용하여 레이아웃을 적용할 수 있습니다.

사용법

  • content
  • content
  • content
html
<ul class="n-list n-bar-list">
  <li>content</li>
  <li>content</li>
  <li>content</li>
</ul>

Card List

카드 레이아웃 리스트입니다. 반응형 디자인에 따라 레이아웃이 조정됩니다. n-list 클래스와 함께 n-card-list 클래스를 사용하여 레이아웃을 적용할 수 있습니다.

사용법

  • content
  • content
  • content
html
<ul class="n-list n-card-list">
  <li>content</li>
  <li>content</li>
  <li>content</li>
</ul>

변수

반응형에 따라 개수를 조절할 수 있는 변수를 제공합니다.

css
.n-list {
  --card-list-column-sm: 1; /* 모바일에서 컬럼 수 */
  --card-list-column-md: 2; /* 태블릿에서 컬럼 수 */
  --card-list-column-lg: 3; /* PC에서 컬럼 수 */
}

Tile List

타일 리스트 레이아웃입니다. n-list 클래스와 함께 n-tile-list 클래스를 사용하여 레이아웃을 적용할 수 있습니다.

사용법

  • content
  • content
  • content
  • content
html
<ul class="n-list n-tile-list">
  <li>content</li>
  <li>content</li>
  <li>content</li>
</ul>

size

n-tile-size:레벨 클래스를 함께 사용하여 각 요소의 크기를 변경할 수 있습니다.

Tile list size

  • content
  • content
  • content
  • content
  • content
  • content
  • content
  • content
  • content
  • content
  • content
  • content
code
html
<ul class="n-list n-tile-list n-tile-size:1">
  <li>content</li>
  <li>content</li>
  <li>content</li>
</ul>

<ul class="n-list n-tile-list n-tile-size:2">
  <li>content</li>
  <li>content</li>
  <li>content</li>
</ul>

<ul class="n-list n-tile-list n-tile-size:3">
  <li>content</li>
  <li>content</li>
  <li>content</li>
</ul>

변수

타일의 사이즈를 조절할 수 있는 변수를 제공합니다.

css
.n-list {
  --tile-size: 80px; /* 기본  */
  --tile-size-1: 80px;
  --tile-size-2: 100px;
  --tile-size-3: 120px;
}

Tag List

태그 레이아웃의 리스트입니다. n-list 클래스와 함께 n-tag-list 클래스를 사용하여 레이아웃을 적용할 수 있습니다. active 클래스를 사용하여 활성화된 태그를 나타낼 수 있습니다.

Tag list

  • content
  • content
  • content
html
<ul class="n-list n-tag-list">
  <li class="active">content</li>
  <li>content</li>
  <li>content</li>
</ul>

size

n-tag-size:레벨 클래스를 함께 사용하여 각 요소의 크기를 변경할 수 있습니다.

Tag list size

  • content
  • content
  • content
  • content
  • content
  • content
  • content
  • content
  • content
code
html
<ul class="n-list n-tag-list n-tag-size:1">
  <li class="active">content</li>
  <li>content</li>
  <li>content</li>
</ul>

<ul class="n-list n-tag-list n-tag-size:2">
  <li class="active">content</li>
  <li>content</li>
  <li>content</li>
</ul>

<ul class="n-list n-tag-list n-tag-size:3">
  <li class="active">content</li>
  <li>content</li>
  <li>content</li>
</ul>

변수

태그의 사이즈를 조절할 수 있는 변수를 제공합니다.

css
.n-list {
  --tag-height: 32px; /* 기본 높이 */
  --tag-height-1: 24px;
  --tag-height-2: 32px;
  --tag-height-3: 40px;

  --tag-padding: 12px; /* 기본 패딩 */
  --tag-padding-1: 8px;
  --tag-padding-2: 12px;
  --tag-padding-3: 16px;
}

Item Type

리스트 아이템에 반복적으로 스타일을 적용하는 것은 번거로울 수 있습니다. 이를 간소화하기 위해, 다양한 아이템 타입 클래스를 제공하여 쉽게 스타일을 변경할 수 있습니다.

각 아이템별 스타일은 아이템 타입에서도 확인하실 수 있습니다.

사용법

  • outline-box
  • outline-box
  • outline-box
  • outline-none
  • outline-none
  • outline-none
  • shadow
  • shadow
  • shadow
  • underline
  • underline
  • underline
code
html
<ul class="n-list n-list-item-type:outline-box">
  <li>outline-box</li>
  <li>outline-box</li>
  <li>outline-box</li>
</ul>

<ul class="n-list n-list-item-type:outline-none">
  <li>outline-none</li>
  <li>outline-none</li>
  <li>outline-none</li>
</ul>

<ul class="n-list n-list-item-type:shadow">
  <li>shadow</li>
  <li>shadow</li>
  <li>shadow</li>
</ul>

<ul class="n-list n-list-item-type:underline gap:0">
  <li>underline</li>
  <li>underline</li>
  <li>underline</li>
</ul>
클래스약어 클래스
n-list n-list-item-type:outline-box
n-list n-list-item-type:outline
n-list n-list-item:outline-box
n-list n-list-item:outline
n-list n-list-item-type:outline-nonen-list n-list-item:outline-none
n-list n-list-item-type:shadown-list n-list-item:shadow
n-list n-list-item-type:underlinen-list n-list-item:underline

Item Border Radius

n-list-item-border-radius:값 또는 n-list-item-bd-radius:값 약어 클래스를 사용하여, 모든 아이템의 border-radius를 조절할 수 있습니다. 이를 통해 디자인의 일관성을 유지하면서, 필요에 따라 개별 아이템의 외관을 조정할 수 있습니다.

아이템 모서리 둥글기

  • bd-radius:0
  • bd-radius:1
  • bd-radius:2
  • bd-radius:3
  • bd-radius:4
  • bd-radius:5
  • bd-radius:full
code
html
<ul class="n-list n-list-item-border-radius:0">
  <li>bd-radius:0</li>
</ul>

<ul class="n-list n-list-item-border-radius:1">
  <li>bd-radius:1</li>
</ul>

<ul class="n-list n-list-item-border-radius:2">
  <li>bd-radius:2</li>
</ul>

<ul class="n-list n-list-item-border-radius:3">
  <li>bd-radius:3</li>
</ul>

<ul class="n-list n-list-item-border-radius:4">
  <li>bd-radius:4</li>
</ul>

<ul class="n-list n-list-item-border-radius:5">
  <li>bd-radius:5</li>
</ul>

<ul class="n-list n-list-item-border-radius:full">
  <li>bd-radius:full</li>
</ul>

다음 변수를 재정의하여 목록 아이템의 border-radius를 변경할 수 있습니다.

css
.n-list {
  --list-item-border-radius: 16px; /* 기본 */
  --list-item-border-radius-0: 0;
  --list-item-border-radius-1: 4px;
  --list-item-border-radius-2: 8px;
  --list-item-border-radius-3: 12px;
  --list-item-border-radius-4: 16px;
  --list-item-border-radius-5: 20px;
  --list-item-border-radius-full: 9999px;
}

Item Padding

n-list-item-padding:값 또는 n-list-item-p:값 약어 클래스를 통해, 모든 아이템의 padding을 조절할 수 있습니다.

아이템 패딩

  • padding:0
  • padding:0
  • padding:0
  • padding:1
  • padding:1
  • padding:1
  • padding:2
  • padding:2
  • padding:2
  • padding:3
  • padding:3
  • padding:3
  • padding:4
  • padding:4
  • padding:4
code
html
<ul class="n-list n-list-item-padding:0">
  <li>padding:0</li>
  <li>padding:0</li>
  <li>padding:0</li>
</ul>

<ul class="n-list n-list-item-padding:1">
  <li>padding:1</li>
  <li>padding:1</li>
  <li>padding:1</li>
</ul>

<ul class="n-list n-list-item-padding:2">
  <li>padding:2</li>
  <li>padding:2</li>
  <li>padding:2</li>
</ul>

<ul class="n-list n-list-item-padding:3">
  <li>padding:3</li>
  <li>padding:3</li>
  <li>padding:3</li>
</ul>

<ul class="n-list n-list-item-padding:4">
  <li>padding:4</li>
  <li>padding:4</li>
  <li>padding:4</li>
</ul>
클래스약어 클래스
n-list n-list-item-padding:0n-list n-list-item-p:0
n-list n-list-item-padding:1n-list n-list-item-p:1
n-list n-list-item-padding:2n-list n-list-item-p:2
n-list n-list-item-padding:3n-list n-list-item-p:3
n-list n-list-item-padding:4n-list n-list-item-p:4

다음 변수를 재정의하여 목록 아이템의 padding을 변경할 수 있습니다.

css
.n-list {
  --list-item-padding: 24px; /* 기본 */
  --list-item-padding-0: 0;
  --list-item-padding-1: 8px;
  --list-item-padding-2: 16px;
  --list-item-padding-3: 24px;
  --list-item-padding-4: 32px;
}

TIP

컴포넌트 커스터마이징에 대한 자세한 내용은 컴포넌트 커스터마이징하기에서 확인하실 수 있습니다.

Eaxmple

예시

  • americano
    americano
    $4.00
  • americano
    cappuccino
    $5.00
  • americano
    latte
    $5.00
code
html
<ul class="n-list n-list-item:shadow">
  <li class="d:flex">
    <div class="h:2 w:2 bd-radius:3 of:hidden">
      <img
        alt="americano"
        src="/coffe_americano.png"
        class="h:100p w:100p obj-fit:cover" />
    </div>
    <div class="ml:6">
      <div class="n-font:subtitle">americano</div>
      <div class="color:base-7 font-weight:2">$4.00</div>
    </div>
  </li>
  <li class="d:flex">
    <div class="h:2 w:2 bd-radius:3 of:hidden">
      <img
        alt="americano"
        src="/coffe_cappuccino.png"
        class="h:100p w:100p obj-fit:cover" />
    </div>
    <div class="ml:6">
      <div class="n-font:subtitle">cappuccino</div>
      <div class="color:base-7 font-weight:2">$5.00</div>
    </div>
  </li>
  <li class="d:flex">
    <div class="h:2 w:2 bd-radius:3 of:hidden">
      <img
        alt="americano"
        src="/coffe_latte.png"
        class="h:100p w:100p obj-fit:cover" />
    </div>
    <div class="ml:6">
      <div class="n-font:subtitle">latte</div>
      <div class="color:base-7 font-weight:2">$5.00</div>
    </div>
  </li>
</ul>