Blurs the content of the object so that it appears out of focus.

Syntax

HTML	<ELEMENT STYLE= "filter:progid:DXImageTransform.Microsoft.Blur(sProperties)" ... >	Internet Explorer 5.5 or later
Scripting	object.style.filter = "progid:DXImageTransform.Microsoft.Blur(sProperties)"	Internet Explorer 5.5 or later

Possible Values

sProperties

String that specifies one or more properties exposed by the filter.

Members Table

The following table lists the members exposed by the Blur object.

Attributes/Properties

Show: Attributes/Properties

Attribute Property Description enabled Enabled Sets or retrieves a value that indicates whether the filter is enabled. makeShadow MakeShadow Sets or retrieves the value that indicates whether content is displayed as a shadow. pixelRadius PixelRadius Sets or retrieves the radius of the area of opaque content around a pixel that is affected by the Blur filter. shadowOpacity ShadowOpacity Sets or retrieves the opacity level of a shadow created by the Blur filter.

Remarks

The object that the filter is applied to must have layout before the filter effect displays. You can give the object layout by setting the height or width property, setting the position property to absolute, setting the writingMode property to tb-rl, or setting the contentEditable property to true.

You can assign multiple filters or transitions to an object by declaring each in the filter property of the object. The following div declaration assigns two filters and a Wheel transition to a div element.

<DIV STYLE="width:100%; filter:
    progid:DXImageTransform.Microsoft.MotionBlur(strength=13, direction=310)
    progid:DXImageTransform.Microsoft.Blur(pixelradius=2)
    progid:DXImageTransform.Microsoft.Wheel(duration=3);">
        Blurry text with smudge of gray.</div>     

When multiple filters are applied to an object, each filter is processed in source order, with the exception of procedural surfaces, which are computed first. To emphasize a filter's effect, place it last in source order or on the object's parent. Always place transitions last in source order.

Examples

The following example shows how to change the effects of this filter by modifying its properties.

This feature requires Microsoft Internet Explorer 5.5 or later. Click the following icon to install the latest version. Then reload this page to view the sample.

This example uses the Enabled property to switch the content of the DIV element from normal to blurred and back.

<SCRIPT LANGUAGE="JScript">

<!-- Switch the enabled property to blur the image.  -->
function fnToggle(oObj) {
    if (oDiv.filters(0).enabled){
        oDiv.filters(0).enabled='false';
        oObj.innerText='Make Blurry';}
    else {                                                        
        oDiv.filters(0).enabled='true';
        oObj.innerText='Make Normal';}
}
</SCRIPT>
 
    <DIV ID="oDiv" STYLE="position:absolute; left:270px; filter: 
            progid:DXImageTransform.Microsoft.blur(pixelradius=3, enabled='false')" >
        An image - >    
        <IMG SRC='/workshop/graphics/earglobe.gif' />
    </DIV>
<BUTTON onclick="fnToggle(this)"> Make Blurry</BUTTON><BR/>

This feature requires Microsoft Internet Explorer 5.5 or later. Click the following icon to install the latest version. Then reload this page to view the sample.

Applies To

A, ABBR, ACRONYM, ADDRESS, B, BDO, BIG, BLOCKQUOTE, BODY, BUTTON, CAPTION, CENTER, CITE, CODE, CUSTOM, DD, DEL, DFN, DIR, DIV, DL, DT, EM, FIELDSET, FONT, FORM, FRAME, hn, IFRAME, FRAMESET, I, INS, IMG, INPUT type=button, INPUT type=checkbox, INPUT type=file, INPUT type=image, INPUT type=password, INPUT type=radio, INPUT type=reset, INPUT type=submit, INPUT type=text, KBD, LABEL, LEGEND, LI, MARQUEE, MENU, NOBR, OL, OBJECT, P, PLAINTEXT, PRE, Q, RT, RUBY, S, SAMP, SMALL, SPAN, STRIKE, STRONG, SUB, SUP, TABLE, TEXTAREA, TH, TD, TT, U, UL, VAR, XMP

See Also

Scripting Filters, Filter Design Considerations