الخاصية `border-width`

الخاصية border-width المختصرة في CSS تضبط عرض إطار العنصر على جميع وجوهه: العلوي (border-top-width) والأيمن (border-right-width) والسفلي (border-bottom-width) والأيسر (border-left-width).

/* كلمات مفتاحية */
border-width: thin;
border-width: medium;
border-width: thick;

/* <length> أطوال */
border-width: 4px;
border-width: 1.2rem;

/* vertical | horizontal */
border-width: 2px 1.5em;

/* top | horizontal | bottom */
border-width: 1px 2em 1.5cm;

/* top | right | bottom | left */
border-width: 1px 2em 0 4rem;

/* قيم عامة */
border-width: inherit;
border-width: initial;
border-width: unset;

بطاقة الخاصية

القيمة الابتدائية	لكل قيمة مختصرة: `border-top-width`: `medium` `border-right-width`: `medium` `border-bottom-width`: `medium` `border-left-width`: `medium`
تُطبَّق على	جميع العناصر.
قابلة للوراثة	لا
القيمة المحسوبة	لكل قيمة مختصرة: `border-bottom-width`: طول `<length>`. `border-left-width`: طول `<length>`. `border-right-width`: طول `<length>`. `border-top-width`: طول `<length>`.

أمثلة

سنعرض في هذا المثال كيفية استخدام الخاصية border-width لتعيين عرض الإطار بتحديد قيمة واحدة أو قيمتين أو ثلاث قيم أو أربع قيم، وذلك على عناصر <p>. شيفرة HTML:

<p id="sval">
    one value: 6px wide border on all 4 sides</p>
<p id="bival">
    two different values: 2px wide top and bottom border, 10px wide right and left border</p>
<p id="treval">
    three different values: 0.3em top, 9px bottom, and zero width right and left</p>
<p id="fourval">
    four different values: "thin" top, "medium" right, "thick" bottom, and 1em right</p>

شيفرة CSS:

#sval {
  border: dashed #ccc;
  border-width: 6px;
}
#bival {
  border: solid salmon;
  border-width: 2px 10px;
}
#treval {
  border: dotted orange;
  border-width: 0.3em 0 9px;
}
#fourval {
  border: solid lightgreen;
  border-width: thin medium thick 1em;
}
p {
  width: auto;
  margin: 1em;
  padding: 1em;
}

دعم المتصفحات

الميزة	Chrome	Firefox	Internet Explorer	Opera	Safari
الدعم الأساسي	1.0	1.0	4.0	3.5	1.0

البنية العامة

يمكن تحديد قيمة واحدة للخاصية border-width أو قيمتين أو ثلاث قيم أو أربع قيم.

عند تحديد قيمة واحدة، فستُطبّق على جميع أوجه الإطار.
عند تحديد قيمتين، فأوّل قيمة ستُطبّق على الإطارين العلوي والسفلي، والقيمة الثانية على الإطارين الأيمن والأيسر.
عند تحديد ثلاث قيم، فأوّل قيمة ستُطبّق على الإطار العلوي، والقيمة الثانية على الإطارين الأيمن والأيسر، والقيمة الثالثة على الإطار السفلي.
عند تحديد أربع قيم، فستُطبّق القيم على الوجه العلوي ثم الأيمن ثم السفلي ثم الأيسر على التوالي وبالترتيب (أي أنَّ الدوران يبدأ من الوجه العلوي ثم يستمر وفق اتجاه عقارب الساعة).

`<br-width>`

تُعرِّف هذه القيمة عرض الإطار، وإما أن تكون طولًا <length> غير سالب، أو كلمةً محجوزةً؛ ويُسمَح باستخدام الكلمات المحجوزة الآتية:

`thin`		إطار رفيع
`medium`		إطار متوسط
`thick`		إطار ثخين

ملاحظة: لأنَّ المواصفة لا تُحدِّد ما هي القيمة الدقيقة المرتبطة بكل كلمة محجوزة، فقد تختلف النتيجة باختلاف المتصفح، لكن مع ذلك، ستتبع هذه القيم للعلاقة thin ≤ medium ≤ thick، وستكون القيم متناسقة فيما بينها في المستند.

البنية الرسمية

border-width: <br-width>{1,4};

حيث:

<br-width> = <length> | thin | medium | thick

انظر أيضًا

صفحة الخاصية المختصرة border
صفحة الخاصيات الأخرى التي تضبطها الخاصية المختصرة border وهي: border-style، و border-color.
صفحة الخاصيات التي تضبط أجزاءً من الإطار: الإطار العلوي border-top، والإطاري السفلي border-bottom، والإطار اليميني border-right، والإطار اليساري border-left.
ضبط صورة للإطار باستخدام الخاصية border-image.
الأركان المدورة border-radius.

مصادر ومواصفات

مواصفة CSS Backgrounds and Borders Module Level 3.
مواصفة ‎CSS Level 2 (Revision 1)‎.
مواصفة CSS Level 1.