Textarea
native textarea의 모든 속성을 전달하며 최소 높이, 세로 resize, focus와 aria-invalid 상태를 뉴모피즘 토큰으로 표현합니다.
@neumorphism-ui/textarea미리보기
설치
설치: textarea
npx shadcn@latest add @neumorphism-ui/textareaCLI가 npm 의존성, base 토큰, utils와 컴포넌트 소스를 순서대로 확인하고 설치합니다.
Registry를 처음 사용한다면 namespace 설정 을 먼저 완료하세요.
사용법
사용법: 설치
npx shadcn@latest add @neumorphism-ui/label @neumorphism-ui/textareaImport
Textarea import 코드
import { Label } from "@/components/ui/label"
import { Textarea } from "@/components/ui/textarea"Example
Textarea 사용 코드
<div className="grid gap-2">
<Label htmlFor="note">메모</Label>
<Textarea
id="note"
name="note"
placeholder="팀에 남길 내용을 입력하세요."
rows={5}
/>
</div>API 레퍼런스
| 컴포넌트 | 속성 | 타입 | 기본값 | 설명 |
|---|---|---|---|---|
Textarea | value / defaultValue | string | — | controlled 또는 초기 uncontrolled 텍스트입니다. |
Textarea | rows | number | — | 초기 표시 행 수입니다. |
Textarea | placeholder | string | — | 입력 형식을 보조하는 짧은 예시입니다. |
Textarea | disabled / required / readOnly | boolean | false | native 입력 제약을 설정합니다. |
Textarea | aria-invalid | boolean | string | — | 오류 테두리와 focus ring을 활성화합니다. |
접근성
- 01
Label의 htmlFor와 Textarea의 id를 연결하고 placeholder로 Label을 대체하지 않습니다.
- 02
글자 수 제한이 있으면 maxLength와 현재 글자 수를 함께 제공하고 필요한 경우 aria-describedby로 연결합니다.
- 03
오류 문구에는 id를 부여하고 aria-invalid, aria-describedby로 control과 연결합니다.