Message Area

The Message Area component is a container that displays message blocks. These blocks are useful for providing end users information about tasks to be completed, alerting them about actions to be taken, or displaying other pertinent information about the page.

Using the Message Area

The main purpose of the Message Area component is to display message blocks—which can be used to give the user information about the page they are on, the records they are working with, or any other subject the builder deems necessary. These message blocks can be dismissed by the user if Show close icon is enabled; otherwise they remain displayed until cleared by a component action.

Add a Message Area component to the page. Default message blocks can be added to the component by clicking Add Message Block on the component within the canvas. However, this component is primarily manipulated through component actions—which can be used to create new message blocks or clear all currently displayed blocks.

Message Areas themselves cannot be styled beyond standard spacing attributes, but each message block may use its own style variant.

Properties

Message Area Properties

Basic [[]]

  • Model:
    • None: Select this to add message block content without referencing context or using merge syntax.
    • [Specific models]: All models within the page will be listed as options. To utilize context—for example, to reference a particular field—select a model.

Advanced [[]]

  • Unique ID Skuid automatically generates an alphanumeric ID for the component; if preferred, give it a practical name.

Styles [[]]

  • Spacing: Sets the spacing of the Header relative to other components on the page. Spacing can be managed for Top Margin, Bottom Margin, Left Margin, Right Margin. All margins can be set to one of the following:

    • None
    • Extra Small
    • Small
    • Reduced
    • Regular
    • Increased
    • Large
    • Extra Large
    • Huge

    Note

    These sizes are relative to one another; the baseline is determined by Design System settings.

Display Logic [[]]

Standard render condition options are available.

Message Block Properties

Basic [[]]

  • Title: Determines the bolded text at the top of a message block. Not compatible with merge syntax.
  • Description: Determines the full message, beneath the title, within the message block. Compatible with merge syntax, which may utilize context if a model is set on the Message Area component.
  • Icon: Determines which icon is displayed beside the message block’s title and description. Defaults to an Information icon.
  • Show close icon: Determines whether or not a close icon is displayed at runtime—allowing end users to dismiss message blocks within the component. If unchecked, the only way to dismiss the message block is via the Clear Message Blocks component action. Unchecked by default.

Advanced [[]]

  • Unique ID Skuid automatically generates an alphanumeric ID for the component; if preferred, give it a practical name.

Styles [[]]

  • Style variant: Style variants are created and set in the Design System Studio. Some components have pre-defined variants for a specific aspect of a component’s style. Also, Skuid Builders can style and customize elements to create their own themes within the DSS. These themes will dynamically populate as selectable values in the Style Variant dropdown menu.

Context [[]]

Context condition options available.

Component Actions

  • Show message block: Creates a new message block within the selected Message Area.
    • Title: Determines the bolded text at the top of a message block. Not compatible with merge syntax.
    • Description: Determines the full message, beneath the title, within the message block. Compatible with merge syntax, which may utilize context if a model is set on the Message Area component.
  • Clear Message Blocks: Closes all message blocks currently displayed within the selected Message Area.