UPGRADE.md

3.0.0

Upgrade a class components with initialize method

Before

export default class {
    initialize(el, options) {
        this.text = options.text;
        el.onclick = this.say;
    }

    say() {
        alert(this.text);
    }
}

After

export default class {
    constructor(el, options) {
        this.text = options.text;
        el.onclick = this.say;
    }

    say() {
        alert(this.text);
    }
}

Upgrade revealing pattern component with initialize method

Before

module.exports = (function() {
    var test = {};

    test.initialize = function(el, options) {
        test.text = options.text;
        el.onclick = this.say;
    };

    test.say = function() {
        alert(test.text);
    }

    return {
        initialize: test.initialize,
        say: test.say,
    };
});

After

// to a class component

export default class {
    constructor(el, options) {
        test.text = options.text;
        el.onclick = this.say;
    }

    say() {
        alert(this.text);
    }
}

// or to a function component

export default function(el, options) {
    el.onclick = function() {
        alert(options.text);
    };
}

// or to a revealing module compatible component

export default function(el, options) {
    var test = {
        test: options.text,
    };

    test.say = function() {
        alert(test.text);
    }

    el.onclick = test.say;

    return {
        say: test.say,
    };
}

Upgrade object components with initialize

Before

module.exports = {
    initialize: function(el, options) {
        this.text = options.text;
        el.onclick = this.say;
    },

    say: function() {
        alert(this.text);
    },
};

After

export default class {
    constructor(el, options) {
        test.text = options.text;
        el.onclick = this.say;
    }

    say() {
        alert(this.text);
    }
}

2.0.0

jQuery removed from web component

Web component initialize method will not longer get a jQuery Element instead it will get a basic javascript HTMLElement. This allows to use web-js without jQuery and detect which components really need jQuery as there dependency.

Before

initialize($el) {

}

// or

initialize($el, options) {

}

After

initialize(el) {
    var $el = el;
}

// or

initialize($el, options) {
    var $el = el;
}

Api service dataType changed

The api service will now use json dataType instead of html. So if HTML should be returned, you should use $.ajax instead.

Multiple call service arguments

Its now possible to provide multiple arguments to a service call for this exist service calls need to be changed.

Before

 web.callServices([{name: 'service', func: 'method', args: 'argument'}])

or when using web component twig extension:

{{ call_service('service', 'method', 'argument') }}

After

 web.callServices([{name: 'service', func: 'method', args: ['argument']}])

or when using twig:

{{ call_service('service', 'method', ['argument']) }}

Folder renamed

The src folder has been renamed to js so you need to ugprade your imports.

Before

var Expand = require('massive-web/src/components/expand');
import ContainerLink from  'massive-web/src/components/expand';

After

var Expand = require('massive-web/js/components/expand');
import ContainerLink from  'massive-web/js/components/expand';