Textarea Object Properties

Previous >    <Next  

‎ويژگي هاي شئTextarea

‎شئTextarea كه درجاوااسكريپت ايجاد ميشود، مرتبط با يكي از عناصرHTML‎<textarea>‎ ‎صفحه ميباشد .اين شئ داراي ويژگي هاي همان عنصر‎<textarea>‎ است كه ميتوان با ‎فرمت شئ گرائي با شئ مذكور روي آن اثر گذاشت .بعبارتي ميتوان مقادير ويژگيهاي آنرا تنظيم ويا ‎بدست آورد.

‎جدول ويژگي هاي شئTextarea مطابق زير بوده ، ودراين صفحه هركدام دربخش داخلي تشريح ميشوند.

‎ويژگي ‎شرح
autofocus ‎مشخص ميكند كه يك ناحيه متني هنگاميكه صفحه بارگذاري ميشود، فوكوس شود يانه.
cols ‎تعداد ستون يك ناخيه متني را مشخص ميكند
defaultValue ‎مقدار پيش فرض ناحيه متني را تنظيم ويابرگشت ميدهد.
disabled ‎وضعيت غيرفعال بودن ناحيه متني را مشخص ميكند.
form ‎مشخص كننده فرمي است كه ناحيه متني متعلق به آنست
maxLength ‎حداكثر كراكتر يك ناحيه متني را مشخص ميكند.
name ‎نامي را براي ناحيه متني مشخص ميكند.
placeholder ‎مقدار ويژگيplaceholder را براي ناحيه متني تنظيم ويابرگشت ميدهد .
readonly ‎وضعيت فقط خواندني ناحيه متني را مشخص ميكند.
required ‎وضعيت ضرورت تكميل ناحيه متني را مشخص ميكند.
rows ‎تعداد خط قابل مشاهده را در ناحيه متني مشخص ميكند.
type ‎نوع فرمي كه ناحيه متني متعلق به آنست برگشت ميدهد.
value ‎ويژگيValue محتوي ناحيه متني را تنظيم ويابرگشت ميدهد .
warp ‎مقدار ويژگيwarp ناحيه متني را تنظيم ويا برگشت ميدهد .

‎ويژگيTextarea autofocus

‎ويژگيTextarea autofocus كه مربوط به عنصر HTML ‎<textare>‎ مرتبط با شئ Textarea‎ميباشد، مشخص ميكند كه آيا بايد عنصر هنگام بار گذاري صفح بطور خودكار فوكوس شود ‎يانه.

‎مثال ـ بررسي اينكه ناحيه متني هنگام بارگذاري صفحه فوكوس ميشود يانه

var x = document.getElementById("myTextarea").autofocus;

--(go to editor for change code and run)

‎فرمت استفاده ـSyntax

‎فرمت برگشت ويژگي
texteaObject.autofocus

‎فرمت تنظيم ويژگي
textareaObject.autofocus=true |false

‎مقادير ويژگي ـProperty Values

‎مقدار ‎شرح
true|false ‎مشخص ميكند كه آيا يا ناحيه متني هنگام بارگذاري صفحه خودكار فوكوس ميشود يانه
  • true‎ـ بصورت خود فوكوس ميشود .
  • false‎ـ فوكوس نميشود .

‎ويژگيTextarea cols

‎ويژگيTextarea cols كه مربوط به عنصرHTML ‎<textare>‎ مرتبط با شئ Textarea‎ميباشد .اين ويژگي عرض ناحيه متني قابل مشاهده را برحسب تعداد كراكتر مشخص ميكند.

‎مثال ـ تغيير عرض ناحيه متني

document.getElementById("myTextarea").cols = "100";

--(go to editor for change code and run)

‎نكته ـ ميتوان عرض ناحيه متني را از طريقstyle.width اقدام نمود .

‎عرض ناحيه براساس اندازه متوسط كراكتر كه پيش فرض آن‎20px‎ است بدست مي آيد .

‎فرمت استفاده ـSyntax

‎فرمت برگشت ويژگي
texteaObject.cols

‎فرمت تنظيم ويژگي
textareaObject.cols=number

‎مقادير ويژگي ـProperty Values

‎مقدار ‎شرح
number ‎اندازه عرض ناحيه متني را برحسب تعداد كراكتر مشخص ميكند.
‎عرض قابل مشاهده از ضرب انداره متوسط كراكتر در تعداد بدست مي ايد.
‎پيش فرض اندازه متوسط كراكتر‎20‎ است .

‎مثال ـ دريافت عرض ناحيه متني برحسب كراكتر

var x = document.getElementById("myTextarea").cols;

--(go to editor for change code and run)

‎مثال ـ تغيير عرض ناحيه متني از طريقstyle.width

document.getElementById("myTextarea").style.width = "500px";

--(go to editor for change code and run)

‎ويژگيTextarea defaultValue

‎ويژگيTextarea defaultValue كه مربوط به عنصرHTML ‎<textare>‎ مرتبط با شئ Textarea‎ميباشد .اين ويژگي مقدار پيش فرض ناحيه متني را مشخص ميكند.

‎توجه ـ مقدارپيش فرض ناحيه متني محتوي بين‎<textarea>‎ و‎</textarea>‎ ‎ميباشد.

‎مثال ـ تغيير مقدار پيش فرض ناحيه متني

document.getElementById("myTextarea").defaultValue = "Fifth Avenue, New York City";

--(go to editor for change code and run)

‎فرمت استفاده ـSyntax

‎فرمت برگشت ويژگي
texteaObject.defaultValue

‎فرمت تنظيم ويژگي
textareaObject.defaultValue=text

‎مقادير ويژگي ـProperty Values

‎مقدار ‎شرح
text ‎محتوي ناحيه متني رامشخص ميكند.
<textarea>text</textarea>

‎مقدار برگشتي همان متن بين تگ شروع وتگ پاياني ناحيه متني است.

‎مثال ـ دريافت مقدار پيش فرض ناحيه متني

var x = document.getElementById("myTextarea").defaultValue;

--(go to editor for change code and run)

‎ويژگيTextarea disabled

‎ويژگيTextarea disabled كه مربوط به عنصرHTML ‎<textare>‎ مرتبط با شئ Textarea‎ميباشد، مشخص ميكند كه آيا عنصر ناحيه متني غير فعال است يا نه

‎مثال ـ غير فعال نمودن ناحيه متني

document.getElementById("myTextarea").disabled = true;

--(go to editor for change code and run)

‎نكته ـ اگر بخواهيد ناحيه متني فقط خواندني باشد از ويژگيreadonly استفاده. شود .

‎فرمت استفاده ـSyntax

‎فرمت برگشت ويژگي
texteaObject.disabled

‎فرمت تنظيم ويژگي
textareaObject.disabled=true |false

‎مقادير ويژگي ـProperty Values

‎مقدار ‎شرح
true|false ‎مشخص ميكند كه آيا يا ناحيه متني غير فعال است يا فعال
  • true‎ـ ناحيه متني غيرفعال است.
  • false‎ـ ناحيه متني فعال است

‎مثال ـ بررسي فعال وياغير فعال بودن ناحيه متني

var x = document.getElementById("myTextarea").disabled;

--(go to editor for change code and run)

‎مثال ـ فعال يا غير فعال نمودن ناحيه متني

function disableTxt() {
  document.getElementById("myTextarea").disabled = true;
}

function undisableTxt() {
  document.getElementById("myTextarea").disabled = false;
}

--(go to editor for change code and run)

‎ويژگيTextarea form

‎ويژگيTextarea form كه مربوط به عنصرHTML ‎<textarea>‎ مرتبط با شئ Textarea‎ميباشد، اين ويژگي فرمي كه ناحيه متني متعلق به آنست رامشخص ميكند.

‎مثال ـ فرمي را كه ناحيه متني به آن متعلق است، برگشت ميدهد.

var x = document.getElementById("myTextarea").form.id

--(go to editor for change code and run)

‎برگشتي اين ويژگي در صورت موفقيت ، يك شئ فرم ميباشدكه ناحيه متني متعلق به آنست.

‎فرمت استفاده ـSyntax

‎فرمت برگشت ويژگي
texteaObject.form

‎ويژگيTextarea maxLength

‎ويژگيTextarea maxLength كه مربوط به عنصرHTML ‎<textarea>‎ مرتبط با شئ Textarea‎ميباشد، اين ويژگي حداكثر كراكتر ناحيه متني رامشخص ميكند.

‎مثال ـ در يافت حداكثر تعداد كراكتر مجاز در ناحيه متني

var x = document.getElementById("myTextarea").maxLength;

--(go to editor for change code and run)

‎فرمت استفاده ـSyntax

‎فرمت برگشت ويژگي
texteaObject.maxLength

‎فرمت تنظيم ويژگي
texteaObject.maxLength=number

‎مثال ـ تغيير حداكثر كراكتر مجاز در ناحيه متني

document.getElementById("myTextarea").maxLength = "4";

--(go to editor for change code and run)

‎ويژگيTextarea name

‎ويژگيTextarea name كه مربوط به عنصرHTML ‎<textarea>‎ مرتبط با شئ Textarea‎ميباشد، اين ويژگي نامي را براي ناحيه متني مشخص ميكند.

‎ويژگيname براي ارجاع به عناصر در جاوااسكريپت ويا براي ارجاع به داده هاي عناصر فرم پس از ‎ارسال استفاده ميشوند.

‎مثال ـ در يافت نام ناحيه متني

var x = document.getElementById("myTextarea").name;

--(go to editor for change code and run)

<>

‎فرمت استفاده ـSyntax

‎فرمت برگشت ويژگي
texteaObject.name

‎فرمت تنظيم ويژگي
texteaObject.name=text

‎مثال ـ تغيير نام ناحيه متني

document.getElementById("myTextarea").name = "newTxtName";

--(go to editor for change code and run)

‎ويژگيTextarea placeholder

‎ويژگيTextarea placeholder كه مربوط به عنصرHTML ‎<textarea>‎ مرتبط با شئ Textarea‎ميباشد، اين ويژگي توضيح مختصر ناحيه متني رامشخص ميكند .ودر صورتيكه ناحيه متني ‎تهي باشد درآن قرار ميگيرد.

‎اين توضيح مختصر ميتواند مقدار نمونه يا فرمت مورد انتظار در ناحيه متني باشد .در هنگام فوكوس ‎ناحيه متني ناپديد ميشود.

‎مثال ـ تغيير ويژگيplaceholder ناحيه متني

document.getElementById("myTextarea").placeholder = "Where do you live?";

--(go to editor for change code and run)

‎فرمت استفاده ـSyntax

‎فرمت برگشت ويژگي
texteaObject.placeholder

‎فرمت تنظيم ويژگي
texteaObject.placeholder=text

‎مثال ـ دريافت مقدارplaceholder ناحيه متني

var x = document.getElementById("myTextarea").placeholder;

--(go to editor for change code and run)

‎ويژگيTextarea readOnly

‎ويژگيTextarea readOnly كه مربوط به عنصرHTML ‎<textarea>‎ مرتبط با شئ Textarea‎ميباشد، اين ويژگي وضعيت فقط خواندني ناحيه متني را مشخص ميكند. ‎در حالتيكه ناحيه متني فقط خواندني باشد، محتوي آنرا نميتوان تغيير داد.

‎مثال ـ تنظيم ناحيه متني بحالت فقط خواندني

document.getElementById("myTextarea").readOnly = true;

--(go to editor for change code and run)

‎نكته ـ براي جلوگيري از تعامل كاربر با ناحيه متني از ويژگيdisabled استفاده نمائيد .

‎فرمت استفاده ـSyntax

‎فرمت برگشت ويژگي
texteaObject.readOnly

‎فرمت تنظيم ويژگي
texteaObject.readOnly=true |false

‎مقادير ويژگي ـProperty Values

‎مقدار ‎شرح
true|false ‎مشخص ميكند كه آيا ناحيه متني فقط خواندني است يانه
  • true‎ـ ناحيه متني فقط خواندني
  • false‎ـ خواندني ونوشتني

‎مثال ـ بررسي وضعيت خواندني ناحيه متني

var x = document.getElementById("myTextarea").readOnly;

--(go to editor for change code and run)

‎ويژگيTextarea required

‎ويژگيTextarea required كه مربوط به عنصرHTML ‎<textarea>‎ مرتبط با شئ Textarea‎ميباشد، اين ويژگي وضعيت ضرورت تكميل ناحيه متني را مشخص ميكند .يعني مشخص ميكند ‎كه ناحيه متني قبل از ارسال فرم بايد پرشده باشد، يا ضرورت ندارد.

‎مثال ـ بررسي ضرورت پركردن فايل متني قبل از ارسال فرم

var x = document.getElementById("myTextarea").required;

--(go to editor for change code and run)

‎فرمت استفاده ـSyntax

‎فرمت برگشت ويژگي
texteaObject.required

‎فرمت تنظيم ويژگي
texteaObject.required=true |false

‎مقادير ويژگي ـProperty Values

‎مقدار ‎شرح
true|false ‎مشخص ميكند كه آيا ناحيه متني قبل از ارسال فرم بايد پرشود، يانه
  • true‎ـ ناحيه متني بايد پرشود
  • false‎ـ ناحيه متني قبل ارسال فرم ميتواند خالي باشد.

‎مثال ـ تنظيم ناحيه متني براي پرشدن قبل از ارسال فرم

document.getElementById("myTextarea").required = true;

--(go to editor for change code and run)

‎ويژگيTextarea rows

‎ويژگيTextarea rows كه مربوط به عنصرHTML ‎<textare>‎ مرتبط با شئ Textarea‎ميباشد .اين ويژگي ارتفاع ناحيه متني قابل مشاهده را برحسب تعدادسطر مشخص ميكند.

‎مثال ـ تغيير تعداد سطر قابل مشاهده ناحيه متني

document.getElementById("myTextarea").rows = "10";

--(go to editor for change code and run)

‎نكته ـ ميتوان براي ارتفاع ناحيه متني ازstyle.height استفاده كرد .

‎فرمت استفاده ـSyntax

‎فرمت برگشت ويژگي
texteaObject.rows

‎فرمت تنظيم ويژگي
textareaObject.rows=number

‎مثال ـ دريافت ارتفاع قابل مشاهده ناحيه متني برحسب تعداد سطر

var x = document.getElementById("myTextarea").rows;

--(go to editor for change code and run)

‎مثال ـ تغيير ارتفاع ناحيه متني با استفاده ازstyle.height

document.getElementById("myTextarea").style.height = "250px";

--(go to editor for change code and run)

‎ويژگيTextarea type

‎ويژگيTextarea type كه مربوط به عنصرHTML ‎<textare>‎ مرتبط با شئ Textarea‎ميباشد .اين ويژگي نوع عنصر فرم را مشخص ميكند .براي عنصر متنيtextarea ميباشد .

‎مثال ـ بررسي نوع عنصري در فرم باid="myTextarea‎"‎

var x = document.getElementById("myTextarea").type;

--(go to editor for change code and run)

‎فرمت استفاده ـSyntax

‎فرمت برگشت ويژگي
texteaObject.type

‎ويژگيTextarea value

‎ويژگيTextarea value كه مربوط به عنصرHTML ‎<textare>‎ مرتبط با شئ Textarea‎ميباشد .اين ويژگي مقدار محتوي ناحيه متني را مشخص ميكند، مقدار اين ويژگي متني است ‎كه بين‎<textarea> ..</textarea>‎ قرار ميگيرد .

‎مثال ـ تغيير محتوي ناحيه متني

document.getElementById("myTextarea").value = "Fifth Avenue, New York City";

--(go to editor for change code and run)

‎فرمت استفاده ـSyntax

‎فرمت برگشت ويژگي
texteaObject.value

‎فرمت تنظيم ويژگي
textareaObject.rows=text

‎مثال ـ دريافت محتوي ناحيه متني

var x = document.getElementById("myTextarea").value;

--(go to editor for change code and run)

‎ويژگيTextarea warp

‎ويژگيTextarea warp كه مربوط به عنصرHTML ‎<textare>‎ مرتبط با شئ Textarea‎ميباشد .اين ويژگي چگونگي تنظيم محتوي ناحيه متني را در هنگام ارسال فرم ‎مشخص ميكند.

‎مثال ـ چگونگي تنظيم محتوي ناحيه متني را در هنگام ارسال فرم، برگشت ميدهد.

var x = document.getElementById("myTextarea").wrap;

--(go to editor for change code and run)

‎فرمت استفاده ـSyntax

‎فرمت برگشت ويژگي
texteaObject.warp

‎فرمت تنظيم ويژگي
textareaObject.warp=soft | hard

‎مقادير ويژگي ـproperty Values

‎مقدار ‎شرح
soft ‎محتوي ناحيه متني بدون تنظيمي ارسال ميشود .اين حالت پيش فرض است
hard ‎وقتي محتوي ناحيه متني ارسال ميشود، تنظيم جديد خواهد شد .متن در خطوط جديدي تنظيم ميگردد.
‎براي اين مقدار ويژگي بايد ويژگيcols مشخص شده باشد .

Previous >    <Next