متد prop در jQuery چیست و چه کاربردی دارد؟
💡آشنایی با متد prop
در این بخش از
آموزش JQuery،
متد prop را به زبان ساده بررسی می کنیم. این متد برای خواندن یا تغییر ویژگی های شیء DOM به کار می رود؛ ویژگی هایی که مرورگر برای هر عنصر HTML در زمان اجرا در اختیار کدهای JavaScript قرار می دهد. برای مثال، وضعیت انتخاب یک چک باکس، فعال یا غیرفعال بودن یک دکمه و نشانی مقصد یک پیوند را می توان با این متد بررسی یا تنظیم کرد.
✅دو کاربرد اصلی
به طور کلی،
متد prop دو کار انجام می دهد: مقدار یک ویژگی را از عنصر یا عناصر انتخاب شده می خواند، یا مقدار یک ویژگی را برای عناصر انتخاب شده تغییر می دهد. در حالت خواندن، نتیجه معمولا از نخستین عنصر مجموعه انتخاب شده به دست می آید؛ در حالت تنظیم، تغییر روی تمام عناصر موجود در مجموعه اعمال می شود.
- خواندن ویژگی: برای بررسی وضعیت فعلی عنصر، مانند فهمیدن اینکه چک باکس انتخاب شده است یا خیر، از متد prop با یک نام ویژگی استفاده کنید.
- تنظیم ویژگی: برای فعال یا غیرفعال کردن یک دکمه، یا تغییر وضعیت انتخاب یک ورودی، نام ویژگی و مقدار جدید را به متد بدهید.
- تنظیم چند ویژگی: می توانید چند ویژگی را هم زمان و با استفاده از یک شیء جاوااسکریپت تنظیم کنید.
نحوه خواندن مقدار ویژگی با متد prop
📖ساختار خواندن
برای دریافت مقدار یک ویژگی، ابتدا عنصر مورد نظر را با selector انتخاب کنید و سپس نام ویژگی را به عنوان آرگومان به prop بدهید. selector می تواند بر اساس شناسه، کلاس، نام تگ یا هر الگوی معتبر دیگر jQuery باشد. نام ویژگی باید رشته ای باشد که با ویژگی DOM مورد نظر مطابقت دارد.
$(selector).prop(property);
🔎معنی آرگومان ها
selector مشخص می کند کدام عنصر یا عناصر HTML انتخاب شوند. این پارامتر در زنجیره انتخاب jQuery قرار می گیرد. property نام ویژگی DOM است که قصد خواندن آن را دارید. برای نمونه، ویژگی checked وضعیت فعلی چک باکس و ویژگی disabled وضعیت فعال بودن یک کنترل را نشان می دهد. اگر مجموعه انتخابی خالی باشد، مقداری برای خواندن وجود ندارد و نتیجه undefined خواهد بود.
نمونه خواندن وضعیت چک باکس
☑️بررسی انتخاب شدن ورودی
ویژگی checked یک مقدار بولی برمی گرداند: اگر چک باکس در حال حاضر انتخاب شده باشد، نتیجه true است و اگر انتخاب نشده باشد، نتیجه false خواهد بود. این روش برای اعتبارسنجی فرم، نمایش پیام یا اجرای یک رفتار وابسته به انتخاب کاربر مناسب است.
var isChecked = $("#terms").prop("checked");
if (isChecked) {
console.log("The checkbox is selected");
}
تغییر مقدار ویژگی با متد prop
🛠️ساختار تنظیم یک ویژگی
برای تغییر ویژگی، نام ویژگی و مقدار تازه آن را به prop ارسال کنید. این فراخوانی مقدار جدید را روی همه عناصر منطبق با selector اعمال می کند و برای زنجیره سازی نیز مناسب است؛ یعنی در بسیاری از موارد می توانید پس از آن متد jQuery دیگری را روی همان مجموعه اجرا کنید.
$(selector).prop(property, value);
🧩پارامترهای متد
selector عنصر هدف را مشخص می کند و اجباری است. property نام ویژگی DOM است که باید تغییر کند. value مقدار تازه ای است که برای آن ویژگی در نظر گرفته می شود؛ این مقدار می تواند رشته، عدد یا مقدار بولی باشد. برای ویژگی هایی مانند disabled و checked معمولا از true یا false استفاده می شود.
غیرفعال کردن یک دکمه
⚠️نمونه کاربردی
در مثال زیر، دکمه با شناسه submit غیرفعال می شود. تنظیم disabled روی true باعث می شود مرورگر دکمه را در وضعیت غیرقابل استفاده قرار دهد. برای فعال کردن دوباره آن، کافی است مقدار ویژگی را false کنید.
$("#submit").prop("disabled", true);
// Enable the button again
$("#submit").prop("disabled", false);
تنظیم هم زمان چند ویژگی
📦ارسال یک شیء از ویژگی ها
وقتی لازم است چند ویژگی را با هم تنظیم کنید، می توانید یک شیء جاوااسکریپت شامل جفت های نام و مقدار به متد بدهید. این شیوه کد را خواناتر می کند و تعداد فراخوانی های جداگانه را کاهش می دهد. هر کلید شیء نام یک ویژگی و مقدار روبه روی آن، مقدار تازه همان ویژگی است.
$("#profile-link").prop({
href: "https://example.com/profile",
title: "View profile",
target: "_blank"
});
📊مقایسه شکل های متداول
انتخاب شکل مناسب به این بستگی دارد که فقط یک ویژگی را می خوانید، یک ویژگی را تغییر می دهید یا چند ویژگی را با هم تنظیم می کنید. جدول زیر تفاوت این حالت ها را به صورت خلاصه نشان می دهد.
| هدف |
ساختار |
نمونه نتیجه |
| خواندن یک ویژگی |
.prop(property) |
مقدار ویژگی عنصر نخست |
| تغییر یک ویژگی |
.prop(property, value) |
تنظیم مقدار برای عناصر انتخاب شده |
| تغییر چند ویژگی |
.prop(object) |
تنظیم چند جفت نام و مقدار |
تفاوت prop و attr در jQuery
🧠ویژگی DOM یا صفت HTML؟
یکی از پرسش های رایج این است که چه زمانی باید از prop و چه زمانی از attr استفاده کرد. متد attr با صفت های نوشته شده در HTML سر و کار دارد؛ اما prop مقدار ویژگی متناظر را در شیء DOM بررسی یا تنظیم می کند. این دو مفهوم در نگاه اول شبیه به هم هستند، ولی پس از تغییر وضعیت عنصر در مرورگر ممکن است نتیجه یکسانی نداشته باشند.
| متد |
تمرکز اصلی |
نمونه کاربرد |
prop() |
وضعیت فعلی ویژگی در DOM |
بررسی checked یا disabled |
attr() |
صفت موجود در نشانه گذاری HTML |
خواندن یا تنظیم صفت های HTML |
⭐نکته مهم درباره checkbox
برای فهمیدن اینکه کاربر در حال حاضر چک باکس را انتخاب کرده است، معمولا prop("checked") انتخاب درستی است؛ زیرا وضعیت جاری کنترل را نشان می دهد. صفت checked در HTML بیشتر وضعیت اولیه ای را توصیف می کند که در نشانه گذاری نوشته شده است. بنابراین برای تعامل هایی که پس از بارگذاری صفحه تغییر می کنند، وضعیت DOM را بررسی کنید.
نکته های کاربردی و خطاهای رایج
1
نام ویژگی را درست انتخاب کنید. prop برای ویژگی های DOM مانند checked، disabled، selected و value کاربرد دارد. نام دلخواهی که به CSS مربوط است لزوما یک ویژگی DOM معتبر محسوب نمی شود.
2
برای تغییر ظاهر از CSS استفاده کنید. رنگ متن، اندازه قلم و پس زمینه، ویژگی های CSS هستند و باید با متدهایی مانند css یا با افزودن و حذف کلاس های CSS مدیریت شوند. prop را برای تغییر مستقیم ظاهر صفحه به کار نبرید.
3
مقدار بولی را با دقت تنظیم کنید. برای ویژگی هایی مانند disabled و checked از true یا false استفاده کنید. ارسال رشته هایی مانند "false" ممکن است باعث برداشت اشتباه از مقدار شود، چون رشته غیرخالی در JavaScript مقدار truthy دارد.
4
نتیجه انتخابگر را در نظر بگیرید. هنگام خواندن یک ویژگی، نتیجه از عنصر نخست مجموعه انتخاب شده برمی گردد. هنگام تنظیم مقدار، تغییر به تمام عناصر منطبق اعمال می شود. اگر انتظار رفتار دیگری دارید، selector و تعداد عناصر انتخاب شده را بررسی کنید.
5
کد را در زمان مناسب اجرا کنید. اگر کد پیش از ساخته شدن عنصر در صفحه اجرا شود، jQuery ممکن است چیزی برای انتخاب پیدا نکند. اجرای کد پس از بارگذاری DOM یا قرار دادن اسکریپت در جای مناسب صفحه، از این مشکل جلوگیری می کند.
تفاوت ویژگی DOM و ویژگی CSS
🚫از prop برای رنگ متن استفاده نکنید
در بعضی نمونه های قدیمی ممکن است کدی دیده شود که با prop نام color را تنظیم می کند. color یک ویژگی CSS است، نه ویژگی معمول DOM برای تغییر رنگ متن؛ بنابراین چنین روشی برای طراحی قابل اتکا نیست. برای ظاهر عنصر، از css یا کلاس استفاده کنید و prop را برای وضعیت و ویژگی های واقعی DOM نگه دارید.
// Change text color with CSS
$("div").css("color", "#ff0000");
// Change a DOM property with prop
$("button").prop("disabled", true);
مثال کامل استفاده از متد prop
🧪فعال شدن دکمه پس از پذیرش قوانین
فرض کنید در فرم ثبت نام، دکمه ارسال تا زمانی که کاربر قوانین را نپذیرفته غیرفعال باشد. با خواندن checked می توان وضعیت چک باکس را دریافت کرد و سپس با تنظیم disabled، وضعیت دکمه را متناسب با انتخاب کاربر تغییر داد.
$("#terms").on("change", function() {
var accepted = $(this).prop("checked");
$("#submit").prop("disabled", !accepted);
});
🎯چرا این مثال مفید است؟
رویداد change هنگام تغییر وضعیت چک باکس اجرا می شود. درون تابع، this به همان چک باکس اشاره می کند و متد prop مقدار فعلی checked را می خواند. سپس نتیجه به شکل معکوس برای ویژگی disabled دکمه استفاده می شود: وقتی قوانین پذیرفته نشده اند، دکمه غیرفعال می ماند و پس از پذیرش، امکان ارسال فرم فراهم می شود.
چه زمانی از متد prop استفاده کنیم؟
🧭انتخاب ابزار مناسب
هنگامی که با وضعیت جاری یک عنصر تعاملی کار می کنید، prop گزینه مناسبی است. این وضعیت می تواند انتخاب شدن ورودی، فعال بودن کنترل، یا مقدار جاری یک ویژگی DOM باشد. اگر هدف شما تغییر رنگ، فاصله، اندازه یا هر ویژگی ظاهری دیگری است، از ابزارهای CSS استفاده کنید. اگر باید مقدار یک صفت HTML را بخوانید یا تغییر دهید، بررسی کنید که attr انتخاب مناسب تری نباشد.
🌐ارتباط با طراحی رابط
در پروژه های رابط کاربری، درک تفاوت میان رفتار و ظاهر اهمیت زیادی دارد. تغییر وضعیت یک دکمه با prop انجام می شود، اما ایجاد جلوه بصری معمولا به CSS وابسته است. همین جداسازی باعث می شود کد ساده تر نگهداری شود و تغییرهای بعدی در
طراحی سایت بدون درهم آمیختن منطق برنامه و ظاهر صفحه انجام شوند.
⭐جمع بندی متد prop در jQuery
متد prop در jQuery راهی ساده برای خواندن و تغییر ویژگی های DOM است. از آن برای بررسی وضعیت هایی مانند checked و disabled، تنظیم ویژگی های یک یا چند عنصر و مدیریت تعامل های فرم استفاده کنید. هنگام خواندن، مقدار عنصر نخست انتخاب شده برگردانده می شود و هنگام تنظیم، تغییر روی عناصر انتخاب شده اعمال می شود. برای صفت های HTML، تفاوت attr و prop را در نظر بگیرید و برای تغییر ظاهر، به سراغ CSS بروید.
سوالات متداول متد prop در jQuery
متد prop در jQuery چه کاری انجام می دهد؟
این متد مقدار یک ویژگی DOM را می خواند یا مقدار آن را برای عنصر یا عناصر انتخاب شده تغییر می دهد. برای نمونه می توان وضعیت ویژگی هایی مانند checked و disabled را بررسی یا تنظیم کرد.
تفاوت prop و attr چیست؟
attr با صفت های تعریف شده در HTML کار می کند، اما prop ویژگی متناظر را در شیء DOM بررسی یا تغییر می دهد. برای وضعیت فعلی یک چک باکس که ممکن است پس از بارگذاری صفحه تغییر کرده باشد، معمولا prop("checked") مناسب است.
آیا prop برای تغییر رنگ یا ظاهر عنصر مناسب است؟
خیر. رنگ و ویژگی های ظاهری به CSS تعلق دارند. برای تغییر آن ها از متد css یا کلاس های CSS استفاده کنید و prop را برای ویژگی های DOM مانند disabled، checked و value به کار ببرید.
اگر selector چند عنصر را انتخاب کند، چه اتفاقی می افتد؟
هنگام خواندن یک ویژگی، مقدار عنصر نخست مجموعه برگردانده می شود. هنگام تنظیم مقدار، تغییر روی همه عناصر منطبق با selector اعمال خواهد شد.
چطور چند ویژگی را هم زمان با prop تغییر دهیم؟
یک شیء جاوااسکریپت شامل نام ویژگی ها و مقدارهای مورد نظر به prop بدهید. برای مثال می توانید ویژگی های href، title و target یک پیوند را در یک فراخوانی تنظیم کنید.