Web Components 카드 개요

    Ignite UI for Web Components 카드는 텍스트, 이미지, 아이콘 및 단추를 시각적으로 풍부한 프레젠테이션으로 표시하여 보다 자세한 정보에 대한 진입점 역할을 할 수 있습니다. 카드를 사용하여 멀티미디어 대시보드를 만들 수 있습니다.

    Web Components Card Example

    EXAMPLE
    TS
    HTML
    CardOverview.css
    index.css
    Edit in:

    Like this sample? Get access to our complete Ignite UI for Web Components toolkit and start building your own apps in minutes. Download it for free.

    Usage

    카드를 사용하면 다양한 유형의 개체 또는 크기와 지원되는 작업이 다를 수 있는 유사한 개체로 구성된 콘텐츠를 쉽게 표시할 수 있습니다.

    시작하기

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

    npm install igniteui-webcomponents
cmd
    import { defineComponents, IgcCardComponent } from 'igniteui-webcomponents';

defineComponents(IgcCardComponent );
ts

    Ignite UI for Web Components에 대한 전체 소개를 보려면 시작하기 항목을 읽어보세요.

    그런 다음 데모 카드 템플릿을 나타내기 위해 다음 코드를 추가할 수 있습니다.

    <igc-card>
    <igc-card-media>
        <img src="https://images.unsplash.com/photo-1518235506717-e1ed3306a89b?ixlib=rb-1.2.1&auto=format&fit=crop&w=640&q=50">
    </igc-card-media>

    <igc-card-header>
        <h3 slot="title">New York</h3>
        <h5 slot="subtitle">City in New York</h5>
    </igc-card-header>

    <igc-card-content>
        <p>New York City comprises 5 boroughs sitting where the Hudson River meets the Atlantic Ocean. At its core is Manhattan, a densely populated borough that’s among the world’s major commercial, financial and cultural centers.</p>
    </igc-card-content>

    <igc-card-actions>
        <igc-button slot="start">
            <igc-ripple></igc-ripple>
            Read more
        </igc-button>
        <div slot="end">
            <igc-icon-button name="twitter" style="margin-right: 10px;">
                <igc-ripple></igc-ripple>
            </igc-icon-button>
            <igc-icon-button name="facebook">
                <igc-ripple></igc-ripple>
            </igc-icon-button>
        </div>
    </igc-card-actions>
</igc-card>
html

    위에서 몇 가지 사항을 확인할 수 있습니다. 첫째, 우리가 원할 때 꼬리표 헤더 제목과 같은 요소 h3 제목 사이에 배치합니다. IgcCardHeaderComponent 태그를 지정하고 슬롯 이름을 다음으로 설정합니다. title. 반대로, 다른 제목 요소를 subtitle 슬롯 이름을 지정하겠습니다. subtitle.

    카드에 표시하려는 이미지나 비디오는 IgcCardMediaComponent 태그 안에 포함됩니다. IgcCardMediaComponent를 사용하면 요소의 전체 콘텐츠 상자를 채우는 동안 가로 세로 비율을 유지하도록 내부에 배치된 콘텐츠의 크기를 조정할 수 있습니다. 개체의 가로 세로 비율이 상자의 가로 세로 비율과 일치하지 않으면 개체가 맞게 잘립니다.

    ​IgcCardContentComponent 태그 안에 무엇이든 배치할 수 있습니다. 일반적으로 텍스트가 거기로 이동합니다.

    마지막으로 IgcCardActionsComponent는 버튼과 같은 실행 가능한 항목을 배치하는 곳입니다.

    Media, Thumbs, and Avatars

    제목과 부제 옆의 카드 헤더에 이미지나 아이콘을 표시하려면 요소의 슬롯 속성을 thumbnail에 할당하면 됩니다.

    위의 카드를 예로 들면 IgcCardHeaderComponent의 콘텐츠를 편집하고 slot="thumbnail" 사용하여 아바타를 추가할 수 있습니다.

    <igc-card-header>
    <igc-avatar slot="thumbnail" src="path/to/image" initials="TS"></igc-avatar>

    <h3 slot="title">Title</h3>
    <h5 slot="subtitle">Subtitle</h5>
</igc-card-header>
html

    위의 예에서는 카드 헤더의 제목 및 부제와 함께 아바타를 표시합니다.

    Outlined cards

    카드에는 설정된 경우 카드에서 그림자를 제거하고 얇은 테두리로 대체하여 카드를 배경과 분리하는 outlined 속성이 있습니다.

    Horizontal Layout

    기본적으로 카드의 모든 섹션(헤더, 콘텐츠, 미디어, 작업)은 수직으로 배치됩니다. 수직 공간이 많을 때 좋습니다. 카드의 섹션을 수평으로 배치하고 싶다고 가정해 보겠습니다. 간단한 CSS를 사용하여 이러한 레이아웃을 구현할 수 있습니다.

    다음은 윤곽선이 있는 가로 카드의 예입니다.

    <igc-card outlined>
    <div class="card-horizontal">
        <div>
            <igc-card-header>
                <img src="ROZES-Under-the-Grave.jpg" slot="thumbnail">
                <h5 slot="title">Rozes</h5>
                <h5 slot="subtitle">Under the Grave (2016)</h5>
            </igc-card-header>
            <igc-card-content>
                <p>As I have always said: I write what’s real and what’s true,
                    even if it means throwing myself under the bus.</p>
            </igc-card-content>
        </div>
        <div class="divider"></div>
        <igc-card-actions>
            <igc-icon-button name="previous"></igc-icon-button>
            <igc-icon-button name="play"></igc-icon-button>
            <igc-icon-button name="next"></igc-icon-button>
        </igc-card-actions>
    </div>
</igc-card>
html

    추가 div 요소를 사용하여 IgcCardHeaderComponent 및 IgcCardContentComponent 함께 묶고 수직 정렬을 유지하며 래핑 div 요소에.card-horizontal 클래스를 적용하여 카드의 두 섹션을 수평으로 정렬합니다.

    ​.card-horizontal 클래스가 적용되는 스타일은 다음과 같습니다.

    .card-horizontal {
    display: flex;
    flex-direction: row;
    flex: 1 1 0%;
}

.card-horizontal img {
    width: 64px;
    height: 64px;
}

.card-horizontal igc-card-actions {
    justify-content: center;
}
css

    모든 것이 순조롭게 진행되었다면 카드는 다음과 같아야 합니다.

    EXAMPLE
    TS
    HTML
    CardHorizontal.css
    index.css
    Edit in:

    Alternative layouts

    ​IgcCardComponent 레이아웃을 사용하면 더욱 창의적으로 작업할 수 있습니다.

    다음은 카드의 모든 섹션이 수직으로 배치되고 IgcCardMediaComponent 수직 섹션 옆에 나타나는 반수평 카드를 만드는 방법을 보여주는 예입니다.

    <igc-card>
    <div class="semi-horizontal">
        <div>
            <igc-card-header>
                <igc-avatar src="mellow_d.jpg" slot="thumbnail">MD</igc-avatar>
                <h5 slot="title">HERE</h5>
                <h5 slot="subtitle">by Mellow D</h5>
            </igc-card-header>
            <igc-card-content>
                <p>Far far away, behind the word mountains,
                    far from the countries Vokalia and Consonantia,
                    there live the blind texts.</p>
            </igc-card-content>
            <igc-card-actions>
                <igc-button>play album</igc-button>
            </igc-card-actions>
        </div>
        <igc-card-media class="card-media">
            <img src="here_media.jpg">
        </igc-card-media>
    </div>
</igc-card>
html
    .semi-horizontal {
    display: flex;
    flex-direction: row;
    flex-grow: 1;
}

.card-media {
    width: 96px;
    min-width: 96px;
}
css

    EXAMPLE
    TS
    HTML
    index.css
    SemiHorizontal.css
    Edit in:

    Card Actions

    카드 작업 영역에서는 이미 언급한 내용에 대한 추가 구성을 허용합니다.

    슬롯 이름을 전환하여 텍스트 버튼과 아이콘 버튼의 순서를 바꿀 수 있습니다.

    <igc-card-actions>
    <igc-button slot="end">
        <igc-ripple></igc-ripple>
        Read more
    </igc-button>
    <div slot="start">
        <igc-icon-button name="twitter">
            <igc-ripple></igc-ripple>
        </igc-icon-button>
        <igc-icon-button name="facebook">
            <igc-ripple></igc-ripple>
        </igc-icon-button>
    </div>
</igc-card-actions>
html

    이제 아이콘 버튼이 텍스트 버튼 앞에 나타납니다.

    간단히 슬롯 속성을 생략하고 요소가 기본 슬롯으로 이동하도록 하여 그 사이에 더 많은 콘텐츠를 추가할 수도 있습니다.

    Ignite UI for Web Components | CTA Banner

    Styling

    카드는 서로 다른 요소를 래핑하는 컨테이너이기 때문에 스타일링은 빌딩 블록(the IgcCardHeaderComponent, IgcCardContentComponent,, IgcCardMediaComponent​ ​IgcCardActionsComponent 및 sub-components)의 스타일을 지정하여 수행됩니다.

    igc-card {
  background-color: var(--ig-secondary-900);
}

igc-card-content,
igc-card-header::part(title) { 
  color: var(--ig-primary-500-contrast);
}

igc-card-header > *[slot="subtitle"] {
  color: var(--ig-warn-500);
  opacity: 0.9;
}

igc-icon-button::part(base) {
  background-color: var(--ig-primary-300);
}
css

    EXAMPLE
    TS
    HTML
    CardStyling.css
    index.css
    Edit in:

    Summary

    이 기사에서는 카드 구성 요소에 대해 많은 부분을 다루었습니다. 간단한 카드를 만들고 몇 가지 이미지를 추가하여 좀 더 매력적으로 만들었습니다. 카드 내부에 아바타, 버튼, 아이콘과 같은 추가 Web Components 사용하여 경험을 풍부하게 하고 몇 가지 기능을 추가했습니다. 마지막으로 빌딩 블록의 주요 색상을 변경하여 카드의 모양을 변경했습니다.

    API References

    Additional Resources