Skip to main content

 

 

 

 
Language:
 
Applies only to Traditional Web Apps
 
 
OutSystems

Columns

Template:OutSystems/Documentation_KB/ContentCollaboration
  • Edit
    Collaborate with us
    Edit this page on GitHub
  • You can use the Columns UI Pattern to split content into separate columns, improving the way information is displayed on screen.

    How to use the Columns UI Pattern

    1. In Service Studio, in the Toolbox, search for Columns.

      The various Column widgets are displayed.

      If the UI widget does not display, it may be because you used a ready-made app, which deletes unused widgets from the module. To make additional widgets available in your app:

      a. Go to Module > Manage dependencies.

      b. Search for and select the relevant Producer, for example OutSystemsUI. Ensure Show All is selected.

      c. On the Public elements for the selected Producer displayed on the right, ensure Show All is selected.

      d. Search for and select the element you want to add, and click Apply.

      e. In Service Studio, in the Toolbox, search for the widget again.

    2. From the Toolbox, drag the required Column widget into the Main Content area of your application's screen. In this example, we drag the Columns 2 widget onto the screen.

    3. Add the required content to the Column widget, for example, images, forms, text. In this example, we add some images and text.

    4. On the Properties tab, you can customize the Colums's look and feel by setting any of the optional properties, for example, the size of columns and space between each of the columns (GutterSize), and in what order the columns display on different device types.

    After following these steps and publishing the module, you can test the pattern in your app.

    Properties

    Property Description
    GutterSize (GutterSize Identifier): Optional Set the gutter size. The default Gutter size is large.

    Examples

    • Blank - A large white space between each column (default value).
    • Entities.GutterSize.Gutter_None - No white space between each of the columns
    • Entities.GutterSize.Gutter_XS - An extra small white space between each of the columns
    TabletBehavior (BreakColumns Identifier): Optional Defines how the columns are displayed on tablets. The predefined options for the tablet behavior are:

    • All
    • First
    • Last
    • Middle
    • None (default).

    See below for an example of how each setting displays.

    PhoneBehavior (BreakColumns Identifier): Optional Defines how the columns are displayed on phones. The predefined options for the phone behavior are:

    • All (default).
    • First
    • Last
    • Middle
    • None

    See below for an example of how each setting displays.

    ExtendedClass (Text): Optional Adds custom style classes to the Pattern. You define your custom style classes in your application using CSS.

    Examples

    • Blank - No custom styles are added (default value)
    • ''myclass'' - Adds the myclass style to the UI styles being applied.
    • ''myclass1'' ''myclass2'' - Adds the myclass1 and myclass2 styles to the UI styles being applied.
    You can also use the classes available on the OutSystems UI. For more information, see the OutSystems UI Live Style Guide.

    The following are examples of how the columns are displayed on each of the devices, depending on which property you select.

    Entities.BreakColumns.None

    Entities.BreakColumns.Middle

    Entities.BreakColumns.Last

    Entities.BreakColumns.First

    • Was this article helpful?