Manipulate listview as grid layout in Vue Listview component

11 Jun 202424 minutes to read

In Listview, list items can be rendered in grid layout with following data manipulations.

Add Item
Remove Item
Sort Items
Filter Items

Grid Layout

In this section, we will discuss about rendering of list items in grid layout.

Initialize and render ListView with dataSource which will render list items in list layout.

Now, add the below CSS to list item. This will make list items to render in grid layout

 #element .e-list-item {
      height: 100px;
      width: 100px;
      float: left; 
   }

In the below sample, we have rendered List items in grid layout.

Composition API (~/src/App.vue)
Options API (~/src/App.vue)
<template>
  <div id="sample">
    <ejs-listview id='element' :dataSource='data' :template='listTemplate'>
    </ejs-listview>
  </div>
</template>

<script setup>

import { ListViewComponent as EjsListview } from "@syncfusion/ej2-vue-lists";
import { createApp } from "vue";

const app = createApp();
var listVue = app.component("demoTemplate", {
  template: `<img id="listImage" src="https://ej2.syncfusion.com/documentation/code-snippet/listview/grid-layout-cs1/apple.png" alt="apple" />`,
  data() {
    return {
      data: {}
    };
  }
});


const data = [1, 2, 3, 4, 5, 6, 7, 8, 9];
const listTemplate = () => {
  return { template: listVue }
};

</script>
<style>
#element {
  display: block;
  max-width: 303px;
  margin: auto;
  border: 1px solid #dddddd;
  border-radius: 3px;
}

#element .e-list-item {
  height: 100px;
  width: 100px;
  float: left;
  padding: 0;
}

#listImage {
  width: 55px;
  height: 55px;
  margin-left: 20px;
  margin-top: 20px;

}
</style>
<template>
  <div id="sample">
    <ejs-listview id='element' :dataSource='data' :template='listTemplate'>
    </ejs-listview>
  </div>
</template>
<script>

import { ListViewComponent } from "@syncfusion/ej2-vue-lists";
import { createApp } from "vue";

const app = createApp();
var listVue = app.component("demoTemplate", {
  template: `<img id="listImage" src="https://ej2.syncfusion.com/documentation/code-snippet/listview/grid-layout-cs1/apple.png" alt="apple" />`,
  data() {
    return {
      data: {}
    };
  }
});

export default {
  name: "App",
  components: {
    "ejs-listview": ListViewComponent
  },

  data: function () {
    return {
      data: [1, 2, 3, 4, 5, 6, 7, 8, 9],
      listTemplate: function () {
        return { template: listVue }
      },
    };
  }
}
</script>
<style>
#element {
  display: block;
  max-width: 303px;
  margin: auto;
  border: 1px solid #dddddd;
  border-radius: 3px;
}

#element .e-list-item {
  height: 100px;
  width: 100px;
  float: left;
  padding: 0;
}

#listImage {
  width: 55px;
  height: 55px;
  margin-left: 20px;
  margin-top: 20px;

}
</style>

Data manipulation

In this section, we will discuss about ListView data manipulations.

Add Item

We can add list item using addItem API. This will accept array of data as argument.

    this.$refs.listViewInstance.addItem([{text: 'Apricot', id: '32'}]);

In the below sample, you can add new fruit item by clicking add button which will open dialog box with fruit name and image URL text box. After entering the item details, click the add button. This will add your new fruit item.

Remove item

We can remove list item using removeItem API. This will accept fields with id or list item element as argument.

    this.$refs.listViewInstance.removeItem({id: '32'});

In the below sample, you can remove fruit by hovering the fruit item which will show delete button and click that delete button to delete that fruit from your list.

Sort Items

Listview can be sorted either in Ascending or Descending order. To enable sorting in your ListView, set sortOrder as Ascending or Descending.

    <ejs-listview sortOrder='Ascending'></ejs-listview>

We can also set sorting after component initialization.

    this.$refs.listViewInstance.sortOrder = 'Ascending'

In the below sample, we have sorted fruits in Ascending order. To sort it in descending, click on sort order icon and vice versa.

Filter Items

Listview data can be filtered with the help of dataManager. After filtering the data, update ListView dataSource with filtered data.

   let value = this.$refs.textboxEle.value;  //input text box value
   let filteredData = new DataManager(this.listdata).executeLocal(
        new Query().where("text", "startswith", value, true)
   );
   listViewInstance.dataSource = filteredData;

In the below sample, we can filter fruit items with the help of search text box. This will filter fruit items based on your input. Here we used startswith of input text to filter data in DataManager.

Composition API (~/src/App.vue)
Options API (~/src/App.vue)
<template>
    <div id="sample">
      <div class="headerContainer">
        <div class="e-input-group">
          <input id="search" ref='searchEle' class="e-input" type="text" placeholder="Search fruits" @keyup='onKeyUp' />
          <span class="e-input-group-icon e-input-search"></span>
        </div>
        <ejs-button id="sort" class="e-control e-btn e-small e-round e-primary e-icon-btn" v-on:click='sortItems'
          title="Sort fruits" data-ripple="true">
          <span class="e-btn-icon e-icons e-sort-icon-ascending"></span>
        </ejs-button>
        <ejs-button id="add" class="e-control e-btn e-small e-round e-primary e-icon-btn" v-on:click='addItem'
          title="Add fruit" data-ripple="true">
          <span class="e-btn-icon e-icons e-add-icon"></span>
        </ejs-button>
        <ejs-dialog id="dialog" ref='dialogObj' width='300px' :content='content' :visible='visible' header='Add Fruit'
          showCloseIcon='true' :buttons='addButtons'></ejs-dialog>
      </div>
      <ejs-listview id='element' ref='listViewInstance' :dataSource='fruitsdata' :template='listTemplate'
        sortOrder='Ascending' :actionComplete='wireEvents'>
      </ejs-listview>
    </div>
  </template>
  
  <script setup>
  
  import { ListViewComponent as EjsListview } from "@syncfusion/ej2-vue-lists";
  import { DialogComponent as EjsDialog } from '@syncfusion/ej2-vue-popups';
  import { closest, enableRipple } from '@syncfusion/ej2-base';
  import { DataManager, Query } from "@syncfusion/ej2-data";
  import { createApp, ref } from "vue";
  enableRipple(true);
  
  const searchEle = ref(null);
  const dialogObj = ref(null);
  const listViewInstance = ref(null);
  
  var listVue = createApp().component("demo", {
    template: `<div class="fruits"><div class="first"><img id="listImage" :src="data.imgUrl" alt="fruit" /><ejs-button class="delete e-control e-btn e-small e-round e-delete-btn e-primary e-icon-btn" data-ripple="true"><span class="e-btn-icon e-icons delete-icon"></span></ejs-button></div><div class="fruitName"></div></div>`,
    data() {
      return {
        data: {}
      };
    }
  });
  
  var dialogVue = createApp().component("demo", {
    template: `<div id="listDialog"><div class="input_name"><label for="name">Fruit Name: </label><input id="name" class="e-input" type="text" placeholder="Enter fruit name"/></div><div><label for="imgurl">Fruit Image: </label><input id="imgurl" class="e-input" type="text" placeholder="Enter image url"/></div></div>`,
    data() {
      return {
        data: {}
      };
    }
  });
  
  const fruitsdata = [
    { text: "Date", id: "1", imgUrl: "https://ej2.syncfusion.com/documentation/code-snippet/listview/manipulation-cs1/dates.jpg" },
    { text: "Fig", id: "2", imgUrl: "https://ej2.syncfusion.com/documentation/code-snippet/listview/manipulation-cs1/fig.jpg" },
    { text: "Apple", id: "3", imgUrl: "https://ej2.syncfusion.com/documentation/code-snippet/listview/manipulation-cs1/apple.png" },
    { text: "Apricot", id: "4", imgUrl: "https://ej2.syncfusion.com/documentation/code-snippet/listview/manipulation-cs1/apricot.jpg" },
    { text: "Grape", id: "5", imgUrl: "https://ej2.syncfusion.com/documentation/code-snippet/listview/manipulation-cs1/grape.jpg" },
    { text: "Strawberry", id: "6", imgUrl: "https://ej2.syncfusion.com/documentation/code-snippet/listview/manipulation-cs1/strawberry.jpg" },
    { text: "Pineapple", id: "7", imgUrl: "https://ej2.syncfusion.com/documentation/code-snippet/listview/manipulation-cs1/pineapple.jpg" },
    { text: "Melon", id: "8", imgUrl: "https://ej2.syncfusion.com/documentation/code-snippet/listview/manipulation-cs1/melon.jpg" },
    { text: "Lemon", id: "9", imgUrl: "https://ej2.syncfusion.com/documentation/code-snippet/listview/manipulation-cs1/lemon.jpg" },
    { text: "Cherry", id: "10", imgUrl: "https://ej2.syncfusion.com/documentation/code-snippet/listview/manipulation-cs1/cherry.jpg" }
  ];
  const listTemplate = function () {
    return { template: listVue };
  };
  let visible = false;
  const content = () => {
    return { template: dialogVue };
  };
  
  
  const wireEvents = () => {
    Array.prototype.forEach.call(document.getElementsByClassName('e-delete-btn'), (ele) => {
      ele.addEventListener('click', onDeleteBtnClick);
    });
  };
  const addItem = () => {
    (document.getElementById("name")).value = "";
    (document.getElementById("imgurl")).value = "";
    dialogObj.value.show();
  };
  const sortItems = () => {
    let ele = document.getElementById("sort").firstElementChild;
    let des = ele.classList.contains('e-sort-icon-descending') ? true : false;
    if (des) {
      ele.classList.remove('e-sort-icon-descending');
      ele.classList.add('e-sort-icon-ascending');
      listViewInstance.value.sortOrder = 'Ascending';
    } else {
      ele.classList.remove('e-sort-icon-ascending');
      ele.classList.add('e-sort-icon-descending');
      listViewInstance.value.sortOrder = 'Descending'
    }
    listViewInstance.value.dataBind();
    this.wireEvents();
  };
  const onKeyUp = () => {
    let value = searchEle.value;
    let data = new DataManager(this.fruitsdata).executeLocal(
      new Query().where("text", "startswith", value, true)
    );
    if (!value) {
      listViewInstance.value.dataSource = this.fruitsdata.slice();
    } else {
      listViewInstance.value.dataSource = data;
      listViewInstance.value.dataBind();
    }
  };
  const onDeleteBtnClick = function (e) {
    e.stopPropagation();
    let li = closest(e.currentTarget, '.e-list-item');
    let data = listViewInstance.value.findItem(li);
    listViewInstance.value.removeItem(data);
    new DataManager(this.fruitsdata).remove('id', { id: data.id });
  };
  const dlgButtonClick = () => {
    let name = (document.getElementById("name")).value;
    let url = (document.getElementById("imgurl")).value;
    let id = Math.random() * 10000;
    listViewInstance.value.addItem([{ text: name, id: id, imgUrl: url }]);
    this.fruitsdata.push({ text: name, id: id, imgUrl: url });
    listViewInstance.value.$el.ej2_instances[0].element.querySelector('[data-uid="' + id + '"]').getElementsByClassName('e-delete-btn')[0].addEventListener('click', onDeleteBtnClick);
    dialogObj.value.hide();
  };
  const addButtons = [{
    click: dlgButtonClick, buttonModel: { content: 'Add', isPrimary: true }
  }];
  
  </script>
  <style>
  #listImage {
    width: 55px;
    height: 55px;
    margin-left: 25px;
  }
  
  #sample {
    max-width: 440px;
    margin: auto;
    box-shadow: 0 3px 6px lightgray;
  }
  
  .headerContainer {
    height: 48px;
    line-height: 48px;
    background: rgb(2, 120, 215);
    color: white;
    margin-bottom: 3px;
  }
  
  .headerContainer .e-input-group {
    margin-left: 20px;
    width: 200px;
    background: white;
    height: 31px;
  }
  
  .headerContainer #search {
    height: 21px;
    margin-left: 10px;
  }
  
  #listDialog .input_name {
    margin-bottom: 20px;
  }
  
  .headerContainer #add,
  .headerContainer #sort {
    float: right;
    margin-right: 15px;
    margin-top: 7px;
    background: white;
    color: black
  }
  
  .headerContainer .e-input-search::before {
    font-family: 'e-icons';
    content: '\e961';
    margin-top: 3px;
  }
  
  .headerContainer .e-input-group .e-input-group-icon.e-input-search {
    padding: 0 10px 0 10px;
  }
  
  #element .e-list-item {
    height: 110px;
    width: 110px;
    float: left;
    padding: 0;
    position: relative;
    user-select: none;
  }
  
  #element .e-delete-btn {
    float: right;
    visibility: hidden;
    margin-top: -10px;
  }
  
  #element .e-delete-btn.e-btn.e-small.e-round {
    width: 2em;
    height: 2em;
  }
  
  #element .e-btn.e-small.e-round .e-btn-icon.delete-icon {
    font-size: 9px;
  }
  
  #element .e-list-item:hover .e-delete-btn {
    visibility: visible;
    background: red;
    border-radius: 50%;
  }
  
  #element .fruits {
    height: inherit;
    width: inherit;
    padding: 10px 0 10px 0;
  }
  
  #element .fruitName {
    text-align: center;
  }
  
  .headerContainer .e-add-icon::before {
    content: '\e823';
  }
  
  #element .delete-icon::before {
    content: '\e7fc';
    color: white;
  }
  
  .headerContainer .e-sort-icon-ascending::before {
    content: '\e840';
  }
  
  .headerContainer .e-sort-icon-descending::before {
    content: '\e83f';
  }
  
  .e-dialog.e-control.e-popup.e-popup-open {
    max-height: 361px !important;
  }
  </style>
<template>
    <div id="sample">
        <div class="headerContainer">
            <div class="e-input-group">
                <input id="search" ref='searchEle' class="e-input" type="text" placeholder="Search fruits"
                    @keyup='onKeyUp' />
                <span class="e-input-group-icon e-input-search"></span>
            </div>
            <ejs-button id="sort" class="e-control e-btn e-small e-round e-primary e-icon-btn" v-on:click='sortItems'
                title="Sort fruits" data-ripple="true">
                <span class="e-btn-icon e-icons e-sort-icon-ascending"></span>
            </ejs-button>
            <ejs-button id="add" class="e-control e-btn e-small e-round e-primary e-icon-btn" v-on:click='addItem'
                title="Add fruit" data-ripple="true">
                <span class="e-btn-icon e-icons e-add-icon"></span>
            </ejs-button>
            <ejs-dialog id="dialog" ref='dialogObj' width='300px' :content='content' :visible='visible'
                header='Add Fruit' showCloseIcon='true' :buttons='addButtons'></ejs-dialog>
        </div>
        <ejs-listview id='element' ref='listViewInstance' :dataSource='fruitsdata' :template='listTemplate'
            sortOrder='Ascending' :actionComplete='wireEvents'>
        </ejs-listview>
    </div>
</template>
<script>

import { ListViewComponent } from "@syncfusion/ej2-vue-lists";
import { DialogComponent } from '@syncfusion/ej2-vue-popups';
import { closest, enableRipple } from '@syncfusion/ej2-base';
import { DataManager, Query } from "@syncfusion/ej2-data";
import { createApp } from "vue";
enableRipple(true);

var listVue = createApp().component("demo", {
    template: `<div class="fruits"><div class="first"><img id="listImage" :src="data.imgUrl" alt="fruit" /><ejs-button class="delete e-control e-btn e-small e-round e-delete-btn e-primary e-icon-btn" data-ripple="true"><span class="e-btn-icon e-icons delete-icon"></span></ejs-button></div><div class="fruitName"></div></div>`,
    data() {
        return {
            data: {}
        };
    }
});

var dialogVue = createApp().component("demo", {
    template: `<div id="listDialog"><div class="input_name"><label for="name">Fruit Name: </label><input id="name" class="e-input" type="text" placeholder="Enter fruit name"/></div><div><label for="imgurl">Fruit Image: </label><input id="imgurl" class="e-input" type="text" placeholder="Enter image url"/></div></div>`,
    data() {
        return {
            data: {}
        };
    }
});

export default {
    name: "App",
    components: {
        "ejs-dialog": DialogComponent,
        "ejs-listview": ListViewComponent
    },

    data: function () {
        return {
            fruitsdata: [
                { text: "Date", id: "1", imgUrl: "https://ej2.syncfusion.com/documentation/code-snippet/listview/manipulation-cs1/dates.jpg" },
                { text: "Fig", id: "2", imgUrl: "https://ej2.syncfusion.com/documentation/code-snippet/listview/manipulation-cs1/fig.jpg" },
                { text: "Apple", id: "3", imgUrl: "https://ej2.syncfusion.com/documentation/code-snippet/listview/manipulation-cs1/apple.png" },
                { text: "Apricot", id: "4", imgUrl: "https://ej2.syncfusion.com/documentation/code-snippet/listview/manipulation-cs1/apricot.jpg" },
                { text: "Grape", id: "5", imgUrl: "https://ej2.syncfusion.com/documentation/code-snippet/listview/manipulation-cs1/grape.jpg" },
                { text: "Strawberry", id: "6", imgUrl: "https://ej2.syncfusion.com/documentation/code-snippet/listview/manipulation-cs1/strawberry.jpg" },
                { text: "Pineapple", id: "7", imgUrl: "https://ej2.syncfusion.com/documentation/code-snippet/listview/manipulation-cs1/pineapple.jpg" },
                { text: "Melon", id: "8", imgUrl: "https://ej2.syncfusion.com/documentation/code-snippet/listview/manipulation-cs1/melon.jpg" },
                { text: "Lemon", id: "9", imgUrl: "https://ej2.syncfusion.com/documentation/code-snippet/listview/manipulation-cs1/lemon.jpg" },
                { text: "Cherry", id: "10", imgUrl: "https://ej2.syncfusion.com/documentation/code-snippet/listview/manipulation-cs1/cherry.jpg" }
            ],
            listTemplate: function () {
                return { template: listVue };
            },
            visible: false,
            content: function () {
                return { template: dialogVue };
            },
            addButtons: [{
                click: this.dlgButtonClick, buttonModel: { content: 'Add', isPrimary: true }
            }]
        };
    },
    methods: {
        wireEvents: function () {
            Array.prototype.forEach.call(document.getElementsByClassName('e-delete-btn'), (ele) => {
                ele.addEventListener('click', this.onDeleteBtnClick);
            });
        },
        addItem: function () {
            (document.getElementById("name")).value = "";
            (document.getElementById("imgurl")).value = "";
            this.$refs.dialogObj.show();
        },
        sortItems: function () {
            let ele = document.getElementById("sort").firstElementChild;
            let des = ele.classList.contains('e-sort-icon-descending') ? true : false;
            if (des) {
                ele.classList.remove('e-sort-icon-descending');
                ele.classList.add('e-sort-icon-ascending');
                this.$refs.listViewInstance.sortOrder = 'Ascending';
            } else {
                ele.classList.remove('e-sort-icon-ascending');
                ele.classList.add('e-sort-icon-descending');
                this.$refs.listViewInstance.sortOrder = 'Descending'
            }
            this.$refs.listViewInstance.dataBind();
            this.wireEvents();
        },
        onKeyUp: function () {
            let value = this.$refs.searchEle.value;
            let data = new DataManager(this.fruitsdata).executeLocal(
                new Query().where("text", "startswith", value, true)
            );
            if (!value) {
                this.$refs.listViewInstance.dataSource = this.fruitsdata.slice();
            } else {
                this.$refs.listViewInstance.dataSource = data;
                this.$refs.listViewInstance.dataBind();
            }
        },
        onDeleteBtnClick: function (e) {
            e.stopPropagation();
            let li = closest(e.currentTarget, '.e-list-item');
            let data = this.$refs.listViewInstance.findItem(li);
            this.$refs.listViewInstance.removeItem(data);
            new DataManager(this.fruitsdata).remove('id', { id: data.id });
        },
        dlgButtonClick: function () {
            let name = (document.getElementById("name")).value;
            let url = (document.getElementById("imgurl")).value;
            let id = Math.random() * 10000;
            this.$refs.listViewInstance.addItem([{ text: name, id: id, imgUrl: url }]);
            this.fruitsdata.push({ text: name, id: id, imgUrl: url });
            this.$refs.listViewInstance.$el.ej2_instances[0].element.querySelector('[data-uid="' + id + '"]').getElementsByClassName('e-delete-btn')[0].addEventListener('click', this.onDeleteBtnClick);
            this.$refs.dialogObj.hide();
        }
    }
}
</script>
<style>
#listImage {
    width: 55px;
    height: 55px;
    margin-left: 25px;
}

#sample {
    max-width: 440px;
    margin: auto;
    box-shadow: 0 3px 6px lightgray;
}

.headerContainer {
    height: 48px;
    line-height: 48px;
    background: rgb(2, 120, 215);
    color: white;
    margin-bottom: 3px;
}

.headerContainer .e-input-group {
    margin-left: 20px;
    width: 200px;
    background: white;
    height: 31px;
}

.headerContainer #search {
    height: 21px;
    margin-left: 10px;
}

#listDialog .input_name {
    margin-bottom: 20px;
}

.headerContainer #add,
.headerContainer #sort {
    float: right;
    margin-right: 15px;
    margin-top: 7px;
    background: white;
    color: black
}

.headerContainer .e-input-search::before {
    font-family: 'e-icons';
    content: '\e961';
    margin-top: 3px;
}

.headerContainer .e-input-group .e-input-group-icon.e-input-search {
    padding: 0 10px 0 10px;
}

#element .e-list-item {
    height: 110px;
    width: 110px;
    float: left;
    padding: 0;
    position: relative;
    user-select: none;
}

#element .e-delete-btn {
    float: right;
    visibility: hidden;
    margin-top: -10px;
}

#element .e-delete-btn.e-btn.e-small.e-round {
    width: 2em;
    height: 2em;
}

#element .e-btn.e-small.e-round .e-btn-icon.delete-icon {
    font-size: 9px;
}

#element .e-list-item:hover .e-delete-btn {
    visibility: visible;
    background: red;
    border-radius: 50%;
}

#element .fruits {
    height: inherit;
    width: inherit;
    padding: 10px 0 10px 0;
}

#element .fruitName {
    text-align: center;
}

.headerContainer .e-add-icon::before {
    content: '\e823';
}

#element .delete-icon::before {
    content: '\e7fc';
    color: white;
}

.headerContainer .e-sort-icon-ascending::before {
    content: '\e840';
}

.headerContainer .e-sort-icon-descending::before {
    content: '\e83f';
}

.e-dialog.e-control.e-popup.e-popup-open {
    max-height: 361px !important;
}
</style>