title	page_title	description	slug	position
Getting Started	Getting Started	Make your first steps with the Telerik UI for {{ site.framework }} Badge component by following a complete step-by-step tutorial.	badge_getting_started	1

Getting Started with the Badge

This tutorial explains how to set up a basic Telerik UI for {{ site.framework }} Badge and highlights the major steps in the configuration of the component.

Usually, the Badges are used as labels over buttons and links to provide information about notifications, updates, messages, and more. You will initialize differently styled Badges integrated into the items of a navigation [AppBar]({% slug htmlhelpers_appbar_aspnetcore_overview %}) component. Next, you will learn how to reference the client-side instance of the component and control its behavior by using the available API methods. {% if site.core %}Finally, you can run the sample code in Telerik REPL and continue exploring the components.{% endif %}

@template

1. Prepare the CSHTML File

@template

Optionally, you can structure the View content by adding the desired HTML elements like headings, divs, paragraphs, and others.

    @using Kendo.Mvc.UI

    <h4>Navigation AppBar with Badges</h4>
    <div>

    </div>

{% if site.core %}

    @addTagHelper *, Kendo.Mvc

    <h4>Navigation AppBar with Badges</h4>
    <div>

    </div>

{% endif %}

2. Initialize the Badge

Use the Badge HtmlHelper {% if site.core %}or TagHelper{% endif %} to add the component to a page:

The Name() configuration method is mandatory as its value is used for the id and the name attributes of the Badge element.
The Text() option specifies the content that will be displayed in the Badge. Alternatively, you can display an icon instead of a text by setting the name for an existing icon in the Kendo UI theme or SVG content through the Icon() option.
The Position method lets you define the position of the Badge relative to the edge of the container.
The Align method allows you to set the position of the Badge relative to its container.

    @using Kendo.Mvc.UI

    <span class='k-icon k-i-cart'>
        @(Html.Kendo().Badge()
            .Name("shoppingCartBadge")
            .Text("+10")
            .Position(BadgePosition.Outside)
            .Align(BadgeAlign.TopStart)
        )
    </span>

{% if site.core %}

    @addTagHelper *, Kendo.Mvc

    <span class='k-icon k-i-cart'>
        <kendo-badge name="shoppingCartBadge" 
            text="+10" 
            position="BadgePosition.Outside"
            align="BadgeAlign.TopStart">
        </kendo-badge>
    </span>

{% endif %}

3. Integrate Badges into UI Components

The next step is to create an [AppBar]({% slug htmlhelpers_appbar_aspnetcore_overview %}) component and integrate Badges in its items.

Use the [Template component]({% slug htmlhelpers_overview_template %}) to define an icon and a Badge into the AppBar's items.

    @using Kendo.Mvc.UI

    @(Html.Kendo().AppBar()
        .Name("appbar")
        .ThemeColor(AppBarThemeColor.Dark)
        .HtmlAttributes(new { style = "height: 50px;"})
        .Items(items =>
        {
            items.Add().Template(Html.Kendo().Template()
                .AddHtml("<span class='k-icon k-i-envelop'>")
                .AddComponent(badge => badge
                    .Badge()
                        .Name("messagesBadge")
                        .Text("+2")
                        .Position(BadgePosition.Edge)
                        .Align(BadgeAlign.TopEnd)
                )
                .AddHtml("</span>")
            )
            .Type(AppBarItemType.ContentItem);
            items.Add().Type(AppBarItemType.Spacer).Width("16px");
            items.Add().Template(Html.Kendo().Template()
                .AddHtml("<span class='k-icon k-i-notification'>")
                .AddComponent(badge => badge
                    .Badge()
                        .Name("notificationsBadge")
                        .Text("+5")
                        .Position(BadgePosition.Edge)
                        .Align(BadgeAlign.TopEnd)
                )
                .AddHtml("</span>")
            )
            .Type(AppBarItemType.ContentItem);
            items.Add().Type(AppBarItemType.Spacer).Width("10px");
            items.Add().Template(Html.Kendo().Template()
                .AddComponent(ddb => ddb
                    .DropDownButton()
                        .Name("profileDDB")
                        .FillMode(FillMode.Flat)
                        .Icon("user")
                        .Items(items=>{
                            items.Add().Id("user-profile").Text("Profile").Icon("folder").Click(@<text>function() { alert("Enter Profile") }</text>);
                            items.Add().Id("user-settings").Text("Settings").Icon("gear").Click(@<text>function() { alert("Profile Settings") }</text>);
                            items.Add().Id("user-logout").Text("Log out").Icon("x").Click(@<text>function() { alert("Log out") }</text>);
                        })
                )
            )
            .Type(AppBarItemType.ContentItem);
            items.Add().Type(AppBarItemType.Spacer).Width("10px");
            items.Add().Template(Html.Kendo().Template()
                .AddHtml("<span class='k-icon k-i-cart'>")
                .AddComponent(badge => badge
                    .Badge()
                        .Name("shoppingCartBadge")
                        .Text("+10")
                        .Position(BadgePosition.Outside)
                        .Align(BadgeAlign.TopStart)
                )
                .AddHtml("</span>")
            )
            .Type(AppBarItemType.ContentItem);
            items.Add().Type(AppBarItemType.Spacer);
        })
    )

{% if site.core %}

    @addTagHelper *, Kendo.Mvc

    <kendo-appbar name="appbar" theme-color="AppBarThemeColor.Dark" style="height: 50px;">
        <items>
            <appbar-item type="AppBarItemType.ContentItem">
                <template>
                <span class='k-icon k-i-envelop'>
                    <kendo-badge name="messagesBadge" 
                        text="+2" 
                        position="BadgePosition.Edge"
                        align="BadgeAlign.TopEnd">
                    </kendo-badge>
                </span>
                </template>
            </appbar-item>
            <appbar-item width="16px" type="AppBarItemType.Spacer"></appbar-item>
            <appbar-item type="AppBarItemType.ContentItem">
                <template>
                    <span class='k-icon k-i-notification'>
                        <kendo-badge name="notificationsBadge" 
                            text="+5" 
                            position="BadgePosition.Edge"
                            align="BadgeAlign.TopEnd">
                        </kendo-badge>
                    </span>
                </template>
            </appbar-item>
            <appbar-item width="10px" type="AppBarItemType.Spacer"></appbar-item>
            <appbar-item type="AppBarItemType.ContentItem">
                <template>
                    <kendo-dropdownbutton name="profileDDB" icon="user" fill-mode="FillMode.Flat">
                        <dropdownbutton-items>
                            <item id="user-profile" text="Profile" icon="folder"></item>
                            <item id="user-settings" text="Settings" icon="gear"></item>
                            <item id="user-logout" text="Log out" icon="x"></item>
                        </dropdownbutton-items>
                    </kendo-dropdownbutton>
                </template>
            </appbar-item>
            <appbar-item width="10px" type="AppBarItemType.Spacer"></appbar-item>
            <appbar-item type="AppBarItemType.ContentItem">
                <template>
                    <span class='k-icon k-i-cart'>
                        <kendo-badge name="shoppingCartBadge" 
                            text="+10" 
                            position="BadgePosition.Outside"
                            align="BadgeAlign.TopStart">
                        </kendo-badge>
                    </span>
                </template>
            </appbar-item>
            <appbar-item type="AppBarItemType.Spacer"></appbar-item>
        </items>
    </kendo-appbar>

{% endif %}

The [Button component]({% slug htmlhelpers_button_aspnetcore %}) provides [built-in Badges]({% slug badges_button_aspnetcore %}), so you can use the Badge() configuration of the Button{% if site.core %} HtmlHelper or the badge tag of the Button TagHelper{% endif %} to decorate a button in the AppBar.

    @using Kendo.Mvc.UI

    @(Html.Kendo().AppBar()
        .Name("appbar")
        .ThemeColor(AppBarThemeColor.Dark)
        .HtmlAttributes(new { style = "height: 50px;"})
        .Items(items =>
        {
            items.Add().Template(Html.Kendo().Template()
                .AddComponent(ddb => ddb
                    .Button()
                    .Name("newsBtn")
                    .Content("Home")
                    .Badge(b => b
                        .Position(BadgePosition.Inline)
                        .Icon("home")
                    )
                )
            )
            .Type(AppBarItemType.ContentItem);
        })
    )

{% if site.core %}

    @addTagHelper *, Kendo.Mvc

    <kendo-appbar name="appbar" theme-color="AppBarThemeColor.Dark" style="height: 50px;">
        <items>
            <appbar-item type="AppBarItemType.ContentItem">
                <template>
                    <kendo-button name="newsBtn">
                        <badge
                            icon="home"
                            position="BadgePosition.Inline"/>
                        Home
                    </kendo-button>
                </template>
            </appbar-item>
        </items>
    </kendo-appbar>

{% endif %}

4. Customize the Appearance of the Badge

To alter the appearance of the Badges, use the ThemeColor, FillMode, Rounded, and Size methods{% if site.core %} when using the HtmlHelper version of the component and the theme-color, fill-mode, rounded, and size attributes when using the TagHelper configuration{% endif %}.

    @using Kendo.Mvc.UI

    @(Html.Kendo().AppBar()
        .Name("appbar")
        .ThemeColor(AppBarThemeColor.Dark)
        .HtmlAttributes(new { style = "height: 50px;"})
        .Items(items =>
        {
            items.Add().Template(Html.Kendo().Template()
                .AddHtml("<span class='k-icon k-i-cart'>")
                .AddComponent(badge => badge
                    .Badge()
                        .Name("shoppingCartBadge")
                        .Text("+10")
                        .Position(BadgePosition.Outside)
                        .Align(BadgeAlign.TopStart)
                        .ThemeColor(BadgeColor.Warning)
                        .FillMode(BadgeFill.Solid)
                        .Rounded(Rounded.Medium)
                        .Size(BadgeSize.Small)
                )
                .AddHtml("</span>")
            )
            .Type(AppBarItemType.ContentItem);
        })
    )

{% if site.core %}

    @addTagHelper *, Kendo.Mvc

    <kendo-appbar name="appbar" theme-color="AppBarThemeColor.Dark" style="height: 50px;">
        <items>
            <appbar-item type="AppBarItemType.ContentItem">
                <template>
                    <span class='k-icon k-i-cart'>
                        <kendo-badge name="shoppingCartBadge" 
                            text="+10" 
                            position="BadgePosition.Outside"
                            align="BadgeAlign.TopStart"
                            theme-color="BadgeColor.Warning"
                            fill-mode="BadgeFill.Solid"
                            rounded="Rounded.Medium"
                            size="BadgeSize.Small">
                        </kendo-badge>
                    </span>
                </template>
            </appbar-item>
        </items>
    </kendo-appbar>

{% endif %}

5. (Optional) Reference Existing Badge Instances

You can reference the Badge instances that you have created and build on top of their existing configuration:

Use the Name() option of the component to establish a reference.

    <script>
        $(document).ready(function() {
            var badgeReference = $("#messagesBadge").data("kendoBadge"); // badgeReference is a reference to the existing Badge instance of the helper.
        });
    </script>

Use the Badge client-side API to control the behavior of the widget. In this example, you will use the text method to change the text of the Badge dynamically (for example, when a button is clicked).

    @(Html.Kendo().Button()
        .Name("btn")
        .Content("Update messages Badge")
        .Events(ev => ev.Click("onBtnClick")))

    <script>
        function onBtnClick() {
            var badgeReference = $("#messagesBadge").data("kendoBadge");
            badgeReference.text("+1");
        }
    </script>

{% if site.core %}

    @addTagHelper *, Kendo.Mvc

    <kendo-button name="btn" on-click="onBtnClick">
        Update messages Badge
    </kendo-button>

    <script>
        function onBtnClick() {
            var badgeReference = $("#messagesBadge").data("kendoBadge");
            badgeReference.text("+1");
        }
    </script>

{% endif %}

For more information on referencing specific helper instances, see the [Methods and Events]({% slug methodevents_core %}) article.

{% if site.core %}

Explore this Tutorial in REPL

You can continue experimenting with the code sample above by running it in the Telerik REPL server playground:

Sample code with the Badge HtmlHelper
Sample code with the Badge TagHelper

{% endif %}

Next Steps

[Customizing the Appearance of the Badge]({% slug appearance_badge_aspnetcore %})
[Using the Badge as a Label (Demo)](https://demos.telerik.com/{{ site.platform }}/badge/labels)

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

getting-started.md

getting-started.md

Getting Started with the Badge

1. Prepare the CSHTML File

2. Initialize the Badge

3. Integrate Badges into UI Components

4. Customize the Appearance of the Badge

5. (Optional) Reference Existing Badge Instances

Explore this Tutorial in REPL

Next Steps

See Also

Files

getting-started.md

Latest commit

History

getting-started.md

File metadata and controls

Getting Started with the Badge

1. Prepare the CSHTML File

2. Initialize the Badge

3. Integrate Badges into UI Components

4. Customize the Appearance of the Badge

5. (Optional) Reference Existing Badge Instances

Explore this Tutorial in REPL

Next Steps

See Also