Textarea
שדה טקסט מרובה שורות שגדל עם התוכן שלו.
- דפדפנים
- Chrome 123+Firefox 152+למה הגרסה הזאת?Safari 26.2+
The auto-sized textarea uses CSS
field-sizing: content. Older Firefox versions keep the textarea at its fixed size as text is entered.למה הגרסה הזאת?The auto-sized textarea uses CSS
field-sizing: content. Older Safari versions keep the textarea at its fixed size as text is entered. - שכבה
- 0
- גודל חבילה דחוסה
- 348 B
- מגבלת פריסה כפויה
- 0 ms
- מגבלת Axe
- 0
- תואם SSR
- כן
- חוזה מפורסם
- סביבת בדיקות
מגרש ניסויים
import { Textarea } from "@gunkin/uiify";
export default function Example() {
return <Textarea className="" aria-label="Notes" name="notes" autoSize />;
}/* Text fields — Input and Textarea share the same surface. Invalid state keys
off the [data-invalid] attribute the components emit. Textarea autosize uses
the native field-sizing (Chrome 123+) when the component sets data-autosize. */
@layer components {
:where([data-uiify-input], [data-uiify-textarea]) {
display: block;
inline-size: 100%;
max-inline-size: 24rem;
padding-block: var(--space-sm);
padding-inline: var(--space-md);
border: var(--border-width) solid var(--input);
border-radius: var(--radius-md);
background-color: var(--card);
color: var(--foreground);
font-size: var(--uiify-control-text);
line-height: var(--leading-normal);
transition: var(--transition-colors);
}
:where([data-uiify-input], [data-uiify-textarea])::placeholder {
color: var(--muted-foreground);
}
:where([data-uiify-input], [data-uiify-textarea]):focus-visible {
border-color: var(--primary);
}
:where([data-uiify-input], [data-uiify-textarea]):disabled,
:where([data-uiify-input], [data-uiify-textarea])[data-disabled] {
opacity: 0.5;
cursor: not-allowed;
}
:where([data-uiify-input], [data-uiify-textarea])[data-invalid],
:where([data-uiify-input], [data-uiify-textarea]):user-invalid {
border-color: var(--destructive);
}
:where([data-uiify-input], [data-uiify-textarea])[data-invalid]:focus-visible {
outline-color: var(--destructive);
}
/* Input is a pill sized like Button: --control-md tall and base text. Textarea keeps its own
rounded rectangle. */
[data-uiify-input] {
box-sizing: border-box;
block-size: var(--uiify-control-size, var(--control-md));
padding-block: 0;
padding-inline: var(--space-lg);
border-radius: var(--radius-full);
font-size: var(--uiify-control-font, var(--text-base));
}
[data-uiify-textarea] {
min-block-size: 4lh;
resize: block;
}
[data-uiify-textarea][data-autosize] {
field-sizing: content;
resize: none;
}
[data-uiify-field] {
display: grid;
gap: var(--space-sm);
inline-size: 100%;
max-inline-size: 24rem;
}
[data-uiify-field] [data-part="label"] {
color: var(--foreground);
font-size: var(--text-sm);
font-weight: var(--weight-medium);
line-height: var(--leading-normal);
}
[data-uiify-field] [data-part="label"][data-required]::after {
content: " *";
color: var(--destructive);
}
[data-uiify-field] [data-part="description"] {
margin: 0;
color: var(--muted-foreground);
font-size: var(--text-xs);
line-height: var(--leading-normal);
}
[data-uiify-field] [data-part="error"] {
margin: 0;
color: var(--destructive);
font-size: var(--text-xs);
line-height: var(--leading-normal);
}
/* Shared presence fade when an error message is mounted. */
@media (prefers-reduced-motion: no-preference) {
[data-uiify-field] [data-part="error"] {
transition: opacity var(--duration-fast) var(--ease-out);
}
@starting-style {
[data-uiify-field] [data-part="error"] {
opacity: 0;
}
}
}
}import { Textarea } from "@gunkin/uiify";
export default function Example() {
return (
<Textarea
className="
focus-visible:[outline:none]
focus-visible:[box-shadow:0_0_0_var(--ring-width)_color-mix(in_oklch,_var(--ring)_20%,_transparent)] block
[inline-size:100%] [max-inline-size:24rem] py-sm px-md border-[length:var(--border-width)] border-solid
border-input rounded-md bg-card text-foreground [font-size:var(--uiify-control-text)]
[line-height:var(--leading-normal)] [transition:var(--transition-colors)] placeholder:text-muted-foreground
focus-visible:border-primary disabled:opacity-50 disabled:cursor-not-allowed data-[disabled]:opacity-50
data-[disabled]:cursor-not-allowed data-[invalid]:border-destructive user-invalid:border-destructive
data-[invalid]:focus-visible:outline-destructive [min-block-size:4lh] [resize:block]
data-[autosize]:[field-sizing:content] data-[autosize]:resize-none
"
aria-label="Notes"
name="notes"
autoSize
/>
);
}API
Textarea
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
value | string | — | הערך הנוכחי, ההופך את אזור הטקסט למבוקר. |
defaultValue | string | — | הערך ההתחלתי של אזור הטקסט הלא מבוקר, שלאחר מכן מנוהל על ידי האלמנט המובנה. |
onValueChange | (value: string) => void | — | נקראת עם הערך החדש בכל שינוי באזור הטקסט. |
autoSize | boolean | false | מרחיב את אזור הטקסט בהתאם לתוכנו באמצעות field-sizing של CSS, ללא JavaScript. |
disabled | boolean | false | משבית את אזור הטקסט המובנה ומגדיר את המאפיין data-disabled. |
readOnly | boolean | false | הופך את הערך לקריאה בלבד, תוך שמירה על האפשרות למקד את אזור הטקסט. |
invalid | boolean | false | מסמן את אזור הטקסט כלא תקין באמצעות aria-invalid והמאפיין data-invalid. |
render | ReactElement | ((props, state) => ReactElement) | — | החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות. |
מקלדת
| מקש | פעולה |
|---|---|
| Tab | העברת המיקוד אל הפקד או ממנו |
| Enter / Space | הפעלה כשהפקד ממוקד (פקדים דמויי כפתור) |
נגישות
משתמש ב-HTML סמנטי ככל האפשר. בדקו את הסימון המרונדר במגרש הניסויים — ARIA נוסף רק כאשר האלמנטים המובנים אינם מספיקים.
נקודות חיבור לעיצוב
data-disabled