Textarea
テキストエリアは、複数行のテキストを入力するためのフォーム要素です。 コメント、説明、メッセージなど、長文の入力に使用します。
2
Variants
2
Sizes
4
Resize
Field
Field
Playground
Preview
defaultstandard4 rows / 16px
Variant
Size
Radius
Resize
Rows
State
Field
Focus
<Textarea placeholder="Type your message..." />Variants
Default
標準的なボーダースタイル。フォームの一般的な入力欄に使用。
一般的なフォーム
Filled
背景色付きスタイル。視覚的に目立たせたい入力欄に。
カード内フォーム
Sizes
Textareaの高さはrows属性で制御します。 sizeプロパティはパディングとフォントサイズのみを調整します。
compactパディング8px 12px
フォント14px
standardパディング12px 16px
フォント16px
| Size | パディング | フォント | 用途 | プレビュー |
|---|---|---|---|---|
compact | 8px 12px | 14px | 狭いスペース用 | |
standard | 12px 16px | 16px | 標準(推奨) |
Features
Resize
None
noneリサイズ不可。固定サイズが必要な場合。
Vertical
vertical縦方向のみ。最も一般的なオプション。
Horizontal
horizontal横方向のみ。特殊なケース用。
Both
both両方向。自由度が必要な場合。
States
Default通常
0/500
Errorエラー
必須項目です
Disabled無効
フォーカスStates
focusRing: false(デフォルト): クリック時はボーダー変化のみ、キーボードTab時はフォーカスリング自動表示。focusRing: true: 常にフォーカスリングを表示。
API
Props
variant"default""default" | "filled"テキストエリアの視覚スタイル
size"default""compact" | "default"パディングとフォントサイズ(compact: 狭いスペース用)
radius"default""none" | "sm" | "base" | "default" | "lg" | "xl" | "2xl" | "3xl" | "full"角丸のサイズ (6px)
resize"vertical""none" | "vertical" | "horizontal" | "both"リサイズ方向
rows4number表示行数
focusRingfalsebooleanカスタムフォーカスリング表示。falseでもキーボード操作時は自動表示
errorundefinedbooleanエラーStates(赤いボーダー)
disabledundefinedboolean無効States
placeholderundefinedstringプレースホルダーテキスト
| Name | Type | Default | Description |
|---|---|---|---|
variant | "default" | "filled" | "default" | テキストエリアの視覚スタイル |
size | "compact" | "default" | "default" | パディングとフォントサイズ(compact: 狭いスペース用) |
radius | "none" | "sm" | "base" | "default" | "lg" | "xl" | "2xl" | "3xl" | "full" | "default" | 角丸のサイズ (6px) |
resize | "none" | "vertical" | "horizontal" | "both" | "vertical" | リサイズ方向 |
rows | number | 4 | 表示行数 |
focusRing | boolean | false | カスタムフォーカスリング表示。falseでもキーボード操作時は自動表示 |
error | boolean | undefined | エラーStates(赤いボーダー) |
disabled | boolean | undefined | 無効States |
placeholder | string | undefined | プレースホルダーテキスト |
Field
errorfalsebooleanエラー状態。FieldError と Textarea に自動伝播
disabledfalseboolean無効状態。FieldLabel と Textarea に自動伝播
gap"default""none" | "xs" | "sm" | "default" | "lg"子要素間の間隔 (0 / 4 / 6 / 8 / 12px)
| Name | Type | Default | Description |
|---|---|---|---|
error | boolean | false | エラー状態。FieldError と Textarea に自動伝播 |
disabled | boolean | false | 無効状態。FieldLabel と Textarea に自動伝播 |
gap | "none" | "xs" | "sm" | "default" | "lg" | "default" | 子要素間の間隔 (0 / 4 / 6 / 8 / 12px) |
FieldLabel
requiredfalseboolean必須マーク(*)をラベル末尾に表示
| Name | Type | Default | Description |
|---|---|---|---|
required | boolean | false | 必須マーク(*)をラベル末尾に表示 |