Skip to content

Tooltip 개요

App Builder의 Tooltip 구성 요소를 통해 사용자가 애플리케이션의 대상 요소 위에 마우스를 올리거나 포커스할 때 상황별 도움말이나 보충 정보를 표시할 수 있습니다. Tooltip은 Properties 패널을 통해 시각적으로 구성되며 코드를 작성하지 않고도 트리거 및 콘텐츠를 모두 사용자 정의할 수 있습니다.

Tooltip은 기본 Ignite UI Tooltip 구성 요소를 사용하며 Angular, React, Blazor 및 Web Components를 위한 깔끔한 프레임워크별 코드를 생성합니다.

주요 기능

구성 요소에 Tooltip 추가

Tooltip은 대상 구성 요소의 Properties 패널에서 직접 활성화됩니다. Tooltip을 연결하려면:

  1. Design Canvas에서 대상 구성 요소를 선택합니다.
  2. Properties 패널에서 Tooltip 섹션까지 스크롤합니다.
  3. Enable Tooltip을 켭니다.
  4. 표시되는 Edit Tooltip 링크를 클릭하여 Tooltip을 열고 해당 속성(Target, Mode, Show delay, Hide delay, Arrow)을 구성합니다.

또는 Components Toolbox에서 Tooltip을 드래그하거나 빠른 추가 바로 가기 Ctrl+E(Mac에서는 ⌘+E)를 사용하고 “Tooltip”을 검색하여 추가할 수 있습니다.

Tooltip 콘텐츠

Tooltip 콘텐츠를 변수 또는 연결된 데이터 원본의 데이터 필드에 바인딩하여 런타임에 동적이고 상황별로 인식하는 힌트를 활성화할 수 있습니다.

Show / Hide 지연

Tooltip의 반응성을 제어하려면 다음을 설정합니다.

  • Show delay — 사용자가 대상 위에 마우스를 올린 후 Tooltip이 나타나기 전의 시간(ms)입니다. 기본값은 300 ms입니다.
  • Hide delay — 커서가 대상을 떠난 후 Tooltip이 사라지기 전의 시간(ms)입니다. 기본값은 0 ms입니다.

이러한 지연은 사용 가능성을 개선하고 사용자가 여러 요소에 걸쳐 빠르게 커서를 이동할 때 Tooltip 깜박임을 방지합니다.

Mode

Mode 속성은 Tooltip이 닫히는 방식을 제어합니다.

  • Default — Tooltip이 마우스 호버/포커스 시 나타나고 커서 또는 포커스가 대상을 떠날 때 자동으로 닫힙니다.
  • Sticky — Tooltip은 사용자가 명시적으로 닫을 때까지 표시된 상태로 유지됩니다.

Arrow

방향 Arrow 표시기를 켜거나 끕니다. 활성화하면 Tooltip에서 대상 요소를 향해 작은 화살표가 가리켜 Tooltip과 대상 요소 간의 연결을 시각적으로 명확하게 합니다.

Tooltip 트리거

기본적으로 Tooltip은 호버(마우스) 및 포커스(키보드)에서 트리거됩니다. 이러한 이중 동작은 WCAG 지침에 따른 접근성 준수를 보장합니다.

지원되는 속성

속성설명
TargetTooltip이 연결된 구성 요소
ModeTooltip이 닫히는 방식: default(자동) 또는 sticky(수동)
Show delayTooltip이 표시되기 전의 지연(ms)입니다. 기본값은 300입니다.
Hide delayTooltip이 숨겨지기 전의 지연(ms)입니다. 기본값은 0입니다.
Arrow방향 화살표 표시기를 켜거나 끕니다.

접근성

Tooltip 구성 요소는 접근성을 고려하여 구축되었습니다.

  • 대상 요소는 Tooltip 콘텐츠에 연결하는 aria-describedby를 받습니다.
  • Tooltip은 포커스 이벤트를 통해 키보드로 접근할 수 있습니다.
  • 적절한 ARIA 역할을 통해 화면 판독기 지원이 제공됩니다.

코드 생성

App Builder는 시각적 구성을 기반으로 프레임워크별 Tooltip 코드를 생성합니다.

  • Angular: Ignite UI for Angular의 igxTooltip 및 igxTooltipTarget 지시문을 사용합니다.
  • React: Ignite UI for React의 IgrTooltip 구성 요소를 사용합니다.
  • Blazor: Ignite UI for Blazor의 IgbTooltip을 사용합니다.
  • Web Components: Ignite UI for Web Components의 igc-tooltip을 사용합니다.
Note

변수 또는 데이터 필드에 바인딩된 Tooltip 콘텐츠는 생성된 코드에 각 프레임워크별 동적 바인딩으로 반영됩니다.

알려진 문제 및 제한사항

  • 중첩된 Tooltip은 허용되지 않습니다.
  • 반복된 Tooltip 생성 코드:
    • Angular ✔️
    • React, Blazor, Web Components 🚧 — Tooltip이 반복된 대상에 올바르게 연결되지 않습니다.
  • 반복된 Select 항목의 Tooltip: 반복된 Select 항목에 연결된 Tooltip은 ng-container 래핑 Select 항목에 ngProjectAs 속성을 추가하지 않으면 Angular에서 작동하지 않습니다. 예를 들면:
<igx-select type="border" class="user-input">
  @for (item of northwindCategories; track item) {
    <ng-container ngProjectAs="igx-select-item">
      <igx-select-item value="Option" #selectItem [igxTooltipTarget]="tooltip4" [showDelay]="300" [hideDelay]="0">
        {{ item.name }}
      </igx-select-item>
      <div #tooltip4="tooltip" igxTooltip>
        <div class="column-layout group_1">
          <p class="ig-typography__body-2 text">
            {{ item.description }}
          </p>
        </div>
      </div>
    </ng-container>
  }
  <label igxLabel>Label/Placeholder</label>
</igx-select>

추가 자료