Web Components 버튼 그룹 개요

    Web Components 버튼 그룹 컴포넌트는 수평/수직 정렬, 단일 및 다중 선택 및 토글이 가능한 스타일 버튼 그룹으로 조직IgcToggleButtonComponent 하는 데 사용됩니다.

    Web Components Button Example

    Usage

    먼저 다음 명령을 실행하여 Ignite UI for Web Components 설치해야 합니다.

    npm install igniteui-webcomponents

    그 다음에는 필요한 CSS를 가져오IgcButtonGroupComponent 고, 그 모듈을 등록해야 합니다. 다음과 같습니다:

    import { defineComponents, IgcButtonGroupComponent } from "igniteui-webcomponents";
import 'igniteui-webcomponents/themes/light/bootstrap.css';

defineComponents(IgcButtonGroupComponent);

    Ignite UI for Web Components에 대한 완전한 소개는 '시작 주제'를 읽어보세요.

    이제 Ignite UI for Web Components 버튼 그룹을 가져왔으니, 기본IgcButtonGroupComponent 설정부터 시작할 수 있습니다.

    셀렉터를IgcButtonGroupComponent 사용해 s를 감싸IgcToggleButtonComponent 서 버튼 그룹으로 표시하세요. 버튼을 기본적으로 선택하고 싶다면, 다음selected 속성을 사용하세요:

     <igc-button-group>
    <igc-toggle-button value="left">
        <igc-icon name="format_align_left" collection="material"></igc-icon>
        <igc-ripple></igc-ripple>
    </igc-toggle-button>

    <igc-toggle-button value="center">
        <igc-icon name="format_align_center" collection="material"></igc-icon>
        <igc-ripple></igc-ripple>
    </igc-toggle-button>

    <igc-toggle-button value="right">
        <igc-icon name="format_align_right" collection="material"></igc-icon>
        <igc-ripple></igc-ripple>
    </igc-toggle-button>

    <igc-toggle-button value="justify" selected>
        <igc-icon name="format_align_justify" collection="material"></igc-icon>
        <igc-ripple></igc-ripple>
    </igc-toggle-button>
</igc-button-group>

    Examples

    Alignment

    이 속성을 사용alignment 해 버튼 그룹 내 버튼의 방향을 설정하세요.

    선택

    Ignite UI for Web ComponentsIgcButtonGroupComponent 선택을 설정하려면 그selection 특성 자체를 사용할 수 있습니다. 이 성질은 다음 세 가지 모드를 수용합니다:

    • 단일- 버튼 그룹의 기본 선택 모드입니다. 사용자는 하나의 버튼을 선택/선택 취소할 수 있습니다.
    • single-required- 라디오 그룹 동작을 모방합니다. 하나의 버튼만 선택할 수 있으며 초기 선택이 이루어지면 사용자 상호 작용을 통해 선택을 취소할 수 없습니다.
    • 여러 - 그룹에서 여러 버튼을 선택하거나 선택 취소할 수 있습니다.

    아래 샘플은 노출IgcButtonGroupComponent 된 선택 모드를 보여줍니다:

    AIgcToggleButtonComponent는 그selected 속성이나IgcButtonGroupComponent selectedItems 속성:

    <igc-button-group selected-items='["bold"]'>
    <igc-toggle-button value="bold">
        <igc-icon name="bold" collection="material"></igc-icon>
        <igc-ripple></igc-ripple>
    </igc-toggle-button>

    <igc-toggle-button value="italic">
        <igc-icon name="italic" collection="material"></igc-icon>
        <igc-ripple></igc-ripple>
    </igc-toggle-button>

    <igc-toggle-button value="underlined">
        <igc-icon name="underlined" collection="material"></igc-icon>
        <igc-ripple></igc-ripple>
    </igc-toggle-button>
</igc-button-group>

    [!Note] Setting IgcToggleButtonComponent value attribute is mandatory for using the selectedItems property of the IgcButtonGroupComponent.

    크기

    CSS 커스텀 속성은--ig-size 버튼 그룹 크기를 제어하는 데 사용할 수 있습니다.

    Styling

    이 컴포넌트는IgcButtonGroupComponent 버튼 그룹 컨테이너를 스타일링할 수 있게 해주는 CSS 파트를 노출합니다group. 또한 s는IgcToggleButtonComponent 버튼 요소를 스타일링하는 데 사용할 수 있는 CSS 부분을 제공합니다toggle.

    igc-button-group::part(group) {
  background-color: var(--ig-primary-500);
  padding: 8px;
}

igc-toggle-button::part(toggle) {
  color: var(--ig-secondary-300);
}

    API Reference

    Additional Resources