۵ نکته مهم درباره متد height در jQuery
💡آشنایی با خواندن و تنظیم ارتفاع
متد height در jQuery برای خواندن ارتفاع داخلی یک عنصر یا تنظیم ارتفاع آن به کار می رود. این متد زمانی مفید است که بخواهید اندازه بخش های یک صفحه را بررسی کنید، نمایش عناصر را هماهنگ کنید یا ارتفاع یک کادر را در پاسخ به رویداد کاربر تغییر دهید. در این راهنما با شیوه استفاده، تفاوت آن با متدهای مشابه و نکته های رایج کار با ارتفاع آشنا می شوید.
📘پیش نیاز و کاربرد
در این بخش از
آموزش JQuery،
متد height را بررسی می کنیم. برای اجرای مثال ها باید jQuery در صفحه بارگذاری شده باشد و کد پس از آماده شدن عناصر صفحه اجرا شود. آشنایی با انتخابگرهای CSS مانند نام تگ، کلاس و شناسه نیز کمک می کند عنصر مورد نظر را دقیق انتخاب کنید.
۱. متد height چه مقداری را می خواند؟
📏ارتفاع خود عنصر
وقتی متد را بدون آرگومان فراخوانی می کنید، مقدار ارتفاع محتوای عنصر انتخاب شده را برمی گرداند. این مقدار بر حسب پیکسل است و بخش محتوای عنصر را اندازه می گیرد؛ بنابراین padding، border و margin جزو مقدار بازگشتی نیستند. اگر ارتفاع عنصر با واحد دیگری مانند درصد تعیین شده باشد، مقدار خوانده شده همچنان به شکل عدد پیکسلی برگردانده می شود.
🧪مثال کاربردی
فرض کنید یک کادر محتوایی ارتفاعی برابر با 300 پیکسل دارد. با انتخاب آن و فراخوانی height()، عدد 300 را دریافت می کنید؛ حتی اگر کادر padding یا حاشیه داشته باشد، آن مقادیر به این عدد اضافه نمی شوند. این رفتار برای بررسی ارتفاع ناحیه محتوا مناسب است، اما برای محاسبه اندازه کلی کادر باید از متد دیگری استفاده کنید.
۲. خواندن ارتفاع یک عنصر با height()
🔎خواندن مقدار برای استفاده در کد
برای خواندن ارتفاع، عنصر را با یک انتخابگر مشخص کنید و height() را بدون مقدار داخل پرانتز به کار ببرید. نتیجه یک عدد است و می توانید آن را در متغیر ذخیره کنید، به کاربر نمایش دهید یا در محاسبات بعدی استفاده کنید. روش زیر ارتفاع عنصر دارای شناسه panel را می خواند.
const panelHeight = $("#panel").height();
console.log(panelHeight);
✅سناریوی واقعی
برای نمونه، در یک صفحه آموزشی ممکن است بخواهید ارتفاع پنل توضیحات را هنگام کلیک روی دکمه در کنسول ثبت کنید. اگر انتخابگر به هیچ عنصری نرسد، نتیجه قابل استفاده ای به دست نمی آید؛ پس هنگام عیب یابی مطمئن شوید شناسه یا کلاس در HTML درست نوشته شده است. همچنین اجرای کد پس از ساخته شدن DOM از خطاهای ناشی از انتخاب زودهنگام عنصر جلوگیری می کند.
۳. تغییر ارتفاع عنصر با height(value)
🛠️تنظیم ارتفاع تازه
با ارسال یک مقدار به height()، ارتفاع محتوای عنصر تغییر می کند. مقدار را می توانید به صورت عددی بر حسب پیکسل یا رشته ای دارای واحد معتبر بنویسید. استفاده از عدد معمولاً خواناتر است و لازم نیست واحد پیکسل را به آن اضافه کنید. برای مثال، کد زیر ارتفاع عنصر با شناسه panel را روی 300 پیکسل تنظیم می کند.
$("#panel").height(300);
💬مثال در واکنش به کلیک
فرض کنید کاربر دکمه «نمایش بیشتر» را انتخاب می کند و باید فضای بیشتری برای متن باز شود. می توانید با رویداد کلیک، ارتفاع کادر را تغییر دهید. اگر قرار است تغییر به صورت تدریجی دیده شود، متد animate() گزینه مناسب تری از تغییر فوری است. انتخاب روش به تجربه ای بستگی دارد که می خواهید برای کاربر ایجاد کنید.
$("#showMore").on("click", function () {
$("#panel").height(300);
});
۴. تفاوت height با innerHeight و outerHeight
📚انتخاب متد متناسب با نیاز
هر متد اندازه گیری ارتفاع را با احتساب بخش های متفاوتی گزارش می کند. height() ارتفاع محتوا را برمی گرداند، innerHeight() ارتفاع محتوا به همراه padding را می سنجد و outerHeight() حاشیه بیرونی یا border را نیز در محاسبه وارد می کند. بنابراین، پیش از استفاده باید روشن کنید که هدف اندازه گیری محتوای داخل عنصر است یا اندازه کلی آن.
| متد |
چه چیزی را می سنجد؟ |
کاربرد معمول |
height() |
محتوای عنصر |
محاسبه یا تنظیم فضای محتوایی |
innerHeight() |
محتوا و padding |
اندازه گیری فضای داخلی قابل استفاده |
outerHeight() |
محتوا، padding و border؛ و در صورت نیاز margin |
بررسی اندازه کلی کادر در چیدمان |
⚠️نکته درباره margin
برای محاسبه ارتفاع بیرونی همراه با margin، آرگومان true را به outerHeight() بدهید. margin در حالت پیش فرض جزو اندازه گزارش شده نیست. اگر عنصر دارای border-box باشد، شیوه محاسبه CSS نیز بر اندازه نهایی نمایشی اثر دارد؛ به همین دلیل مقایسه متدها باید با آگاهی از box model انجام شود.
۵. انتخاب درست عنصر و زمان اجرای کد
🧭جلوگیری از خطاهای معمول
انتخابگر باید به همان عنصری اشاره کند که قصد اندازه گیری یا تغییر آن را دارید. اگر چند عنصر انتخاب شوند، خواندن ارتفاع معمولاً بر اساس نخستین عنصر مجموعه انجام می شود؛ اما هنگام تنظیم ارتفاع، مقدار روی عناصر انتخاب شده اعمال می شود. این تفاوت را هنگام استفاده از کلاس مشترک برای چند کادر در نظر بگیرید.
🧩نمونه با آماده شدن صفحه
در نمونه زیر، کد داخل تابع آماده شدن سند اجرا می شود تا عنصر پیش از اندازه گیری در صفحه موجود باشد. این الگو برای صفحه هایی که اسکریپت در بخش بالایی سند قرار دارد مفید است. در پروژه های جدید، می توانید از جاوااسکریپت ساده هم برای خواندن اندازه استفاده کنید؛ اما اگر پروژه شما بر پایه jQuery است، این متد روشی کوتاه و سازگار با الگوی همان پروژه فراهم می کند.
$(function () {
const panelHeight = $("#panel").height();
console.log(panelHeight);
});
نمونه کامل برای خواندن و تنظیم ارتفاع
📝ترکیب دو حالت متد
در مثال زیر ابتدا ارتفاع فعلی پنل خوانده و در پیام ثبت می شود؛ سپس با کلیک روی دکمه، ارتفاع آن تغییر می کند. در HTML باید عناصری با شناسه های استفاده شده در انتخابگرها وجود داشته باشند. این نمونه را می توانید با کد HTML و فایل jQuery پروژه خود هماهنگ کنید.
$(function () {
const currentHeight = $("#panel").height();
console.log("Current height:", currentHeight);
$("#resizePanel").on("click", function () {
$("#panel").height(300);
});
});
چند نکته برای استفاده بهتر از height در jQuery
- اندازه مورد نیاز را مشخص کنید: برای ارتفاع محتوا از
height() و برای اندازه داخلی یا بیرونی از متد متناسب استفاده کنید.
- وجود عنصر را بررسی کنید: اگر کد پیش از ساخته شدن عنصر اجرا شود، اندازه گیری نتیجه مورد انتظار را نمی دهد.
- به واحدها توجه کنید: مقدار عددی برای تنظیم ارتفاع بر حسب پیکسل است؛ برای اندازه های نسبی، به نیاز پروژه و رفتار CSS توجه کنید.
- ارتفاع ثابت را با احتیاط تنظیم کنید: در صفحه های واکنش گرا، محتوای متغیر ممکن است به فضای بیشتری نیاز داشته باشد. محدود کردن ارتفاع می تواند بخشی از متن را پنهان کند.
- دسترسی پذیری را فراموش نکنید: اگر با تغییر ارتفاع بخشی از محتوا پنهان یا آشکار می شود، وضعیت آن را برای کاربر واضح کنید و از کنترل قابل استفاده با صفحه کلید بهره ببرید.
مقایسه سریع متدهای اندازه گیری ارتفاع
| نیاز شما |
متد پیشنهادی |
دلیل |
| خواندن یا تنظیم ارتفاع محتوا |
height() |
مستقیماً با ارتفاع محتوای عنصر کار می کند. |
| محاسبه فضای داخلی همراه با padding |
innerHeight() |
padding را هم در اندازه لحاظ می کند. |
| محاسبه اندازه کادر همراه با border |
outerHeight() |
برای بررسی اندازه بیرونی عنصر کاربرد دارد. |
| اندازه بیرونی همراه با margin |
outerHeight(true) |
margin را نیز در نتیجه وارد می کند. |
۱۰ پرسش و پاسخ درباره متد height در jQuery
در این بخش به پرسش های پرکاربرد درباره خواندن و تغییر ارتفاع پاسخ می دهیم. دانستن تفاوت متدهای اندازه گیری و آگاهی از زمان اجرای کد، انتخاب روش مناسب را ساده تر می کند؛ به ویژه زمانی که چیدمان صفحه به محتوا یا اندازه نمایشگر وابسته است.
۱. متد height در jQuery چه کاری انجام می دهد؟
این متد ارتفاع محتوای یک عنصر را می خواند یا ارتفاع تازه ای برای آن تنظیم می کند. فراخوانی بدون آرگومان برای دریافت مقدار است و فراخوانی همراه با مقدار برای تغییر اندازه استفاده می شود. برای نمونه، $("#box").height() ارتفاع محتوای عنصر را برمی گرداند و $("#box").height(250) آن را تنظیم می کند.
۲. شکل کلی خواندن ارتفاع چیست؟
ساختار کلی به صورت $(selector).height() است. ابتدا انتخابگر عنصر مورد نظر را مشخص می کنید و سپس متد را بدون مقدار فراخوانی می کنید. نتیجه معمولاً یک عدد بر حسب پیکسل است. می توانید آن را در متغیر ذخیره کنید یا برای بررسی مقدار فعلی در کنسول چاپ کنید.
۳. چطور ارتفاع یک عنصر را تغییر دهم؟
مقدار مورد نظر را داخل پرانتز قرار دهید؛ برای مثال $("#box").height(250) ارتفاع محتوای عنصر را روی 250 پیکسل می گذارد. اگر چند عنصر با یک انتخابگر انتخاب شده باشند، تنظیم روی همه آنها اعمال می شود. پیش از استفاده از ارتفاع ثابت، بررسی کنید که متن یا محتوای متغیر در اندازه های مختلف صفحه بریده نشود.
۴. آیا height شامل padding و border می شود؟
خیر. متد height() ارتفاع بخش محتوا را گزارش می کند و padding، border و margin را در مقدار بازگشتی وارد نمی کند. اگر به اندازه محتوا به همراه padding نیاز دارید، از innerHeight() استفاده کنید. برای در نظر گرفتن border نیز outerHeight() مناسب تر است.
۵. تفاوت height و innerHeight چیست؟
height() فقط ارتفاع محتوا را می سنجد، اما innerHeight() padding بالا و پایین را هم به حساب می آورد. برای مثال، هنگام محاسبه فضای داخلی یک کادر که متن در آن قرار می گیرد، دانستن اندازه همراه با padding می تواند مفید باشد. هیچ کدام از این دو متد margin را در نتیجه وارد نمی کنند.
۶. چه زمانی از outerHeight استفاده می شود؟
وقتی می خواهید ارتفاع عنصر را همراه با padding و border بدانید، از outerHeight() استفاده کنید. برای محاسبه همراه با margin نیز آرگومان true را ارسال کنید؛ یعنی outerHeight(true). این متدها در مقایسه اندازه کادرها و تنظیم فاصله میان اجزای چیدمان کاربرد دارند.
۷. مقدار height با چه واحدی برگردانده می شود؟
مقدار خوانده شده به صورت عدد پیکسلی برگردانده می شود. هنگام تنظیم ارتفاع نیز می توانید عددی مانند 250 بدهید که بر حسب پیکسل تفسیر می شود. اگر مقدار دارای واحد CSS می فرستید، از رشته مناسب استفاده کنید و رفتار آن را با سبک های اعمال شده بر عنصر هماهنگ نگه دارید.
۸. چرا گاهی مقدار ارتفاع صفر یا نامنتظره است؟
ممکن است انتخابگر عنصری را پیدا نکند، کد پیش از ساخته شدن DOM اجرا شود یا عنصر در وضعیتی باشد که اندازه قابل مشاهده ای ندارد. همچنین قواعد CSS و محتوای عنصر بر اندازه اثر می گذارند. شناسه یا کلاس را بررسی کنید، کد را پس از آماده شدن سند اجرا کنید و در ابزار توسعه مرورگر وضعیت نمایش و سبک های عنصر را ببینید.
۹. آیا height برای چند عنصر هم زمان کار می کند؟
بله. اگر انتخابگر چند عنصر را برگرداند، تنظیم ارتفاع روی همه آنها انجام می شود. اما هنگام خواندن مقدار، نتیجه معمولاً مربوط به نخستین عنصر مجموعه است. اگر ارتفاع هر عنصر را جداگانه لازم دارید، مجموعه را پیمایش کنید و برای هر عضو مقدار را بخوانید؛ این کار مانع اشتباه گرفتن یک مقدار با اندازه تمام عناصر می شود.
۱۰. برای تغییر تدریجی ارتفاع چه روشی مناسب است؟
برای تغییر فوری می توانید از height(value) استفاده کنید. اگر می خواهید تغییر ارتفاع به شکل انیمیشن نمایش داده شود، متد animate() را به کار ببرید و مقدار نهایی را تعیین کنید. انیمیشن را برای هدفی روشن و با زمان مناسب به کار ببرید تا تغییر چیدمان باعث سردرگمی یا اختلال در خواندن محتوا نشود.
نتیجه گیری
⭐انتخاب متد مناسب
متد
height در jQuery راهی ساده برای خواندن ارتفاع محتوای عنصر یا تنظیم مقدار تازه برای آن است. برای اندازه گیری دقیق تر، تفاوت آن با
innerHeight() و
outerHeight() را در نظر بگیرید و زمان اجرای کد و انتخابگر را بررسی کنید. اگر با توسعه صفحه یا
طراحی سایت سروکار دارید، انتخاب روش اندازه گیری متناسب با box model کمک می کند چیدمان قابل پیش بینی تری بسازید.
سوالات متداول متد height در jQuery
متد height در jQuery فقط ارتفاع محتوای عنصر را برمی گرداند؟
بله. در حالت خواندن، height ارتفاع محتوای عنصر را بر حسب پیکسل برمی گرداند و padding، border و margin را شامل نمی شود. برای محاسبه بخش های دیگر از innerHeight یا outerHeight استفاده کنید.
چطور ارتفاع عنصر را روی 300 پیکسل تنظیم کنم؟
عنصر را انتخاب کنید و مقدار 300 را به متد بدهید؛ مانند $("#panel").height(300);. مقدار عددی بر حسب پیکسل در نظر گرفته می شود.
برای اندازه گیری ارتفاع همراه با padding از کدام متد استفاده کنم؟
از متد innerHeight() استفاده کنید. این متد ارتفاع محتوا و padding را محاسبه می کند، اما border و margin را در نتیجه وارد نمی کند.
چرا مقدار height برای عنصر من درست نیست؟
انتخابگر نادرست، اجرای کد پیش از آماده شدن صفحه یا پنهان بودن عنصر می تواند بر نتیجه اثر بگذارد. شناسه و کلاس را بررسی کنید و کد اندازه گیری را پس از آماده شدن سند اجرا کنید.
آیا می توان ارتفاع چند عنصر را با یک دستور تغییر داد؟
بله. اگر انتخابگر چند عنصر را برگرداند، تنظیم height روی تمام عناصر انتخاب شده اعمال می شود. برای خواندن ارتفاع هر عنصر به صورت جداگانه، مجموعه را پیمایش کنید.