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 상단 앱 바
함수
독립 패키지

Icon아이콘

아이콘은 일반적인 작업을 나타내는 데 사용됩니다. Material Icons 아이콘과 SVG 아이콘 사용을 지원합니다.

사용법

컴포넌트 가져오기:

import 'mdui/components/icon.js';

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

import type { Icon } from 'mdui/components/icon.js';

사용 예시:

<mdui-icon name="search"></mdui-icon>

Material Icons 아이콘 사용하기

이 컴포넌트를 통해 Material Icons 아이콘을 사용하려면 Material Icons의 CSS 파일을 별도로 가져와야 합니다. Material Icons는 총 5가지 변형(Filled, Outlined, Rounded, Sharp, Two Tone)이 있으므로, 사용하려는 아이콘 변형에 해당하는 CSS 파일을 가져오세요:

<!-- Filled -->
<link
  href="https://fonts.googleapis.com/icon?family=Material+Icons"
  rel="stylesheet"
/>

<!-- Outlined -->
<link
  href="https://fonts.googleapis.com/icon?family=Material+Icons+Outlined"
  rel="stylesheet"
/>

<!-- Rounded -->
<link
  href="https://fonts.googleapis.com/icon?family=Material+Icons+Round"
  rel="stylesheet"
/>

<!-- Sharp -->
<link
  href="https://fonts.googleapis.com/icon?family=Material+Icons+Sharp"
  rel="stylesheet"
/>

<!-- Two Tone -->
<link
  href="https://fonts.googleapis.com/icon?family=Material+Icons+Two+Tone"
  rel="stylesheet"
/>

컴포넌트 사용 시 name 속성에 아이콘 이름을 전달하고 아이콘 변형 이름을 접미사로 붙입니다(Filled 변형은 접미사 불필요). 아래는 delete 아이콘의 5가지 변형 사용 방식입니다:

<!-- Filled -->
<mdui-icon name="delete"></mdui-icon>

<!-- Outlined -->
<mdui-icon name="delete--outlined"></mdui-icon>

<!-- Rounded -->
<mdui-icon name="delete--rounded"></mdui-icon>

<!-- Sharp -->
<mdui-icon name="delete--sharp"></mdui-icon>

<!-- Two Tone -->
<mdui-icon name="delete--two-tone"></mdui-icon>

페이지 하단의 Material Icons 아이콘 검색 도구에서 아이콘을 직접 검색하고, 사용하려는 아이콘을 클릭하면 아이콘 코드가 자동으로 클립보드에 복사됩니다.

또한 mdui는 별도의 패키지 @mdui/icons를 제공합니다. 이 패키지의 각 아이콘 컴포넌트는 독립적인 파일로 구성되어 있어, 전체 아이콘 라이브러리를 가져올 필요 없이 필요한 아이콘 컴포넌트만 가져와서 사용합니다.

SVG 아이콘 사용하기

이 컴포넌트는 SVG 아이콘을 아이콘 내용으로 사용하는 것도 지원합니다. 컴포넌트의 src 속성으로 SVG 아이콘 링크를 전달할 수 있습니다. 예시:

<mdui-icon src="https://fonts.gstatic.com/s/i/materialicons/search/v17/24px.svg"></mdui-icon>

컴포넌트의 default 슬롯에 SVG 내용을 전달할 수도 있습니다. 예시:

<mdui-icon>
  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
    <path d="M0 0h24v24H0z" fill="none"/>
    <path d="M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/>
  </svg>
</mdui-icon>

예시

색상 설정

<mdui-icon> 요소나 부모 요소의 color CSS 스타일을 설정하여 아이콘 색상을 변경합니다.

크기 설정

<mdui-icon> 요소나 부모 요소의 font-size CSS 스타일을 설정하여 아이콘 크기를 변경합니다.

API

속성

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

Material Icons 아이콘 이름입니다.

srcsrcstring-

svg 아이콘의 경로입니다.

Slots

이름
기본

svg 아이콘의 콘텐츠

FilledOutlinedRoundedSharpTwo tone
<mdui-icon name=""></mdui-icon>
이 페이지의 목차