This documentation supports the 22.1 version of Action Request System.
To view an earlier version, select the version from the Product version menu.

Setting panels to scroll at different rates in Progressive Web Applications

When panels on application screens have different quantities of content, a normal scroll bar creates blank spaces in the panels that have less content. A sticky panel helps avoid such blank spaces by scrolling the panel with more content at a different rate.

You can add sticky panels in Progressive Web Applications (PWA) screens with multiple panels by using Developer Studio . Adding sticky panels helps improve user experience when your users scroll screens with multiple panels displaying different amounts of content.

Sticky panels scroll in such a way that the panel with more content scrolls first so that scrolling of all the panels completes at the same time. Application users can see the content of the panels easily, without any of the content going out of view.

Scenario

At Apex Global, the change request screen has an activity panel which often has more scrollable content than the main panel. When users scroll down to view the activity panel content, the content in the main panel goes out of view.


The following animation shows a scenario where the panel on the left scrolls out of view leaving an empty space:

To address this issue, the application developer, Seth, adds a property in Developer Studio that causes both the panels to scroll at different rates based on their content. The panel with more content scrolls first while the panel with less content remains sticky, until both panels have the same amount of scrollable content.

The following animation shows how a sticky panel behaves when scrolling:

Before you begin

You must start with an existing form that has more than one panel with the following properties:

PropertyValue
Display > Display TypeFlow Panel
Display > TypeSection Panel
Display > OrientationVertical

For example, the PWA screen in Smart IT such as the SHR:SV_TicketDisplay form has two flow panels with these properties.

To set panels to scroll at different rates in Progressive Web Applications

  1. In Developer Studio , open the form for which you want to create sticky panels.
    For example, open the SHR:SV_TicketDisplay form.
  2. Select the Flow Panel Holder.
    For example, in the SHR:SV_TicketDisplay form, select panels with IDs 304428481 and 304436081.

  3. In Properties, under Display > Custom CSS Style, add the following string:
    sticky-holder
    If there are previously existing values in the Custom CSS Style field, the string sticky-holder must be preceded by a space. 

  4. (Optional) If the form has horizontal navigation fields, remove the following string from the Custom CSS Style property:
    detach
  5. Click Save and sync the Mid Tier cache.
    For more information about how to sync the cache, see Synchronizing Mid Tier cache

To validate the behavior of the sticky panels in Progressive Web Applications

  1. In a browser, log in to PWA.
    <serverName>:8080/arsys/pwa/#/login
  2. Change the URL to include the Progressive View form that you created in  Developer Studio .
    <serverName>:8080/arsys/pwa/#/forms/<serverName>/<formName>/<viewName>
    The panels in the PWA show 'sticky' behavior whenever there is more content in one of the panels.

Troubleshooting

If the panels do not appear or if there is an issue with scrolling, perform the following steps:

  • Confirm that the page source of the PWA screen appears correct by using the browser developer tools.
  • Confirm that the workflows and field properties are correctly defined in Developer Studio .
  • If the page has horizontal navigation fields, remove the following string from the Custom CSS Style property:
    detach
Was this page helpful? Yes No Submitting... Thank you

Comments