Marionette Component

Re-usable encapsulated views for your MarionetteJS Application Marionette 3.x & Backbone.Radio 2.x required.

Installation

npm i --save @jakejarrett/marionette-component

Dependencies

• Backbone v1.3.3
• Backbone.Radio v2.0.0+
• Backbone.Marionette v3.0.0+

Usage

Using Webpack 2 with html-loader, sass-loader & css-loader

Importing

import { Component, on } from "@jakejarrett/marionette-component";
import Template from "./index.html"; // Optional, You can inline the HTML too.
import Styles from "!css-loader?modules!sass-loader!./style.scss"; // Optional, can also inline styles

Creating a component

Currently only supports ES6 class syntax

// Extend the Component object
class DemoComponent extends Component {

    /**
     * Setup our component.
     */
    constructor (elementName, props, /* Optional */ { disableShadowDOM: true }) {
        /** Initialize component **/
        super(elementName);

        // you can setup state etc here.

        // Call render
        this.render(elementName, props);

        // Return the element
        return this.element;
    }

    /**
     * The render method, we'll define what is being rendered onto the dom here.
     */
    render (elementName, props) {
        /**
         * Assume that we're pre-filling the elements with this object.
         */
        let data = {
            elements: {
                input: {
                    placeholder: props.input.placeholder
                },
                textarea: {
                    value: props.textarea.value
                }
            }
        };

         const renderedTemplate = _.template(Template)(data);

        this.renderComponent(elementName, renderedTemplate, Styles);
    }

    /** Custom annotation - This hooks into this.events (You have to support compiling annotations) **/
    @on("change input")
    onInputValueChange (event) {
        // Log out the new value
        console.log(event.path[0].value);
    }
}

/**
 *  Export the Component
 *
 * @exports DemoComponent
 */
export default DemoComponent;