Tab Control Templates

Feb 02, 2023
3 minutes to read

PageControl supports template technology , allowing you to completely customize the tab header appearance. The look of the tabs can be completely modified by creating a specific template, defining how an element will be rendered by a client browser.

PageControl allows you to create templates for active and inactive tabs. You can apply templates for all tabs within PageControl (using extension level templates) or for a particular tab (using tab level templates). Additionally, you can create templates for a space before tabs and a space after tabs.

The table below lists the members used to create templates.

	Tab level templates	Extension level templates
Active tab content templates	MVCxTab.SetActiveTabTemplateContent	TabControlSettings.SetActiveTabTemplateContent
Inactive tab content templates	MVCxTab.SetTabTemplateContent	TabControlSettings.SetTabTemplateContent
Space before tabs template	-	TabControlSettingsBase.SetSpaceBeforeTabsContent
Space after tabs template	-	TabControlSettingsBase.SetSpaceAfterTabsContent

Note that templates created at a tab level override extension level templates.

Example: Creating Templates (Razor)

This example demonstrates how a template can be defined in a view. The result is shown in the first image in this topic (see it above).

View code - “TemplatesTab.ascx” (Razor):

csharp

<table border="0" cellpadding="0" cellspacing="0">
    <tr>
        <td></td>
        <td style="white-space: nowrap; background-repeat: repeat-x; background-image:url(@Url.Content("~/Content/TabControl/UnSelectedCenter.gif"));">
            <span style="font-family:tahoma; color:#333333; font-size:8pt">
                @((MVCxTabPage)Model)
            </span>
        </td>
        <td></td>
    </tr>
</table>

View code - “TemplatesActiveTab.ascx” (Razor):

csharp

<table border="0" cellpadding="0" cellspacing="0">
    <tr>
        <td></td>
        <td style="white-space: nowrap; background-repeat: repeat-x; background-image:url(@Url.Content("~/Content/TabControl/SelectedCenter.gif"));">
            <span style="font-family:tahoma; color:#333333; font-size:8pt">
                @((MVCxTabPage)Model)
            </span>
        </td>
        <td></td>
    </tr>
</table>

View code (Razor):

csharp

@Html.DevExpress().TabControl(
    settings =>
    {
        settings.Name = "tcTemplates";

        ...

        settings.Tabs.Add("Episode I");
        settings.Tabs.Add("Episode II");
        settings.Tabs.Add("Episode III");
        settings.Tabs.Add("Episode IV");
        settings.Tabs.Add("Episode V");
        settings.Tabs.Add("Episode VI");

        settings.SetActiveTabTemplateContent(c =>
        {
            Html.RenderPartial("TemplatesActiveTab", c.Tab);
        });
        settings.SetTabTemplateContent(c => {
            Html.RenderPartial("TemplatesTab", c.Tab);
        });
        }).GetHtml()

Example: Creating Templates (ASPX)

This example demonstrates how a template can be defined in a view. The result is shown in the first image in this topic (see it above).

View code - “TemplatesTab.ascx” (ASPX):

csharp

<%@ Control Language="C#" Inherits="System.Web.Mvc.ViewUserControl" %>
<table border="0" cellpadding="0" cellspacing="0">
    <tr>
        <td>" width="14px" height="31px"/></td>
        <td style="white-space: nowrap; background-repeat: repeat-x; background-image:url(<%= Url.Content("~/Content/TabControl/UnSelectedCenter.gif") %>);">
            <span style="font-family:tahoma; color:#333333; font-size:8pt">
                <%= ((MVCxTabPage)Model).Text %>
            </span>
        </td>
        <td>" width="14px" height="31px"/></td>
    </tr>
</table>

View code - “TemplatesActiveTab.ascx” (ASPX):

csharp

<%@ Control Language="C#" Inherits="System.Web.Mvc.ViewUserControl" %>
<table border="0" cellpadding="0" cellspacing="0">
    <tr>
        <td>" width="14px" height="32px"/></td>
        <td style="white-space: nowrap; background-repeat: repeat-x; background-image:url(<%= Url.Content("~/Content/TabControl/SelectedCenter.gif") %>);">
            <span style="font-family:tahoma; color:#333333; font-size:8pt">
                <%= ((MVCxTabPage)Model).Text %>
            </span>
        </td>
        <td>" width="14px" height="32px"/></td>
    </tr>
</table>

View code (ASPX):

csharp

<%
    Html.DevExpress().TabControl(
        settings =>
        {
            settings.Name = "tcTemplates";

            ...

            settings.Tabs.Add("Episode I");
            settings.Tabs.Add("Episode II");
            settings.Tabs.Add("Episode III");
            settings.Tabs.Add("Episode IV");
            settings.Tabs.Add("Episode V");
            settings.Tabs.Add("Episode VI");

            settings.SetActiveTabTemplateContent(c =>
                { %>
                    <% Html.RenderPartial("TemplatesActiveTab", c.TabPage); %>
                <%});
                settings.SetTabTemplateContent(c =>
                { %>
                    <% Html.RenderPartial("TemplatesTab", c.TabPage); %>
                <%});
            }).Render();
%>