-
Notifications
You must be signed in to change notification settings - Fork 16
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #813 from OpenUpSA/feature/show-tutorial-with-url-…
…parama Add onboarding=tutorial to the query params to show the tutorial on load
- Loading branch information
Showing
1 changed file
with
110 additions
and
82 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,106 +1,134 @@ | ||
import {Component} from '../../utils'; | ||
import {createRoot} from "react-dom/client"; | ||
import { Component } from "../../utils"; | ||
import { createRoot } from "react-dom/client"; | ||
import TutorialButton from "./tutorial_button"; | ||
import React from "react"; | ||
import xss from 'xss'; | ||
import xss from "xss"; | ||
|
||
|
||
const allowedTags = ['a', 'b', 'em', 'span', 'i', 'div', 'p', 'ul', 'li', 'ol', 'table', 'tr', 'td', 'th']; | ||
const allowedTags = [ | ||
"a", | ||
"b", | ||
"em", | ||
"span", | ||
"i", | ||
"div", | ||
"p", | ||
"ul", | ||
"li", | ||
"ol", | ||
"table", | ||
"tr", | ||
"td", | ||
"th", | ||
]; | ||
const allowedAttributes = ["class", "target", "style", "href"]; | ||
const xssOptions = { | ||
stripIgnoreTag: true, | ||
onTag: function (tag, html, options) { | ||
if (allowedTags.indexOf(tag) === -1) { | ||
return ''; | ||
} | ||
}, | ||
onTagAttr: function (tag, name, value, isWhiteAttr) { | ||
if (allowedAttributes.indexOf(name) >= 0) { | ||
return name + '="' + xss.escapeAttrValue(value) + '"'; | ||
} | ||
}, | ||
onIgnoreTagAttr: function (tag, name, value, isWhiteAttr) { | ||
if (name.substr(0, 5) === "data-") { | ||
return name + '="' + xss.escapeAttrValue(value) + '"'; | ||
} | ||
stripIgnoreTag: true, | ||
onTag: function (tag, html, options) { | ||
if (allowedTags.indexOf(tag) === -1) { | ||
return ""; | ||
} | ||
}, | ||
onTagAttr: function (tag, name, value, isWhiteAttr) { | ||
if (allowedAttributes.indexOf(name) >= 0) { | ||
return name + '="' + xss.escapeAttrValue(value) + '"'; | ||
} | ||
}, | ||
onIgnoreTagAttr: function (tag, name, value, isWhiteAttr) { | ||
if (name.substr(0, 5) === "data-") { | ||
return name + '="' + xss.escapeAttrValue(value) + '"'; | ||
} | ||
}, | ||
}; | ||
|
||
const xssFilter = new xss.FilterXSS(xssOptions); | ||
|
||
export class Tutorial extends Component { | ||
constructor(parent) { | ||
super(parent) | ||
constructor(parent) { | ||
super(parent); | ||
|
||
this.wrapperClass = '.w-slider-mask'; | ||
this.slideClass = '.w-slide'; | ||
this.nextButton = '.w-slider-arrow-right .tutorial__slide_button'; | ||
this.prevButton = '.w-slider-arrow-left .tutorial__slide_button'; | ||
} | ||
this.wrapperClass = ".w-slider-mask"; | ||
this.slideClass = ".w-slide"; | ||
this.nextButton = ".w-slider-arrow-right .tutorial__slide_button"; | ||
this.prevButton = ".w-slider-arrow-left .tutorial__slide_button"; | ||
} | ||
|
||
addTutorialButton(feedbackBtnVisible) { | ||
let container = window.document.createElement('div'); | ||
container.classList.add('tutorial-button-container'); | ||
window.document.getElementsByClassName('main')[0].append(container); | ||
addTutorialButton(feedbackBtnVisible) { | ||
let container = window.document.createElement("div"); | ||
container.classList.add("tutorial-button-container"); | ||
window.document.getElementsByClassName("main")[0].append(container); | ||
|
||
const root = createRoot(container); | ||
root.render( | ||
<TutorialButton | ||
displayTutorialDialog={this.displayTutorialDialog} | ||
feedbackBtnVisible={feedbackBtnVisible} | ||
/> | ||
) | ||
const root = createRoot(container); | ||
root.render( | ||
<TutorialButton | ||
displayTutorialDialog={this.displayTutorialDialog} | ||
feedbackBtnVisible={feedbackBtnVisible} | ||
/> | ||
); | ||
// If URL param is present, display tutorial dialog | ||
const urlParams = new URLSearchParams(window.location.search); | ||
const onboarding = urlParams.get("onboarding"); | ||
if (onboarding === "tutorial") { | ||
this.displayTutorialDialog(); | ||
// Remove from URL | ||
const newParams = new URLSearchParams(urlParams.toString()); | ||
newParams.delete("onboarding"); | ||
window.history.pushState(null, "", `${newParams.size > 0 ? `?${newParams.toString()}` : '/'}`); | ||
} | ||
} | ||
|
||
createSlides = (tutorialArr) => { | ||
let tutorials = tutorialArr || []; | ||
let container = $(this.wrapperClass); | ||
let nextButton = $(this.nextButton); | ||
let prevButton = $(this.prevButton); | ||
let currentIndex = 0; | ||
var items = container.find(this.slideClass); | ||
var clonedItem = items.first().clone(); | ||
createSlides = (tutorialArr) => { | ||
let tutorials = tutorialArr || []; | ||
let container = $(this.wrapperClass); | ||
let nextButton = $(this.nextButton); | ||
let prevButton = $(this.prevButton); | ||
let currentIndex = 0; | ||
var items = container.find(this.slideClass); | ||
var clonedItem = items.first().clone(); | ||
|
||
let self = this; | ||
if (tutorials.length > 0) { | ||
items.remove(); | ||
tutorials.forEach((slide, i) => { | ||
let item = clonedItem.clone(); | ||
item.find(".slide-info__title").html(xssFilter.process(slide.title)); | ||
item.find(".slide-info__introduction").html(xssFilter.process(slide.text)); | ||
item.find(".tutorial__slide-number").html(`<div>${i+1}/${tutorialArr.length}</div>`); | ||
item.find(".tutorial__slide-image").css('background-image', `url(${slide.image})`); | ||
container.append(item); | ||
}); | ||
let self = this; | ||
if (tutorials.length > 0) { | ||
items.remove(); | ||
tutorials.forEach((slide, i) => { | ||
let item = clonedItem.clone(); | ||
item.find(".slide-info__title").html(xssFilter.process(slide.title)); | ||
item | ||
.find(".slide-info__introduction") | ||
.html(xssFilter.process(slide.text)); | ||
item | ||
.find(".tutorial__slide-number") | ||
.html(`<div>${i + 1}/${tutorialArr.length}</div>`); | ||
item | ||
.find(".tutorial__slide-image") | ||
.css("background-image", `url(${slide.image})`); | ||
container.append(item); | ||
}); | ||
|
||
nextButton.click(function() { | ||
currentIndex = (currentIndex + 1) % tutorials.length; | ||
self.updateCarousel(currentIndex); | ||
}); | ||
|
||
prevButton.click(function() { | ||
currentIndex = (currentIndex - 1 + tutorials.length) % tutorials.length; | ||
self.updateCarousel(currentIndex); | ||
}); | ||
|
||
} | ||
nextButton.click(function () { | ||
currentIndex = (currentIndex + 1) % tutorials.length; | ||
self.updateCarousel(currentIndex); | ||
}); | ||
|
||
prevButton.click(function () { | ||
currentIndex = (currentIndex - 1 + tutorials.length) % tutorials.length; | ||
self.updateCarousel(currentIndex); | ||
}); | ||
} | ||
updateCarousel = (currentIndex) => { | ||
$(this.slideClass).hide(); | ||
$(this.slideClass).eq(currentIndex).show(); | ||
} | ||
}; | ||
updateCarousel = (currentIndex) => { | ||
$(this.slideClass).hide(); | ||
$(this.slideClass).eq(currentIndex).show(); | ||
}; | ||
|
||
setTextOrLogError = (cls, item, text, index) => { | ||
let ele = $(cls, item); | ||
if (ele.length <= 0) { | ||
console.error(`Missing html element in slide ${index + 1} : ${cls}`); | ||
return; | ||
} | ||
ele.text(text); | ||
setTextOrLogError = (cls, item, text, index) => { | ||
let ele = $(cls, item); | ||
if (ele.length <= 0) { | ||
console.error(`Missing html element in slide ${index + 1} : ${cls}`); | ||
return; | ||
} | ||
ele.text(text); | ||
}; | ||
|
||
displayTutorialDialog() { | ||
$('.tutorial-modal').css('display', 'flex'); | ||
} | ||
displayTutorialDialog() { | ||
$(".tutorial-modal").css("display", "flex"); | ||
} | ||
} |