Export (0) Print
Expand All
Expand Minimize

marginLeft property

Sets or retrieves the width of the left margin of the object.

CSS 2.1, Section 5.5.4Internet Explorer 9


Integer value = object.put_marginLeft(Variant v);Integer value = object.get_marginLeft(Variant* sWidth);

Property values


auto (auto)

Default. Left margin is set equal to the right margin.

percentage (percentage)

Integer, followed by a percent sign (%). The value is a percentage of the width of the parent object.

String format

<margin-width> | inherit

CSS information

Applies ToAll elements
Initial Value0

Standards information


You can specify possible length values relative to the height of the element's font (em) or the height of the letter "x" (ex).

In Microsoft Internet Explorer 3.0, the specified margin value is added to the default value of the object. In Microsoft Internet Explorer 4.0 and later, the margin value is absolute. The margin properties do not work with the td and tr objects in Internet Explorer 4.0, but they do work in Internet Explorer 3.0. To set margins in the cell for Internet Explorer 4.0 and later, apply the margin to an object, such as div or p, within the td.

This property applies to inline elements, starting with Microsoft Internet Explorer 5.5. With earlier versions of Windows Internet Explorer, inline elements must have an absolute IHTMLCSSStyleDeclaration::position or layout to use this property. Element layout is set by providing a value for the IHTMLCSSStyleDeclaration::height property or the IHTMLCSSStyleDeclaration::width property.

Negative margins are supported, except for top and bottom margins on inline objects.


The following example shows three div elements with specified IHTMLCSSStyleDeclaration::height, IHTMLCSSStyleDeclaration::width, and IHTMLCSSStyleDeclaration::backgroundColor values. The second div element also specifies a IHTMLCSSStyleDeclaration::marginLeft setting of 10px.

<div id="blue"></div>
<div id="yellow"></div>
<div id="green"></div>

#blue {
   background-color: #00A4EF;
   height: 50px;
   width: 50px;
#yellow {
   background-color: #FFB900;
   height: 50px;
   width: 50px;
   margin-left: 10px;
#green {
   background-color: #7FBA00;
   height: 50px;
   width: 50px;

The following image shows the result. The second div element has 10 pixels of padding on the left margin.

Three squares with margin-left applied to the center square

This example uses inline scripting to set the left margin of the image to 1 centimeter when an HTMLFrameSiteEvents::onclick event occurs.

Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/marginLeft.htm

<img src="sphere.jpg" onclick="this.style.marginLeft='1cm'">


Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]







See also

CSS Values and Units Reference
Other Resources
CSS Enhancements in Internet Explorer 6



Community Additions

© 2014 Microsoft