Child pages
  • Styling with CSS

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Stoc

Overview

Servoy supports the use of HTML cascading style sheets (CSS) for styling applications. These text files are stored in the resource project. A resource project can have many CSS files, and more than one CSS can used in a solution.

...

  • Adds to the consistency of the user interface; form elements across the application can use the same styles.
  • Gives the developer to make style changes over many/all forms by changing a single value in the CSS.
  • Style sheets can be used over multiple applications, adding consistency to the all the company's applications.
  • Adds consistency to an application in team development, making it easier for development teams to use the same styling on all forms.
  • Style sheets can be changed programmatically, allowing a developer to change styles to different users' taste or to have periodic style changes in their applications. See overrideStyle function for more details.

Creating a Style

To create a style in Servoy:

...

Tip
titleTIP

It is normally easier to work with an existing style. Most of the sample solutions have a style associated with them and these style are imported when the solution is imported into Servoy Developer. You can also create a new style and copy/paste different entries from one style to another.

Working With a Style

To open an existing style sheet:

  1. Click on Styles under the Resources project in the Solution Explorer and do one of the following:
    1. Select the style desired (shown in the Solution Explorer list view) and click on the Open style button in the Solution Explorer list view toolbar.
    2. Double click the style desired.
    3. Right click on the style desired and select Open style from the menu.
  2. The style will open in the center of the Workspace in an editor view.

Structure of the Style Sheet

A style sheet for Servoy has basic style definitions and style definition classes.

...

Notice that the border style and font are not modified in the mytext class. This means if a label were specified to use mytext for its style, it would be bold, 10pt, Verdana because that is what is specified in the parent style definition. The color would be red (not black) because that was overridden by the mytext definition class.

Using Styles in Forms

In order to use a style sheet, the style sheet must be applied to a form. Solutions do not have a style sheet applied, only forms. Styles for the elements on a form are dependent on the style sheet applied to the form.

Setting the Style in the Form

A style can be applied to a form in one of two ways.

...

Tip
titleTIP

If you are creating forms, the style sheet selected for the first form will be automatically selected in the New Form Wizard for subsequent forms. If you happen to not enter a style sheet in the wizard, but would like to apply a style sheet to many forms, just multiple select the forms in the Solution Explorer and edit the Properties view. This will change the property on all the forms you have selected.

Setting Styles to Form Elements

Any elements on a form with a style applied AND have a style definition entered for the element type will take the styling from the style definition entry.  For example, if I am using the style test, and there is a label entry in the test style sheet, then ANY label placed on the form will take the label style from the style sheet. 

...