/
Fluid Skinning System (FSS)

Documentation for a historical release of Infusion: 1.3
Please view the Infusion Documentation site for the latest documentation.
If you're looking for Fluid Project coordination, design, communication, etc, try the Fluid Project Wiki.

Fluid Skinning System (FSS)

Apr 03, 2013

Getting Started With FSS

The FSS is intended to be used as the basis for your website, extended and customized by your own styles. The short-version of how to use FSS is:

  1. Include the FSS .css files you want, in the right order, ahead of your own .css file(s).

  2. Add FSS classes to your mark-up, ahead of your own class names

  3. If desired, override or extend any FSS classes as needed.

A slightly longer version of how to use FSS is provided in the sections below. For more details on the specific classes available in the FSS, see the FSS Cheat Sheet page.

1. Including FSS files

FSS includes several separate files, each providing particular functionality:

  1. fss-reset-global.css or fss-reset-context.css: new in v1.4 normalize visual discrepancies between browsers. Optional, but recommended. (For earlier versions, use fss-reset.css.)

    • fss-reset-global.css: The global file will affect the entire page.

    • fss-reset-context.css: Changes are scoped to the fl-reset class.

  2. fss-base-global.css or fss-base-context.css: new in v1.4 applies a default set of styles. Optional, but recommended, and work well when used with the fss-reset files. (For earlier versions, use fss-reset.css.)

    • fss-base-global.css: The global file will affect the entire page.

    • fss-base-context.css: Changes are scoped to the fl-reset class.

  3. fss-layout.css: contains classes for defining margins, paddings, positions, etc., as well as classes useful for laying pages out with columns, etc.

  4. fss-text.css: includes classes for setting font size, font family, line height, etc.

  5. fss-theme-<themeName>.css: new in v1.1 contains classes defining sets of colors, background colors, etc.

File Order is Critical

The order of the files in your document is important: FSS stylesheets should be included before any Infusion component stylesheets, and in the order described above. Any custom stylesheets should be included last.

Your declaration of FSS files should look somewhat like the following:

The above example uses all the different FSS CSS functions. If you have no use for one of the files, you do not need to include it.

2. Adding FSS classes to your mark-up

Note also that you should always put any FSS class names at the beginning of the class attribute in your HTML declarations, before any of your custom classes. For example:

<div class="fl-container-250 fl-font-size-110 myCustomClass"> </div>

3. Overriding FSS classes

While the FSS classes are generally well thought-out and pretty comprehensive, it is likely that you will want to customize your site by overriding some of the styles. This is how we expect the FSS to be used.

There are generally two ways of overriding predefined styles:

  1. Overriding an entire class

  2. Overriding only one instance of a class

In all cases, you should override FSS classes in your own custom stylesheet. Do not modify the original FSS files.

Overriding an entire class

Overriding an entire class doesn't mean that you have to change all of the properties specified. To override fl-para, you can copy and paste the code into your imported or embedded style sheet and modify it however you like. Here's an example:

If this override is pasted into an imported style sheet, please note that the code for importing that style sheet would have to come after the code for importing the original (see Order of overrides #4).

Overriding an instance of a class

In some cases, you may only wish to override an FSS style for one element that the class is applied to. This can be accomplished by using a selector that is specific to only that element, for example by adding a class name, or using other specifics.

Extending FSS classes

The FSS defines many variations of a given style - for example, it defines several widths for use with fixed-width columns. But it is likely that someone will want a width (or font size, or anything else) that is not specifically defined in the FSS files. In these cases, you are encouraged to copy the style, rename it and customize it to your specific needs.