• Jump To … +
    ./demo/canvas-001.js ./demo/canvas-002.js ./demo/canvas-003.js ./demo/canvas-004.js ./demo/canvas-005.js ./demo/canvas-006.js ./demo/canvas-007.js ./demo/canvas-008.js ./demo/canvas-009.js ./demo/canvas-010.js ./demo/canvas-011.js ./demo/canvas-012.js ./demo/canvas-013.js ./demo/canvas-014.js ./demo/canvas-015.js ./demo/canvas-016.js ./demo/canvas-017.js ./demo/canvas-018.js ./demo/canvas-019.js ./demo/canvas-020.js ./demo/canvas-021.js ./demo/canvas-022.js ./demo/canvas-023.js ./demo/canvas-024.js ./demo/canvas-025.js ./demo/canvas-026.js ./demo/canvas-027.js ./demo/canvas-028.js ./demo/canvas-029.js ./demo/canvas-030.js ./demo/canvas-031.js ./demo/canvas-032.js ./demo/canvas-033.js ./demo/canvas-034.js ./demo/canvas-035.js ./demo/canvas-036.js ./demo/canvas-037.js ./demo/canvas-038.js ./demo/canvas-039.js ./demo/canvas-040.js ./demo/canvas-041.js ./demo/canvas-042.js ./demo/canvas-043.js ./demo/canvas-044.js ./demo/canvas-045.js ./demo/canvas-046.js ./demo/canvas-047.js ./demo/canvas-048.js ./demo/canvas-049.js ./demo/canvas-050.js ./demo/canvas-051.js ./demo/canvas-052.js ./demo/canvas-053.js ./demo/canvas-054.js ./demo/canvas-055.js ./demo/canvas-056.js ./demo/canvas-057.js ./demo/canvas-058.js ./demo/canvas-059.js ./demo/canvas-060.js ./demo/canvas-061.js ./demo/canvas-062.js ./demo/canvas-063.js ./demo/canvas-064.js ./demo/canvas-065.js ./demo/canvas-066.js ./demo/canvas-067.js ./demo/canvas-068.js ./demo/canvas-069.js ./demo/canvas-070.js ./demo/canvas-071.js ./demo/canvas-072.js ./demo/canvas-073.js ./demo/canvas-201.js ./demo/canvas-202.js ./demo/canvas-203.js ./demo/canvas-204.js ./demo/canvas-205.js ./demo/canvas-206.js ./demo/canvas-207.js ./demo/canvas-208.js ./demo/canvas-209.js ./demo/canvas-210.js ./demo/canvas-211.js ./demo/canvas-212.js ./demo/delaunator-001.js ./demo/delaunator-002.js ./demo/dom-001.js ./demo/dom-002.js ./demo/dom-003.js ./demo/dom-004.js ./demo/dom-005.js ./demo/dom-006.js ./demo/dom-007.js ./demo/dom-008.js ./demo/dom-009.js ./demo/dom-010.js ./demo/dom-011.js ./demo/dom-012.js ./demo/dom-013.js ./demo/dom-015.js ./demo/dom-016.js ./demo/dom-017.js ./demo/dom-018.js ./demo/dom-019.js ./demo/dom-020.js ./demo/dom-021.js ./demo/filters-001.js ./demo/filters-002.js ./demo/filters-003.js ./demo/filters-004.js ./demo/filters-005.js ./demo/filters-006.js ./demo/filters-007.js ./demo/filters-008.js ./demo/filters-009.js ./demo/filters-010.js ./demo/filters-011.js ./demo/filters-012.js ./demo/filters-013.js ./demo/filters-014.js ./demo/filters-015.js ./demo/filters-016.js ./demo/filters-017.js ./demo/filters-018.js ./demo/filters-019.js ./demo/filters-020.js ./demo/filters-021.js ./demo/filters-022.js ./demo/filters-023.js ./demo/filters-024.js ./demo/filters-025.js ./demo/filters-026.js ./demo/filters-027.js ./demo/filters-028.js ./demo/filters-029.js ./demo/filters-030.js ./demo/filters-031.js ./demo/filters-032.js ./demo/filters-033.js ./demo/filters-034.js ./demo/filters-035.js ./demo/filters-036.js ./demo/filters-037.js ./demo/filters-038.js ./demo/filters-039.js ./demo/filters-040.js ./demo/filters-041.js ./demo/filters-042.js ./demo/filters-101.js ./demo/filters-102.js ./demo/filters-103.js ./demo/filters-104.js ./demo/filters-105.js ./demo/filters-501.js ./demo/filters-502.js ./demo/filters-503.js ./demo/filters-504.js ./demo/filters-505.js ./demo/mediapipe-001.js ./demo/mediapipe-002.js ./demo/mediapipe-003.js ./demo/modules-001.js ./demo/modules-002.js ./demo/modules-003.js ./demo/modules-004.js ./demo/modules-005.js ./demo/modules-006.js ./demo/packets-001.js ./demo/packets-002.js ./demo/particles-001.js ./demo/particles-002.js ./demo/particles-003.js ./demo/particles-004.js ./demo/particles-005.js ./demo/particles-006.js ./demo/particles-007.js ./demo/particles-008.js ./demo/particles-009.js ./demo/particles-010.js ./demo/particles-011.js ./demo/particles-012.js ./demo/particles-013.js ./demo/particles-014.js ./demo/particles-015.js ./demo/particles-016.js ./demo/particles-017.js ./demo/snippets-001.js ./demo/snippets-002.js ./demo/snippets-003.js ./demo/snippets-004.js ./demo/snippets-005.js ./demo/snippets-006.js ./demo/temp-001.js ./demo/temp-shape-scale-investigation.js ./demo/tensorflow-001.js ./demo/tensorflow-002.js ./demo/utilities.js
  • §

    Demo DOM 003

    Dynamically create and clone Element artefacts; drag and drop elements (including SVG elements) around a Stack

  • §

    Run code

    import * as scrawl from '../source/scrawl.js'
    
    import { reportSpeed } from './utilities.js';
  • §

    Scene setup

    const stack = scrawl.findStack('mystack');
  • §

    Namespacing boilerplate

    const namespace = stack.name;
    const name = (n) => `${namespace}-${n}`;
  • §

    Create a new group to which we can assign the artefacts we want to drag around the stack

    const hitGroup = scrawl.makeGroup({
    
        name: name('my-hit-group'),
        host: stack.name,
    });
  • §

    TODO: we need perspectiveZ (CSS perspective) to be picked up from CSS setting in html file. The code where this is handled is in mixin/dom.js lines 355 onwards. Currently is a known issue (low priority)

    stack.set({
        perspectiveZ: 1200,
        css: {
            overflow: 'hidden',
        },
    });
  • §

    Generate new (DOM) element artefacts and add them to the stack via our new group

    stack.addNewElement({
    
        name: name('basic-square'),
        group: hitGroup,
        tag: 'div',
    
        text: 'Default square <div>',
    
        css: {
            border: '1px solid black',
            padding: '1em',
            textAlign: 'center',
            cursor: 'grab',
  • §

    Test to make sure that SC ignores attempts to set CSS values for top, right, bottom, left

            bottom: '0',
        },
    
    }).clone({
    
        name: name('oval'),
    
        startX: 150,
        startY: 50,
        width: 150,
        height: 'auto',
    
        classes: 'circle',
        text: 'Oval <div> with added class',
    
        css: {
            font: '12px monospace',
            left: '0',
        },
    });
  • §

    Clones will create literal clones of the element they are cloning. Thus cannot clone an element and attempt to change its tag value at the same time.

    stack.addNewElement({
    
        name: name('list'),
        group: name('my-hit-group'),
        tag: 'ul',
    
        width: '25%',
        height: 80,
        startX: 400,
        startY: 120,
        handleX: 'center',
        handleY: 'center',
        roll: 30,
    
        classes: 'red-text',
    
        content: `<li>unordered list</li>
    <li>with several</li>
    <li>bullet points</li>`,
    
        css: {
            font: '12px fantasy',
            paddingInlineStart: '20px',
            paddingTop: '0.5em',
            margin: '0',
            border: '1px solid red',
            cursor: 'grab',
            top: '0',
        },
    
    }).clone({
    
        name: name('list-no-border'),
    
        startY: 250,
        scale: 1.25,
        pitch: 30,
        yaw: 30,
    
        css: {
            border: 0,
            right: '0',
        },
    });
  • §

    Generate more elements - these ones won’t be draggable: instead we will pivot them to the element artefacts generated above

    stack.addNewElement({
    
        name: name('pivot-1'),
        tag: 'div',
    
        width: 12,
        height: 12,
        handleX: 'center',
        handleY: 'center',
    
        pivot: name('basic-square'),
        lockTo: 'pivot',
        order: 1,
    
        css: {
            backgroundColor: 'blue',
            bottom: '0',
        },
    
    }).clone({
    
        name: name('pivot-2'),
        pivot: name('oval'),
    
    }).clone({
    
        name: name('pivot-3'),
        pivot: name('list'),
    
    }).clone({
    
        name: name('pivot-4'),
        pivot: name('list-no-border'),
    });
  • §

    Handle the pre-existing SVG DOM elements that have been automatically imported into the stack

    • SVG elements, because their child elements are effectively instructions on how to draw them, do not play nicely with Scrawl-canvas’s inbuilt drag-and-drop functionality.
    • We can get around this issue in two ways

    Option 1 (simple yet disappointing)

    • Add a new Element to the Stack
    • Set the SVG Element artefact to pivot to the new Element
    stack.addNewElement({
    
        name: name('weather-icon-dragger'),
        tag: 'div',
    
        width: 40,
        height: 40,
    
        startX: 340,
        startY: 360,
        handleX: 'center',
        handleY: 'center',
    
        group: hitGroup.name,
    
        classes: 'circle',
        css: {
            cursor: 'grab',
            border: '5px solid gold',
            backgroundColor: 'darkgray',
        },
    });
    
    scrawl.findElement('weathericon').set({
    
        pivot: name('weather-icon-dragger'),
        lockTo: 'pivot',
        order: 1,
    });
  • §

    Option 2 (more complex yet more pleasing)

    • Add a new <div> Element to the Stack to act as the <svg> DOM element’s parent element
    • Set the SVG Element wrapper’s start attribute to the new Element’s top-left corner
    • Append the <svg> DOM element to the parent DOM element
    • After the first Display cycle has completed, we can remove the SVG Element wrapper from SC
    const simpleSvg = scrawl.findElement('simple-svg'),
        simpleSvgElement = simpleSvg.domElement;
    
    const svgContainer = stack.addNewElement({
    
        name: name('simple-svg-container'),
        tag: 'div',
    
        width: parseInt(simpleSvgElement.getAttribute('width'), 10),
        height: parseInt(simpleSvgElement.getAttribute('height'), 10),
    
        start: [120, 300],
        handle: ['center', 'center'],
    
        group: hitGroup,
    
        pitch: 30,
        yaw: 50,
    
        css: { cursor: 'grab' },
    });
    
    simpleSvg.set({ start: [0, 0] });
    
    svgContainer.domElement.appendChild(simpleSvgElement);
  • §

    User interaction

    Create the drag-and-drop zone

    scrawl.makeDragZone({
    
        zone: stack,
        collisionGroup: hitGroup,
        endOn: ['up', 'leave'],
        preventTouchDefaultWhenDragging: true,
    });
  • §

    Scene animation

    Function to display frames-per-second data, and other information relevant to the demo

    const report = reportSpeed('#reportmessage');
  • §

    Create the Display cycle animation

    scrawl.makeRender({
    
        name: name('animation'),
        target: stack,
        afterShow: report,
    
        afterCreated: () => {
  • §

    The Elements in the Stack don’t know their corner positions, and thus their hit zones (for drag-and-drop), until after the first render. This one-time-run function is enough to get the Elements to perform the necessary recalculations.

            stack.reset();
  • §

    We can also remove the unwanted SVG artefact object from SC at this point.

    • Passing the kill function a false boolean stops SC trying to remove the SVG markup from the DOM
            simpleSvg.kill(false);
        },
    });
  • §

    Development and testing

    console.log(scrawl.library);