92 lines
1.9 KiB
Markdown
92 lines
1.9 KiB
Markdown
# SelectBasic 컴포넌트
|
|
|
|
select-basic 컴포넌트입니다
|
|
|
|
## 개요
|
|
|
|
- **ID**: `select-basic`
|
|
- **카테고리**: input
|
|
- **웹타입**: select
|
|
- **작성자**: 개발팀
|
|
- **버전**: 1.0.0
|
|
|
|
## 특징
|
|
|
|
- ✅ 자동 등록 시스템
|
|
- ✅ 타입 안전성
|
|
- ✅ Hot Reload 지원
|
|
- ✅ 설정 패널 제공
|
|
- ✅ 반응형 디자인
|
|
|
|
## 사용법
|
|
|
|
### 기본 사용법
|
|
|
|
```tsx
|
|
import { SelectBasicComponent } from "@/lib/registry/components/select-basic";
|
|
|
|
<SelectBasicComponent
|
|
component={{
|
|
id: "my-select-basic",
|
|
type: "widget",
|
|
webType: "select",
|
|
position: { x: 100, y: 100, z: 1 },
|
|
size: { width: 200, height: 36 },
|
|
config: {
|
|
// 설정값들
|
|
}
|
|
}}
|
|
isDesignMode={false}
|
|
/>
|
|
```
|
|
|
|
### 설정 옵션
|
|
|
|
| 속성 | 타입 | 기본값 | 설명 |
|
|
|------|------|--------|------|
|
|
| placeholder | string | "" | 플레이스홀더 텍스트 |
|
|
| disabled | boolean | false | 비활성화 여부 |
|
|
| required | boolean | false | 필수 입력 여부 |
|
|
| readonly | boolean | false | 읽기 전용 여부 |
|
|
|
|
## 이벤트
|
|
|
|
- `onChange`: 값 변경 시
|
|
- `onFocus`: 포커스 시
|
|
- `onBlur`: 포커스 해제 시
|
|
- `onClick`: 클릭 시
|
|
|
|
## 스타일링
|
|
|
|
컴포넌트는 다음과 같은 스타일 옵션을 제공합니다:
|
|
|
|
- `variant`: "default" | "outlined" | "filled"
|
|
- `size`: "sm" | "md" | "lg"
|
|
|
|
## 예시
|
|
|
|
```tsx
|
|
// 기본 예시
|
|
<SelectBasicComponent
|
|
component={{
|
|
id: "sample-select-basic",
|
|
config: {
|
|
placeholder: "입력하세요",
|
|
required: true,
|
|
variant: "outlined"
|
|
}
|
|
}}
|
|
/>
|
|
```
|
|
|
|
## 개발자 정보
|
|
|
|
- **생성일**: 2025-09-11
|
|
- **CLI 명령어**: `node scripts/create-component.js select-basic --category=input --webType=select`
|
|
- **경로**: `lib/registry/components/select-basic/`
|
|
|
|
## 관련 문서
|
|
|
|
- [컴포넌트 시스템 가이드](../../docs/컴포넌트_시스템_가이드.md)
|
|
- [개발자 문서](https://docs.example.com/components/select-basic)
|