Skip to main content

Customization

Styling

There is a possibility to make changes in the look and feel of a list. For this you need to take the following steps:

  • add a new CSS class(es) with desired settings in the <style> section of your HTML page or in your file with styles (don't forget to include your file on the page in this case):
<style>
.my-first-class {
/*some styles*/
}

.my-second-class {
/*some styles*/
}
</style>
  • specify the name of the created CSS class (or names of classes separated by spaces) as the value of the css property in the List configuration:
var list = new dhx.List({ 
css:"my-first-class my-second-class"
});

Related sample: List. Custom Styles

Styling items

You can style particular cells in the list.

For example, apply some color to each even item, as in:

var list = new dhx.List("list");
list.data.parse(dataset);

list.data.map(function (item, i) {
if (!(i % 2)) {
list.data.update(item.id, {css: "bg-gray"})
}
})

<style>
.bg-gray {
background: #faf9f9;
}
</style>

Related sample: List. Custom item Styles

Adding custom selection

It is also possible to customize selection of an item.

Related sample: List. Add Custom Selection With Custom Css

<style>
.custom-class {
padding: 20px;
}
.custom-class.dhx_list-item--selected {
background-color: rgba(2, 136, 209, 0.3);
box-shadow: inset 2px 0 0 0 rgb(2, 136, 209),
inset -2px 0 0 0 #0288d1,
inset 0 -2px 0 0 #0288d1,
inset 0 2px 0 0 #0288d1;
}
</style>

var list = new dhx.List("list");
list.data.parse(dataset);

list.data.map(function (item, i) {
list.data.update(item.id, {css: "custom-class"})
});