این آموزش در تاریخ ۱۴۰۱/۰۶/۲۶ آپدیت شده است.
آموزش ویژگی scrollLeft در DOM جاوااسکریپت
سلام خدمت تمامی دوستان و همراهان محترم سایت آموزشی فری لرن ، امیدوارم که حال همگیتون خوب باشه. لطفا در ادامه با آموزش ویژگی scrollLeft در DOM جاوااسکریپت با من همراه باشید.
Free-Learn
آنچه در این جلسه میخوانید :
ویژگی scrollLeft در DOM جاوااسکریپت
با استفاده از ویژگی scrollLeft میتونیم میزان یا مقدار ( اسکرول کردن بصورت افقی از سمت چپ به راست ) یک تگ رو بدست آوریم و یا مقدار جدید براش تنظیم نماییم.
و همچنین با استفاده از ویژگی scrollTop میتونیم میزان یا مقدار ( اسکرول کردن بصورت عمودی از سمت بالا به پایین ) یک تگ رو بدست آوریم و یا مقدار جدید براش تنظیم نماییم.
اگه اسکرول در باکسی که راست به چپ ( یا RTL ) باشد اتفاق بیوفتد، مقدار ویژگی scrollLeft در خروجی منفی می شود. ( مثال شماره ۳ )
| مقدار برگشتی | یک مقدار عددی که نشان دهنده میزان اسکرولی هست که بصورت افقی انجام شده |
|---|
Free-Learn
مثال از این ویژگی
در ادامه میتوانید یک مثال از این ویژگی را در زبان جاوا اسکریپت مشاهده نمایید.
مثال شماره ۱ : در مثال زیر هم از ویژگی scrollLeft و هم scrollTop استفاده شده ( برای بدست آوردن میزان اسکرول پیمایش شده بصورت افقی و عمودی )
|
1 2 3 4 5 6 7 8 9 10 |
<script> function Get(){ var MyBox = document.getElementById("MyBox"); var Scroll_Left = MyBox.scrollLeft; var Scroll_Top = MyBox.scrollTop; document.getElementById("Result").innerHTML = "افقی = " + Scroll_Left + "px" + "<br>" + "عمودی = " + Scroll_Top + "px"; } </script> |
مثال شماره ۲ : تنظیم مقدار جدید
|
1 2 3 4 5 6 7 8 9 10 |
<script> function Set(){ var MyBox = document.getElementById("MyBox"); MyBox.scrollLeft = 200; MyBox.scrollTop = 200; document.getElementById("Result").innerHTML = "Horizontally = " + MyBox.scrollLeft + "px" + "<br>" + "Vertically = " + MyBox.scrollTop + "px"; } </script> |
مثال شماره ۳ : اگه باکسی که قراره اسکرول بخوره جهت متنش rtl بود ( یعنی از راست به چپ ) اونوقت ویژگی scrollLeft بصورت افقی از سمت راست به چپ اسکرول میکنه و مقدار منفی میده.
|
1 2 3 |
#MyBox{ direction: rtl; } |
Free-Learn
پشتیبانی مرورگرها
در جدول زیر میتوانید مشاهده نمایید که آیا مرورگرهای اینترنتی از این ویژگی در جاوااسکریپت پشتیبانی میکنند یا خیر.
| نام ویژگی | Chrome | Firefox | Opera | Safari | Edge |
| scrollLeft | بله | بله | بله | بله | بله |
Free-Learn
شکل نوشتاری
نحوه نوشتن یا استفاده یا سینتَکس (Syntax) این ویژگی در جاوااسکریپت بصورت زیر می باشد.
- برای گرفتن مقدار :
|
1 |
Element.scrollLeft; |
- برای تنظیم / ست کردن مقدار جدید :
|
1 |
Element.scrollLeft = New_Value; |
- New_Value : مقدار عددی به پیکسل که قرار است بصورت افقی اسکرول شود
Free-Learn
نکات و توضیحات
- ویژگی scrollLeft مقدار اسکرول که بصورت افقی انجام میشود را برمیگرداند یا میتوان مقدار جدید تنظیم کرد.
- ویژگی scrollTop مقدار اسکرول که بصورت عمودی انجام میشود را برمیگرداند یا میتوان مقدار جدید تنظیم کرد.
