# cmdk(⌘K) - React용 커맨드 메뉴 컴포넌트

> Clean Markdown view of GeekNews topic #19801. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=19801](https://news.hada.io/topic?id=19801)
- GeekNews Markdown: [https://news.hada.io/topic/19801.md](https://news.hada.io/topic/19801.md)
- Type: news
- Author: [xguru](https://news.hada.io/@xguru)
- Published: 2025-03-17T10:14:01+09:00
- Updated: 2025-03-17T10:14:01+09:00
- Original source: [github.com/pacocoursey](https://github.com/pacocoursey/cmdk)
- Points: 5
- Comments: 0

## Summary

cmdk는 빠르고 조합 가능한 명령어 메뉴 컴포넌트로, 자동 필터링 및 정렬 기능을 제공하며 사용자 정의 필터링 함수도 추가할 수 있습니다. 이 컴포넌트는 최대 2,000~3,000개의 항목을 원활하게 처리할 수 있는 성능을 갖추고 있으며, 다양한 스타일링 옵션과 접근성 지원을 제공합니다. 그러나 Virtualization 미지원과 동시 모드의 완전한 지원 부족, React Native 미지원 등의 제한 사항이 있습니다.

## Topic Body

- 빠르고, 조합가능한 명령어 메뉴 컴포넌트(콤보박스로도 사용 가능)  
- 렌더링된 항목을 **자동 필터링 및 정렬**. 사용자 정의 필터링 함수 추가 가능   
- 완전히 구성 가능한 **API 제공** - 커스텀 컴포넌트, 필터, 정렬 로직 정의 가능. 다른 컴포넌트나 JSX와 함께 사용  
- **성능 우수** – 최대 2,000~3,000개 항목까지 원활한 처리 가능  
- 입력 및 출력 상태 제어 : `value`, `onValueChange`,`onSelect` 등으로 상태 변화 및 키 입력에 따라 상태 제어 가능  
- **다양한 스타일링 옵션**  
  - CSS 변수 및 데이터 속성(`cmdk-`)으로 스타일링 가능  
  - 특정 컴포넌트의 상태 및 스타일 커스터마이징 가능  
- 접근성 지원 : `aria` 속성 및 DOM 순서 준수  
- **Radix UI 통합**  
  - Radix UI의 `Dialog` 컴포넌트를 기반으로 한 대화 상자 지원  
  - 포털 위치 및 상태 제어 가능  
  
### 단점 및 제한 사항  
- **Virtualization 미지원** – 대규모 항목에서는 성능 저하  
- **동시 모드(Concurrent Mode) 완전 지원 아님** – 일부 동작에서 불안정 가능성 있음  
- React Native 미지원

## Comments



_No public comments on this page._