شئTextarea كه درجاوااسكريپت ايجاد ميشود، مرتبط با يكي از عناصرHTML<textarea> صفحه ميباشد .اين شئ داراي ويژگي هاي همان عنصر<textarea> است كه ميتوان با فرمت شئ گرائي با شئ مذكور روي آن اثر گذاشت .بعبارتي ميتوان مقادير ويژگيهاي آنرا تنظيم ويا بدست آورد.
جدول ويژگي هاي شئTextarea مطابق زير بوده ، ودراين صفحه هركدام دربخش داخلي تشريح ميشوند.
ويژگي | شرح |
---|---|
autofocus | مشخص ميكند كه يك ناحيه متني هنگاميكه صفحه بارگذاري ميشود، فوكوس شود يانه. |
cols | تعداد ستون يك ناخيه متني را مشخص ميكند |
defaultValue | مقدار پيش فرض ناحيه متني را تنظيم ويابرگشت ميدهد. |
disabled | وضعيت غيرفعال بودن ناحيه متني را مشخص ميكند. |
form | مشخص كننده فرمي است كه ناحيه متني متعلق به آنست |
maxLength | حداكثر كراكتر يك ناحيه متني را مشخص ميكند. |
name | نامي را براي ناحيه متني مشخص ميكند. |
placeholder | مقدار ويژگيplaceholder را براي ناحيه متني تنظيم ويابرگشت ميدهد . |
readonly | وضعيت فقط خواندني ناحيه متني را مشخص ميكند. |
required | وضعيت ضرورت تكميل ناحيه متني را مشخص ميكند. |
rows | تعداد خط قابل مشاهده را در ناحيه متني مشخص ميكند. |
type | نوع فرمي كه ناحيه متني متعلق به آنست برگشت ميدهد. |
value | ويژگيValue محتوي ناحيه متني را تنظيم ويابرگشت ميدهد . |
warp | مقدار ويژگيwarp ناحيه متني را تنظيم ويا برگشت ميدهد . |
ويژگيTextarea autofocus كه مربوط به عنصر HTML <textare> مرتبط با شئ Textareaميباشد، مشخص ميكند كه آيا بايد عنصر هنگام بار گذاري صفح بطور خودكار فوكوس شود يانه.
مثال ـ بررسي اينكه ناحيه متني هنگام بارگذاري صفحه فوكوس ميشود يانه
var x = document.getElementById("myTextarea").autofocus;
مقدار | شرح |
---|---|
true|false | مشخص ميكند كه آيا يا ناحيه متني هنگام بارگذاري صفحه خودكار فوكوس ميشود يانه
|
ويژگيTextarea cols كه مربوط به عنصرHTML <textare> مرتبط با شئ Textareaميباشد .اين ويژگي عرض ناحيه متني قابل مشاهده را برحسب تعداد كراكتر مشخص ميكند.
مثال ـ تغيير عرض ناحيه متني
document.getElementById("myTextarea").cols = "100";
نكته ـ ميتوان عرض ناحيه متني را از طريقstyle.width اقدام نمود .
عرض ناحيه براساس اندازه متوسط كراكتر كه پيش فرض آن20px است بدست مي آيد .
مقدار | شرح |
---|---|
number | اندازه عرض ناحيه متني را برحسب تعداد كراكتر مشخص ميكند.
عرض قابل مشاهده از ضرب انداره متوسط كراكتر در تعداد بدست مي ايد. پيش فرض اندازه متوسط كراكتر20 است . |
مثال ـ دريافت عرض ناحيه متني برحسب كراكتر
var x = document.getElementById("myTextarea").cols;
مثال ـ تغيير عرض ناحيه متني از طريقstyle.width
document.getElementById("myTextarea").style.width = "500px";
ويژگيTextarea defaultValue كه مربوط به عنصرHTML <textare> مرتبط با شئ Textareaميباشد .اين ويژگي مقدار پيش فرض ناحيه متني را مشخص ميكند.
توجه ـ مقدارپيش فرض ناحيه متني محتوي بين<textarea> و</textarea> ميباشد.
مثال ـ تغيير مقدار پيش فرض ناحيه متني
document.getElementById("myTextarea").defaultValue = "Fifth Avenue, New York City";
مقدار | شرح |
---|---|
text | محتوي ناحيه متني رامشخص ميكند.
<textarea>text</textarea> |
مقدار برگشتي همان متن بين تگ شروع وتگ پاياني ناحيه متني است.
مثال ـ دريافت مقدار پيش فرض ناحيه متني
var x = document.getElementById("myTextarea").defaultValue;
ويژگيTextarea disabled كه مربوط به عنصرHTML <textare> مرتبط با شئ Textareaميباشد، مشخص ميكند كه آيا عنصر ناحيه متني غير فعال است يا نه
مثال ـ غير فعال نمودن ناحيه متني
document.getElementById("myTextarea").disabled = true;
نكته ـ اگر بخواهيد ناحيه متني فقط خواندني باشد از ويژگيreadonly استفاده. شود .
مقدار | شرح |
---|---|
true|false | مشخص ميكند كه آيا يا ناحيه متني غير فعال است يا فعال
|
مثال ـ بررسي فعال وياغير فعال بودن ناحيه متني
var x = document.getElementById("myTextarea").disabled;
مثال ـ فعال يا غير فعال نمودن ناحيه متني
function disableTxt() { document.getElementById("myTextarea").disabled = true; } function undisableTxt() { document.getElementById("myTextarea").disabled = false; }
ويژگيTextarea form كه مربوط به عنصرHTML <textarea> مرتبط با شئ Textareaميباشد، اين ويژگي فرمي كه ناحيه متني متعلق به آنست رامشخص ميكند.
مثال ـ فرمي را كه ناحيه متني به آن متعلق است، برگشت ميدهد.
var x = document.getElementById("myTextarea").form.id
برگشتي اين ويژگي در صورت موفقيت ، يك شئ فرم ميباشدكه ناحيه متني متعلق به آنست.
ويژگيTextarea maxLength كه مربوط به عنصرHTML <textarea> مرتبط با شئ Textareaميباشد، اين ويژگي حداكثر كراكتر ناحيه متني رامشخص ميكند.
مثال ـ در يافت حداكثر تعداد كراكتر مجاز در ناحيه متني
var x = document.getElementById("myTextarea").maxLength;
مثال ـ تغيير حداكثر كراكتر مجاز در ناحيه متني
document.getElementById("myTextarea").maxLength = "4";
ويژگيTextarea name كه مربوط به عنصرHTML <textarea> مرتبط با شئ Textareaميباشد، اين ويژگي نامي را براي ناحيه متني مشخص ميكند.
ويژگيname براي ارجاع به عناصر در جاوااسكريپت ويا براي ارجاع به داده هاي عناصر فرم پس از ارسال استفاده ميشوند.
مثال ـ در يافت نام ناحيه متني
var x = document.getElementById("myTextarea").name;
مثال ـ تغيير نام ناحيه متني
document.getElementById("myTextarea").name = "newTxtName";
ويژگيTextarea placeholder كه مربوط به عنصرHTML <textarea> مرتبط با شئ Textareaميباشد، اين ويژگي توضيح مختصر ناحيه متني رامشخص ميكند .ودر صورتيكه ناحيه متني تهي باشد درآن قرار ميگيرد.
اين توضيح مختصر ميتواند مقدار نمونه يا فرمت مورد انتظار در ناحيه متني باشد .در هنگام فوكوس ناحيه متني ناپديد ميشود.
مثال ـ تغيير ويژگيplaceholder ناحيه متني
document.getElementById("myTextarea").placeholder = "Where do you live?";
مثال ـ دريافت مقدارplaceholder ناحيه متني
var x = document.getElementById("myTextarea").placeholder;
ويژگيTextarea readOnly كه مربوط به عنصرHTML <textarea> مرتبط با شئ Textareaميباشد، اين ويژگي وضعيت فقط خواندني ناحيه متني را مشخص ميكند. در حالتيكه ناحيه متني فقط خواندني باشد، محتوي آنرا نميتوان تغيير داد.
مثال ـ تنظيم ناحيه متني بحالت فقط خواندني
document.getElementById("myTextarea").readOnly = true;
نكته ـ براي جلوگيري از تعامل كاربر با ناحيه متني از ويژگيdisabled استفاده نمائيد .
مقدار | شرح |
---|---|
true|false | مشخص ميكند كه آيا ناحيه متني فقط خواندني است يانه
|
مثال ـ بررسي وضعيت خواندني ناحيه متني
var x = document.getElementById("myTextarea").readOnly;
ويژگيTextarea required كه مربوط به عنصرHTML <textarea> مرتبط با شئ Textareaميباشد، اين ويژگي وضعيت ضرورت تكميل ناحيه متني را مشخص ميكند .يعني مشخص ميكند كه ناحيه متني قبل از ارسال فرم بايد پرشده باشد، يا ضرورت ندارد.
مثال ـ بررسي ضرورت پركردن فايل متني قبل از ارسال فرم
var x = document.getElementById("myTextarea").required;
مقدار | شرح |
---|---|
true|false | مشخص ميكند كه آيا ناحيه متني قبل از ارسال فرم بايد پرشود، يانه
|
مثال ـ تنظيم ناحيه متني براي پرشدن قبل از ارسال فرم
document.getElementById("myTextarea").required = true;