X

Shay Shmeltzer's Oracle Development Tools Tips

Adding Off Canvas Layout to a Visual Builder Application

Shay Shmeltzer
Director of Product Management - Oracle

Off Canvas layout is a common UI pattern for modern applications, especially on mobile devices. The concept is aimed at saving space on your page, allowing you to pop out a "drawer" of additional information. This helps reduce clatter on the main page but still provide access to important data when needed without leaving the page context. You can see an example of the runtime behavior at the top of this post. 

Oracle JET provides this type of "off-canvas" behavior as a built in component, and they have a demo of it working as part of the cookbook here.

In the video below I show you how to add this to a Visual Builder application. As always - you can mostly just copy and paste code from the JET cookbook, but you need to handle some of the importing of resources a little different, and use the Visual Builder approach for adding your JavaScript function.

The code used in the video is:

Page source:

<div class="oj-offcanvas-outer-wrapper">
  <div class="oj-offcanvas-start oj-panel oj-panel-alt5 oj-offcanvas-overlay-shadow"
    id="startDrawer" style="width: 200px">
    <div class="oj-flex">
      <h2 class="oj-flex-item oj-sm-12 oj-md-12" id="h1-1660298733-2">Menu</h2>
    </div>

    <div class="oj-flex">
      <oj-label class="oj-flex-item oj-sm-12 oj-md-3" id="oj-label-1660298733-1">List</oj-label>
    </div>

    <div class="oj-flex">
      <oj-label class="oj-flex-item oj-sm-12 oj-md-3" id="oj-label-1660298733-2">chart</oj-label>
    </div>
  </div>

  <div class="demo-main-content" id="mainContent">
    <div class="oj-flex">
      <h2 class="oj-flex-item oj-sm-12 oj-md-10" id="h1-1660298733-1">Gifts</h2>
    </div>

    <div class="oj-flex">
      <hr class="oj-flex-item oj-sm-12 oj-md-12" id="hr-1660298733-1" />
    </div>

    <div class="oj-flex">
      <oj-list-view class="oj-flex-item oj-sm-12 oj-md-12" data="[[$page.variables.giftsListSDP]]"
        id="oj-list-view-1660298733-1"> <template slot="itemTemplate"> <oj-vb-list-item> <img :src="[[$current.data.picture]]" height="32" slot="image" width="32" />
<p slot="title1"><oj-bind-text value="[[$current.data.product]]"></oj-bind-text></p>

<p slot="value1"><oj-bind-text value="[[$current.data.cost]]"></oj-bind-text></p>

<p slot="title2"><oj-bind-text value="[[$current.data.sKU]]"></oj-bind-text></p>
</oj-vb-list-item> </template> </oj-list-view>
    </div>
  </div>
</div>

JavaScript Function in the page:

define(['ojs/ojcore'], function(oj) {
  'use strict';

  var PageModule = function PageModule() {};

  PageModule.prototype.showSide = function() {
    var offcanvas = {
      "selector": "#startDrawer",
      "content": "#mainContent",
      "edge": "start",
      "displayMode": "push",
      "size": "200px"
    };

    oj.OffcanvasUtils.open(offcanvas);

  }

  return PageModule;
});

and in your page Json file add this import:

"oj-offCanvas": {
  "path": "ojs/ojoffcanvas"
}

Join the discussion

Comments ( 2 )
  • Samuel Lima Wednesday, October 30, 2019
    Hi Shay,

    I copied exactly the same code and got an "Unexpected string in JSON at position 412" while loading page "shell/main/main-start".

    Do you know how I can fix it?
  • shay Thursday, October 31, 2019
    Samuel, Seems like there was some junk code added to the json file in the blog. It is fixed now should be:
    "oj-offCanvas": {
    "path": "ojs/ojoffcanvas"
    }
Please enter your name.Please provide a valid email address.Please enter a comment.CAPTCHA challenge response provided was incorrect. Please try again.