Gradient Filter

Displays a color gradient between the object's background and content.

Syntax

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

Possible Values

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

Members Table

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

Attributes/Properties
AttributePropertyDescription
enabledEnabled Sets or retrieves a value that indicates whether the filter is enabled.
EndColor Sets or retrieves the final opaque color for a gradient surface.
EndColorStr Sets or retrieves the final color for a gradient surface.
GradientType Sets or retrieves the orientation of the gradient.
StartColor Sets or retrieves the initial opaque color for a gradient surface.
startColorStrStartColorStr Sets or retrieves the initial color for a gradient surface.

Remarks

When revealed by a transition, any text that covers a Gradient procedural surface is initially exposed as transparent. After the transition has finished, the text is updated to the applicable color.

The object that the filter is applied to must have layout before the filter effect will display. 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 the effects of this filter when its properties are modified.

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 shows how the text is unaffected by the gradient behind it.


<SCRIPT>

<!-- Toggle the Enabled property to toggle the gradient.  -->
function fnToggle(oObj) {
    if (oDiv.filters(0).enabled){
        oDiv.filters(0).enabled='false';
        oObj.innerText='Add Gradient';}
    else {                                                        
        oDiv.filters(0).enabled='true';
        oObj.innerText='Make Normal';}
}
</SCRIPT>

<font size="+5">
    <DIV ID="oDiv" STYLE="height:120px; color:green; filter: 
            progid:DXImageTransform.Microsoft.gradient(enabled='false',
                startColorstr=#550000FF, endColorstr=#55FFFF00)" >
        A simple gradient   
    </DIV>
</font>
<P>
<BUTTON onclick="fnToggle(this)">Add Gradient</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

Tags :


Community Content

Stanley Roark
Gradient filter rendering bug on IE6 with SELECT controls

Is this a known bug?: I added a Gradient filter to the Body style of my web page. This displays fine on IE7 but on IE6 it screws up the page rendering when I scroll. Redrawing of the SELECT controls on the page seems to be the problem.

From the CSS:

.body-style {
background-color: #92CBE0;
filter:progid:DXImageTransform.Microsoft.Gradient
(GradientType=0,StartColorStr='#92CBE0',EndColorStr='#6B9EBC');
}


Stanley Roark
gradient filters on firefox

I am creating a website with a friend and we use the gradient code in the website. It works well however when we get our new computer system up and running we will be using FireFox instead of IE and the gradient code doesn't work in that, so is there a way we can do it with out making it upload an image every time?
sam bennett

Noelle Mallory - MSFT] Please post questions to the MSDN Forums at http://forums.microsoft.com/msdn. You will likely get a quicker response through the forum than through the Community Content.


ejasoft
it's not working for me

i tried to use it in my site

look in the backgorund

it's not working

<a href="http://gamezat.dr3.net">العاب</a>

http://gamezat.dr3.net


mabanza
Gradient filter brokes fonts!
Gradient filter brokes fonts

Tags :

mabanza
Gradient spoils the font appearance
Hi there
Gradient filter spoils fonts if the gradient is applied. Sympthoms: font Verdana turns into something urgly with juggy edges if I apply the gradient. Everithing is Ok if font size greater then ~13 pt. Bug?
And you guys displays here the only example where font size is huge. I believe, for the reason not to display this issue. Am I right?
Anyway, how to cope with it?
Thanks.
Tags : gradient

koblejer
Doesn't Include IE8
This will cause other styles to not work in IE8!

Tags :

Dan Hines
Re: Gradient Font Problems

FYI, I have had luck getting my fonts to work by adding an invisible drop shadow:

filter: PROGID:DXImageTransform.Microsoft.Gradient(GradientType=0, StartColorStr='white', EndColorStr='steelblue') PROGID:DXImageTransform.Microsoft.DropShadow(Color='white', OffX=0, OffY=0);

Tags : gradient

Page view tracker