📞 02166056460

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

6 / 10
از 5 کاربر
بازگشت به لیست مقالات » | پنجشنبه 16 مهر 1405 در ساعت 19 و 11 دقیقه | نظرات کاربران ( 1 )

متد 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 یک پیوند را در یک فراخوانی تنظیم کنید.

ارسال نظر و نظرات ثبت شده
داود :
4 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 و کاربرد آن در طراحی سایت راهنمای کاربردی افزودن کلاس ...
دسته بندی
جستجو
⏳ در حال پردازش...
لطفا صبر کنید