# STextarea

> 자동 생성 문서 — `npm run docs:gen`. 소스: 각 컴포넌트의 Props/Handle 인터페이스 + import 의존성.

### STextarea

#### Props

| Prop | Type | Default | Description |
|------|------|---------|-------------|
| `value?` | `string` | — | 값 (제어) |
| `rows?` | `number` | `3` | 행 수 |
| `rules?` | `Rule[]` | — | 유효성 규칙 — blur 시 자동 검증 |
| `status?` | `SFieldStatus` | — | 필드 상태 ('default' | 'pass' | 'error') |
| `focused?` | `boolean` | — | 포커스 상태 (제어/반영) |
| `hovered?` | `boolean` | — | 호버 상태 (제어/반영) |
| `textareaClass?` | `string` | — | 내부 textarea 요소 className |
| `textareaStyle?` | `CSSProperties` | — | 내부 textarea 요소 style |
| `label?` | `string` | — |  |
| `labelWidth?` | `number \| string` | — |  |
| `icon?` | `SIconName` | — | 레이블 영역 아이콘 |
| `iconColor?` | `SColor` | — |  |
| `labelTooltip?` | `string` | — | 레이블 툴팁 텍스트 |
| `labelTooltipProps?` | `Partial<STooltipProps>` | — | 레이블 툴팁 상세 옵션 |
| `addonLabel?` | `string` | — | 우측 어드온 레이블 |
| `addonAlign?` | `SFieldAddonAlign` | — | 어드온 정렬 |
| `hint?` | `string` | — |  |
| `error?` | `boolean` | — |  |
| `errorMessage?` | `string` | — |  |
| `width?` | `number \| string` | — |  |
| `disabled?` | `boolean` | `false` |  |
| `readOnly?` | `boolean` | `false` |  |
| `className?` | `string` | — |  |
| `style?` | `CSSProperties` | — |  |

#### Events

| Event | Type | Description |
|-------|------|-------------|
| `onValueChange` | `(value: string) => void` | 값 변경 (sdUpdate) |
| `onChange` | `TextareaHTMLAttributes<HTMLTextAreaElement>['onChange']` | 네이티브 onChange (form-agnostic) |

## Dependencies

### Used by

 - [SKeyValueTable](../SKeyValueTable)

### Depends on

- [SField](../SField)

### Graph

```mermaid
graph TD;
  STextarea --> SField
  SKeyValueTable --> STextarea
  style STextarea fill:#f9f,stroke:#333,stroke-width:4px
```