Share via


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

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 IHTMLStyle6::boxSizing settings.

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

The first div object sets IHTMLStyle6::boxSizing to content-box. The added padding and border are drawn outside of the content box. In the second div object, IHTMLStyle6::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