Setting the content background alpha a Spark List control in Flex 4

by Peter deHaan on February 5, 2010

in List (Spark), beta2

In a previous example, “Hiding the border on a Spark List control in Flex 4″, we saw how you could toggle the border visibility on a Spark List control in Flex 4 by setting the Boolean borderVisible style.

The following example shows how you can set the content background alpha on a Spark List control in Flex 4 by setting the contentBackgroundAlpha style to a number between 0.0 and 1.0.

The following example(s) require Flash Player 10 and the Adobe Flex 4 SDK. To download the Adobe Flash Builder 4 beta, check out the Adobe Flash Builder 4 page on the Adobe Labs site. To download the latest build of the Flex 4 SDK, see http://opensource.adobe.com/wiki/display/flexsdk/Download+Flex+4. For instructions on using the beta Flex 4 SDK in Flex Builder 3, see "Using the beta Flex 4 SDK in Flex Builder 3".

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2010/02/05/setting-the-content-background-alpha-a-spark-list-control-in-flex-4/ -->
<s:Application name="Spark_List_contentBackgroundAlpha_test"
        xmlns:fx="http://ns.adobe.com/mxml/2009"
        xmlns:s="library://ns.adobe.com/flex/spark"
        xmlns:mx="library://ns.adobe.com/flex/mx">
 
    <s:Panel title="Spark List test"
            horizontalCenter="0" verticalCenter="0">
        <s:controlBarContent>
            <mx:Form>
                <mx:FormItem label="contentBackgroundAlpha:">
                    <s:HSlider id="sl"
                            minimum="0.0"
                            maximum="1.0"
                            value="1.0"
                            snapInterval="0.1"
                            stepSize="0.1" />
                </mx:FormItem>
            </mx:Form>
        </s:controlBarContent>
 
        <s:Rect width="100%" height="100%">
            <s:fill>
                <s:LinearGradient rotation="45">
                    <s:GradientEntry color="red" />
                    <s:GradientEntry color="yellow" />
                    <s:GradientEntry color="haloBlue" />
                </s:LinearGradient>
            </s:fill>
        </s:Rect>
 
        <s:List id="lst"
                contentBackgroundAlpha="{sl.value}"
                left="20" right="20" top="20" bottom="20">
            <s:layout>
                <s:VerticalLayout requestedRowCount="4"
                        gap="0"
                        horizontalAlign="contentJustify" />
            </s:layout>
            <s:dataProvider>
                <s:ArrayList id="arr" source="[red,orange,yellow,green,blue]" />
            </s:dataProvider>
        </s:List>
    </s:Panel>
 
</s:Application>

View source is enabled in the following example.

You can also set the contentBackgroundAlpha style in an external .CSS file or <Style> block, as seen in the following example:

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2010/02/05/setting-the-content-background-alpha-a-spark-list-control-in-flex-4/ -->
<s:Application name="Spark_List_contentBackgroundAlpha_test"
        xmlns:fx="http://ns.adobe.com/mxml/2009"
        xmlns:s="library://ns.adobe.com/flex/spark"
        xmlns:mx="library://ns.adobe.com/flex/mx">
 
    <fx:Style>
        @namespace s "library://ns.adobe.com/flex/spark";
 
        s|List {
            contentBackgroundAlpha: 0.6; /* 60% */
        }
    </fx:Style>
 
    <s:Panel title="Spark List test"
            horizontalCenter="0" verticalCenter="0">
        <s:Rect width="100%" height="100%">
            <s:fill>
                <s:LinearGradient rotation="45">
                    <s:GradientEntry color="red" />
                    <s:GradientEntry color="yellow" />
                    <s:GradientEntry color="haloBlue" />
                </s:LinearGradient>
            </s:fill>
        </s:Rect>
 
        <s:List id="lst"
                left="20" right="20" top="20" bottom="20">
            <s:layout>
                <s:VerticalLayout requestedRowCount="4"
                        gap="0"
                        horizontalAlign="contentJustify" />
            </s:layout>
            <s:dataProvider>
                <s:ArrayList id="arr" source="[red,orange,yellow,green,blue]" />
            </s:dataProvider>
        </s:List>
    </s:Panel>
 
</s:Application>

Or you can set the contentBackgroundAlpha style using ActionScript, as seen in the following example:

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2010/02/05/setting-the-content-background-alpha-a-spark-list-control-in-flex-4/ -->
<s:Application name="Spark_List_contentBackgroundAlpha_test"
        xmlns:fx="http://ns.adobe.com/mxml/2009"
        xmlns:s="library://ns.adobe.com/flex/spark"
        xmlns:mx="library://ns.adobe.com/flex/mx">
 
    <fx:Script>
        <![CDATA[
            protected function sl_changeHandler(evt:Event):void {
                lst.setStyle("contentBackgroundAlpha", sl.value);
            }
        ]]>
    </fx:Script>
 
    <s:Panel title="Spark List test"
            horizontalCenter="0" verticalCenter="0">
        <s:controlBarContent>
            <mx:Form>
                <mx:FormItem label="contentBackgroundAlpha:">
                    <s:HSlider id="sl"
                            minimum="0.0"
                            maximum="1.0"
                            value="1.0"
                            snapInterval="0.1"
                            stepSize="0.1"
                            change="sl_changeHandler(event);"/>
                </mx:FormItem>
            </mx:Form>
        </s:controlBarContent>
 
        <s:Rect width="100%" height="100%">
            <s:fill>
                <s:LinearGradient rotation="45">
                    <s:GradientEntry color="red" />
                    <s:GradientEntry color="yellow" />
                    <s:GradientEntry color="haloBlue" />
                </s:LinearGradient>
            </s:fill>
        </s:Rect>
 
        <s:List id="lst"
                left="20" right="20" top="20" bottom="20">
            <s:layout>
                <s:VerticalLayout requestedRowCount="4"
                        gap="0"
                        horizontalAlign="contentJustify" />
            </s:layout>
            <s:dataProvider>
                <s:ArrayList id="arr" source="[red,orange,yellow,green,blue]" />
            </s:dataProvider>
        </s:List>
    </s:Panel>
 
</s:Application>

This entry is based on a beta version of the Flex 4 SDK and therefore is very likely to change as development of the Flex SDK continues. The API can (and will) change causing examples to possibly not compile in newer versions of the Flex 4 SDK.

{ 2 comments… read them below or add one }

1 Peter deHaan February 5, 2010 at 7:09 pm

Whee! SWFs!!!

Reply

2 Marc Permanyer February 6, 2010 at 2:38 am

I know it’s more work, but i LOVE IT when you include the swf example!!!!!

Reply

Leave a Comment

Sorry, this blog is terrible at eating HTML comments.
If you're pasting any HTML/XML/MXML code, you need to convert your < characters to &lt; and your > characters to &gt; .

You can use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong> <pre lang="" line="" escaped="">

Anti-Spam Protection by WP-SpamFree

Previous post:

Next post: