رویداد blur در jQuery زمانی اجرا میشود که یک عنصر فوکوس خود را از دست بدهد. در این راهنما با روش استفاده، مثالها و تفاوت آن با رویدادهای مشابه آشنا میشوید.
رویداد blur در jQuery چیست؟
💡تعریف رویداد blur
در این بخش از
آموزش JQuery،
رویداد blur را در
طراحی سایت بررسی میکنیم. این رویداد در jQuery وقتی رخ میدهد که یک عنصر، مانند کادر ورود متن، فوکوس را از دست بدهد. به بیان ساده، اگر کاربر داخل یک فیلد کلیک کند و سپس به بخش دیگری از صفحه برود، فیلد قبلی دیگر فعال نیست و رویداد blur آن اجرا میشود.
🔎کاربرد در فرمها
از دست رفتن فوکوس به معنی کلیک کردن روی یک دکمه خاص نیست. فوکوس ممکن است با کلیک روی بخش دیگری از صفحه، انتخاب یک فیلد دیگر یا جابهجایی با کلید Tab تغییر کند. بنابراین، blur راهی مناسب برای تشخیص پایان موقت کار کاربر با یک ورودی است؛ برای مثال میتوانید پس از خروج کاربر از فیلد ایمیل، مقدار آن را بررسی کنید یا راهنمای کوتاهی نمایش دهید.
⭐نکته درباره مثال اولیه
در نمونههای قدیمی ممکن است به جای blur از متد focus استفاده شده باشد. این دو رویداد رفتار یکسانی ندارند: focus هنگام فعال شدن عنصر رخ میدهد، اما blur هنگام از دست رفتن فوکوس اجرا میشود. پس اگر هدف شما واکنش به خروج کاربر از یک فیلد است، باید از blur استفاده کنید.
نحوه استفاده از متد blur در jQuery
🧩ساختار کلی
برای استفاده از این رویداد، ابتدا عنصر مورد نظر را با یک selector انتخاب میکنید و سپس تابعی را به آن اختصاص میدهید. تابع زمانی اجرا میشود که همان عنصر فوکوس خود را از دست بدهد. شکل کلی کد به صورت زیر است:
$("selector").blur(function() {
// کد مورد نظر
});
📘معنی بخشهای کد
selector مشخص میکند کدام عنصر صفحه باید رویداد را دریافت کند. برای نمونه، میتوانید همه ورودیها را با انتخابگر input هدف قرار دهید یا با استفاده از شناسه و کلاس، یک فیلد خاص را انتخاب کنید. تابع داخل متد نیز دستورهایی را در بر میگیرد که پس از خروج فوکوس اجرا میشوند.
🛠️تابع رویداد
function تابعی است که محتوای آن را شما تعیین میکنید. این تابع میتواند ظاهر فیلد را تغییر دهد، مقدار واردشده را بررسی کند، پیامی به کاربر نشان دهد یا اطلاعات را برای پردازش آماده کند. بهتر است هر تابع فقط مسئول کاری روشن باشد تا نگهداری و عیبیابی کد سادهتر شود.
مثال تغییر ظاهر فیلد پس از خروج فوکوس
✅یک نمونه کاربردی
در مثال زیر، وقتی هر ورودی فوکوس خود را از دست میدهد، رنگ پس زمینه آن سفید میشود. انتخابگر input تمام عناصر ورودی را هدف میگیرد؛ اگر قرار است تنها یک فیلد تغییر کند، میتوانید انتخابگر را محدودتر کنید.
$("input").blur(function() {
$(this).css("background-color", "#ffffff");
});
🧠چرا از this استفاده شده است؟
درون تابع رویداد، this به عنصری اشاره میکند که رویداد blur روی آن رخ داده است. با تبدیل آن به شیء jQuery، میتوان متدهایی مانند css را روی همان ورودی اجرا کرد. در نتیجه، اگر چند فیلد در صفحه وجود داشته باشد، فقط فیلدی که کاربر از آن خارج شده تغییر میکند.
اعتبارسنجی فرم با رویداد blur
📝بررسی ورودی کاربر
یکی از استفادههای رایج blur بررسی اطلاعات فرم پس از تکمیل یک فیلد است. برای مثال، میتوان خالی بودن نام کاربری را تشخیص داد و در صورت نیاز، راهنمایی کوتاهی کنار فیلد نمایش داد. این روش بازخورد را سریعتر از بررسی فرم در پایان کار ارائه میکند؛ با این حال، اعتبارسنجی نهایی باید هنگام ارسال فرم نیز انجام شود.
$("#username").on("blur", function() {
const value = $(this).val().trim();
if (value === "") {
$("#username-message").text("وارد کردن نام کاربری الزامی است.");
} else {
$("#username-message").text("");
}
});
⚠️ساختار HTML لازم
این نمونه فرض میکند صفحه دارای عنصری با شناسه username و یک محل نمایش پیام با شناسه username-message است. اگر شناسهها در HTML وجود نداشته باشند، انتخابگرها عنصری پیدا نمیکنند و پیام نشان داده نمیشود. همچنین پیام خطا باید برای کاربر قابل فهم باشد و در صورت رفع مشکل، با پاک کردن متن پیام از باقی ماندن هشدار جلوگیری شود.
تفاوت blur با focus و focusout
| رویداد |
زمان اجرا |
کاربرد معمول |
| focus |
هنگامی که عنصر فوکوس میگیرد. |
برجسته کردن ورودی فعال یا نمایش راهنما. |
| blur |
هنگامی که عنصر فوکوس را از دست میدهد. |
بررسی یک فیلد پس از پایان ورود اطلاعات. |
| focusout |
هنگام خروج فوکوس و با قابلیت انتشار در زنجیره عناصر. |
مدیریت رویداد برای عناصر تو در تو یا استفاده از واگذاری رویداد. |
🔁انتخاب رویداد مناسب
رویداد blur روی همان عنصری اجرا میشود که فوکوس را از دست داده است و برخلاف focusout به طور معمول در ساختار DOM منتشر نمیشود. به همین دلیل، واگذاری مستقیم blur به عناصر فرزند که بعدا به صفحه اضافه میشوند ممکن است نتیجه مورد انتظار را نداشته باشد. برای چنین شرایطی، استفاده از focusout یا متد مناسب jQuery برای واگذاری رویداد انتخاب بهتری است.
واگذاری رویداد برای عناصر پویا
⚙️استفاده از on و focusout
اگر فیلدها پس از بارگذاری اولیه صفحه ساخته میشوند، بهتر است رویداد را به یک عنصر والد ثابت واگذار کنید. این کار باعث میشود ورودیهای جدید نیز مدیریت شوند. در مثال زیر، فرم والد رویداد را دریافت میکند و فقط زمانی تابع اجرا میشود که یک ورودی داخل آن فوکوس خود را از دست بدهد.
$("#myForm").on("focusout", "input", function() {
console.log("یک ورودی فوکوس خود را از دست داد.");
});
⭐نکته فنی
برای فیلدهای معمولی فرم، blur گزینهای ساده و خواناست. زمانی به focusout فکر کنید که به انتشار رویداد در ساختار صفحه یا واگذاری آن به والد نیاز دارید. انتخاب درست به ساختار رابط کاربری شما بستگی دارد و استفاده از رویداد پیچیدهتر همیشه لازم نیست.
نکات مهم برای استفاده درست از رویداد blur
۱
انتخابگر دقیق بنویسید: استفاده از انتخابگر عمومی input ممکن است رویداد را به تعداد زیادی از فیلدها متصل کند. اگر فقط یک ورودی باید بررسی شود، شناسه یا کلاس اختصاصی آن را هدف بگیرید.
۲
پیام را به موقع پاک کنید: اگر خطا با اصلاح مقدار از بین میرود، متن هشدار را نیز پاک کنید. باقی ماندن پیام قدیمی ممکن است کاربر را درباره وضعیت فیلد سردرگم کند.
۳
اعتبارسنجی سمت سرور را فراموش نکنید: بررسی با jQuery برای راهنمایی سریع در مرورگر مفید است، اما به تنهایی امنیت یا صحت اطلاعات را تضمین نمیکند. دادهها باید در سمت سرور نیز بررسی شوند.
۴
رفتار صفحه کلید را در نظر بگیرید: کاربر ممکن است با Tab از یک فیلد خارج شود، نه فقط با ماوس. رویداد blur هنگام تغییر فوکوس اجرا میشود و برای بسیاری از تعاملهای صفحه کلید نیز کاربرد دارد.
۵
تعداد رویدادهای تکراری را کنترل کنید: اگر یک کد چند بار اجرا شود، ممکن است یک خروج از فیلد چند پاسخ ناخواسته ایجاد کند. اتصال رویداد را در جای مناسب انجام دهید و هنگام نیاز از off برای حذف شنونده قبلی استفاده کنید.
عیبیابی خطاهای رایج
🚨تابع اجرا نمیشود
ابتدا بررسی کنید jQuery پیش از کد شما بارگذاری شده باشد و انتخابگر دقیقا با شناسه یا کلاس عنصر تطابق داشته باشد. سپس مطمئن شوید عنصر قابلیت دریافت فوکوس دارد؛ برای مثال، یک پاراگراف عادی در حالت معمول مانند input فوکوس نمیگیرد. خطاهای کنسول مرورگر نیز میتوانند علت اجرا نشدن کد را مشخص کنند.
🔧کد روی عناصر جدید کار نمیکند
اگر ورودی بعد از اجرای اولیه صفحه به صورت پویا اضافه شود، اتصال مستقیم رویداد به ورودیهای موجود آن را پوشش نمیدهد. در این حالت، رویداد را از طریق یک والد ثابت واگذار کنید و برای تشخیص خروج فوکوس، focusout را در نظر بگیرید.
جمعبندی رویداد blur در jQuery
✅خلاصه کاربرد
در مجموع، رویداد blur در jQuery زمانی مناسب است که بخواهید پس از خروج کاربر از یک عنصر، کاری انجام شود؛ از تغییر ظاهر فیلد تا نمایش پیام یا بررسی مقدار ورودی. انتخابگر دقیق، تابع کوتاه و روشن و توجه به تفاوت blur با focusout، پیادهسازی را قابل اعتمادتر میکند. برای عناصر پویا نیز از واگذاری رویداد استفاده کنید و اعتبارسنجی نهایی اطلاعات را در سمت سرور انجام دهید.
سوالات متداول رویداد blur در jQuery
رویداد blur در jQuery چه زمانی اجرا میشود؟
این رویداد زمانی اجرا میشود که عنصر فوکوس خود را از دست بدهد؛ برای مثال، وقتی کاربر از یک کادر ورودی به بخش دیگری از صفحه میرود.
تفاوت blur و focus چیست؟
رویداد focus هنگام فعال شدن عنصر و دریافت فوکوس اجرا میشود، اما blur هنگام از دست رفتن فوکوس رخ میدهد.
آیا میتوان با blur مقدار یک فیلد را اعتبارسنجی کرد؟
بله. میتوانید پس از خروج کاربر از فیلد، مقدار آن را بررسی و پیام مناسب نمایش دهید. برای اطمینان از صحت دادهها، بررسی سمت سرور نیز ضروری است.
چرا رویداد blur روی ورودیهای جدید اجرا نمیشود؟
اگر ورودی پس از بارگذاری صفحه ساخته شده باشد، اتصال مستقیم رویداد به عناصر اولیه آن را شامل نمیشود. رویداد را از یک والد ثابت واگذار کنید و برای این کاربرد focusout را بررسی کنید.
برای فرمهای پویا از blur استفاده کنیم یا focusout؟
برای ورودیهای موجود، blur انتخابی ساده است. برای واگذاری رویداد به والد و مدیریت عناصر پویا، focusout معمولا گزینه مناسبتری است.