Wrapper¶

Style variant section [[]]¶

Global styles for this component are set in the Design System Studio. The following Style properties can be adjusted for an individual page.

• 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.

  Note

  To refresh available style variant options, click refresh Refresh style variants.

  This is useful for when changes to the design system (like style variants or variable options) have been made in another browser window or by another user.

Spacing section [[]]¶

• Component 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.

Background section [[]]¶

Background source: This controls the appearance of the Wrapper’s background.

• Design system: The background is determined by the Wrapper’s style variant.

• Image: The background is an image file.

  • Image source: Determines where to source the image file from.

    • URL: Displays the image available at the specified URL

      • Image URL: The URL of the image to display

        Note

        You may also use merge syntax in the URL field. If a merge model is specified, you can reference fields with standard merge variables like {Name}. If no merge model is specified, you can still use global merge syntax.

        For example, if you host an account’s logo image at a particular URL, and you want it displayed next to a record, you could use www.YourSite.com/{{$Model.Account.data.0.Name<http://www.yoursite.com/%7B%7B$Model.Account.data.0.Name>`__}}for the image URL.

        If you choose to do this, ensure that the variable pulled in by the merge syntax is URL encoded—no spaces.

    • File: Displays an image previously uploaded within Settings > Files.

      • File name: The file to display. Provides autocomplete options based on uploaded files.

    • Attachment: Displays an image that has been uploaded and attached to a record within a model.

      Note

      This option only accepts lookup relationship fields that have File as the related object.

      The object must have a custom attachment field created on it.

      • Image field: Click the field picker to select the attachment image’s ID field.

        Note

        You may need to click next to the image field’s name to access and select the actual attachment field ID. You need to select this, not the reference field, for the image component to work

        If the image field is a Photo URL field, use URL as the image source.

  • Merge model / Model: The selected model provides values for merge syntax or record options for attachments.

  • Alternative text: Determines the descriptive text about the image that can be used by access/assistive technologies such as screen readers and conforms to Web Accessibility Initiative—Accessible Rich Internet Applications (WAI-ARIA) specifications. This property can be a specific string of text, the merge variables of one or more fields, or a combination of the two.

    Note

    If no alternative text is specified, assistive technologies will either ignore the image or (in some cases) speak a generic label, such as “Image displayed.”

  • 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 the transparent symbol to open color the selection menu.

• Color: Choose a color to serve as Wrapper background. Defaults to transparent.

  • Click the transparent symbol to open color the selection menu.

Wrapper height section [[]]¶

• Height Strategy:

  • Fit to Content: This sizes the wrapper to fit the components within.

    • Max Height (optional): The maximum height of the Wrapper component. Options are:

      • None

      • Short

      • Medium

      • Tall

      • Custom: Uses a custom height.

        • Custom Height: The height of the table, using a number and a sizing unit.

    • Min Height (optional): The minimum height of the Wrapper component. Options are:

      • None

      • Short

      • Medium

      • Tall

      • Custom: Uses a custom height.

        • Custom Height: The height of the table, using a number and a sizing unit

  • Fixed Height: Sets an absolute height.

    • Height:

      • Fit to Content

      • Short

      • Medium

      • Tall

      • Custom: Uses a custom height.

        • Custom Height: The height of the table, using a number and a sizing unit.

• Overflow: Determines how content that overflows the wrapper is handled.

  • Scroll: The content is scrollable and a scroll bar is displayed.
  • Hide: The content that does not fit into the wrapper remains hidden.
  • Show: The wrapper resizes the content to fit into the wrapper.