Image

The Image component lets you add images—plus alternative accessibility text that describes the images—to headers, drawers, modals, and other components.

Using the Image Component

Create visual context for your end users with the image component. Add an Image component to a page and then adjust the image properties:

  • Select the image source ( General tab): Images can be sourced from previously uploaded files or external URLs.
  • If desired, add alternative text to describe the image for access/assistive technologies such as screen readers.
  • Configure the image properties
    • Add any desired behaviors for the image, and set up the interactions these behaviors will trigger.
  • Preview, and adjust as needed

Properties

Component properties

  • Image source: Determines the source of the image file.

    • 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 such as {Name}. If no merge model is specified, you can still use Global Merge Variables / Functions.

        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}} for the image URL. Make sure the variable pulled in by the merge syntax is URL encoded and contains no spaces.

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

      • File name: The name of the file where the image is stored.

    • 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. For more information, see Object Relationships Overview.

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

        Note: 

        For the image component to work correctly, make sure to select the actual attachment field ID, not the reference field. You may need to click next to the image field name to access and select it. 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 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 both. For more information, see Merge syntax.

  • Unique ID (optional): Nintex Apps automatically generates an alphanumeric ID for the component; if preferred, give it a practical name.

Click Add and then select:

  • Add action flow: Select an existing action flow or click Create new action flow. Use action flows to launch actions.
  • Show menu: Configure a custom menu to show when a user interacts with an element.

Note:  Use the Show/hide menu action to add a dropdown menu to the image.

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. Nintex Apps 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.

    Note: 

    • To refresh available style variant options, click 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.

  • Margins: Sets a component's margin (the space around it) relative to other components on the page.

    • To set margins for all sides, click All.

    • To set margins for each side individually, click Separate.

    Set margins using spacing variables defined in the design system. Custom or arbitrary values are not allowed. For more information, see Spacing.

  • Height ( optional ): The height of the Image component.
  • Width ( optional ): The width of the Image component.

Standard Display logic options are available to display or hide the component or feature.