boxSizing property

Specifies the box model to use for object sizing.

 

Syntax

HRESULT value = object.put_boxSizing( v);HRESULT value = object.get_boxSizing(* p);

Property values

Type: BSTR

content-box (content-box)

Default. The specified IHTMLCurrentStyle::width and IHTMLRuleStyle::height apply to the width and height respectively of the content box of the element. The IHTMLRuleStyle::padding and IHTMLRuleStyle::border of the element are drawn outside this area.

border-box (border-box)

The specified IHTMLCurrentStyle::width and IHTMLRuleStyle::height determine the border box of the element. Any IHTMLRuleStyle::padding or IHTMLRuleStyle::border specified on the element is drawn inside the remaining area. The content box is computed by subtracting the IHTMLRuleStyle::padding or IHTMLRuleStyle::border widths of the respective sides from the specified width and height.

This is the default behavior of IHTMLCurrentStyle::width and IHTMLRuleStyle::height in IE5 mode for replaced elements and input elements, such as buttons.

String format

content-box | border-box

CSS information

Applies To	All elements
Media	visual
Inherited	no
Initial Value	content-box

Standards information

• CSS3 Basic User Interface Module, Section 7.1

Remarks

This property requires Windows Internet Explorer to be in IE8 Standards mode rendering.

The illustration below demonstrates the content-box value and how the IHTMLRuleStyle::padding and IHTMLRuleStyle::border are drawn outside of the width of the content box.

The illustration below demonstrates the border-box value and how the IHTMLRuleStyle::padding and IHTMLRuleStyle::border are included in the content box.

As of Internet Explorer for Windows Phone 8.1 Update, Internet Explorer for Windows Phone supports "-webkit-box-sizing" as an alias for this property.

Examples

The following example shows two div objects with different IHTMLRuleStyle6::boxSizing settings.

<div id="contentBox">box-sizing: content-box;</div>
<div id="borderBox">box-sizing: border-box;</div>

The first div object sets IHTMLRuleStyle6::boxSizing to content-box. The added padding and border are drawn outside of the content box. In the second div object, IHTMLRuleStyle6::boxSizing is set to border-box. The added padding and border are included in the calculation of the content box.

#contentBox {
   width: 200px;
   border: 5px solid #000080;
   box-sizing: content-box;
   padding: 15px;
}       
#borderBox {
   width: 200px;
   border: 5px solid #000080;
   box-sizing: border-box;
   padding: 15px;
}

The following image shows the result. The second div object has a shorter width than the first div object:

Requirements

Minimum supported client	Windows XP with SP2
Minimum supported server	Windows Server 2003
Header	Mshtml.h
IDL	Mshtml.idl
DLL	Mshtml.dll