Styles > How to Use

As you can see above, all the style related elements and attributes appear under the <styles> parent element. It should effectively contain all your style related XML code. FusionCharts will not recognize any style definition outside the <styles> parent element.

Children to <styles> element are <definition> and <application> elements. As the name suggests, <definition> element contains your custom styles definition for the chart while under <application> element you apply your custom defined styles to different chart objects.

Now, let's first get to the definition of styles.

Cruising back through the above XML code, you'll see that we've defined three custom styles namely:

• MyFirstFontStyle, which will later help us in setting font properties for text on the chart.
• MyFirstAnimationStyle will help us in animating a chart object, and
• MyFirstShadow that can render a shadow effect on any chart object.

Each style has to be defined using the <style> element. Multiple style elements may be placed one after another under <definition> element. So, if you wish to define five custom styles, you need to create five <style> elements.

Depending on the style type you are defining, each <style> element can have multiple attributes. In the above code example, each <style> element has its own set of properties. However, following two attributes are common to all:

1. name
2. type.

Both the attributes are mandatory for each style definition.

Mandatory Attributes

Style Name

Format: name='stylename'

There are no restrictions on the style name, barring the pointers below:

• Style name can only include alphabets and numbers. Punctuation marks (including underscore) shouldn't be used.
• Style name must be unique, i.e., two style definitions cannot have the same name as there will be a conflict between the two.

Style Type

Each style needs to be defined as to what type it is. The type defines what this style is going to do. FusionCharts v3 supports six style types:

• Font
• Animation
• Shadow
• Glow
• Blur
• Bevel

So, the type attribute expects one of the above six values as its parameter. In our example, we've defined the first style type as "font", second one as "animation" and third one as "shadow", which is self explanatory.

Other Attributes

The rest of the attributes for a style element are dependent on its Type. For example, we can use face, size, color, bold etc. property for a FONT style type. However, the same is not valid for ANIMATION style type, as these parameters make no sense for an animation. Each style type has therefore its own set of attributes which you can specify which will be discussed next.

Now, if you're already eager to apply the styles to chart objects, let's get to the application part of the story.

Applying custom defined styles to chart objects

To apply your defined styles to chart objects, you first need to make sure that you've the list of chart objects. This can be found in the "XML Sheet" for each chart.

Each chart has a different list of Objects. So, you need to ensure that you're working with the right Object name for the given chart.

Now, the following XML does the work of applying styles to different chart objects:

Each <apply> element helps to apply multiple styles to one chart object e.g., in our code, we first apply the MyFirstFontStyle font style to Caption of the chart and then apply the shadow style MyFirstShadow to the same object. To apply multiple styles, we separate the names of the respective styles by a comma.

Format: <apply toObject='Object' styles='Style1, Style2, Style3 ...' />

You need to make sure of few things here:

• To apply multiple styles to a chart object, you need to separate the style names using comma.
  e.g., <apply toObject='Caption' styles='MyFirstFontStyle,MyFirstShadow' />
  
• To apply a single style to multiple objects, you'll need to define <apply> element for each object and then assign the style for it.
  e.g.,
  <apply toObject='Caption' styles='MyFirstShadow' />
  <apply toObject='DataPlot' styles='MyFirstShadow' />
  
  You CANNOT separate the object list by comma and then assign a single style to it - the following will be INVALID:
  <apply toObject='Caption,DataPlot' styles='MyFirstShadow' />

• The style name specified during application has been defined earlier in style definition and the spelling is correct, else, FusionCharts would ignore it and log the error in Debug Window.

And now that you're familiar with style definition and application, we move on to see the list of parameters supported by each style type. We start with FONT style next.