HTML DOM Input Week Object
Previous > <Nextشئ ورودي هفته ـInput Week
شئInput Week منتسب با يك عنصرHTML <input> ميباشد .با شئ فوق ميتوان عنصرHTML <input> صفحه را بصورت اقدامات شئ گرائي مديريت كرد.
بايد عنصر<input> مرتبط با شئInput Week داراي ويژگيtype="week" باشد .مقدار پيش فرض ويژگيtype براي عنصر input مقدار "text"ميباشد .
شئInput Week يك فيلد وردي تاريخ كه داراي جزء سال و هفته(YYYY-Www ) است را ارائه ميدهد.
توجه ـ<input type="week"> در مرورگرهايIE11 ،Firefox و Safari پشتيباني نمي شود.
دسترسي به شئInput Week
ميتوان بيك عنصر<input type="week"> بوسيله متدgetElementById() دسترسي پيدا گرد.
مثال ـ دسترسي به شئInput Week باid="myWeek"
var x = document.getElementById("myWeek");
ايجاد شئInput Week
با متدdocument.createElement() ميتوان شئInput Week را ايجاد نمود .بعبارتي ميتوان عنصر<input> را با ويژگيtype="week" ايجاد كرد.
مثال ـ ايجاد شئInput Week
var x = document.createElement("INPUT");
x.setAttribute("type", "week");
ويژگي هايInput Week Object
| ويژگي | شرح |
|---|---|
| autocomplete | مقدار ويژگيautocomplete را تنظيم ويابرگشت ميدهد .
ويژگي تكميل خودكار شئInput Week |
| autofocus | ويژگي مشخص ميكند كه آيا عنصر بصورت اتوماتيك در بارگذاري انتخاب شود. |
| defaultValue | مقدار پيش فرض فيلد ورودي راتنظيم ويا برميگرداند. |
| disabled | وضعيت فعال بودن عنصر را تنظيم ويابرگشت ميدهد. |
| form | ويژگيform مشخص ميكند كه فيلد ورودي ، متعلق بكدام عنصرفرم است. |
| list | فهرستي از عنصر<datalist> كه شامل ليستي ازتاريخ هفته است برگشت ميدهد. |
| max | ماكزيمم براي فيلد تاريخ هفته مشخص ميكند. |
| min | ويژگي مقدار مينيمم را براي فيلد تاريخ هفته مشخص ميكند |
| name | ويژگيname نامي را براي فيلد ورودي مشخص ميكند. |
| readonly | مشخص ميكند كه فيلد ورودي فقط خواندني است |
| required | مشخص ميكند كه فيلد ورودي ضروري است وبايد تكميل شود. |
| step | مقدار ويژگيstep فيلد تاريخ هفته را مشخص ميكند.
مقدار ويژگيstep براي جزء هفته(WW) عمل ميشود. |
| type | ويژگيtype نوع عنصر ورودي را مشخص ميكند .
type="week"برايInput Week |
| value | مقدار ويژگيvalue را براي فيلد برگشت ويا تنظيم ميكند. |
متد هاي شئInput Week
| متد | شرح |
|---|---|
| select() | يك فيلد متني تاريخ را انتخاب ميكند |
| stepDown() | محتوي يك فيلد تاريخ هفته رابا عدد مشخصي برحسب تعداد هفته كاهش ميدهد.
فقط هفته تاريخ، جزءww مستقيم تغيير ميكند ولي دراثر تغيير بقيه اجزاء هم تنظيم ميشود . |
| stepUp() | محتوي يك فيلد تاريخ هفته با عدد مشخصي برحسب تعداد هفته افزايش ميدهد.
فقط هفته تاريخ، جزءww مستقيم تغيير وبا اجزاء ديگر تاريخ تنظيم ميشود. |
در ادامه بعضي از ويژگي شئ مذكور در بخشهاي همين صفحه تشريح ميشوند، اما متدهاي آن در صفحه بعدي تشريح ميگردند.
ويژگيInput Week max
ويژگيInput Week max مقدار ويژگيmax عنصر<input> مرتبط با شئInput Week را تنظيم ويا برگشت ميدهد .مقدار اين ويژگي حداكثر را براي فيلد تاريخ هفته مشخص ميكند، كه شئ Input Weekنمايانگر فيلد تاريخ هفته ميباشد . فرمت اين تاريخ بصورتYYYY-WW ميباشد.
مثال ـ دريافت ماكزيمم تاريخ مجاز براي فيلد تاريخ هفته
var x = document.getElementById("myWeek").max;
نكته ـ از ويژگيmax همراهmin براي محدوده فيلدتاريخ هفته قابل قبول استفاده كنيد.
فرمت استفاده ـSyntax
فرمت برگشت ويژگي
weekObject.max
فرمت تنظيم ويژگي
weekObject.max=YYYY-Www
مقادير ويژگي ـProperty Values
| مقدار | شرح |
|---|---|
| YYYY-Www | ماكريمم تاريخ مجاز براي فيلد تاريخ هفته
تشريح اجزاء ويژگي:
|
پشتيباني مرورگرBrowser Support -
| ويژگي | 
| 
| 
| 
| 
|
|---|---|---|---|---|---|
| max | Yes | 10.0 | Yes | Yes | Yes |
توجه ـ عنصر<input type="week"> هيچ فيلد / تقويم را در فايرفاكس نشان نمي دهد.
مثال ـ حد اكثر هفته وسال مجاز را تغيير ميدهد.
document.getElementById("myWeek").max = "2014-W35";
ويژگيInput Week min
ويژگيInput Week min مقدار ويژگيmin عنصر<input> مرتبط با شئInput Week را تنظيم ويا برگشت ميدهد .مقدار اين ويژگي حداقل را براي فيلد تاريخ هفته مشخص ميكند، كه شئ Input Weekنمايانگر فيلد تاريخ هفته ميباشد . فرمت اين تاريخ بصورتYYYY-WW ميباشد.
مثال ـ دريافت مينيمم تاريخ مجاز براي فيلد تاريخ هفته
var x = document.getElementById("myWeek").min;
نكته ـ از ويژگيmax همراهmin براي محدوده فيلدتاريخ هفته قابل قبول استفاده كنيد.
فرمت استفاده ـSyntax
فرمت برگشت ويژگي
weekObject.min
فرمت تنظيم ويژگي
weekObject.min=YYYY-Www
مقادير ويژگي ـProperty Values
مقادير مشابه با جدول مربوط به ويژگي ماكزيمم است، كه در بالا توضيح داده شده است .نحوي پشتيباني مرورگر ها هم مشابه است.
مثال ـ حد اقل هفته وسال مجاز را تغيير ميدهد.
document.getElementById("myWeek").min = "2014-W16";
ويژگيInput Week step
ويژگيInput Week step مقدار ويژگيstep عنصر<input> مرتبط با شئInput Weekرا تنظيم ويا برگشت ميدهد .مقدار اين ويژگي روي فيلد تاريخ هفته، كه شئ Input Weekنمايانگر آن است تاثير ميكند.
ويژگيstep براي فيلد تاريخ هفته فاصل قانوني را مشخص ميكند كه كاربر ميتواند تقويم را در فيلد باز كند .فاصله فقط در هفته تاريخ تاثير دارد .بعنوان مثال اگرstep="2"باشد، تقويم با فاصله دو هفته دو هفته ميتواند انتخاب شود.
مثال ـ تغيير فواصل قانوني در تقويم انتخاب
document.getElementById("myWeek").step = "2";
فرمت استفاده ـSyntax
فرمت برگشت ويژگي
اweekObject.step
فرمت تنظيم ويژگي
weekObject.min=YYYY-Www
مقادير ويژگي ـProperty Values
| مقدار | شرح |
|---|---|
| number | فواصل قانوني هفته هارا مشخص ميكند.
مثالها:
|
مثال ـ فواصل هفته هاي قانوني دريافت ميشود.
var x = document.getElementById("myWeek").step;
ويژگيInput Week Value
ويژگيInput Week value مقدار ويژگيvalue عنصر<input> مرتبط با شئInput Week را تنظيم ويا برگشت ميدهد .اين ويژگي تاريخ هفته را براي فيلد ورودي مشخص ميكند، كه شئ Input Weekنمايانگر فيلد تاريخ هفته ميباشد.
مقدار اين ويژگي مشخص كننده شماره هفته وسال براي يك فيلد ورودي هفته ميباشد.
مثال ـ تنظيم مقدار هفته سال يك فيلد ورودي هفته
document.getElementById("myWeek").value = "2014-W48";
توجه ـ عنصر<input type="week"> هيچ فيلد / تقويم را در فايرفاكس نشان نمي دهد.
فرمت استفاده ـSyntax
فرمت برگشت ويژگي
weekObject.value
فرمت تنظيم ويژگي
weekObject.value=YYYY-Www
مقادير ويژگي ـProperty Values
مقادير مشابه با جدول مربوط به ويژگي ماكزيمم است، كه در بالا توضيح داده شده است .نحوي پشتيباني مرورگر ها هم مشابه است.
مثال ـ دريافت هفته وسال از يك فيلد ورودي هفته
var x = document.getElementById("myWeek").value;
شئInput Week از ويژگي ها ورويداد هاي استاندارد پيروي ميكند.
صفحات مرتبط
Previous > <Next