📞 02166056460

متد val در جی کوئری

9 / 10
از 1 کاربر
بازگشت به لیست مقالات » | چهارشنبه 15 مهر 1405 در ساعت 17 و 45 دقیقه | نظرات کاربران ( 1 )

متد val در jQuery یکی از روش های پرکاربرد برای خواندن و تغییر مقدار فیلدهای فرم در صفحات وب است. با کمک این متد می توانید مقدار ورودی هایی مانند متن، گزینه های انتخابی، چک باکس و دکمه های رادیویی را دریافت کنید یا مقدار تازه ای برای آن ها قرار دهید. در این راهنما، ساختار، کاربردها، مثال های عملی و خطاهای رایج کار با این متد را بررسی می کنیم.

در ادامه آموزش JQuery، با متد val آشنا می شویم و می بینیم چطور می توان آن را در فرم های واقعی به کار برد.

متد val در jQuery چیست و چه کاربردی دارد؟

متد val برای دسترسی به ویژگی value عناصر فرم یا تنظیم مقدار آن ها استفاده می شود. این عناصر می توانند شامل فیلدهای متنی، فهرست های کشویی، چک باکس ها و دکمه های رادیویی باشند. استفاده از این متد در بسیاری از سناریوهای رایج، مانند پر کردن خودکار فرم، بررسی ورودی کاربر یا نمایش اطلاعات انتخاب شده، کدنویسی را ساده تر می کند.

این متد دو شکل اصلی دارد: در حالت بدون ورودی، مقدار عنصر را می خواند و در حالت دریافت یک مقدار، مقدار عنصر را تغییر می دهد. برای انتخاب عنصر موردنظر نیز ابتدا یک انتخابگر jQuery مانند شناسه، کلاس یا نوع فیلد به کار می رود.

$(selector).val();
$(selector).val(newValue);
  • $(selector).val() مقدار عنصر انتخاب شده را برمی گرداند.
  • $(selector).val(newValue) مقدار تازه را در عنصر یا عناصر انتخاب شده قرار می دهد.

نحوه خواندن مقدار فیلدهای فرم

برای خواندن مقدار یک فیلد، کافی است عنصر را با انتخابگر مناسب مشخص کنید و متد val را بدون آرگومان فراخوانی کنید. مقدار بازگشتی معمولا به شکل یک رشته است. اگر انتخابگر به چند عنصر برسد، در حالت خواندن مقدار عنصر نخست مجموعه بازگردانده می شود؛ بنابراین برای بررسی همه عناصر باید آن ها را جداگانه پیمایش کنید یا از انتخابگری دقیق تر استفاده کنید.

خواندن مقدار فیلد متنی

در مثال زیر، مقدار فیلدی که شناسه آن name است در متغیر nameValue قرار می گیرد. شناسه باید در صفحه یکتا باشد تا انتخاب عنصر دقیق و قابل پیش بینی بماند.

var nameValue = $('input#name').val();
console.log(nameValue);

اگر فیلد خالی باشد، مقدار دریافتی رشته ای خالی خواهد بود. می توانید پیش از ارسال فرم این مقدار را بررسی کنید و در صورت خالی بودن، پیام مناسبی به کاربر نمایش دهید. بهتر است اعتبارسنجی در مرورگر را در کنار اعتبارسنجی سمت سرور به کار ببرید؛ زیرا بررسی سمت کاربر به تنهایی برای اطمینان از صحت داده ها کافی نیست.

خواندن گزینه انتخاب شده در فهرست کشویی

در یک عنصر select، متد val مقدار گزینه انتخاب شده را برمی گرداند. برای خواندن گزینه فعال در فهرستی با کلاس foo می توانید از انتخابگر زیر استفاده کنید:

var selectedValue = $('select.foo option:selected').val();

در بسیاری از موارد، نوشتن انتخابگر کوتاه تر نیز نتیجه موردنظر را می دهد:

var selectedValue = $('select.foo').val();

اگر فهرست چندانتخابی باشد، مقدار بازگشتی می تواند شامل چند مقدار انتخاب شده باشد. در این حالت بهتر است متغیر را به شکل آرایه در نظر بگیرید و پیش از نمایش یا پردازش آن، مقدارهای موجود را بررسی کنید.

تنظیم مقدار عناصر با متد val

برای تغییر مقدار یک فیلد، مقدار تازه را به عنوان آرگومان به val می دهید. jQuery مقدار تعیین شده را روی عنصر یا عناصر مطابق با انتخابگر قرار می دهد. برای نمونه، کد زیر مقدار فیلد متنی name را روی عبارت Ali تنظیم می کند:

$('input#name').val('Ali');

در زمان پر کردن فرم با داده های دریافتی از سرور، این روش کاربرد زیادی دارد. برای نمونه می توانید اطلاعات قبلی کاربر را در فیلدهای فرم قرار دهید تا امکان مشاهده یا ویرایش آن ها فراهم شود. هنگام قرار دادن مقدار در فیلد، نوع داده را نیز در نظر بگیرید و در صورت نیاز آن را به رشته تبدیل کنید.

تنظیم گزینه انتخابی در select

اگر مقدار مشخصی با یکی از گزینه های فهرست کشویی مطابقت داشته باشد، می توانید آن را به عنوان گزینه انتخاب شده تعیین کنید. برای مثال، کد زیر گزینه دارای مقدار two را در select با کلاس foo انتخاب می کند:

$('select.foo').val('two');

برای فهرست چندانتخابی، می توان مجموعه ای از مقادیر را به متد داد. در این صورت گزینه هایی که مقدارشان با یکی از اعضای آرایه مطابقت داشته باشد انتخاب می شوند.

$('select[name="topics"]').val(['jquery', 'html']);

تنظیم چک باکس و دکمه رادیویی

در چک باکس و دکمه رادیویی، ویژگی value با وضعیت انتخاب شدن عنصر تفاوت دارد. متد val مقدار تعریف شده برای گزینه را می خواند یا تغییر می دهد؛ برای تشخیص اینکه یک چک باکس انتخاب شده است یا نه، معمولا باید وضعیت checked را بررسی کنید.

var checkedValue = $('input:checkbox:checked').val();
var isChecked = $('#newsletter').prop('checked');

برای انتخاب یک دکمه رادیویی در گروهی با نام bar، می توانید مقدار گروه را تعیین کنید. مقدار ارسالی باید با value یکی از دکمه های همان گروه برابر باشد.

$('input:radio[name="bar"]').val(['option2']);

تفاوت خواندن مقدار و بررسی وضعیت انتخاب

یکی از اشتباه های رایج، استفاده از val برای تشخیص انتخاب بودن یک چک باکس یا رادیو است. val مقدار ثبت شده در ویژگی value را برمی گرداند، اما وضعیت انتخاب را نشان نمی دهد. برای دریافت وضعیت، ویژگی checked را بخوانید. این تمایز در فرم هایی که چند گزینه مشابه دارند اهمیت زیادی دارد.

نیاز برنامه روش پیشنهادی نتیجه
خواندن متن واردشده $('input').val() مقدار فیلد متنی
بررسی انتخاب چک باکس $('#id').prop('checked') مقدار true یا false
خواندن گزینه انتخاب شده $('select').val() مقدار گزینه یا مجموعه ای از مقدارها
تغییر مقدار یک فیلد $('input').val('متن تازه') قرار گرفتن مقدار تازه در فیلد

استفاده از val در رویدادهای فرم

معمولا خواندن مقدار فیلد زمانی انجام می شود که کاربر کاری انجام داده باشد؛ برای مثال، هنگام ارسال فرم یا تغییر گزینه یک فهرست. با رویدادهای jQuery می توانید مقدار تازه را بخوانید و متناسب با آن پیام نمایش دهید یا بخشی از صفحه را به روزرسانی کنید.

$('#name').on('input', function () {
    var currentValue = $(this).val();
    $('#preview').text(currentValue);
});

در این نمونه، رویداد input هنگام تغییر مقدار فیلد اجرا می شود و متن واردشده در عنصر preview نمایش داده می شود. استفاده از this باعث می شود همان فیلدی که رویداد روی آن رخ داده است انتخاب شود. برای جلوگیری از نمایش ناخواسته کد HTML واردشده توسط کاربر، در مثال از text استفاده شده است.

نکته مهم درباره رویداد change

تغییر مقدار با val به تنهایی لزوما رویداد change را اجرا نمی کند. اگر بخشی از برنامه به این رویداد وابسته است، پس از تنظیم مقدار باید آن را به شکل صریح فعال کنید. این کار را فقط زمانی انجام دهید که واقعا لازم است؛ فعال سازی رویداد ممکن است کدهای وابسته دیگری را نیز اجرا کند.

$('#category').val('books').trigger('change');

تنظیم مقدار پویا با تابع

متد val امکان دریافت تابع را نیز دارد. تابع برای هر عنصر انتخاب شده اجرا می شود و می تواند مقدار جدید را با توجه به مقدار فعلی یا موقعیت عنصر برگرداند. این قابلیت در زمان به روزرسانی چند فیلد به شکل هم زمان مفید است.

$('input.quantity').val(function (index, currentValue) {
    return currentValue || '1';
});

در این مثال، اگر مقدار فعلی فیلد خالی باشد، مقدار 1 قرار می گیرد؛ در غیر این صورت همان مقدار قبلی حفظ می شود. هنگام استفاده از تابع، خروجی آن باید با نوع و انتظار فیلد سازگار باشد. اگر داده از منبع نامطمئن می آید، آن را پیش از استفاده بررسی کنید تا مقدار ناخواسته وارد فرم نشود.

نمونه کاربردی: بررسی فرم پیش از ارسال

یکی از استفاده های متداول متد val، بررسی مقدارهای ضروری پیش از ارسال فرم است. در نمونه زیر، مقدار نام و ایمیل خوانده می شود و اگر هر یک خالی باشد، ارسال فرم متوقف می شود. این کنترل برای بهتر شدن تجربه کاربری است و جایگزین اعتبارسنجی سمت سرور نیست.

$('#contact-form').on('submit', function (event) {
    var name = $('#name').val().trim();
    var email = $('#email').val().trim();

    if (!name || !email) {
        event.preventDefault();
        $('#form-message').text('لطفا نام و ایمیل را وارد کنید.');
    }
});

استفاده از trim کمک می کند فاصله های ابتدا و انتهای متن به اشتباه به عنوان محتوای معتبر پذیرفته نشوند. در یک فرم واقعی، بهتر است قالب ایمیل، طول ورودی ها و دیگر محدودیت های موردنیاز نیز بررسی شوند. پیام خطا باید روشن باشد و به کاربر بگوید چه چیزی را اصلاح کند.

خطاهای رایج هنگام استفاده از متد val

  • انتخابگر نادرست: اگر شناسه، کلاس یا نام عنصر اشتباه باشد، jQuery عنصری برای تغییر پیدا نمی کند. انتخابگر را با ساختار HTML صفحه تطبیق دهید.
  • اشتباه گرفتن مقدار با وضعیت: val مقدار گزینه را می خواند، اما برای تشخیص checked بودن از prop استفاده کنید.
  • فراموش کردن رویداد: تنظیم مقدار با val به طور خودکار همه رویدادهای تغییر را اجرا نمی کند. در صورت نیاز، رویداد را آگاهانه فعال کنید.
  • انتظار یک رشته از انتخاب چندگانه: فهرست چندانتخابی ممکن است چند مقدار برگرداند. نوع داده بازگشتی را متناسب با کاربرد بررسی کنید.
  • نادیده گرفتن اعتبارسنجی: مقدار دریافت شده از فرم را معتبر فرض نکنید. داده ها باید در سمت سرور نیز بررسی شوند.
  • اعتماد به شناسه های تکراری: شناسه در یک صفحه باید یکتا باشد. برای انتخاب چند عنصر، از کلاس یا انتخابگر مناسب استفاده کنید.

مقایسه val با روش های دیگر دسترسی به مقدار

برای فیلدهای فرم، val معمولا خواناترین گزینه در jQuery است. با این حال، در کار با ویژگی هایی مانند checked یا disabled باید از روش های ویژه مربوط به ویژگی و وضعیت عنصر استفاده کنید. برای نمایش متن عادی در یک عنصر نیز متدهایی مانند text مناسب تر هستند؛ زیرا هدف آن ها خواندن یا تغییر محتوای متنی است، نه مقدار فرم.

متد یا ویژگی کاربرد اصلی نمونه مورد استفاده
val خواندن یا تنظیم مقدار کنترل های فرم input، select و textarea
prop خواندن یا تنظیم ویژگی های وضعیتی checked و disabled
text خواندن یا تنظیم متن داخل عنصر عنوان، پیام و برچسب

پنج نکته مهم برای استفاده درست از متد val

۱. انتخابگر را تا حد امکان دقیق بنویسید

انتخابگر دقیق احتمال تغییر عنصر اشتباه را کم می کند. اگر چند فرم در صفحه وجود دارد، آن ها را با شناسه یا ساختار والد از هم جدا کنید. این کار به ویژه در صفحه هایی که فرم جستجو، فرم ورود و فرم تماس هم زمان دارند اهمیت دارد.

۲. نوع عنصر را در نظر بگیرید

رفتار دریافت مقدار در input متنی با select چندانتخابی یکسان نیست. پیش از استفاده از نتیجه، مشخص کنید که با رشته، مقدار خالی یا مجموعه ای از گزینه ها روبه رو هستید. این بررسی از خطاهای پردازش داده جلوگیری می کند.

۳. میان مقدار و وضعیت تفاوت بگذارید

در چک باکس و رادیو، value محتوای تعریف شده گزینه است؛ checked وضعیت انتخاب را نشان می دهد. انتخاب روش درست باعث می شود منطق فرم قابل فهم و نتیجه آن قابل اعتماد باشد.

۴. پس از تغییر برنامه ای، وابستگی ها را بررسی کنید

اگر تغییر مقدار باید باعث به روزرسانی بخش دیگری از صفحه شود، مشخص کنید کدام رویداد مسئول این کار است. سپس در صورت نیاز رویداد را اجرا کنید تا کدهای وابسته از تغییر جدید مطلع شوند.

۵. داده ها را امن و معتبر نگه دارید

مقادیر فرم ممکن است ناقص یا نامعتبر باشند. اعتبارسنجی سمت کاربر به تجربه بهتر کمک می کند، اما کنترل نهایی باید در سمت سرور انجام شود. همچنین هنگام نمایش مقدار واردشده، آن را به صورت امن در صفحه قرار دهید.

پرسش های متداول درباره متد val در jQuery

آیا متد val فقط برای input کاربرد دارد؟

خیر. از این متد برای خواندن یا تنظیم مقدار عناصر فرم مانند input، textarea و select استفاده می شود. رفتار دقیق آن به نوع عنصر وابسته است؛ برای مثال، select چندانتخابی ممکن است چند مقدار داشته باشد.

چطور مقدار فیلد را خالی کنم؟

برای خالی کردن یک فیلد متنی می توانید رشته خالی را به val بدهید. این روش مقدار فیلد را پاک می کند، اما لزوما رویدادهای وابسته به تغییر را اجرا نمی کند.

$('#name').val('');

چرا پس از استفاده از val، کد رویداد change اجرا نمی شود؟

تنظیم مقدار با val به صورت خودکار رویداد change را اجرا نمی کند. اگر اجرای کدهای وابسته لازم است، می توانید رویداد را جداگانه فعال کنید؛ البته باید مراقب باشید فعال سازی آن موجب اجرای ناخواسته منطق دیگری نشود.

چطور مقدار گزینه انتخاب شده را بخوانم؟

عنصر select را انتخاب کنید و val را بدون آرگومان به کار ببرید. اگر فهرست چندانتخابی باشد، نتیجه می تواند چند مقدار را در بر بگیرد؛ بنابراین بهتر است پیش از استفاده، نوع و تعداد مقدارهای بازگشتی را بررسی کنید.

جمع بندی

متد val در jQuery راهی ساده و کاربردی برای خواندن و تغییر مقدار کنترل های فرم است. با استفاده از آن می توانید اطلاعات فیلدهای متنی را دریافت کنید، گزینه های select را تغییر دهید و داده های فرم را پیش از ارسال بررسی کنید. برای نتیجه دقیق، نوع عنصر را بشناسید، مقدار را با وضعیت انتخاب اشتباه نگیرید و در صورت نیاز رویدادهای وابسته را جداگانه اجرا کنید.

در پروژه های وب، مدیریت درست فرم ها بخشی از تجربه کاربری و کیفیت کلی طراحی سایت است. رعایت اعتبارسنجی مناسب، انتخابگرهای دقیق و نمایش امن داده ها کمک می کند تعامل کاربران با فرم ها روان تر باشد و کد برنامه نیز نگهداری پذیر بماند.

ارسال نظر و نظرات ثبت شده
فاطمه :
0 0
عالی بود
سایر مقالات
متد wrapInner در جی کوئری متد wrapInner در jQuery متد wrapInner برای قرار دادن محتوای داخلی یک عنصر درون ساختاری تازه به ...
متد wrapAll در جی کوئری متد wrapAll در jQuery چند عنصر انتخاب شده را یکجا داخل یک ساختار HTML قرار می دهد. این متد زمانی کار ...
متد wrap در جی کوئری متد wrap در jQuery روشی ساده برای قرار دادن یک یا چند عنصر HTML داخل یک عنصر والد است. با استفاده از ...
متد width در جی کوئری متد width در jQuery یکی از روش های پرکاربرد برای دریافت یا تغییر عرض عناصر در صفحه وب است. با استفاد ...
متد val در جی کوئری متد val در jQuery یکی از روش های پرکاربرد برای خواندن و تغییر مقدار فیلدهای فرم در صفحات وب است. با ...
متد unwrap در جی کوئری متد unwrap در jQuery چیست و چگونه کار می کند؟ 💡 آشنایی با متد در این راهنمای آموزش jQuery ...
متد toggleClass در جی کوئری متد toggleClass در jQuery راهی ساده برای افزودن یا حذف شرطی کلاس های CSS است. با این متد می توانید ...
متد text در جی کوئری متد text در jQuery چیست و چه کاربردی دارد؟ 💡آشنایی با متد text در این راهنمای متد text در ...
متد removeProp در جی کوئری متد removeProp در jQuery چیست؟ 💡آشنایی با حذف ویژگی‌ها متد removeProp در jQuery برای ...
متد removeClass در جی کوئری متد removeClass در jQuery چیست و چه کاربردی دارد؟ 💡آشنایی با حذف کلاس‌ها در این راهن ...
متد removeAttr در جی کوئری متد removeAttr در jQuery چیست و چه کاربردی دارد؟ 💡آشنایی با متد در این راهنما با متد remo ...
متد remove در جی کوئری متد remove در jQuery چیست و چه کاربردی دارد؟ 💡آشنایی با حذف عناصر در صفحه متد remove در j ...
متد prop در جی کوئری متد prop در jQuery چیست و چه کاربردی دارد؟ 💡آشنایی با متد prop در این بخش از آموزش JQuery ...
متد prependTo در جی کوئری آموزش متد prependTo در jQuery 💡آشنایی با prependTo در این راهنمای متد prependTo در jQuery ی ...
متد prepend در جی کوئری متد prepend در jQuery چیست و چگونه کار می کند؟ 💡آشنایی با درج محتوا در ابتدای عنصر در این ...
متد position در جی کوئری متد position در jQuery چیست و چه کاربردی دارد؟ 📘آشنایی با موقعیت عناصر در این بخش از آموز ...
متد outerWidth در جی کوئری متد outerWidth در jQuery چیست؟ 💡آشنایی با اندازه گیری عرض عناصر در این بخش از آموزش JQuery، ...
متد outerHeight در جی کوئری آموزش متد outerHeight در jQuery؛ اندازه گیری ارتفاع بیرونی عناصر 💡آشنایی با متد در این بخش ...
متد offsetParent در جی کوئری متد offsetParent در jQuery چیست و چه کاربردی دارد؟ 💡آشنایی با متد متد offsetParent در jQu ...
متد offset در جی کوئری متد offset در jQuery چیست و چه کاربردی دارد؟ 💡آشنایی با موقعیت عنصر متد offset در jQuery بر ...
متد insertBefore در جی کوئری متد insertBefore در jQuery چیست و چه کاربردی دارد؟ 💡آشنایی با درج محتوا در صفحه در این راهن ...
متد scrollLeft در جی کوئری متد scrollLeft در jQuery چیست و چگونه کار می کند؟ 💡آشنایی با اسکرول افقی در این راهنما با م ...
متد insertAfter در جی کوئری متد insertAfter در jQuery برای افزودن متن، عنصر HTML یا مجموعه ای از عناصر پس از یک عنصر مشخص در صفح ...
متد innerWidth در جی کوئری متد innerWidth در jQuery چیست و چگونه استفاده می‌شود؟ 💡آشنایی با متد در این راهنما از ...
متد replaceWith در جی کوئری متد replaceWith در jQuery؛ آموزش جایگزینی عناصر HTML 💡آشنایی با متد در این راهنما با متد ...
متد replaceAll در جی کوئری متد replaceAll در jQuery برای جایگزین کردن یک یا چند عنصر HTML با محتوای تازه به کار می رود. در ای ...
متد innerHeight در جی کوئری متد innerHeight در jQuery چیست و چگونه از آن استفاده کنیم؟ 💡 اندازه گیری فضای داخلی عنصر ...
متد html در جی کوئری متد html در jQuery چیست و چگونه از آن استفاده کنیم؟ 💡آشنایی با متد در این راهنمای متد htm ...
متد height در جی کوئری ۵ نکته مهم درباره متد height در jQuery 💡آشنایی با خواندن و تنظیم ارتفاع متد height در jQuer ...
متد hasClass در جی کوئری متد hasClass در jQuery چیست و چگونه از آن استفاده کنیم؟ ⭐ بررسی سریع متد متد hasClass در jQu ...
متد empty در جی کوئری ۵ نکته مهم درباره متد empty در jQuery ⭐ آشنایی سریع با متد متد empty در jQuery محتوای داخل ی ...
متد detach در جی کوئری آموزش jQuery ۵ نکته مهم درباره متد detach در jQuery حذف موقت عنصر از صفحه، بدون از دست رفت ...
متد css در جی کوئری آموزش jQuery متد css در jQuery؛ آموزش خواندن و تغییر ویژگی های CSS با مثال های کاربردی، مق ...
متد clone در جی کوئری آموزش jQuery متد clone در jQuery؛ آموزش کپی کردن عناصر HTML ساختار، کاربردها، مثال‌ها ...
متد before در جی کوئری آموزش jQuery متد before در jQuery؛ آموزش کاربرد، مثال و نکات مهم یاد بگیرید چگونه محتوا را ...
متد attr در جی کوئری آموزش jQuery متد attr در jQuery؛ آموزش خواندن و تغییر ویژگی عناصر با مثال‌های کاربردی ...
متد appendTo در جی کوئری آموزش jQuery متد appendTo در jQuery؛ آموزش کاربرد و مثال با نحوه افزودن عناصر HTML، تفاوت ...
متد append در جی کوئری آموزش jQuery متد append در jQuery؛ آموزش کامل افزودن محتوا به صفحه نحوه استفاده، مثال&zwnj ...
متد after در جی کوئری آموزش jQuery متد after در jQuery؛ افزودن محتوا پس از یک عنصر آشنایی با ساختار، کاربردها، م ...
متد addClass در جی کوئری آموزش jQuery متد addClass در jQuery و کاربرد آن در طراحی سایت راهنمای کاربردی افزودن کلاس ...
دسته بندی
جستجو
⏳ در حال پردازش...
لطفا صبر کنید