The IApps-Navigation feature provides a method for users to circle back to the IndustryApps platform if they have accessed a third-party application which redirects via a new tab. Please utilise this add-on feature if your applications configuration fits this criteria.
Users utilise many applications on IndustryApps for different use cases, and as such providing a smooth flow transition is important for an improved user experience.
How do I add it?
The feature should be added as code snippets in your client-side application. The add-on will redirect the user back when the IApps back button on-click event is triggered.
Copy the line of code below into your index.html file.
In case of an Angular application a similar framework, you may include the .js and .css files in the angular.json script and style sections.
<div id="iapps-nav-logo"></div>
Include the iapps-nav.js functions file illustrated below.
iapps-nav.js
document.getElementById("iapps-nav-logo").onclick = function() {onClickIappsLogo()};
var isDragged = false;
function onClickIappsLogo() {
if (isDragged) {
return;
}
let params = window.location.hash.split('launch=')
let url = params.length > 1 ? params[1] : '';
window.location.href = decodeURIComponent(url);
}
dragElement(document.getElementById("iapps-nav-logo"));
function dragElement(elmnt) {
var pos1 = 0, pos2 = 0, pos3 = 0, pos4 = 0;
if (document.getElementById("iapps-nav-logo")) {
// if present, the header is where you move the DIV from:
document.getElementById("iapps-nav-logo").onmousedown = dragMouseDown;
} else {
// otherwise, move the DIV from anywhere inside the DIV:
elmnt.onmousedown = dragMouseDown;
}
function dragMouseDown(e) {
e = e || window.event;
e.preventDefault();
// get the mouse cursor position at startup:
pos3 = e.clientX;
pos4 = e.clientY;
document.onmouseup = closeDragElement;
// call a function whenever the cursor moves:
document.onmousemove = elementDrag;
}
function elementDrag(e) {
isDragged = true;
e = e || window.event;
e.preventDefault();
// calculate the new cursor position:
pos1 = pos3 - e.clientX;
pos2 = pos4 - e.clientY;
pos3 = e.clientX;
pos4 = e.clientY;
// set the element's new position:
elmnt.style.top = (elmnt.offsetTop - pos2) + "px";
elmnt.style.left = (elmnt.offsetLeft - pos1) + "px";
}
function closeDragElement() {
// stop moving when mouse button is released:
document.onmouseup = null;
document.onmousemove = null;
setTimeout(dragEnd, 500);
}
function dragEnd() {
isDragged = false;
}
}
In case of an Angular application, include the js and css files in the angular.json script and style sections.
Copy the iapps-nav.png image to your assets folder, available below.
Third-party Applications URL should contain a queryParam - launch. The URL assigned to launch the param will be used to redirect while clicking on the IApps back button.
