Skip to content

Latest commit

 

History

History
136 lines (108 loc) · 3.67 KB

README.md

File metadata and controls

136 lines (108 loc) · 3.67 KB
Raw

Tutorial: A View Stack Widget Using QCObjects

Step 1:

Create three files: view-stack.html. one.html, two.html

Step 2:

Iside the file index.html include the following tag in the head section:

<head>
<script type="text/javascript" src="https://cdn.qcobjects.dev/QCObjects.js"></script>
</head>

Step 3:

In the body section, add the following:

<h1>This is a view stack example</h1>
<h2>There are 3 files, view-stack.html , one.html and two.html</h2>
<h3>This part of the page (index.html) does not change when you click in a link</h3>
<p>Open DevTools in your browser (second mouse button, click on  Inspect Elements) and see what happens with the elements of this page when you click a link</p>

<view-stack componentClass="CustomComponent">
  <routing path="/one" name="page-one" ></routing>
  <routing path="/two" name="page-two"></routing>
  <routing path="/" name="view-stack"></routing>
  <routing path="" name="view-stack"></routing>
</view-stack>

Step 4:

Give some style to your component

<style>
component[name=view-stack]{
  border: 1px solid black;
   width: 200px;
   height: 200px;
   position: relative;
   display: block;
   padding: 0;
}
</style>

Step 5

Create a CustomComponent class to define the custom behaviour when a view is loaded

CONFIG.set("routingWay", "pathname")

Class ("CustomComponent", Component, {
  _new_ (o){
    var component = this;
    component.addComponentHelper(function (){
      component.__promise__.then(function (){
        // This shows a notification when the content of the current page is fully loaded into the view stack
        return Promise.resolve(NotificationComponent.success(`Current View is ${component.routingSelected.pop().name}`));
      }).catch (function (e){
        return Promise.resolve(NotificationComponent.danger("some problem"));
      })

    });
    _super_("Component", "_new_").call(this, o);
  }
});
RegisterWidget("view-stack")

The complete code looks like this

<!doctype html>
<html class="no-js" lang="en">

<head>
<script type="text/javascript" src="https://cdn.qcobjects.dev/QCObjects.js"></script>
</head>

<body>
<style>
component[name=view-stack]{
  border: 1px solid black;
   width: 200px;
   height: 200px;
   position: relative;
   display: block;
   padding: 0;
}
</style>
<h1>This is a view stack example</h1>
<h2>There are 3 files, view-stack.html , one.html and two.html</h2>
<h3>This part of the page (index.html) does not change when you click in a link</h3>
<p>Open DevTools in your browser (second mouse button, click on  Inspect Elements) and see what happens with the elements of this page when you click a link</p>
<view-stack componentClass="CustomComponent">
  <routing path="/one" name="page-one" ></routing>
  <routing path="/two" name="page-two"></routing>
  <routing path="/" name="view-stack"></routing>
  <routing path="" name="view-stack"></routing>
</view-stack>

<script>
CONFIG.set("routingWay", "pathname")

Class ("CustomComponent", Component, {
  _new_ (o){
    var component = this;
    component.addComponentHelper(function (){
      component.__promise__.then(function (){
        // This shows a notification when the content of the current page is fully loaded into the view stack
        return Promise.resolve(NotificationComponent.success(`Current View is ${component.routingSelected.pop().name}`));
      }).catch (function (e){
        return Promise.resolve(NotificationComponent.danger("some problem"));
      })

    });
    _super_("Component", "_new_").call(this, o);
  }
});
RegisterWidget("view-stack")
</script>

</body>

</html>

See this example running on glitch index.html