API ارزشیابی

از ویکی‌کد
پرش به ناوبری پرش به جستجو
Main Page Tutorial
JavaScript-menu.png
موارد آموزشی
فرم‌ها در جاوا اسکریپت
۱فرم‌ها
۲ارزشیابی
اشیاء در جاوا اسکریپت
تابع در جاوا اسکریپت
HTML DOM در جاوا اسکریپت
Browser BOM در جاوا اسکریپت
AJAX در جاوا اسکریپت
JSON در جاوا اسکریپت
جی‌کوئری در برابر جاوا اسکریپت
مثال‌های جاوا اسکریپت
مرجع جاوا اسکریپت

ارزشیابی محدودیتی متدهای DOM [۱]

ویژگی توضیحات
checkValidity() در صورتی یک ورودی داده، داده معتبر داشته باشد مقدار true را برمی‌گرداند.
setCustomValidity() ویژگی پیغام ارزشیابی یا validationMessage یک کنترل را تنظیم می‌کند.

در صورتی که یک فیلد ورودی شامل داده‌های نامعتبر شود، یک پیغام نمایش بده:

متد checkValidity()

 1 <input id="id1" type="number" min="100" max="300" required>
 2 <button onclick="myFunction()">OK</button>
 3 
 4 <p id="demo"></p>
 5 
 6 <script>
 7 function myFunction() {
 8   var inpObj = document.getElementById("id1");
 9   if (!inpObj.checkValidity()) {
10     document.getElementById("demo").innerHTML = inpObj.validationMessage;
11   }
12 }
13 </script>


مشاهدهٔ نتیجه


ارزشیابی محدودیتی برای ویژگی‌های DOM

ویژگی توضیحات
Validity شامل مقادیرمنطقی یا بولین مربوط به معتبر بودن یک عنصر ورودی است.
validationMessage شامل پیغامی است که زمانی که ویژگی Validity برابر با false باشد، مرورگر آن را نمایش می‌دهد.
willValidate مشخص می‌کند که آیا یک فیلد ورودی ارزشیابی خواهد شد یا خیر.

ویژگی های اعتبار سنجی

ویژگی‌های اعتبار سنجی یک کنترل شامل تعداداز ویژگی‌هایی می‌شود که به اعتبارسنجی داده‌ها مربوط است:

ویژگی توضیحات
customError اگر مقداری برای ویژگی custom validity message تنظیم شده باشد، این ویژگی برابر با true خواهد بود.
patternMismatch اگر مقدار عنصر با الگوی تعریف شده در ویژگی pattern همخوانی داشته باشد، مقدار این ویژگی نیز برابر با true خواهد بود.
rangeOverflow مقدار آن در صورتی که طول مقدار یک عنصر ورودی بیشتر از حداکثر طول آن باشد، برابر با true می‌گردد.
rangeUnderflow مقدار آن در صورتی که طول مقدار یک عنصر ورودی کمتر از حداقل طول آن باشد، برابر با true می‌گردد.
stepMismatch اگر یک عنصر بر اساس ویژگی step خودش نامعتبر باشد، مقدار این ویژگی برابر با true می‌گردد.
tooLong مقدار این ویژگی در صورتی که طول مقدار یک عنصر از حداکثر طول آن بیشتر باشد، برابر با true می‌گردد.
typeMismatch مقدار این ویژگی برابر با true می‌شود اگر مقدار عنصر با توجه به ویژگی type، نامعتبر باشد
valueMissing در صورتی که یک فیلد اجباری فاقد مقدار باشد، این ویژگی برابر با true می‌شود.
Valid مقدار آن برابر با true می‌شود اگر مقدارعنصر معتبر باشد.

مثال‌ها

اگر عدد درون فیلد ورودی بزرگتر از ۱۰۰ (مقدار ویژگی حداکثر طول یا max attribute) بود، یک پیغام نمایش بده:

ویژگی rangeOverFlow

 1 <input id="id1" type="number" max="100">
 2 <button onclick="myFunction()">OK</button>
 3 
 4 <p id="demo"></p>
 5 
 6 <script>
 7 function myFunction() {
 8   var txt = "";
 9   if (document.getElementById("id1").validity.rangeOverflow) {
10     txt = "Value too large";
11   }
12   document.getElementById("demo").innerHTML = txt;
13 }
14 </script>


مشاهدهٔ نتیجه


اگر عدد درون فیلد ورودی کمتر از ۱۰۰ (مقدار حداقل طول فیلد یا min attribute) بود، یک پیغام نمایش بده:

ویژگی rangeUnderflow

 1 <input id="id1" type="number" min="100">
 2 <button onclick="myFunction()">OK</button>
 3 
 4 <p id="demo"></p>
 5 
 6 <script>
 7 function myFunction() {
 8   var txt = "";
 9   if (document.getElementById("id1").validity.rangeUnderflow) {
10     txt = "Value too small";
11   }
12   document.getElementById("demo").innerHTML = txt;
13 }
14 </script>


مشاهدهٔ نتیجه


منابع آموزشی