Slideover Plug-In

The APEX Slideover Plug-In

I made an Oracle APEX Plug-In that allows creating Slideover regions which slide in content from the side when opened.

I am proud to share my first public Oracle APEX Plug-In. You can download it on GitHub.

Demo of the slideover in action

The Demo is available here.

The Slideover Plug-In is a region Plug-In that is by default hidden and slides in from the side when opened. It can slide in from both sides and uses the user-configured Universal Theme styles for APEX Version 21.1. The minimum APEX version to use this Plug-In is 19.2. For more details take a look at the GitHub Page.

How to use

  • Create a region of the type “Slideover [Plug-In]
  • Change Layout -> Position to “Inline Dialogs” Body1
  • Put your desired child regions into the created Plug-In region
  • Change settings under the region attributes (optional)

Open a Region

To open the region create a Dynamic Action with the Action “Open Region”. Then select the Plug-In region.

Or with JavaScript:

apex.region('regionStaticID').open();
apex.region('regionStaticID').close();

Configuration

The Plug-In features three attributes that can be configured. You can set a title, change the direction from which side the Slideover will open, and set a width of the Slideover.

Screenshot of the attributes window in the APEX Page Designer

Change title

You can use JavaScript to change the title of the Slideover dynamically.

The initial ital title can be set in the APEX Page Designer in the Attributes. If you want to change it afterward you can call setTitle on the region:

apex.region('regionStaticID').setTitle('New Title');

Change Styles

For APEX 21.1 it uses the CSS variables by universal theme. The slideover will fit nicely into your app.

You can also style the Slideover with custom CSS:

/* Dark background to draw attention to the slideover */
slide-over::part(lay-over) {
  background-color: rgba(90, 41, 41, 0.6);
}

/* The layover itself */
slide-over::part(slide-over) {
  background-color: #ffffd2;
}

/* Header of the layover */
slide-over::part(slide-header-text) {
  font-weight: 300;
  color: purple;
}

/* Close button */
slide-over::part(close-button) {
  color: purple;
}

/* Set close button focus outline */
slide-over::part(close-button):focus {
  border-color: pink;
}

Video Tutorial

Updates

Download the lastest version here.

Version 1.2

  • Bugfix: The Slideover Web Component now gets appended into the form (wwvFlowForm) instead of the body. There was an issue where Date-Pickers in the Slideover caused strange JS issues
  • Slideover Web Components now have a unique ID for better referencing
  • New API to change the Slideover title with JavaScript: apex.region('staticId').setTitle('New Title');

Version 1.1

In version 1.1 it is now possible (and I recommend doing so) to put the Slideover region inside the “Inline Dialogs” section instead of “Body1”.

There was an issue with Faceted Search Regions where the Slideover content was visible for a short time on page load. Putting the Slideover into the “Inline Dialogs” section fixes this because the content is hidden by default.

Comments

loading comments...