MDUI문서
llms.txt 링크 복사llms-full.txt 링크 복사이 페이지를 Markdown 형식으로 보기ChatGPT와 이 페이지 내용에 대해 논의하기프로젝트 전체 문서에 대해 ChatGPT와 논의하기
프리셋 색상
사용자 지정 색상
배경화면에서 색상 추출
배경화면을 선택해 주세요
개발 가이드
AI 보조 개발
스타일
프레임워크와 통합
컴포넌트
Avatar 아바타Badge 배지BottomAppBar 하단 앱 바Button 버튼ButtonIcon 아이콘 버튼Card 카드Checkbox 체크박스Chip CircularProgress 원형 프로그레스Collapse 접기Dialog 다이얼로그Divider 구분선Dropdown 드롭다운Fab 플로팅 액션 버튼Icon 아이콘Layout 레이아웃LinearProgress 선형 프로그레스List 목록Menu 메뉴NavigationBar 내비게이션 바NavigationDrawer 내비게이션 드로어NavigationRail 내비게이션 레일Radio 라디오RangeSlider 범위 슬라이더Select 셀렉트SegmentedButton 세그먼트 버튼Slider 슬라이더Snackbar 스낵바Switch 스위치Tabs TextField 텍스트 필드Tooltip 툴팁TopAppBar 상단 앱 바
함수
독립 패키지

Snackbar스낵바

스낵바 컴포넌트는 페이지에 간단한 애플리케이션 프로세스 정보를 표시할 때 사용합니다.

컴포넌트를 직접 사용하는 것 외에도 mdui는 mdui.snackbar 함수를 제공하여 Snackbar 컴포넌트 사용을 간소화할 수 있습니다.

사용법

컴포넌트 가져오기:

import 'mdui/components/snackbar.js';

컴포넌트의 TypeScript 타입 가져오기:

import type { Snackbar } from 'mdui/components/snackbar.js';

사용 예시:

Photo archived Snackbar 열기
<mdui-snackbar class="example-snackbar">Photo archived</mdui-snackbar>

<mdui-button>Snackbar 열기</mdui-button>

<script>
  const snackbar = document.querySelector(".example-snackbar");
  const openButton = snackbar.nextElementSibling;

  openButton.addEventListener("click", () => snackbar.open = true);
</script>

예시

위치

placement 속성으로 Snackbar의 표시 위치를 설정할 수 있습니다.

작업 버튼

action 속성을 사용해 Snackbar 오른쪽에 작업 버튼을 추가하고, 이 속성으로 버튼의 텍스트를 지정할 수 있습니다. 작업 버튼을 클릭하면 action-click 이벤트가 트리거됩니다. 작업 버튼을 로딩 중 상태로 표시하려면 action-loading 속성을 추가합니다.

action 슬롯을 통해 Snackbar 오른쪽에 사용자 정의 요소를 추가할 수도 있습니다.

닫기 가능

closeable 속성을 추가하면 Snackbar 오른쪽에 닫기 버튼이 나타납니다. 이 버튼을 클릭하면 Snackbar가 닫히고 close 이벤트가 트리거됩니다.

close-button 슬롯을 통해 닫기 버튼의 요소를 사용자 정의할 수 있습니다.

close-icon 속성을 설정하여 기본 닫기 버튼의 Material Icons 아이콘을 수정할 수 있습니다. close-icon 슬롯을 통해 닫기 버튼의 아이콘 요소를 사용자 정의할 수도 있습니다.

텍스트 행 수

기본적으로 메시지 텍스트는 행 수 제한이 없습니다. message-line 속성으로 텍스트 행 수를 제한할 수 있으며, 최대 2행까지 설정할 수 있습니다.

자동 닫힘 지연 시간

auto-close-delay 속성을 사용해 자동 닫힘 지연 시간을 설정할 수 있습니다. 단위는 밀리초이며, 기본값은 5000밀리초입니다.

외부 영역 클릭 시 닫기

close-on-outside-click 속성을 추가하면 Snackbar 외부 영역을 클릭할 때 Snackbar를 닫을 수 있습니다.

API

속성

HTML 속성JavaScript 프로퍼티Reflect유형기본값
openopenbooleanfalse

스낵바를 표시할지 여부를 설정합니다.

placementplacement'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end''bottom'

스낵바의 표시 위치입니다. 기본값은 bottom입니다. 사용 가능한 값:

  • top: 상단 중앙
  • top-start: 상단 왼쪽 정렬
  • top-end: 상단 오른쪽 정렬
  • bottom: 하단 중앙
  • bottom-start: 하단 왼쪽 정렬
  • bottom-end: 하단 오른쪽 정렬
actionactionstring-

작업 버튼의 텍스트입니다. slot="action"을 통해 작업 버튼을 설정할 수도 있습니다.

action-loadingactionLoadingbooleanfalse

작업 버튼을 로딩할지 여부를 설정합니다.

closeablecloseablebooleanfalse

오른쪽에 닫기 버튼을 표시할지 여부를 설정합니다.

close-iconcloseIconstring-

닫기 버튼의 Material Icons 아이콘 이름입니다. slot="close-icon"을 통해서도 설정할 수 있습니다.

message-linemessageLine1 | 2-

메시지 텍스트의 최대 표시 줄 수입니다. 기본값은 제한 없음입니다. 사용 가능한 값:

  • 1: 최대 한 줄 표시
  • 2: 최대 두 줄 표시
auto-close-delayautoCloseDelaynumber5000

자동 닫힘 지연 시간(밀리초)입니다. 0으로 설정하면 자동으로 닫히지 않습니다. 기본값은 5000밀리초입니다.

close-on-outside-clickcloseOnOutsideClickbooleanfalse

스낵바 외부 영역을 클릭하거나 터치할 때 스낵바를 닫을지 여부를 설정합니다.

이벤트

이름
open

스낵바 표시가 시작될 때 발생합니다. event.preventDefault()를 호출하여 스낵바 표시를 막을 수 있습니다.

opened

스낵바 표시 애니메이션이 완료되면 발생합니다.

close

스낵바 숨김이 시작될 때 발생합니다. event.preventDefault()를 호출하여 스낵바 닫힘을 막을 수 있습니다.

closed

스낵바 숨김 애니메이션이 완료되면 발생합니다.

action-click

작업 버튼을 클릭할 때 발생합니다.

Slots

이름
기본

스낵바의 메시지 텍스트 콘텐츠

action

오른쪽의 작업 버튼

close-button

오른쪽의 닫기 버튼. closeable 속성이 true로 설정되어야 표시됩니다.

close-icon

닫기 버튼 내의 아이콘

CSS Parts

이름
message

메시지 텍스트

action

작업 버튼

close-button

닫기 버튼

close-icon

닫기 버튼 내의 아이콘

CSS 사용자 정의 속성

이름
--shape-corner

컴포넌트의 둥근 모서리 크기입니다. 구체적인 픽셀 값을 지정할 수 있지만, 디자인 토큰을 참조하는 것을 권장합니다.

--z-index

컴포넌트의 CSS z-index

이 페이지의 목차