HTML DOM Button Object Properties

Previous >    <Next  

Button Object Properties ويژگي هاي شئ دكمه ـ

ويژگي هاي شي دكمه

‎شئ دكمه‎(Button Object)‎ كه توسط امكانات جاوااسكريت ايجادويا قابل دسترسي ‎است، داراي ويژگي هاي خاص بوده كه توسط جاوااسكريت بسادگي مطابق الگوي شئ گرائي قابل تنظيم ‎بوده ويا قابل دسترسي است .اين اشياء نماينده هاي عنصر‎HTML <button> tag‎ ‎ميباشد.، و درصفحه ميتوان توسط جاوااسكريپت مديريت نمود.

‎ويژگي هاي شئ دكمه ـButton Object Properties

‎ويژگي ‎شرح
autofocus ‎فوكوس شدن خودكار دكمه را درصفحه تنظيم ويا برگشت ميدهد.
disabled ‎وضعيت فعال بودن دكمه را تنظيم ويابرگشت ميدهد.
form ‎فرم مربوط به دكمه را برگشت ميدهد.
formAction ‎مقدار ويژگيformAction دكمه را تنظيم ويابرگشت ميشود .
formEnctype ‎مقدارويژگيformEntype دكمه راتنظيم يابرگشت ميدهد .
formMethod ‎ويژگيformMethod دكمه راتنظيم ويابرگشت ميدهد .
formNoValidate ‎ويژگيformNoValidate دكمه راتنظيم ويابرگشت ميدهد.
formTarget ‎ويژگيformTarget دكمه راتنظيم ويابرگشت ميدهد .
name ‎ويژگيname دكمه راتنظيم ويابرگشت ميدهد .
type ‎ويژگيtype دكمه راتنظيم ويابرگشت ميدهد .
value ‎ويژگيvalue دكمه راتنظيم ويابرگشت ميدهد .

‎ويژگيButton autofocus

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

‎توجه ـ ويژگي فوكوس خودكار براي عنصر‎<button>‎ جديداست .

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

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

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

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

‎برگشت ويژگيautofocus
buttonObject.autofocus

‎تنظيم ويژگيAutofocus
buttonObject.autofocus=true |false

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

‎ويژگي ‎شرح
autofocus ‎مشخص ميكند كه آيا يك دكمه بايد هنگام بارگيري صفحه فوكوس شود يانه
  • true‎ـ دكمه فوكوس ميشود
  • false‎ـ پيش فرض و دكمه داراي فوكوس نيست

‎صفحات مرتبط

HTML autofocus

‎ويژگيButton disabled

‎ويژگيButton disabled براي فعال ويا غير فعال نمودن عنصر HTML ‎<button>‎ ‎استفاده ميشود .يك عنصرغير فعال ،غيرقابل استفاده وغيرقابل كليك است .معمولا آنها توسط ‎مرورگرها بارنگ خاكستري نمايش داده ميشوند.

‎مثال ـ غير فعال نمودنbutton

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

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

‎اين ويژگي منعكس كننده ويژگيdisabled عنصرHTML ‎<button>‎ است .

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

‎برگشت ويژگيdisabled
buttonObject.disabled

‎تنظيم ويژگيdisabled
buttonObject.disabled=true |false

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

‎ويژگي ‎شرح
disabled ‎مشخص ميكند كه آيا يك دكمه بايد فعال باشد ياخير
  • true‎ـ دكمه غير فعال ميشود
  • false‎ـ دكمه فعال ميشود .پيش فرض ويژگي

‎مثال ـ بررسي فعال يا غير فعاليتbutton

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

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

‎صفحات مرتبط

HTML disabled Property

‎ويژگيButton form

‎ويژگيButton form فرمي را كه دكمه به آن متصل است مشخص ميكند .مقدار ويژگي شناسه فرمي ‎كه دكمه به آن متصل است .ويژگيButton form يك شئ فرم را درصورت موفقيت برميگرداند .

‎اين ويژگي فقط خواندني است.

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

var x = document.getElementById("myBtn").form.id;

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

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

buttonObject.form

‎مقدار برگشتيReturn Value :

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

‎ويژگيButton formAction

‎ويژگيformActon مقدار ويژگي formAction شئ دكمه اي را تنظيم يابرگشت ميدهد .

‎ويژگي فوق مشخص ميكند كه هنگام ارسال فرم، داده ها به كجا بايدارسال شود .اين ويژگي ‎ويژگيaction فرم رالغو ميكند .

‎ويژگيformAction فقط براي دكمه هاي با type="submit‎"‎استفاده ميشود .

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

var x = document.getElementById("myBtn").formAction;

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

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

‎برگشت ويژگيformAction
buttonObject.fromAction

‎تنظيم ويژگيformAction
buttonObject.fromAction =URL

‎مقادير ويژگيformAction

‎مقدار ‎شرح
URL ‎محلي كه بايد داده ها ارسال شود مشخص ميكند.
‎اين ويژگي ، ويژگيaction مربوط به عنصر ‎<form>‎ را لغوميكند .
‎مقادير ممكن:
  • ‎يك آدرسurl مطلق ‎(href="http://www.example.com/formresuult.asp‎")
  • ‎آدرس نسبيURL ـ اشاره در سايت جاري مثل‎(href="formresult.asp‎")

‎مثال ـ مقدار ويژگيfromAction شئ Button راتغيير يدهد .

document.getElementById("myBtn").formAction = "/action_page2.php";

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

‎مثال ـ مقدار ويژگيformAction دكمه برگشت ميشود .

var x = document.getElementById("myBtn").formAction;

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

‎صفحات مرتبط

HTML formAction Auttribute

‎ويژگيButton fromEnctype

‎ويژگيButton formEnctype مقدار ويژگي formEnctype دكمه اي راتنظيم ويا برگشت ميدهد . ‎اين ويژگي نحوي رمزگذاري داده ها قبل از ارسال به سرورمشخص ميكند .ويژگي فوق همچنين ويژگي Enctype‎مروط فرم مرتبط را لغو ميكند .

‎ويژگيformEnctype فقط براي دكمه هائي با type="submit‎"‎ميباشد .

‎توجه ـ ويژگيformEnctype براي عنصر‎<button>‎ درHTML5 جديد ميباشد.

‎مثال ـ روش رمزگذاري داده ها رابرگشت ميدهد.

var x = document.getElementById("myBtn").formEnctype;

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

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

‎برگشت ويژگيformEnctype
buttonObject.fromEnctype

‎تنظيم ويژگيformEnctype
buttonObject.fromEnctype =URL

‎مقادير ويژگيformEnctype

‎مقدار ‎شرح
application/x-
www-form-
urlencoded
‎همه كراكترها قبل از ارسال رمزگذاري ميشوند .اين پيش فرض است.
multipart/form-
data
‎هيچ كراكتري رمزگذاري نميشود.
‎اين براي فرم هاي داراي فايل آپلودي هستند لازم است.
text/plain ‎بلنك ها به علامت‎‎"+‎"‎ تبديل ميشوند .اما كراكتر هاي خاص كدگذاري نميشوند .

‎مثال ـ تغيير مقدار ويژگيformEnctype يك دكمه از‎‎"text/plain‎"‎ به "application/x-www-form-urlencoded"

document.getElementById("myBtn").formEnctype = "application/x-www-form-urlencoded";

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

‎مثال ـ مقدار ويژگيformEnctype رابرگشت ميدهد .

var x = document.getElementById("myBtn").formEnctype;

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

‎صفحات مرتبط

HTML <button>

‎ويژگيButton formMethod

‎ويژگيButton formMethod مقدار ويژگي formMethod دكمه اي راتنظيم ويا برگشت ميدهد . ‎اين ويژگي مشخص ميكند كه با كدامHTTPداده ها فرم بايد ارسال شوند .اين ويژگي ،باعث لغو ويژگي method‎فرم مرتبط ميشود .

‎ويژگيButton formMethod فقط حالت خواندني دارد . اين ويژگي براي دكمه هاي با ‎type="submit‎"‎ميتواند منظور شود .

‎مثال ـ روش ارسال داده ها را برگشت ميدهد .مقدار ويژگيformMethod

var x = document.getElementById("myBtn").formMethod;

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

‎داده هاي فرم را ميتوان به عنوان متغير هايURL با‎"‎ لثفmethod="يا بعنوان پستHTTP با mehod="post‎"‎ارسال. كرد .

‎نكاتي روي متد‎: ‎"get‎"

‎نكاتي درمورد روش‎: ‎"post‎"

‎توجه ـ ويژگيformMethod براي دكمه هاي ارسال در HTML5 جديد است .

‎پشتيباني مرورگرBrowser Support -‎

‎ويژگي Chorome Edge Firefox Safari Opera
formMethod Yes 10.0 Yes Yes Yes

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

‎برگشت ويژگيformMethod
buttonObject.fromMethod

‎تنظيم ويژگيformMethod
buttonObject.fromMethod =get |post

‎مقادير ويژگيformMethod

‎مقدار ‎شرح
get ‎داده هاي فرم را درurl بفرم زوج ‎name/value‎ اضافه ميكند
?name1=value1&name2=value2...
post ‎داده هاي فرم را بعنوان تراكنش پستHTTP ارسال ميكند .

‎مثال ـ متد ارسال داده ها را تغيير ميدهد.

document.getElementById("myBtn").formMethod = "post";

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

‎مثال ـ مثالي ديگر از برگشت مقدار ويژگيformMethod

var x = document.getElementById("myBtn").formMethod;

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

‎ويژگيButton formNoValidate

‎ويژگيButton formNoValidate تنظيم ويا برگشت ميدهد، كه آيا داده هاي فرم هنگام ارسال ‎بايد اعتبارسنجي شوند ياخير.

‎اين ويژگي براي دكمه باtype="submit‎"‎ميباشد .هنگاميكه مقدار آن true باشد، داده هاي فرم ‎هنگام ارسال اعتبار سنجي نميشوند .اما اگرمقدار ويژگيfalse باشد، ارسال همراه با اعتبارسنجي ‎داده هاي فرم است .اين حالت پيش فرض دكمه است.

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

var x = document.getElementById("myBtn").formNoValidate;

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

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

‎برگشت ويژگيformNoValidate
buttonObject.fromNoValidate

‎تنظيم ويژگيformNoValidate
buttonObject.fromNOValidate =true |false

‎مقادير ويژگيformNoValidate

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

‎مثال ـ تنظيم ويژگيformNoValidate دكمه فرم

document.getElementById("myBtn").formNoValidate = false;

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

‎صفحات مرتبط

HTML <button>

‎ويژگيButton formTarget

‎ويژگيButton formTarget مقدار ويژگي formTarget دكمه اي راتنظيم ويا برگشت ميدهد .اين ‎ويژگي مشخص ميكند كه نتايج فرم ارسالي كه بايد نمايش داده شود .اين ويژگي باعث لغو ويژگي target‎فرم مرتبط ميگردد .

‎ويژگيButton formTarget فقط براي دكمه هاي با type="submit‎"‎ ميباشد

‎توجه ـ اين ويژگي براي‎HTML5 <button>‎ جديد است .

‎مثال ـ محل نمايش نتايج ارسال فرم را نشان ميدهد.

var x = document.getElementById("myBtn").formTarget;

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

‎پشتيباني مرورگرBrowser Support -‎

‎ويژگي Chorome Edge Firefox Safari Opera
formTarget Yes 10.0 Yes Yes Yes

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

‎برگشت ويژگيformTarget
buttonObject.fromTarget

‎تنظيم ويژگيformTarget
buttonObject.fromNOValidate = "_blank" |"_self" |"_parent" |"_top" |framName

‎مقادير ويژگيformTarget

‎مقدارtarget ‎شرح
_blank ‎نتايج را در يك پنجره جديد باز و قرار ميدهد.
_self ‎نتايج را درهمان فريم مشابه قرار ميگيرد .اين مقدارپيش فرض اين ويژگي است
_parent ‎نتايج را در مجموعه فريم والدين باز وقرار ميدهد.
_top ‎نتايج را در پنجره اي كامل بازميكند وقرار ميدهد.
framename ‎نتايج رادر فريم مشخص شده قرار ميدهد.

‎مثال ـ مقدار ويژگيformTaget دكمه اي راتغيير ميدهد .

document.getElementById("myBtn").formTarget = "_self";

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

‎مثال ـ مثالي ديگر براي برگشت مقدار ويژگيformTarget

var x = document.getElementById("myBtn").formTarget;

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

‎ويژگيButton name

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

‎مثال ـ مقدار ويژگي نام دكمه را برگشت ميدهد.

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

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

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

‎برگشت ويژگيname
buttonObject.name

‎تنظيم ويژگيname
buttonObject.name =name

‎مثال ـ تغيير ويژگيname دكمه اي

document.getElementById("myBtn").name = "newButtonName";

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

‎ويژگيButton type

<>‎ويژگيBotton type مقدار ويژگيtype دكمه اي را تنظيم و يا برگشت ميدهد.

‎نكته ـ هميشه ويژگيtype را براي دكمه مشخص كنيد .نوع يش فرض اينترنت اكسپلورر ‎"button‎"‎ ‎است، درصورتيكه درساير مرورگرها‎"submit‎"‎ ميباشد .

‎مثال ـ مقدار ويژگيtype را براي دكمه اي برگشت ميدهد.

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

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

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

‎برگشت ويژگيname
buttonObject.type

‎تنظيم ويژگيtype
buttonObject.name =" submit" |"button" |"reset"

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

‎مقدار ‎شرح
submit ‎دكمه رابانوع‎"submit‎"‎مشخص ميكند .
‎اين براي همه مرورگرها پيش فرض است، بجز اينترنت اكسپلورر
button ‎دكمه اي قابل كليك كردن رامشخص ميكند .پيش فرض اينترنت اكسپلورر
reset ‎دكمه اي براي تنظيم مجدد صفحه‎)‎ صفحه پاك ميشود‎(‎.

‎مثال ـ نوع دكمه را به‎"submit‎"‎تبديل ميكند

document.getElementById("myBtn").type = "submit";

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

‎مثال ـ تغيير نوع دكمه به‎"reset‎"‎

document.getElementById("myBtn").type = "reset";

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

‎ويژگيButton value

‎ويژگيButton value مقدار ويژگي value دكمه راتنظيم ويا. برگشت ميدهد .ويژگي value مقدار ‎زمينه اي رابراي دكمه مشخص ميكند.

‎مهم ـ اگر عنصرHTML ‎<button>‎را در فرمي استفاده ميكنيد، مرورگرهاي مختلف مقدار ‎متفاوتي را ارسال ميكنند .اينترنت اكسپلورر متن موجود در دكمه را ، كه درشروع وپايان دكمه ‎وجود دارد، ارسال ميكند .مابقي مرورگرها مقدارويژگيvalue دكمه را ارسال ميكنند.

‎مثال ـ مقدار ويژگيvalue دكمه اي رابرگشت ميدهد .

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

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

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

‎برگشت ويژگيvalue
buttonObject.value

‎تنظيم ويژگيvalue
buttonObject.value =text

‎مقادير ويژگيvalue

‎مقدارvalue ‎شرح
text ‎مقدار اوليه دكمه

‎مثال ـ ويژگيvalue دكمه اي راتغيير ميدهد .

document.getElementById("myBtn").value = "newButtonValue";

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


Previous >    <Next