Skip to main content

 

 

 

 
Language:
 
Applies only to Traditional Web Apps
 
 
OutSystems

Blank Slate

Template:OutSystems/Documentation_KB/ContentCollaboration
  • Edit
    Collaborate with us
    Edit this page on GitHub
  • You can use the Blank State UI Pattern to inform end users, for example, to complete a task or when there is no data available for display etc.

    How to use the Blank Slate UI Pattern

    1. In Service Studio, in the Toolbox, search for Blank Slate.

      The Blank Slate widget is 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 Blank Slate widget into the Main Content area of your application's screen.

      By default, the Blank Slate widget contains icon and text placeholders.

    3. Add your content to the placeholders. In this example we change the icon to a calendar icon by selecting the Icon placeholder, and on the Properties tab, from the Name drop-down, selecting the calendar icon. We also enter new text in the Text placeholder.

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

    Properties

    Property Description
    Position (PositionExtended Identifier): Optional Sets the widget position.

    Examples

    • Blank - The widget displays in the center of the screen. This is the default.
    • Entities.PositionExtended.BottomRight - The widget displays on the bottom right of the screen.
    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.
    • Was this article helpful?