InY UI.
빌드 도구도, 프레임워크도 필요 없는 순수 HTML/CSS 컴포넌트 키트입니다. 다크·라이트 테마, 변수 하나로 바꾸는 브랜드 컬러, 키보드 접근성을 처음부터 담았습니다.
- 컴포넌트
- 27
- 외부 의존성
- 0
- 테마
- 2
- 브랜드 컬러 변수
- 1개
배포 설정
정상production · 마지막 배포 3분 전
시작하기
설치 #
파일 두 개를 프로젝트에 복사하고 링크하면 끝입니다. JS는 선택 사항이며, 모달 열기·토스트·탭 키보드 조작이 필요할 때만 추가하세요. 대부분의 컴포넌트는 JS 없이도 그대로 렌더링됩니다.
<!-- (선택) Pretendard 웹폰트 — 없으면 시스템 서체로 표시됩니다 -->
<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/orioncactus/[email protected]/dist/web/variable/pretendardvariable-dynamic-subset.min.css">
<!-- InY UI -->
<link rel="stylesheet" href="iny-ui.css">
<script src="iny-ui.js" defer></script>
<!-- (선택) 페이지 기본 배경·서체 적용 -->
<body class="iny-body">
iny-ui.css
54 KB · gzip 11 KBiny-ui.js 선택
15 KB · gzip 5 KB시작하기
테마 · 강조색 #
기본은 다크 테마입니다. <html data-theme="light">로 라이트 테마를 고정하고, data-theme를 생략하면 운영체제 설정을 따릅니다. 브랜드 컬러는 --iny-accent 하나만 바꾸면 호버·배경·포커스 색이 모두 자동으로 계산됩니다. 상단의 강조색 견본을 눌러 바로 확인해 보세요.
/* 브랜드 컬러 변경 — 이 한 줄이면 됩니다 */
:root {
--iny-accent: #4f8cff;
}
/* 특정 영역만 다른 강조색 (.iny-scope 를 함께 지정) */
.promo.iny-scope {
--iny-accent: #2fbf71;
}
/* 그 밖의 토큰도 필요하면 덮어쓰기 */
:root {
--iny-radius-md: 10px;
--iny-font: "Your Font", sans-serif;
}
<!-- 테마 고정: dark | light (생략 시 OS 설정) -->
<html data-theme="light">
<!-- 어두운 강조색이라면 강조색 위 글자·체크 표시를 흰색으로 -->
<html data-iny-on-accent="light" style="--iny-accent: #5b3fd6">
<script>
// 또는 JS로: 대비를 계산해 글자색까지 자동 지정
InyUI.setAccent('#5b3fd6');
</script>
주요 토큰
--iny-bg페이지 배경--iny-surface카드 · 패널--iny-surface-2보조 표면--iny-border테두리 (-strong)--iny-text본문 텍스트--iny-muted보조 텍스트--iny-accent강조색 (#ff5a1f)--iny-accent-soft강조 배경 (자동)--iny-success성공--iny-warning경고--iny-danger오류 · 위험--iny-info정보시작하기
접근성 #
모든 컴포넌트는 네이티브 HTML 요소를 기반으로 하며, 아래 원칙을 기본값으로 지킵니다.
키보드 포커스
:focus-visible 포커스 링을 표시합니다. 탭은 방향키·Home·End로 이동합니다.명도 대비
동작 줄이기
prefers-reduced-motion 설정 시 전환·스켈레톤 반짝임이 꺼지고, 스피너는 느리게 회전합니다.시맨틱 마크업
<dialog>, <details>, <progress> 등 네이티브 요소와 ARIA 속성을 그대로 사용합니다.액션
버튼 #
주요·보조·고스트·위험 네 가지 변형과 세 가지 크기를 제공합니다. 로딩 중에는 aria-busy="true"를 지정하면 텍스트를 유지한 채 스피너가 표시되고, 아이콘만 있는 버튼에는 반드시 aria-label을 넣어 주세요.
.iny-btn--primary--secondary--ghost--danger--sm--lg--icon--block폼
입력 필드 #
.iny-field로 라벨·입력·도움말을 묶습니다. 오류 상태는 aria-invalid="true"로 표시하고, 오류 문구를 aria-describedby로 연결하면 스크린리더가 함께 읽어 줍니다.
.iny-field.iny-label.iny-input.iny-help.iny-error-text.iny-input-wrap--sm--lg업무용 이메일을 권장합니다.
8자 이상 입력해 주세요.
생성 후에는 변경할 수 없습니다.
폼
텍스트 영역 #
여러 줄 입력용입니다. 세로 방향으로만 크기를 조절할 수 있고, 입력 필드와 같은 포커스·오류 스타일을 공유합니다.
.iny-textarea최대 200자까지 입력할 수 있습니다.
폼
셀렉트 #
네이티브 <select>에 스타일만 입혔습니다. 모바일 기본 선택 UI와 키보드 조작, 스크린리더 지원을 그대로 유지합니다.
.iny-select--sm--lg폼
체크박스 · 라디오 #
네이티브 입력 요소에 appearance: none을 적용해 모양만 바꿨습니다. <label class="iny-check">로 감싸면 글자를 눌러도 선택됩니다. indeterminate 상태도 지원합니다.
.iny-check.iny-checkbox.iny-radio.iny-fieldset.iny-legend폼
토글 스위치 #
즉시 적용되는 켜기/끄기 설정에 사용합니다. 체크박스에 role="switch"를 지정해 스크린리더가 "스위치, 켬"으로 읽습니다. 라벨을 오른쪽 끝에 두려면 --end를 쓰세요.
.iny-switch.iny-switch__input.iny-switch__track--end폼
슬라이더 #
네이티브 <input type="range">입니다. 채워진 비율은 --iny-range-value로 표시하며, JS를 쓰면 값이 바뀔 때 자동으로 갱신되고 <output for>도 함께 업데이트됩니다.
.iny-range.iny-range-head--iny-range-value데이터 표시
배지 · 태그 #
배지는 상태나 개수처럼 짧은 정보를, 태그는 사용자가 추가·삭제하는 키워드를 표시합니다. 상태 색만으로 의미를 전달하지 않도록 항상 텍스트를 함께 넣으세요.
.iny-badge--accent--solid--success--warning--danger--info.iny-tag.iny-tag__remove데이터 표시
아바타 #
이니셜 또는 <img>를 넣어 사용합니다. 상태 점과 겹쳐 쌓는 그룹을 지원합니다. 이니셜만 있을 때는 role="img"와 aria-label로 이름을 알려 주세요.
.iny-avatar--xs--sm--lg--xl--square--accent.iny-avatar__status.iny-avatar-group데이터 표시
카드 #
머리글·본문·바닥글로 나뉜 기본 컨테이너입니다. 카드 전체가 링크라면 <a class="iny-card iny-card--interactive">로 만들어 호버와 포커스 상태를 얻으세요.
.iny-card__header__title__desc__body__footer__media--interactive--elevated월간 활성 사용자
지난달 대비 942명 증가
팀원 초대
워크스페이스에 함께할 사람을 초대하세요.
설치 가이드 읽기
CSS 한 줄로 시작해 테마와 강조색까지 5분이면 적용할 수 있습니다.
자세히 보기세 번째 카드의 .doc-link-card, .doc-ico는 문서용 보조 클래스입니다. 내부 레이아웃은 자유롭게 구성하세요.
데이터 표시
테이블 #
.iny-table-wrap이 좁은 화면에서 가로 스크롤을 담당합니다. 키보드로도 스크롤할 수 있도록 tabindex="0"과 role="region", 이름을 지정했습니다. 숫자 열은 .is-num으로 오른쪽 정렬하세요.
.iny-table-wrap.iny-table--striped--hover--compact.is-num.is-muted| 프로젝트 | 담당자 | 상태 | 진행률 | 마감일 |
|---|---|---|---|---|
| 브랜드 리뉴얼 | 김하늘 | 진행 중 | 72% | 2026.12.04 |
| 결제 모듈 개선 | 이준호 | 검토 중 | 90% | 2026.11.28 |
| 모바일 앱 v2 | 박서연 | 완료 | 100% | 2026.11.15 |
| 관리자 대시보드 | 최민준 | 지연 | 38% | 2026.11.20 |
| 고객 지원 챗봇 | 정유진 | 대기 | 12% | 2027.01.10 |
데이터 표시
빈 상태 #
보여줄 데이터가 없을 때 이유와 다음 행동을 안내합니다. 제목은 상황을, 설명은 해결 방법을 짧게 적는 것이 좋습니다.
.iny-empty__icon__title__desc__actions아직 프로젝트가 없습니다
첫 프로젝트를 만들거나 기존 파일을 가져와 팀과 함께 작업을 시작하세요.
피드백
알림 #
페이지 안에 머무르는 안내 메시지입니다. 페이지 로드 후 동적으로 나타나는 긴급 메시지에는 role="alert", 그 외에는 role="status"를 권장합니다. 닫기 버튼에 data-iny-dismiss를 지정하면 JS가 처리합니다.
.iny-alert--info--success--warning--error__icon__title__body정기 점검 안내
11월 24일 새벽 2시부터 30분간 서비스 점검이 진행됩니다.
저장 완료
변경 사항이 모든 팀원에게 반영되었습니다.
저장 공간 90% 사용 중
공간이 가득 차면 새 파일을 업로드할 수 없습니다. 플랜 확인하기
결제에 실패했습니다
카드 정보를 확인한 뒤 다시 시도해 주세요.
피드백
프로그레스 #
네이티브 <progress>를 사용하므로 별도 ARIA 없이도 진행률이 전달됩니다. value를 생략하면 진행률을 알 수 없는 상태(무한 반복)로 표시됩니다.
.iny-progress--sm--lg--success--warning--danger.iny-progress-label피드백
스피너 #
짧은 대기 상태를 알립니다. 스피너 자체는 장식이므로, role="status"를 가진 컨테이너에 읽을 수 있는 문구를 함께 두세요. 색은 color 속성을 따릅니다.
.iny-spinner--sm--lg--muted.iny-loading피드백
스켈레톤 #
콘텐츠의 형태를 미리 보여 주어 로딩이 덜 지루하게 느껴지도록 합니다. 스켈레톤은 aria-hidden으로 숨기고, 컨테이너에 aria-busy="true"와 대체 문구를 두세요.
.iny-skeleton--text--title--circle--block피드백
토스트 #
작업 결과를 잠시 띄웠다 사라지는 메시지입니다. InyUI.toast(message, type)를 호출하거나 버튼에 data-iny-toast를 지정하세요. 마우스를 올리거나 포커스가 있으면 자동으로 닫히지 않습니다.
.iny-toast--info--success--warning--error.iny-toast-regionInyUI.toast()저장 완료
// 기본 (type: "info" | "success" | "warning" | "error")
InyUI.toast('변경 사항이 저장되었습니다.', 'success');
// 제목 · 표시 시간(ms) 지정 — duration: 0 이면 자동으로 닫히지 않음
const t = InyUI.toast('파일을 업로드하지 못했습니다.', 'error', {
title: '업로드 실패',
duration: 6000
});
t.close(); // 코드로 닫기
피드백
툴팁 #
CSS만으로 동작합니다. data-iny-tooltip에 문구를 넣으면 마우스를 올리거나 키보드로 포커스했을 때 표시되고, JS를 쓰면 Esc로 숨길 수 있습니다. 툴팁 문구는 보조 기술에 전달되지 않으므로 같은 내용을 aria-label에도 넣어 주세요.
data-iny-tooltipdata-iny-tooltip-pos="top | bottom | left | right"피드백
모달 #
네이티브 <dialog> 기반이라 포커스 가두기, Esc로 닫기, 배경 비활성화가 브라우저에서 기본 제공됩니다. data-iny-open="아이디"로 열고, <form method="dialog"> 안의 버튼은 JS 없이도 모달을 닫습니다. 배경을 눌러 닫히지 않게 하려면 data-iny-static을 지정하세요.
.iny-modal--sm--lg__header__title__desc__body__footerdata-iny-opendata-iny-close내비게이션
탭 #
WAI-ARIA 탭 패턴을 따릅니다. JS가 있으면 ← → Home End로 이동하고 aria-selected·tabindex를 관리합니다. JS가 없어도 첫 번째 패널은 그대로 표시됩니다.
.iny-tabs__list__tab__panel--segmented내비게이션
아코디언 #
<details>·<summary> 기반이라 JS 없이 동작하고 키보드로도 열고 닫을 수 있습니다. 같은 name을 지정하면 하나만 열리고, 지원 브라우저에서는 부드럽게 펼쳐집니다.
.iny-accordion__item__trigger__contentReact나 Vue 프로젝트에서도 쓸 수 있나요?
기존 디자인과 충돌하지 않나요?
iny- 접두사를 붙였고, 전역 요소 선택자를 쓰지 않아 기존 스타일과 섞여도 안전합니다.브라우저 지원 범위는 어떻게 되나요?
내비게이션
페이지네이션 #
현재 페이지는 aria-current="page"로 표시합니다. 이전·다음처럼 아이콘만 있는 항목에는 aria-label을 넣어 주세요.
.iny-pagination__list__item__ellipsis내비게이션
브레드크럼 #
현재 위치까지의 경로를 보여 줍니다. 구분 기호는 CSS로 그려 스크린리더가 읽지 않습니다.
.iny-breadcrumb__list__item__link내비게이션
구분선 #
가로, 가운데 글자가 있는 형태, 세로 세 가지입니다. 의미 있는 구분에는 <hr>을, 장식용 세로선에는 role="separator"를 사용하세요.
.iny-divider--label--vertical