Wrapper

The Wrapper is a layout component that serves as a container for other components. Using the Wrapper, you can “wrap” other components to more easily control styling and conditional rendering.

Using the Wrapper Component

The Wrapper component exists to give uniformity to components used on your Skuid page. The background image or color, size, and border and padding of each Wrapper can be customized. Controlling these visual details ensures a consistent design across all components contained in the Wrapper.

Beyond visual app design, the Wrapper offers a more efficient way to apply conditional rendering to multiple components. Rendering logic applied to a single Wrapper component becomes uniform for all the components it contains. If you would like to apply the same rendering logic to several components, place the components in a Wrapper, and apply the logic to the Wrapper itself rather than setting up rendering properties for each individual component.

Add Components to the Wrapper

  1. Drag and drop a Wrapper component onto a Skuid page.
  2. Click, then drag desired components into the Wrapper component.
  3. Modify component properties as usual to adjust behavior.

Note

The visual settings placed on the Wrapper may override visual styles applied to individual components within the Wrapper.

Properties

Styles tab [[]]

  • Background: Control the appearance of the Wrapper’s background.

    • Not Set (default)

    • Image: Pulls in an image from a Skuid data source.

      • Data Source Type: Select the data source type from which you will be pulling the image.

        Note

        Select “Ui-Only” for images associated with Ui-Only models.

      • Data Source: Choose the specific data source containing the desired image. (Defaults to “Ui-only” for Ui-only models.)

      • Image Source:

        In Skuid Platform

        • File:

          Setting Data Source Type to REST and Data Source to SkuidLocal lets you access images previously uploaded within the Files tab.

          • File Name: If the file has been correctly uploaded, when you start typing the filename, Skuid will autocomplete.
        • URL: To access an image URL using Skuid Platform, you must change the data source and data source type:

          • Data Source Type: UI-Only.
          • Data Source: UI-Only.
          • Image Source: URL
          • Model: It is not necessary to specify a model. However, if using merge fields for the URL, setting the model the provides the needed model/row context.
          • Image URL: Enter the complete URL.

        In Skuid on Salesforce

        • Static Resource:

          • Note

            You must have an image file uploaded as a static resource.

          • Resource Name: If the file has been correctly uploaded, when you start typing the filename, Skuid will autocomplete.

        • URL:

          • Model: It is not necessary to specify a model. However, if using merge fields for the URL, setting the model the provides the needed model/row context.
            • Image URL: Enter the complete URL.
      • Size: Control the size of the image.

        • Original: The image will display at its original size, without regard to the size of the Wrapper.
        • Contain: The image will scale so that it will at least meet the top and bottom margins of the Wrapper.
        • Cover: The image will scale so all parts of the Wrapper’s background are covered by the image.
      • Position: Choose the orientation of the image within the Wrapper.

      • Repeat: Determine if the image will repeat vertically, horizontally or both.

        • No Repeat
        • Horizontal
        • Vertical
        • Both
      • Special Effects: Add special effects to Wrapper image.

        • No effects
        • Parallax means that, when scrolling, the contents in the grid will scroll over the image
      • Color: Background color behind image. Defaults to transparent.

        • Click transparent symbol to open color selection menu.
  • Color: Choose a color to serve as Wrapper background. Defaults to transparent.

    • Click transparent symbol to open color selection menu.
  • Border and Padding: Set border and padding properties for the Wrapper.

    Note

    Border refers to the lines—or lack thereof—that form the boundary of the Wrapper within the page. Padding is the amount of space between components in a Wrapper and the Wrapper’s border.

    • Border
      • No Borders
      • All
      • Left
      • Top
      • Right
      • Bottom
    • Padding
      • No Padding
      • All
      • Left
      • Top
      • Right
      • Bottom
    • Margin
      • No Margin
      • All
      • Left
      • Top
      • Right
      • Bottom
  • Size: Alters the height and width of the Wrapper.

    • Width

      • Full: Extends to full width of screen or other containers the Wrapper is within.
      • Collapse: Adjusts Wrapper to width of its contents.
      • Custom: Customize Wrapper maximum and minimum width by percentage, pixel, and other options.
    • Height

      • Collapse: Adjusts Wrapper to width of its contents.
      • Custom: Customize Wrapper maximum and minimum height by percentage, pixel, and other options.

In addition to the standard attributes, you can add custom CSS values to the Wrapper.

  • Click fa-plus-circle Add New Custom Attribute and enter:
    • Custom CSS property
    • Custom CSS value

Need to remove a custom style attribute? Click fa-times-circle next to the attribute.

Advanced tab [[]]

Interactions tab [[]]

  • Action/Interaction Types: Choose from three possible interactions:
    • Click—best for desktop as well as mobile
    • Swipe—best for mobile
    • Press—best for mobile

Click fa-plus-circle Add Action on the selected interaction type to add actions, then edit the Action Types:

Rendering tab [[]]

Standard conditional rendering options are available.