Nobody Publish Monsters

    vue-colcade

    1.2.4 • Public • Published

    📐 Vue Colcade

    Lightweight masonry layout thanks to Vuejs

    Travis (.org) David NpmLicense

    A small wrapper for integrating Colcade to Vuejs.

    Vue.js plugin accessible globally from any component to run multiple colcade grid instances. Let's interact with differents grids throughout differents components. This plugin needs you to use the basic Colcade configuration usage.




    Install

      npm install vue-colcade
      yarn add vue-colcade

    Import vue-colcade.js in the main project file

      import Vue from 'vue';
      import VueColcade from 'vue-colcade';
     
      Vue.use(VueColcade);

    Usage

    In your Vue.js components, to create a new grid, simply use:

     
      this.$colcade.create({
          name: 'myGridName',  // name of colcade instance -> will be used as a reference for grid instance
          el: myGridElement,  // element that hosts the grid -> as mentioned in Colcade config
          config: {  // native Colcade configuration -> as mentioned in Colcade config
            columns: '.grid-col',
            items: '.grid-item',
          },
        });

    That grid is accessible across all components by using the new global vue property: $colcade. So you can create as many grids as you want, referencing them by their name. Every future modifications thanks to vue-colcade must referred the name of the instance in order to affect it. As an exemple, if you create an instance with myGridName as name, you can update it with the following method: this.$colcade.update('myGridName').

    Methods

    vue-colcade offers following methods:

    • create - this.$colcade.create({}) - Create a new instance of Colcade grid -> see usage above
    • destroy - this.$colcade.destroy('myGridName') - Destroy an instance of Colcade grid
    • update - this.$colcade.update('myGridName') - Update grid items (after changing order, removing items...)
    • append - this.$colcade.myGridName.append(items) - Add items to the end of layout
    • prepend - this.$colcade.myGridName.prepend(items) - Add items to the beginning of layout

    As exemple, in order to destroy a grid, just call: this.$colcade.destroy('myGridName').

    Then, if you need to update items values inside a colcade grid, you may call the following property in order to force Colcade to refresh itself: this.$colcade.update('myGridName').

    And, all native colcade methods are still accessibles :

      this.$colcade.myGridName.append();
      this.$colcade.myGridName.prepend();
      this.$colcade.myGridName.destroy(); // be carefull, that doesn't destroy the myGridName instance but only the Colcade grid

    By Alexis Colin, thanks to Colcade by David DeSandro

    Licence

    MIT License.

    Install

    npm i vue-colcade

    DownloadsWeekly Downloads

    12

    Version

    1.2.4

    License

    MIT

    Unpacked Size

    116 kB

    Total Files

    9

    Last publish

    Collaborators

    • alexiscolin