jQuery Syntax

نحوه نوشتار در jQuery

jQuery سفارشی، برای انتخاب عناصر HTML و انجام عملیات روی آن‌ها درست شده است. نوشتار پایه در آن به صورت: $(selector).action() است.

  • علامت $ برای دسترسی به jQuery
  • یک انتخاب کننده (selector) برای پیدا کردن عنصر یا عناصر HTML
  • یک عمل (action) در jQuery برای انجام شدن روی عنصر یا عناصر.

مثال:

  • $(this).hide() عنصر جاری را مخفی می‌کند.
  • $("p").hide() تمام عناصر <p> را مخفی می‌کند.
  • $(".test").hide() تمام عناصر با "class="tets را مخفی می‌کند.
  • $("#test").hide() عنصر دارای "id="test را مخفی می‌کند.

رخداد Document Ready

تمامی کدهای jQuery را داخل رخداد document ready می‌نویسند.

$(document).ready(function(){

    // jQuery methods go here...

});

دلیل این امر آن است که نمی‌خواهیم قبل از آماده شدن سند هیچ کدی از jQuery اجرا شود. اگر قبل از بارگذاری کامل سند کد جاوا اسکریپت شما اجرا شود، ممکن است با شکست مواجه شود. مانند دو نمونه زیر:

  • سعی در مخفی کردن یک عنصر قبل از ساخته شدن آن
  • سعی در گرفتن اندازه یک تصویر که هنوز بارگذاری نشده است.

تیم jQuery نوشتار ساده‌تری را برای رخداد document ready ایجاد کرده‌اند:

$(function(){

    // jQuery methods go here...

});

هر کدام را که ترجیح می‌دهید استفاده کنید. ولی نظر ما این است که استفاده از نوشتار اول یعنی استفاده از رخداد document ready برای خواندن و درک کد آسان‌تر است.

هرچند استفاده از رخداد document ready این امکان را فراهم می‌کند که کدهای جاوا اسکریپت خود را در بخش <head> قرار دهید، ولی در عمل بهتر است که کدهای جاوا اسکریپت در آخر صفحه و قبل از برچسب پایانی <body/> قرار داده شوند. همچنین اگر تعدا صفحات وب سایت شما زیاد است و می‌خواهید که نگهداری از کدهای jQuery برایتان آسان باشد، بهتر است که کدهای خود را در یک فایل جداگانه قرار دهید و آن را در فایل HTML فراخوانی کنید.