jQuery اثر - روش toggle()

مثال

تغییر وضعیت نمایش و پنهان <p> عناصر:

$(".btn1").click(function(){
  $("p").hide();
});

آزمایش کنید

تعریف و نحوه‌ی استفاده

مетод toggle() وضعیت قابل مشاهده عناصر را تغییر می‌دهد.

اگر عناصر انتخاب شده قابل مشاهده باشند، آن‌ها را پنهان کنید، اگر پنهان باشند، آن‌ها را نمایش دهید.

نحوه‌ی استفاده

$(selector).toggle(speed,callback,switch)
پارامترها توضیح
speed

اختیاری. تعیین می‌کند که عناصر از قابل مشاهده به پنهان یا برعکس با چه سرعتی تغییر کنند (یا برعکس). پیش‌فرض "0" است.

ممکنه‌ها:

  • میلی‌ثانیه (مثلاً 1500)
  • "slow"
  • "normal"
  • "fast"

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

اگر این پارامتر تنظیم شود، نمی‌توان از پارامتر switch استفاده کرد.

callback

اختیاری. توابعی که پس از اجرای toggle باید اجرا شوند.

برای یادگیری بیشتر در مورد callback، لطفاً به فصل jQuery Callback ما مراجعه کنید.

مگر اینکه پارامتر speed تنظیم شده باشد، نمی‌توان این پارامتر را تنظیم کرد.

switch

اختیاری. نوع بولین. تعیین می‌کند که toggle آیا همه عناصر انتخاب شده را پنهان یا نمایش کند.

  • True - نمایش همه عناصر
  • False - پنهان کردن همه عناصر

اگر این پارامتر تنظیم شود، نمی‌توان از پارامترهای speed و callback استفاده کرد.

نکات و یادداشت‌ها

نکته:این اثر برای عناصر پنهان شده توسط jQuery یا عناصری که در CSS با display:none مشخص شده‌اند (اما برای عناصر visibility:hidden مناسب نیست) مناسب است.

مثال‌های بیشتر

از پارامتر speed استفاده کنید
از پارامتر speed برای پنهان کردن و نمایش عناصر استفاده کنید.
از پارامتر switch استفاده کنید
از پارامتر switch برای نمایش همه بخش‌های پنهان استفاده کنید.