Style and Appearance in Blazor Chips
27 Aug 20268 minutes to read
This section explains how to customize styles, leading icons, avatars, trailing icons, outline chips, and templates in the Blazor Chips component.
Styles
The Blazor Chips component exposes the following predefined style classes that can be applied through the CssClass property.
| Class | Description |
|---|---|
| e-primary | Represents a primary chip. |
| e-success | Represents a positive chip. |
| e-info | Represents an informative chip. |
| e-warning | Represents a chip with caution. |
| e-danger | Represents a negative chip. |
@using Syncfusion.Blazor.Buttons
<SfChip>
<ChipItems>
<ChipItem Text="Default"></ChipItem>
<ChipItem Text="Primary" CssClass="e-primary"></ChipItem>
<ChipItem Text="Success" CssClass="e-success"></ChipItem>
<ChipItem Text="Info" CssClass="e-info"></ChipItem>
<ChipItem Text="Warning" CssClass="e-warning"></ChipItem>
<ChipItem Text="Danger" CssClass="e-danger"></ChipItem>
</ChipItems>
</SfChip>
Leading icon
The leading icon of a chip is added and customized through the LeadingIconCss property.
@using Syncfusion.Blazor.Buttons
<SfChip ID="chip-avatar" EnableDelete="true">
<ChipItems>
<ChipItem Text="Anne" LeadingIconCss="anne"></ChipItem>
<ChipItem Text="Janet" LeadingIconCss="janet"></ChipItem>
<ChipItem Text="Laura" LeadingIconCss="laura"></ChipItem>
<ChipItem Text="Margaret" LeadingIconCss="margaret"></ChipItem>
</ChipItems>
</SfChip>
<style>
#chip-avatar .anne {
background-image: url('https://ej2.syncfusion.com/demos/src/chips/images/anne.png')
}
#chip-avatar .margaret {
background-image: url('https://ej2.syncfusion.com/demos/src/chips/images/margaret.png')
}
#chip-avatar .laura {
background-image: url('https://ej2.syncfusion.com/demos/src/chips/images/laura.png')
}
#chip-avatar .janet {
background-image: url('https://ej2.syncfusion.com/demos/src/chips/images/janet.png')
}
</style>
Avatar
The avatar of a chip is added and customized through the LeadingIconCss property. The avatar layout is defined by the parent e-leading-avatar CSS class, and child icon elements are targeted with the corresponding icon class names.
@using Syncfusion.Blazor.Buttons
<SfChip EnableDelete="true" CssClass="e-leading-avatar">
<ChipItems>
<ChipItem Text="Andrew" LeadingIconCss="andrew"></ChipItem>
<ChipItem Text="Janet" LeadingIconCss="janet"></ChipItem>
<ChipItem Text="Laura" LeadingIconCss="laura"></ChipItem>
<ChipItem Text="Margaret" LeadingIconCss="margaret"></ChipItem>
</ChipItems>
</SfChip>
<style>
.e-leading-avatar .andrew {
background-image: url('https://ej2.syncfusion.com/demos/src/chips/images/andrew.png')
}
.e-leading-avatar .margaret {
background-image: url('https://ej2.syncfusion.com/demos/src/chips/images/margaret.png')
}
.e-leading-avatar .laura {
background-image: url('https://ej2.syncfusion.com/demos/src/chips/images/laura.png')
}
.e-leading-avatar .janet {
background-image: url('https://ej2.syncfusion.com/demos/src/chips/images/janet.png')
}
</style>Leading text
The leading text of a chip is added and customized through the LeadingText property. It is typically used to render an avatar-style initial alongside the chip label.
@using Syncfusion.Blazor.Buttons
<SfChip EnableDelete="true" CssClass="e-leading-avatar">
<ChipItems>
<ChipItem Text="Andrew" LeadingText="A"></ChipItem>
<ChipItem Text="Janet" LeadingText="J"></ChipItem>
<ChipItem Text="Laura" LeadingText="L"></ChipItem>
<ChipItem Text="Margaret" LeadingText="M"></ChipItem>
</ChipItems>
</SfChip>
Trailing icon
The trailing icon of a chip is added and customized through the TrailingIconCss property. The built-in e-dlt-btn class renders the default delete icon; to enable deletion, also set EnableDelete="true" on the SfChip component.
@using Syncfusion.Blazor.Buttons
<SfChip>
<ChipItems>
<ChipItem Text="Andrew" TrailingIconCss="e-dlt-btn"></ChipItem>
<ChipItem Text="Janet" TrailingIconCss="e-dlt-btn"></ChipItem>
<ChipItem Text="Laura" TrailingIconCss="e-dlt-btn"></ChipItem>
<ChipItem Text="Margaret" TrailingIconCss="e-dlt-btn"></ChipItem>
</ChipItems>
</SfChip>
Outline chip
Outline chips have a border with a transparent background. The e-outline class is applied to each ChipItem through the CssClass property.
@using Syncfusion.Blazor.Buttons
<SfChip EnableDelete="true">
<ChipItems>
<ChipItem CssClass="e-outline" Text="Andrew"></ChipItem>
<ChipItem CssClass="e-outline" Text="Janet"></ChipItem>
<ChipItem CssClass="e-outline" Text="Laura"></ChipItem>
<ChipItem CssClass="e-outline" Text="Margaret"></ChipItem>
</ChipItems>
</SfChip>
Template
The Chips Template property allows the layout and design of each chip to be customized. Any custom HTML elements, icons, links, or additional content can be included through the Template property or as direct child content inside the ChipItem of the SfChip component.
The following code example demonstrates how the layout and design of chips can be customized by adding direct child content inside the ChipItem.
@using Syncfusion.Blazor.Buttons
<SfChip ID="customTemplate">
<ChipItems>
<ChipItem LeadingIconCss="trendingIcon">
<a href="https://timesofindia.indiatimes.com/news" target="_blank" aria-label="Breaking News" class="anchorElement">#BreakingNews</a>
<span class="textElement">125k posts</span>
</ChipItem>
<ChipItem LeadingIconCss="cameraIcon">
<a href="https://blog.google/products-and-platforms/products/photos/" target="_blank" aria-label="Photo Of The Day" class="anchorElement">#PhotoOfTheDay</a>
</ChipItem>
<ChipItem LeadingIconCss="trendingIcon">
<a href="https://indianexpress.com/section/technology/" target="_blank" aria-label="Tech News" class="anchorElement">#TechNews</a>
<span class="textElement">107k posts</span>
</ChipItem>
</ChipItems>
</SfChip>
<style>
#customTemplate .e-chip .trendingIcon {
margin: 4px 0 4px 6px;
width: 16px;
height: 16px;
background-image: url("data:image/svg+xml;utf8;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGhlaWdodD0iNDgiIHdpZHRoPSI0OCI+PHBhdGggZD0ibTMyIDEyIDQuNTkgNC41OS05Ljc2IDkuNzUtOC04TDQgMzMuMTcgNi44MyAzNmwxMi0xMiA4IDggMTIuNTgtMTIuNTlMNDQgMjRWMTJ6Ii8+PHBhdGggZD0iTTAgMGg0OHY0OEgweiIgZmlsbD0ibm9uZSIvPjwvc3ZnPg==");
}
#customTemplate .e-chip .cameraIcon {
margin: 4px 0 4px 6px;
width: 16px;
height: 16px;
background-image: url("data:image/svg+xml;utf8;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZD0iTTE5LDYuNUgxNy43MmwtLjMyLTFhMywzLDAsMCwwLTIuODQtMkg5LjQ0QTMsMywwLDAsMCw2LjYsNS41NWwtLjMyLDFINWEzLDMsMCwwLDAtMywzdjhhMywzLDAsMCwwLDMsM0gxOWEzLDMsMCwwLDAsMy0zdi04QTMsMywwLDAsMCwxOSw2LjVabTEsMTFhMSwxLDAsMCwxLTEsMUg1YTEsMSwwLDAsMS0xLTF2LThhMSwxLDAsMCwxLDEtMUg3YTEsMSwwLDAsMCwxLS42OGwuNTQtMS42NGExLDEsMCwwLDEsLjk1LS42OGg1LjEyYTEsMSwwLDAsMSwuOTUuNjhsLjU0LDEuNjRBMSwxLDAsMCwwLDE3LDguNWgyYTEsMSwwLDAsMSwxLDFabS04LTlhNCw0LDAsMSwwLDQsNEE0LDQsMCwwLDAsMTIsOC41Wm0wLDZhMiwyLDAsMSwxLDItMkEyLDIsMCwwLDEsMTIsMTQuNVoiLz48L3N2Zz4=");
}
#customTemplate .e-chip .anchorElement {
margin: 0 4px;
font-weight:600;
height: 16px;
line-height:16px;
font-size: 12px;
color: #0F6CBD;
text-decoration: none;
}
#customTemplate .e-chip .textElement {
font-weight: 400;
height: 14px;
line-height: 14px;
font-size: 10px;
margin-right: 6px;
}
</style>