آموزش متد outerHeight در jQuery؛ اندازه گیری ارتفاع بیرونی عناصر
💡آشنایی با متد
در این بخش از
آموزش JQuery، با
متد outerHeight آشنا می شوید؛ روشی کاربردی برای به دست آوردن ارتفاع بیرونی عناصر صفحه. اگر در حال یادگیری jQuery یا توسعه یک رابط کاربری هستید، دانستن تفاوت ارتفاع محتوا، حاشیه داخلی، کادر و فاصله بیرونی کمک می کند اندازه واقعی یک عنصر را دقیق تر بررسی کنید. این متد در ساخت رابط های واکنش گرا، تنظیم جایگاه اجزا و عیب یابی چیدمان صفحه نیز کاربرد دارد.
متد outerHeight در jQuery چه کاری انجام می دهد؟
📏خواندن ارتفاع بیرونی
متد outerHeight ارتفاع بیرونی اولین عنصر انتخاب شده در HTML را برمی گرداند. منظور از ارتفاع بیرونی، ارتفاعی است که با احتساب padding و border محاسبه می شود. در حالت معمول، margin در این مقدار حساب نمی شود؛ اما می توان با ارسال مقدار true آن را نیز به محاسبه اضافه کرد. خروجی این متد یک عدد بر حسب پیکسل است و معمولا بدون واحد CSS برگردانده می شود.
⭐نکته مهم درباره مقدار خروجی
مقدار محاسبه شده ممکن است عدد اعشاری باشد؛ برای نمونه، در صفحه هایی که بزرگ نمایی مرورگر یا اندازه های کسری دارند، مقدار ارتفاع همیشه عدد صحیح نیست. بنابراین بهتر است هنگام مقایسه یا انجام محاسبات بعدی، خروجی را همان طور که دریافت می کنید در نظر بگیرید و تنها زمانی آن را گرد کنید که کاربرد پروژه به عدد صحیح نیاز داشته باشد.
ساختار اصلی متد
⌨️قالب فراخوانی
ساختار متد به شکل زیر است. عبارت selector مشخص می کند کدام عنصر یا عناصر HTML انتخاب شوند و آرگومان includeMargin تعیین می کند که فاصله بیرونی نیز در اندازه نهایی لحاظ شود یا خیر.
$(selector).outerHeight(includeMargin)
🔎معنی آرگومان ها
آرگومان includeMargin اختیاری است. اگر آن را وارد نکنید یا مقدار false بدهید، نتیجه شامل ارتفاع محتوا، padding و border خواهد بود. با مقدار true، حاشیه های بالا و پایین نیز به اندازه اضافه می شوند. استفاده از true زمانی مناسب است که می خواهید فضای اشغال شده توسط عنصر را در چیدمان صفحه بسنجید، نه فقط اندازه کادر قابل مشاهده آن را.
تفاوت outerHeight با height و innerHeight
🧭انتخاب متد مناسب
در jQuery چند متد برای اندازه گیری ارتفاع وجود دارد و هر کدام بخش متفاوتی از جعبه عنصر را گزارش می کنند. انتخاب نادرست متد ممکن است باعث شود فاصله ها در محاسبات شما با ظاهر واقعی صفحه هماهنگ نباشد. به طور خلاصه، height برای بخش محتوا، innerHeight برای محتوا به همراه padding و outerHeight برای اندازه بیرونی شامل padding و border کاربرد دارد.
| متد |
چه چیزی را اندازه می گیرد؟ |
آیا margin حساب می شود؟ |
کاربرد معمول |
| height() |
ارتفاع محتوای عنصر |
خیر |
بررسی اندازه ناحیه محتوا |
| innerHeight() |
محتوا به همراه padding |
خیر |
اندازه فضای داخلی عنصر |
| outerHeight() |
محتوا، padding و border |
خیر، مگر با true |
اندازه کادر بیرونی عنصر |
| outerHeight(true) |
محتوا، padding، border و margin |
بله |
محاسبه فضای اشغال شده در چیدمان |
📝یک مثال ساده از تفاوت اندازه ها
فرض کنید ارتفاع محتوای یک کادر 100 پیکسل، padding بالا و پایین آن در مجموع 20 پیکسل و ضخامت border بالا و پایین آن در مجموع 4 پیکسل باشد. در این وضعیت، height مقدار 100، innerHeight مقدار 120 و outerHeight مقدار 124 پیکسل را گزارش می کند. اگر margin بالا و پایین نیز در مجموع 16 پیکسل باشد، outerHeight(true) مقدار 140 پیکسل خواهد داشت. این اعداد نمونه هستند و نتیجه واقعی به سبک های CSS عنصر بستگی دارد.
نمونه استفاده از متد outerHeight
▶️نمایش ارتفاع با کلیک روی دکمه
مثال زیر، رویداد کلیک را به دکمه متصل می کند. پس از کلیک، jQuery ارتفاع بیرونی نخستین عنصر div انتخاب شده را می خواند و آن را در پنجره هشدار نمایش می دهد. در این نمونه چون آرگومان متد ارسال نشده است، margin در عدد نمایش داده شده محاسبه نمی شود.
$("button").click(function(){
alert($("div").outerHeight());
});
⚠️دقت به انتخابگر در مثال
انتخابگر $("div") ممکن است چندین عنصر div را پیدا کند، اما outerHeight در حالت خواندن، مقدار نخستین عنصر موجود در مجموعه انتخاب شده را برمی گرداند. برای اینکه کد دقیقا عنصر مورد نظر را بررسی کند، بهتر است از شناسه یا کلاس مشخص استفاده کنید. این کار از نتیجه های غیرمنتظره جلوگیری می کند و خوانایی کد را نیز افزایش می دهد.
$("#content").outerHeight();
$(".card").first().outerHeight();
$(".card").outerHeight(true);
نحوه خواندن مثال
1
با $("button") عناصر button را برای اتصال رویداد کلیک انتخاب می کنید. اگر چند دکمه وجود داشته باشد، رویداد برای همه آنها ثبت می شود.
2
با فرا رسیدن کلیک، تابع داخل click اجرا می شود. درون تابع، selector مربوط به div اجرا شده و عنصر مورد نظر برای اندازه گیری پیدا می شود.
3
متد outerHeight مقدار ارتفاع بیرونی را می خواند و تابع alert آن عدد را در یک پنجره کوچک مرورگر نشان می دهد. برای نمایش نتیجه در خود صفحه می توانید آن را در یک عنصر متنی قرار دهید.
استفاده از outerHeight برای تغییر ارتفاع
🛠️حالت تنظیم مقدار
outerHeight فقط برای خواندن اندازه نیست و در jQuery می توان از آن برای تنظیم ارتفاع بیرونی عنصر نیز استفاده کرد. اگر یک عدد یا مقدار معتبر را به متد بدهید، کتابخانه ارتفاع CSS را طوری تنظیم می کند که اندازه بیرونی مورد نظر به دست آید. این رفتار با خواندن مقدار فرق دارد؛ پس هنگام تغییر اندازه، به تفاوت مقدار نهایی و ارتفاع محتوا توجه کنید.
$("#panel").outerHeight(250);
🚦احتیاط هنگام تنظیم اندازه
تغییر ارتفاع ممکن است روی چیدمان بخش های دیگر صفحه اثر بگذارد؛ به ویژه اگر عنصر دارای محدودیت های CSS، محتوای پویا یا رفتار واکنش گرا باشد. پس از تنظیم مقدار، صفحه را در اندازه های مختلف بررسی کنید. اگر هدف فقط تعیین حداقل یا حداکثر اندازه است، ویژگی های CSS مانند min-height و max-height می توانند انتخاب مناسب تری باشند.
نکته های کاربردی و خطاهای رایج
1
عنصر باید در صفحه قابل اندازه گیری باشد. اندازه گیری عنصری که با display:none پنهان شده، می تواند نتیجه قابل اتکایی نداشته باشد؛ چون عنصر در چیدمان عادی صفحه حضور ندارد. اگر لازم است اندازه چنین بخشی را بخوانید، زمان اندازه گیری را به بعد از نمایش آن موکول کنید.
2
تغییرات محتوا را در نظر بگیرید. متن هایی که دیرتر بارگذاری می شوند، تصویرهای بدون ابعاد ثابت و فونت هایی که پس از نمایش صفحه آماده می شوند، می توانند ارتفاع عنصر را تغییر دهند. اگر اندازه در رویداد بارگذاری یا پس از دریافت داده لازم است، آن را در زمان مناسب دوباره محاسبه کنید.
3
margin را با padding اشتباه نگیرید. padding بخشی از فضای داخلی عنصر است، اما margin فضای بیرونی آن را مشخص می کند. برای محاسبه اندازه همراه با margin باید outerHeight(true) را فراخوانی کنید. اگر این تفاوت در نظر گرفته نشود، فاصله بین اجزا در محاسبات شما ممکن است کمتر از فضای واقعی صفحه باشد.
4
اندازه را بی دلیل در حلقه های سنگین نخوانید. خواندن اندازه های صفحه به مرورگر نیاز دارد تا اطلاعات چیدمان را فراهم کند. اگر در حلقه ای بزرگ، اندازه گیری و تغییر CSS را پشت سر هم انجام دهید، ممکن است عملکرد صفحه کاهش یابد. بهتر است خواندن اندازه ها را تا حد ممکن گروه بندی کنید و تغییرات ظاهری را جداگانه اعمال کنید.
5
نسخه jQuery و شیوه انتخاب عنصر را بررسی کنید. مطمئن شوید کتابخانه jQuery در صفحه بارگذاری شده و کد پس از آماده شدن عناصر DOM اجرا می شود. همچنین انتخابگرهای دقیق، مانند شناسه یا کلاس اختصاصی، از اندازه گیری اشتباه عنصر جلوگیری می کنند.
کاربردهای رایج در طراحی رابط کاربری
🎨از تنظیم پنل تا طراحی سایت
در رابط کاربری، اندازه گیری ارتفاع می تواند برای هماهنگ کردن کارت ها، محاسبه جایگاه یک پنل، تنظیم فضای قابل پیمایش یا بررسی تفاوت اندازه بخش های صفحه به کار رود. در پروژه های
طراحی سایت نیز این نوع محاسبه زمانی مفید است که اندازه اجزا بر اساس محتوای واقعی یا تعامل کاربر تغییر کند. با این حال، برای چیدمان های ساده بهتر است ابتدا از CSS و ابزارهایی مانند Flexbox یا Grid استفاده کنید و تنها در صورت نیاز سراغ محاسبه با JavaScript بروید.
🧪آزمایش نتیجه در مرورگر
برای اطمینان از نتیجه، ابزار توسعه مرورگر را باز کنید و مقدار محاسبه شده را با CSS عنصر مقایسه کنید. در این بررسی، padding، ضخامت border، مقدار margin و قوانین واکنش گرا را در نظر بگیرید. اگر نتیجه در اندازه های مختلف صفحه تغییر می کند، احتمال دارد محتوای عنصر چند خطی شده یا یک قانون رسانه ای، ارتفاع یا فاصله ها را تغییر داده باشد.
جمع بندی متد outerHeight در jQuery
✅نتیجه گیری
در یک جمع بندی، متد outerHeight در jQuery راهی روشن برای اندازه گیری ارتفاع بیرونی عنصر است و به طور پیش فرض محتوا، padding و border را در مقدار خود لحاظ می کند. با افزودن true می توانید margin بالا و پایین را نیز محاسبه کنید. تفاوت آن با height و innerHeight را بشناسید، عنصر درستی را انتخاب کنید و اندازه گیری را پس از نمایش کامل محتوا انجام دهید تا نتیجه دقیق تری بگیرید.
سوالات متداول متد outerHeight در jQuery
متد outerHeight در jQuery چه مقداری برمی گرداند؟
این متد ارتفاع بیرونی نخستین عنصر انتخاب شده را بر حسب پیکسل برمی گرداند. در حالت پیش فرض، ارتفاع محتوا به همراه padding و border محاسبه می شود و margin در مقدار خروجی وجود ندارد.
چطور margin را هم در محاسبه ارتفاع وارد کنم؟
آرگومان true را به متد اضافه کنید؛ برای نمونه، $(".box").outerHeight(true). در این حالت margin بالا و پایین نیز به ارتفاع عنصر افزوده می شود.
تفاوت outerHeight با innerHeight چیست؟
innerHeight ارتفاع محتوا و padding را اندازه می گیرد، اما outerHeight علاوه بر این دو، ضخامت border را نیز حساب می کند. outerHeight(true) مقدار margin را هم در نظر می گیرد.
آیا outerHeight برای تغییر اندازه عنصر هم کاربرد دارد؟
بله. می توانید یک مقدار را به متد بدهید تا ارتفاع بیرونی عنصر تنظیم شود؛ برای مثال، $("#panel").outerHeight(250). پس از تغییر اندازه، اثر آن را روی چیدمان صفحه بررسی کنید.
چرا اندازه عنصر پنهان ممکن است دقیق نباشد؟
عنصری که با display:none پنهان است در چیدمان عادی صفحه حضور ندارد؛ بنابراین اندازه گیری آن ممکن است نتیجه مورد انتظار را ندهد. اندازه را پس از قابل مشاهده شدن عنصر محاسبه کنید.