برچسب <textarea> در اچ‌تی‌ام‌ال

از ویکی‌کد، دانشنامهٔ برنامه‌نویسی
پرش به ناوبری پرش به جستجو
کنترل ورودی چند خطی (منطقه متن) را تعریف می‌کند
معرفی شده در نسخهٔ:۲
حذف شده در نسخهٔ: هنوز در حال استفاده است
ویژگی‌های مجاز:به پائین مراجعه کنید
تنظیمات پیش‌فرض CSS:ندارد

{{منو اسکرول چپ|نام منو={{مرجع منو اچ‌تی‌ام‌ال|expanded=مرجع}}}}

مثال

یک فضای متن (text area) در اچ‌تی‌ام‌ال:

<label for="w3review">Review of W3Schools:</label>

<textarea id="w3review" name="w3review" rows="4" cols="50">
At w3schools.com you will learn how to make a website. They offer free tutorials in all web development technologies.
</textarea>


تعریف و کاربرد

برچسب <textarea> یک کنترل ورودیِ متنِ چندخطی را تعریف می‌کند.[۱]

یک فضای متن می‌تواند بی‌نهایت تعداد کاراکتر را در خود جای دهد، و متن درون آن بصورت فونت با پهنای ثابت (معمولا Courier) رندر می‌شود.

اندازهٔ یک فضای متن (text area) را می‌توان با ویژگی‌های cols و rows مشخص کرد، یا بهتر از آن، از طریق ویژگی‌های height و width در CSS.

نکته: همیشه برچسب <label> را برای بهترین شیوهٔ دسترسی اضافه کنید!

پشتیبانی مرورگر

عنصر Chrome Internet Explorer / Edge Firefox Safari Opera
<textarea> بله بله بله بله بله

ویژگی‌ها

ویژگی مقدار شرح
autofocus autofocus مشخص می‌کند که فضای متن (text area) باید هنگام بارگذاری صفحه به‌صورت خودکار مورد تمرکز (focus) قرار بگیرد
cols number پهنای قابل مشاهده از یک فضای متن را مشخص می‌کند
dirname textareaname.dir مشخص می‌کند که جهت متن درون یک فضای متن، ارسال شود
disabled disabled مشخص می‌کند که فضای متن باید غیرفعال شود
form form_id مشخص می‌کند که فضای متن به کدام فرم تعلق دارد
maxlength number بیشینهٔ (حداکثر) تعداد کاراکترهایی که در فضای متن مجاز است را مشخص می‌کند
name text یک نام را برای یک فضای متن مشخص می‌کند
placeholder text یک اشارهٔ کوتاه را مشخص می‌کند که به توصیف مقدار مورد انتظار از یک فضای متن می‌پردازد
readonly readonly مشخص می‌کند که یک فضای متن باید فقط‌خواندنی باشد
required required مشخص می‌کند که فضای متن لازم است/باید پر شود
rows number تعداد خطوط قابل مشاهده در یک فضای متن را مشخص می‌کند
wrap hard

soft

مشخص می‌کند که متن درون فضای متن، باید برای ارسال فرم، خط‌شکنی (wrapped) شود

ویژگی‌های سراسری

همچنین برچسب <textarea> از ویژگی‌های سراسری (Global Attributes) در اچ‌تی‌ام‌ال پشتیبانی می‌کند.

ویژگی‌های رویداد

همچنین برچسب <textarea> از ویژگی‌های رویداد (Event Attributes) در اچ‌تی‌ام‌ال پشتیبانی می‌کند.

مثال‌های بیشتر

مثال

غیرفعال کردن گزینه تغییر اندازه پیش فرض:

<head>
<style>
textarea {
  resize: none;
}
</style>
</head>
<body>

<label for="w3review">Review of W3Schools:</label>

<textarea id="w3review" name="w3review" rows="4" cols="50">
At w3schools.com you will learn how to make a website. They offer free tutorials in all web development technologies.
</textarea>

</body>


صفحات مرتبط

مرجع DOM اچ‌تی‌ام‌ال: شیء Textarea (Textarea Object)

آموزش CSS: سبک‌دهی به فرم‌ها (Styling Forms)

تنظیمات پیش‌فرض CSS

ندارد.

منابع آموزشی