본문으로 건너뛰기
InY UI v1.0
InY 인하우스 프로덕트

InY UI.

빌드 도구도, 프레임워크도 필요 없는 순수 HTML/CSS 컴포넌트 키트입니다. 다크·라이트 테마, 변수 하나로 바꾸는 브랜드 컬러, 키보드 접근성을 처음부터 담았습니다.

컴포넌트
27
외부 의존성
0
테마
2
브랜드 컬러 변수
1개

배포 설정

정상

production · 마지막 배포 3분 전

빌드 캐시 사용량72%
72%

시작하기

설치 #

파일 두 개를 프로젝트에 복사하고 링크하면 끝입니다. JS는 선택 사항이며, 모달 열기·토스트·탭 키보드 조작이 필요할 때만 추가하세요. 대부분의 컴포넌트는 JS 없이도 그대로 렌더링됩니다.

HTML
<!-- (선택) 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 KB
디자인 토큰, 다크·라이트 테마, 27종 컴포넌트 스타일. 이 파일 하나만으로 동작합니다.

iny-ui.js 선택

15 KB · gzip 5 KB
모달 열기·닫기, 토스트, 탭 방향키 조작, 슬라이더 채움, 강조색 대비 자동 계산.

시작하기

테마 · 강조색 #

기본은 다크 테마입니다. <html data-theme="light">로 라이트 테마를 고정하고, data-theme를 생략하면 운영체제 설정을 따릅니다. 브랜드 컬러는 --iny-accent 하나만 바꾸면 호버·배경·포커스 색이 모두 자동으로 계산됩니다. 상단의 강조색 견본을 눌러 바로 확인해 보세요.

CSS
/* 브랜드 컬러 변경 — 이 한 줄이면 됩니다 */
:root {
  --iny-accent: #4f8cff;
}

/* 특정 영역만 다른 강조색 (.iny-scope 를 함께 지정) */
.promo.iny-scope {
  --iny-accent: #2fbf71;
}

/* 그 밖의 토큰도 필요하면 덮어쓰기 */
:root {
  --iny-radius-md: 10px;
  --iny-font: "Your Font", sans-serif;
}
HTML · JS
<!-- 테마 고정: 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로 이동합니다.

명도 대비

본문·보조 텍스트는 두 테마 모두 WCAG AA(4.5:1) 이상, 체크박스·입력 테두리는 3:1 이상으로 설계했습니다.

동작 줄이기

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
60%
80

데이터 표시

배지 · 태그 #

배지는 상태나 개수처럼 짧은 정보를, 태그는 사용자가 추가·삭제하는 키워드를 표시합니다. 상태 색만으로 의미를 전달하지 않도록 항상 텍스트를 함께 넣으세요.

.iny-badge--accent--solid--success--warning--danger--info.iny-tag.iny-tag__remove
기본 신규 PRO 배포됨 검토 중 실패 베타
디자인 시스템 접근성 다크 모드

데이터 표시

아바타 #

이니셜 또는 <img>를 넣어 사용합니다. 상태 점과 겹쳐 쌓는 그룹을 지원합니다. 이니셜만 있을 때는 role="img"와 aria-label로 이름을 알려 주세요.

.iny-avatar--xs--sm--lg--xl--square--accent.iny-avatar__status.iny-avatar-group
김 이 박 IY
김 이 박 최 +5

데이터 표시

카드 #

머리글·본문·바닥글로 나뉜 기본 컨테이너입니다. 카드 전체가 링크라면 <a class="iny-card iny-card--interactive">로 만들어 호버와 포커스 상태를 얻으세요.

.iny-card__header__title__desc__body__footer__media--interactive--elevated

월간 활성 사용자

12,480+8.2%

지난달 대비 942명 증가

팀원 초대

워크스페이스에 함께할 사람을 초대하세요.

김 이 +3

설치 가이드 읽기

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
파일 업로드 중64%
64%
백업 완료100%
100%
스토리지9.1 / 10GB
91%
데이터 분석 중잠시만요

피드백

스피너 #

짧은 대기 상태를 알립니다. 스피너 자체는 장식이므로, 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()

저장 완료

변경 사항이 저장되었습니다.

JS
// 기본 (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"

내비게이션

탭 #

WAI-ARIA 탭 패턴을 따릅니다. JS가 있으면 ← → Home End로 이동하고 aria-selected·tabindex를 관리합니다. JS가 없어도 첫 번째 패널은 그대로 표시됩니다.

.iny-tabs__list__tab__panel--segmented
프로젝트의 목표와 일정, 주요 지표를 한눈에 확인할 수 있습니다.
팀 플랜 · 월 29,000원

내비게이션

아코디언 #

<details>·<summary> 기반이라 JS 없이 동작하고 키보드로도 열고 닫을 수 있습니다. 같은 name을 지정하면 하나만 열리고, 지원 브라우저에서는 부드럽게 펼쳐집니다.

.iny-accordion__item__trigger__content
React나 Vue 프로젝트에서도 쓸 수 있나요?
네. 클래스 이름만 사용하는 순수 CSS라 어떤 프레임워크에서도 그대로 쓸 수 있습니다. JS 헬퍼가 필요 없다면 CSS 파일만 불러오세요.
기존 디자인과 충돌하지 않나요?
모든 클래스와 변수에 iny- 접두사를 붙였고, 전역 요소 선택자를 쓰지 않아 기존 스타일과 섞여도 안전합니다.
브라우저 지원 범위는 어떻게 되나요?
Chrome·Edge 111+, Safari 16.4+, Firefox 121+ 등 최신 브라우저를 지원합니다. 자세한 내용은 README를 참고하세요.

내비게이션

페이지네이션 #

현재 페이지는 aria-current="page"로 표시합니다. 이전·다음처럼 아이콘만 있는 항목에는 aria-label을 넣어 주세요.

.iny-pagination__list__item__ellipsis

내비게이션

구분선 #

가로, 가운데 글자가 있는 형태, 세로 세 가지입니다. 의미 있는 구분에는 <hr>을, 장식용 세로선에는 role="separator"를 사용하세요.

.iny-divider--label--vertical