الخاصية margin-left
الخاصية margin-left في CSS تضبط الهامش في الطرف الأيسر من العنصر، والقيم الموجبة ستؤدي إلى إبعاد العنصر عمّا جاوره، والقيم السالبة ستقربه منها.
بطاقة الخاصية
| القيمة الابتدائية | 0
|
|---|---|
| تُطبَّق على | جميع العناصر، ما عدا عناصر الجداول التي لا تساوي فيها قيمة الخاصية display إحدى الكلمات المحجوزة table-caption و table و inline-table.
|
| قابلة للوراثة | لا |
| قابلة للتحريك | نعم |
| القيمة المحسوبة | نسبة مئوية أو طول مطلق. |
/* <length> أطوال */
margin-left: 10px; /* طول مطلق */
margin-left: 1em; /* طول نسبي لحجم الخط */
margin-left: 5%; /* طول نسبي لعرض أقرب حاوية كتلية */
/* الكلمات المحجوزة */
margin-left: auto;
/* القيم العامة */
margin-left: inherit;
margin-left: initial;
margin-left: unset;
في حالات نادرة التي يكون فيها عرض العنصر مُقيّدًا (أي أنَّ جميع الخاصيات width و margin-left و border و padding و margin-right مُعرَّفة)، فستهمل الخاصية margin-left، وسيكون لها نفس قيمة auto.
أمثلة
سنستخدم العنصر <div> في المثال الآتي لتبيان أثر مختلف أنواع القيم للخاصية margin-left:
<div class="parent">
<div class="margin-em">margin-left: 1em;</div>
<div class="margin-px">margin-left: 10px;</div>
<div class="margin-percent">margin-left: 10%;</div>
</div>
شيفرة CSS:
.parent {
border: 1px solid #eaecf0;
background-color: #f8f9fa;
margin: 1em;
}
.parent > div {
padding: 0.25em;
background-color: #069;
color: white;
}
.margin-em { margin-left: 1em; }
.margin-px { margin-left: 10px; }
.margin-percent { margin-left: 10%; }
دعم المتصفحات
| الميزة | Chrome | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| الدعم الأساسي | 1.0 | 1.0 | 3.0 | 3.5 | 1.0 |
البنية العامة
تقبل الخاصية margin-left قيمةً واحدةً يمكن أن تكون طولًا <length> أو نسبةً مئويةً <percentage> أو الكلمة المحجوزة auto، وكل قيمة يمكن أن تكون موجبة أو سالبة أو صفر.
auto
سيكون للهامش الأيسر حصّة من المسافة الأفقية غير المستخدمة التي تُحدَّد بشكل رئيسي من التخطيط المستخدم. ولو كانت الخاصيتين margin-left و margin-right تساوي auto، فستوزّع المسافة المحسوبة بالتساوي. هذا الجدول يوضِّح مختلف الحالات:
| قيمة display | قيمة float | قيمة position | قيمة auto المحسوبة |
|---|---|---|---|
inline أو inline-block أو inline-table
|
أي قيمة | static أو relative
|
0
|
inline أو inline-block أو block أو table أو inline-table أو list-item أو table-caption.
|
أي قيمة | static أو relative
|
0، ما عدا إذا كانت قيمة margin-left و margin-right تساوي auto، ففي هذه الحالة سيتم توسيط العنصر ضمن العنصر الأب.
|
inline أو inline-block أو block أو table أو inline-table أو list-item أو table-caption.
|
left أو right
|
static أو relative
|
0
|
أي قيمة table-* ما عدا table-caption.
|
أي قيمة | أي قيمة | 0
|
أي قيمة ما عدا flex و inline-flex و table-*.
|
أي قيمة | fixed أو absolute
|
0، ما عدا إذا كانت قيمة margin-left و margin-right تساوي auto، ففي هذه الحالة سيتم توسيط العنصر ضمن العنصر الأب.
|
flex و inline-flex.
|
أي قيمة | أي قيمة | 0، ما عدا إذا كانت قيمة margin-left و margin-right تساوي auto، ففي هذه الحالة سيتم توسيط العنصر ضمن العنصر الأب.
|
<length>
تحديد قيمة الهامش بالأطوال المطلقة.
<percentage>
تحديد قيمة الهامش كنسبة مئوية من عرض العنصر الكتلي الحاوي للعنصر الحالي.
البنية الرسمية
margin-left: <length> | <percentage> | auto;
انظر أيضًا
- صفحة
marginوصفحة الخاصيات الفرعية التي تضبطها هذه الخاصية وهي:margin-top، وmargin-bottom، وmargin-right. - صفحة الخاصية
paddingالتي تضبط الحاشية في الأطراف الأربعة للعنصر. - صفحة الخاصية
positionالتي تصف كيف يجب أن يتموضع العنصر في المستند.
مصادر ومواصفات
- مسودة CSS Basic Box Model.
- مسودة CSS Transitions.
- مواصفة CSS Level 2 (Revision 1).
- مواصفة CSS Level 1.