Skip to main content

 

 

 

 
Language:
 
Applies only to Mobile Apps and Reactive Web Apps
Service Studio version:
 
 
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 Columns 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. The following example uses the Columns 2 widget.

    3. Add the required content to the Columns widget. In this example we add an image and text.

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

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

    Properties

    Property Description
    GutterSize (GutterSizeIdentifier): Optional Defines the space between columns.

    Examples

    • Empty - Leaves a space of 16px between columns. This is the default (Entities.GutterSize.Base).
    • Entities.GutterSize.None - No space between 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
    See below for an example of how each of the options look.
    PhoneBehavior (BreakColumns Identifier): Optional Defines how the columns are displayed on phones. The predefined options for the phone behavior are:

    • All
    • First
    • Last
    • Middle
    • None
    See below for an example of how each of the options look.
    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.

    Entities.ColumnBreak.BreakNone (default)

    Entities.ColumnBreak.BreakMiddle

    Entities.ColumnBreak.BreakLast

    Entities.ColumnBreak.BreakFirst

    • Was this article helpful?