متد 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 را تغییر دهید و داده های فرم را پیش از ارسال بررسی کنید. برای نتیجه دقیق، نوع عنصر را بشناسید، مقدار را با وضعیت انتخاب اشتباه نگیرید و در صورت نیاز رویدادهای وابسته را جداگانه اجرا کنید.
در پروژه های وب، مدیریت درست فرم ها بخشی از تجربه کاربری و کیفیت کلی طراحی سایت است. رعایت اعتبارسنجی مناسب، انتخابگرهای دقیق و نمایش امن داده ها کمک می کند تعامل کاربران با فرم ها روان تر باشد و کد برنامه نیز نگهداری پذیر بماند.