Template Support

10 Aug 20174 minutes to read

By default you can add any text or image to the DropDownList list item. To customize the items layout or to create your own visualized elements you can use this template support.

Header Template

You can create the popup header by using headerTemplate property. You can add any HTML content in header template.


Refer the check all option in popup list : link

Template Field

Create a set of div containers with common syntax or elements and assign it to the template property. You can add any HTML mark-up element inside the DropDownList list using this property.

In the demo, a JSON array is created with text, imgId, role and country which is initialized with dataSource property. Content template is created by using the corresponding fields and assigned in template property. The content template is customized with images and custom CSS styles to visualize the items in popup.

  • HTML
  • <input type="text" id="dropdown1" />
  • CSS
  • .imgId {
            margin: 0;
            padding: 3px 10px 3px 3px;
            border: 0 none;
            width: 60px;
            height: 60px;
            float: left;
        .e-header {
            font-weight: bold;
            border-bottom: 1px solid #c8c8c8;
            background: #c8c8c8;
        .e-header > span {
            display: inline-block;
            padding: 10px;
        .ename {
            font-weight: bold;
            padding: 6px 3px 1px 3px;
        .role, .cont {
            font-size: smaller;
            padding: 3px 3px -1px 0px;
  • var List = [{
            text: "Erik Linden",
            imgId: "3",
            role: "Representative",
            country: "England"
        }, {
            text: "John Linden",
            imgId: "6",
            role: "Representative",
            country: "Norway"
        }, {
            text: "Louis",
            imgId: "7",
            role: "Representative",
            country: "Australia"
        }, {
            text: "Lawrence",
            imgId: "8",
            role: "Representative",
            country: "India"
        $(function() {
                width: 200,
                dataSource: List,
                headerTemplate: "<div class='e-header'><span>PHOTO</span> <span>DETAILS</span></div>",
                template: '<div><img class="imgId" src="Employee/${imgId}.png" alt="employee"/>' + '<div class="ename"> ${text} </div><div class="role"> ${role} </div><div class="cont"> ${country} </div></div>'


    Images for this sample are available in (installed location)\Syncfusion\Essential Studio\24.2.3\JavaScript\samples\web\themes\images


    Showing custom selected valued in the input field of DropDownList : link