Shay Shmeltzer's Oracle Development Tools Tips
-
Visual Builder
November 7, 2018
Adding Off Canvas Layout to a Visual Builder Application
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"
}
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?
"oj-offCanvas": {
"path": "ojs/ojoffcanvas"
}