highest safe dose of levitralevitra takecompare levitra cialis viagrageneric levitra onlinecheap herbal vardenafillevitra online uklevitra increases sperm countwomen\s vardenafillevitra samplelevitra slide kitmail order levitralevitra prescription onlinesoft levitraPurchase Levitra pillthe buy levitrageneric levitra canadaproduct team levitravardenafil 90 pills Buylevitra sale 32free sample prescription for levitralevitra trial offermedication levitranon prescription vardenafillevitra online shop in uklevitra medicareinformation levitralevitra on line saleslevitra japanqry vardenafilSale vardenafil 20 pillscheap herbal levitraidentify vardenafillevitra alternative lavitraflomax levitraGeneric Levitra 20 mg Salelevitra couponus vardenafilbuy levitra 10mglevitra commercial modelsforum levitraOnline vardenafil Courier shipping10 mg vs 20 mg levitralevitra dosage directionstoo much levitrawhere to puchase vardenafil onlinecheap levitra on linecialis levitra vardenafilhow levitra workqueen levitravardenafil 180 pills orderlevitra beogradlevitra birth control pillslevitra orallow cost alternatives and vardenafilLevitra 120 pills BuyBuy vardenafil Free Airmail shippingordering levitra onlinecialis levitra viagra comparebuy vardenafil online australiaorder levitra cheap pricevardenafil saleanyone tried generic levitravardenafil softabsbuy levitra viagra onlinelevitra user reviewneed for increasing amounts of levitralevitra online purchasewhat is vardenafilvardenafil rrp australia costvardenafil fast shippingvardenafil no prescriptionlevitra online gamblingviva levitrawomen taking levitradiscount vardenafil onlinelevitra sampleslowest price levitra generic onlinelevitra penslevitra and flomaxpurchase levitra 60 pillslevitra side effectorder Levitra 10 mgalternative to levitraby levitra priceBuy vardenafil Courier shippinguk alternative vardenafillevitra sarasota floridaprice on levitralevitra or viagra which is betterlevitra from canadalevitra ad reviewtry levitra for freeacheter du levitrawholesale vardenafillevitra where to buycomparison levitra cialistoo much vardenafilcomparison of levitra and viagradosage for levitrageneric mexican levitrahow to buy levitragenuine vardenafilcialis levitra viagra which is bettervardenafil onlinerelative costs of cialis levitraget vardenafil drug onlinelevitra vs viagra vs cialisorder levitra 30 pillssample of vardenafildiscount cialis levitra online canadanatural equivelant ingredient in levitraorder levitravardenafil 20 pills onlinecialis vardenafilreviews of viagra cialis and levitraeuropean vardenafilcanada in levitraPurchase Generic vardenafil 20 mglevitra 100mglevitra propafenoneinfo levitrauk levitra saleswoman\s levitraOnline Levitra 120 pillspurchase vardenafil 10 mggeneric levitra tab 20mgvardenafil australiacompare viagra to levitravardenafil 6 free samplesvardenafil canadian drugslevitra generikaOnline Levitra 20 mgwhat does vardenafil dovardenafil uterine thicknesslevitra hourslevitra cost of salesGeneric Levitra 10 mg ordervardenafil lengthvardenafil sideviagra cyalis levitra comparedlevitra pictureslevitra for salevardenafil online cheapLevitra 20 pills BuyLevitra Free Airmail shipping onlinebuy levitra online atgeneric levitra manufacturermaximum dosage levitravardenafil Courier shipping SaleSale vardenafil 10 pillswhat is better levitra or viagradifference between cialis levitra viagralevitracialis compare levitramedical drug levitravardenafil patent levitraprice levitralevitra tablevardenafil vs cialisvardenafil 180 pills Buyeffects of levitraget levitra drug onlinedreampharmaceuticals from levitranew erectile drug vardenafilover the counter levitrabuy levitra australiangeneric vardenafil indiacialis dysfunction erectile levitralevitra side effects visiondiscount levitra pillsOnline vardenafil Free Insurancecanadian pharmacy levitralevitra low costlevitra reviewsPurchase Generic Levitranew erectile drug levitravardenafil usevardenafil pricinglevitra herb alternativeOrder Generic vardenafil 20 mgvardenafil max complaintsfree vardenafil sampleslevitra or viagraSale Levitra 10 mglevitra lowest pricecheap vardenafil siproblems with levitralevitra suppliers in the ukwatermelon levitralevitra to buy new zealandmedicine levitralevitra 10 mg tabletbuy levitra online dream pharmaceuticalsoft levitra mastercardlevitra ingredientsvardenafil perscription onlinegeneric levitra cheapcanadian vardenafillevitra and price listvardenafil hcl 20 mgbayer levitra onlinefree trial of vardenafilbuy levitra delived fed exrecreational levitra usekey buy levitra onlinelevitrabuy cheap levitra onlineGeneric vardenafil 10 mg onlineorder cheap levitra faslevitra by bayervardenafil 30 pills onlineship free vardenafil sampleregalis vardenafilbuy levitra usvardenafil super activeLevitra 180 pills Buydrug levitra newvardenafil purchasevardenafil 30 pills orderprofessional levitra627 discount levitra online 903levitra and premature ejaculationpfizer vardenafilcialis levitra or viagralevitra twice a daysnorting levitraorder 50mg levitrabuy Levitra 10mgLevitra pills Buybuy cheap levitra onlinelevitra vs cialis reviewbrand name levitratake levitralevitra pill pricevardenafil optionslevitra cialis for womenhow to get levitravardenafil alternativespharmacy vardenafilbuy levitra ukvardenafil hcl 20mg tab side effectsbuy levitra in ukgeneric levitra professionallevitra efectosgeneric levitra effectiveorder vardenafil 10 mg2buy levitra online viagralevitra worksflomax and levitraSale Levitra Airmail shippingclinical data levitrageneric levitra soft tab fasti have levitrarx levitravardenafil 120 pillsbuy vardenafil meds onlinevardenafil online no prescriptionis vardenafil professional realcheap vardenafil walmartuk levitrabuy levitra in canadavardenafil from indiafree sample pack of levitramature vardenafilhow long is levitra effectivelevitra price comparisonlevitra storyvardenafil effekter biverkningarvardenafil for teenscheapest levitra in ukfda on levitralevitra fedexgeneric vardenafil mexicosample levitralevitra best resultslevitra substitutelevitra generic soft tabsafe maximum levitra dosagelevitra online cheapLevitra pills onlinevardenafil free sampleslevitra dysfunction erectilelevitra rxlevitra from mexicovardenafil drug prescriptionvardenafil discountsOrder vardenafil Free Insurancelevitra precautionsbuy buy cheap cheap levitra levitralevitra v s levitravardenafil sex dominationlevitra success storieslevitra for womanvardenafil 20 mg paypallevitra sverigecheap levitra overnightOrder Levitra Airmail shippingbuy vardenafil 10 pillscounterfeit levitrabuy levitra 30 pillsvardenafil suppliers in the ukvardenafil effective timeLevitra Courier shipping orderorder levitra from canadabuy drug satellite tv levitralevitra 20order vardenafillevitra wholesale onlinelevitra fast overnight delivery usa onlyuser review levitracialis and levitra generic brandgeneric levitralevitracialis generic levitra viagralevitra online usdoes levitra look likebuy levitra lowest pricescompare viagra levitralevitra on linesample of levitraviagra cialis levitra candian pharmacy safecheap vardenafil nzprice of vardenafilbuy online vardenafilnatural levitrageneric levitra pillsnatural equivalent ingredient in vardenafilordering vardenafillevitra free pillsbuy vardenafil in uklevitra order2buy generic levitralevitra pay with paypalvardenafil in uk onlineglaxo levitravardenafil and commercialvardenafil 50 mglevitra with lisinoprilwhat does levitra dobuy levitra medicationlevitra couchcan a woman take levitravardenafil 10mgreal levitralevitra offervardenafil 10 pills Buylowest prices for levitracanada vardenafilfree levitra pillscheapest online cost for levitravardenafil generic pricevardenafil gelvardenafil mexicovardenafil ukon levitralevitra discussiongeneric name of levitrabuy vardenafil 30 pillslevitra price walmartlevitra time effectiveLevitra Free Airmail shipping Salevardenafil wholesale onlinelevitra andacheter levitra francecheap vardenafil 20 mgwoman in levitra commercialpill identification levitrageneric discount levitralevitra 20 mg dosagelevitra interactionsoriginal levitrapurchase vardenafil 10mgbuy levitra online in 24 hoursvardenafil for sale without a prescriptionlevitrabuy levitra onlineLevitra 10 mg onlineviagra medication prescription levitra cialis propecialevitra anwendungviagra cialis levitra vpxlcan woman take levitrabuy levitra upsLevitra 90 pills BuySale vardenafil pillovernight vardenafilvardenafil reviewslevitra drugswatermellon vardenafilbuy levitra without prescriptionquery lowest levitra price onlinebuying levitra onlinelevitra generic priceusing levitralevitra for freegeneric viagra levitra generic cialis pillsvardenafil testimonialGeneric Levitra 20 mg ordervardenafil on linevardenafil Free Airmail shipping onlinehow long will levitra lastq buy levitraorder discount levitraviagra levitra cialis offerslevitra and bayercheap pharmacy viagra cialis levitralevitra vs viagra reviewswomans levitraburing levitra onlinelevitra softbuy cheap levitralevitra drug prescriptionbuy levitra in englandvardenafil Salevardenafil for daily useactress in levitra commercialbuy levitra with pay palcheap vardenafil overnightindia vardenafilvardenafil pill orderbuy levitra online 35008 buylevitra pill cuttervardenafil sizevardenafil uk cost pillvardenafil 60 pills onlinegeneric soft tabs vardenafilkey buy levitra cheaplevitra cheap buy onlinelow price vardenafilcheap vardenafil tabletslevitra onlinevardenafil 20 mg orderblindness cialis levitravardenafil levitra onlinelevitra faqsplitting levitravardenafil in ukvardenafil lowest priceprozac interactions with viagra cialis levitrakeywords cialis levitra sales viagrahow quick does levitra workwhat is levitra productPurchase vardenafil Free Airmail shippingLevitra 20 mgcomparison of cialis levitra and viagraovernight shipping of professional vardenafilbenefits of levitralevitra vs viagra which is better2buy cheap levitra onlinelevitra prices american pharmaciesvardenafil online overnightdiscount levitra cialis viagrabuy cheap levitra xanax xenicalorder levitra onlinecheapest vardenafil substitute vardenafilbuy vardenafil cialasbuy cheap generic levitra pharmacy onlinelevitra soft tablevitra third quarter 2004 saleslevitra bestellenvardenafil fedexviva levitra commercialLevitra Courier shipping Salecheapest vardenafil professionalLevitra 10 pills Buycheap vardenafil canadaOnline Levitra Free Airmail shippingfull information levitradiscounted vardenafillevitra substitutesLevitra 20 mg Buylevitra 20 mg bayerbuy vardenafil delived fed exforeign cialis levitra pillswomen vardenafilvardenafil overnight shippingcan women use levitravardenafil Buyvardenafil propafenonelevitra provardenafil impotence drug eli lilly cobuy levitra viagralevitra web siteship free levitra sampleorder levitra without prescriptionfree levitra onlinesuper levitralevitra in ukcompare viagra 26 levitra2cheap levitra onlineOrder vardenafilvardenafil Courier shipping orderbuy vardenafilvardenafil storieslevitra successdiscount levitra purchasecheapest levitra substitute sildenafillevitra cialis viagra comparebuy vardenafil online in ukLevitra 20 mg onlineordering levitraconnecticut levitra vardenafillevitra productsLevitra Free Airmail shipping BuyGeneric vardenafil 10 mg Sale
intense creativity » Tutorial - Creating Custom Flex Components - Skins & CSS Styles

Tutorial - Creating Custom Flex Components - Skins & CSS Styles

Hi Everyone,

over the span of the next 6 weeks I will be creating 2 custom flex components for Verizon Wireless' MediaStore. One will be a data grid which is meant to be faster and custom fitted to their needs, and another one is to display search results.

Right now, I am at the exploration stage of building things from the ground up. These components need to be skinnable, meaning I need to offer css styling that I will use to draw the respective component's UI. My first challenge was to enable the use of either graphic elements from a .swf or a programmatic skin. In other words, to permit something like this:

CSS:
  1. ContentGrid
  2. {
  3.     headerTopLine         : #EDEDED;
  4.     headerSeparatorAlpha  : 0.20;
  5.     arrowGradient         : #424242, #5b5b5b;
  6.    
  7.     sortArrowSkin         : ClassReference("com.ml.styles.view.skins.GridHeaderSortArrowSkin");
  8.  
  9.     icon                  : Embed(source="../resources/styles/assets/symbols.swf", symbol="scrollableArrowMenuUpIcon");
  10. }

For the first three styles, you can easily get the values using the getStyle() function of the UIComponent (or any derived class). For example, the first three values:

Actionscript:
  1. // this will convert the hex color value to a uint, to be used directly with the drawing API
  2. var topLineColor:uint = getStyle("headerTopLine");
  3.  
  4. // this will give you the numeric value, just as set in the css
  5. var seperatorAlpha:int = getStyle("headerSeperatorAlpha");
  6.  
  7. // this will give you two colors in an array, the second command converts them
  8. var colors:Array = getStyle("arrowGradient");
  9. StyleManager.getColorNames(colors);

Don't ask me why they called it getColorNames cause that doesn't make sense to me! Maybe it has another reason of being..

Now for the tricky part: to get Class references (skins) and use them, and to get embedded assets from inside a .swf file. The important detail to remember is that for example this line

CSS:
  1. headerBgSkin : ClassReference("com.ml.skins.ContentGridHeaderBgSkin");

could also be a reference to an asset inside a swf like so

CSS:
  1. headerBgSkin : Embed(source="../resources/styles/assets/symbols.swf", symbol="contentGridHeaderBg");

Therefore, when handling this element, you need to think of these two possibilities.

Handling a style that can either be a ProgrammaticSkin or Graphical Asset

First, here is the code for the Programmatic skin

Actionscript:
  1. package com.ml.skins
  2. {
  3.     import mx.skins.ProgrammaticSkin;
  4.  
  5.     public class ContentGridHeaderBgSkin extends ProgrammaticSkin
  6.     {
  7.         public function ContentGridHeaderBgSkin()
  8.         {
  9.             super();
  10.         }
  11.        
  12.         override protected function updateDisplayList(w:Number, h:Number):void
  13.         {
  14.             var g:Graphics = graphics;
  15.             g.clear();
  16.        
  17.             var colors:Array = getStyle("headerBgGradient");
  18.             StyleManager.getColorNames(colors);
  19.            
  20.             var matrix:Matrix = new Matrix();
  21.             matrix.createGradientBox(w, h + 1, Math.PI/2, 0, 0);
  22.            
  23.             colors = [ colors[0], colors[1] ];
  24.             var ratios:Array = [ 0, 255 ];
  25.             var alphas:Array = [ 1.0, 1.0 ];
  26.            
  27.            
  28.             g.beginGradientFill(GradientType.LINEAR, colors, alphas, ratios, matrix);
  29.             g.lineStyle(0, 0x000000, 0);
  30.             g.drawRect(0,0,w,h);
  31.             g.endFill();
  32.            
  33.             g.lineStyle(1, getStyle("headerTopLine"), 1);
  34.             g.moveTo(0,0);
  35.             g.lineTo(w, 0);
  36.            
  37.             g.lineStyle(1, getStyle("headerBottomLine"), 1);
  38.             g.moveTo(0, h - 0.5);
  39.             g.lineTo(w, h - 0.5);         
  40.         }   
  41.     }
  42. }

As you might have noticed, I use styles to decide on colors used to draw the skin. This is an important detail, we'll get back to that shortly.

This skin is used to draw the background of the header of the custom DataGrid. It is, therefore, a graphical asset. I have decided to create this skin in the createChildren function of the DataGrid like so

Actionscript:
  1. public class ContentGrid extends ScrollControlBase
  2.     {
  3.         protected var _headerBgSkin:DisplayObject;
  4.  
  5. // ....
  6.  
  7.         override protected function createChildren():void
  8.         {
  9.             super.createChildren();
  10.            
  11.             // get the reference to the style defined in the CSS
  12.             var headerSkin:Object = getStyle("headerBgSkin");
  13.            
  14.             // if the style is a Sprite (therefore a symbol in a .swf)
  15.             if(headerSkin is DisplayObject)
  16.             {
  17.                 // nothing fancy here, just use it straight
  18.                 _headerBgSkin = headerSkin;
  19.  
  20.                 // if it is a sprite, make sure it doesn't react to mouse events
  21.                 if(_headerBgSkin is Sprite)
  22.                     (headerSkin as Sprite).mouseEnabled = false;
  23.                        
  24.             }
  25.             // however if it is a class reference
  26.             else if(headerSkin is Class)
  27.             {
  28.                 // instantiate it, assuming it is derived from ProgrammaticSkin
  29.                 _headerBgSkin = new headerSkin();            
  30.             }
  31.        
  32.             // finally, add it to the displayList   
  33.             addChild(_headerBgSkin);
  34.         }
  35.     }

As you can see from the code above, both situations are handled. Now in the updateDisplayList method of our custom component, just in case the developer decided to use a programmatic skin, we want to ensure this skin has access to styles he might want to define inside of the same CSS Class. We do it like so

Actionscript:
  1. override protected function updateDisplayList(w:Number, h:Number):void
  2.         {
  3.             super.updateDisplayList(w, h);
  4.            
  5.             // if the _headerBgSkin implements the basic style client properties & functions, set his style appropriately
  6.             if(_headerBgSkin is ISimpleStyleClient)
  7.                 ISimpleStyleClient(_headerBgSkin).styleName = this;   
  8.  
  9.             _headerBgSkin.width = width;
  10.             _headerBgSkin.height = 32;
  11.         }

This ensures that these lines from the programmatic skin will work properly:

Actionscript:
  1. var colors:Array = getStyle("headerBgGradient");
  2. StyleManager.getColorNames(colors);
  3.  
  4. // ...
  5.  
  6. g.lineStyle(1, getStyle("headerTopLine"), 1);
  7.  
  8. // and so on

At this point I am thinking of hardcoding defaults inside of the skin, just in case...

Handling Style Changes

In UIComponent derived classes there is a nice function you can derive which has the following signature:

Actionscript:
  1. override public function styleChanged(styleProp:String):void

This function gets called when a style has changed, or all styles have changed. I found the following implementation in ScrollControlBase

Actionscript:
  1. override public function styleChanged(styleProp:String):void
  2.     {
  3.         var allStyles:Boolean = (styleProp == null || styleProp == "styleName");
  4.  
  5.         super.styleChanged(styleProp);
  6.  
  7.         // ....
  8.  
  9.     // Replace the borderSkin
  10.     if (allStyles || styleProp == "borderSkin")
  11.     {
  12.        if (border)
  13.        {
  14.           removeChild(DisplayObject(border));
  15.           border = null;
  16.           createBorder();
  17.        }
  18.     }
  19.     }

As you can see from the code above, there is a need to remove the previously created graphic object (border in this case) before re-creating it. I have implemented something similar for my _headerBg (has been shortened to _headerBg from _headerBgSkin by now!). You can see the changes below: for one I put all the code needed to create the _headerBg in a function that I could call from different places, then I added the styleChanged function. A few other modifications have been made, be very attentive! Here it is:

Actionscript:
  1. package com.ml.contentgrid
  2. {
  3.     import flash.display.DisplayObject;
  4.     import flash.display.Sprite;
  5.    
  6.     import mx.collections.ArrayCollection;
  7.     import mx.core.ScrollControlBase;
  8.     import mx.styles.ISimpleStyleClient;
  9.  
  10.     public class ContentGrid extends ScrollControlBase
  11.     {
  12.         // {...}       
  13.         protected var _headerBg:DisplayObject;
  14.  
  15.         // {...}
  16.        
  17.         override protected function createChildren():void
  18.         {
  19.             super.createChildren();
  20.            
  21.             createHeaderBg();
  22.                        
  23.             _header = new ContentGridHeader();
  24.             addChild(_header);
  25.         }
  26.        
  27.         protected function createHeaderBg():void
  28.         {
  29.             var idx:Number = numChildren;
  30.  
  31.             // first remove existing graphical object... (if it exists)   
  32.             if(_headerBg != null)
  33.             {
  34.                 idx = getChildIndex(_headerBg);
  35.                 removeChild(_headerBg);
  36.                 _headerBg = null;                                    
  37.             }
  38.  
  39.             // create new skin
  40.             var headerSkin:Object = getStyle("headerBgSkin");
  41.            
  42.             if(headerSkin is DisplayObject)
  43.             {
  44.                 _headerBg = headerSkin;
  45.  
  46.                 if(headerSkin is Sprite)
  47.                     (headerSkin as Sprite).mouseEnabled = false;
  48.             }
  49.             else if(headerSkin is Class)
  50.             {
  51.                 _headerBg = new headerSkin();            
  52.             }
  53.            
  54.             addChildAt(_headerBg, idx);
  55.         }
  56.  
  57.         // {...}
  58.        
  59.         override protected function updateDisplayList(w:Number, h:Number):void
  60.         {
  61.             super.updateDisplayList(w, h);     
  62.  
  63.             _headerBg.width = width;
  64.             _headerBg.height = calculateHeaderHeight();
  65.         }   
  66.        
  67.         override public function styleChanged(styleProp:String):void
  68.         {
  69.             var allStyles:Boolean = (styleProp == null || styleProp == "styleName");
  70.             super.styleChanged(styleProp);
  71.            
  72.             if(allStyles || styleProp == "headerBgSkin")
  73.             {
  74.                 createHeaderBg();
  75.             }
  76.  
  77.             if(_headerBg is ISimpleStyleClient)
  78.                 ISimpleStyleClient(_headerBg).styleName = this;
  79.  
  80.             invalidateDisplayList();
  81.         }
  82.  
  83.         // {...}
  84.     }      
  85.  
  86. }

That's it for today. As I dig deeper, I will blog about my findings.. :) Thanks for reading!

Cheers!

Martin

One Response to “Tutorial - Creating Custom Flex Components - Skins & CSS Styles”

  1. Cristian Pascu says:

    Am about to start creating my own skin enabled components. Wish me luck! :-)

Leave a Reply