Skip to main content
twblazor
Home
  • Get started
  • Tailwind with Blazor
  • Why twblazor?
  • Theme
  • Class Merge
    • Configuring localization
    • RTL Provider
  • Breadcrumb
  • Card
  • Carousel
  • Collapse
  • Footer
  • MenuNew
  • Navbar
  • On This PageNew
  • Sidebar
  • Stepper
  • Tabs
  • Tree List
  • Button
  • Checkbox
  • Color Picker
    • Date
    • Date Range
    • Datetime
    • Datetime Range
    • Time
    • Time Range
  • File Upload
  • NumericNew
  • Radio Button
  • RatingNew
  • Select
  • Slider
  • Switch
  • Textfield
  • Alert
  • Avatar
  • Chip
  • Icon
  • Progress
  • Skeleton
  • Spinner
  • TooltipNew
  • Data Table
  • Pagination
  • Pick List
  • BarcodeNew
  • QR CodeNew
  • CalendarNew
  • Table
  • Overview
  • Area
  • Bar
  • Box Plot
  • Bullet
  • Bump
  • Candlestick
  • Column
  • Dot Plot
  • Dumbbell
  • Funnel
  • Gantt
  • Gauge
  • Heatmap
  • Histogram
  • Icon
  • Line
  • Lollipop
  • Matrix
  • Nightingale
  • Parallel Coordinates
  • Pie
  • Quadrant
  • Radar
  • Radial Bar
  • Range
  • Scatter
  • Slope
  • Small Multiples
  • Strip Plot
  • Treemap
  • Waffle
  • Waterfall
  • Arc Diagram
  • Barcode
  • Beeswarm
  • Bump Area
  • Categorical Scatter
  • Chord Diagram
  • Circular Treemap
  • Contour
  • Convex Treemap
  • Density Plot
  • Dendrogram
  • Euler Diagram
  • Flowchart
  • Hexagonal Binning
  • Horizon
  • Marimekko
  • Network Diagram
  • Radial Histogram
  • Ridgeline
  • Sankey
  • Stream Graph
  • Sunburst
  • Venn Diagram
  • Violin Plot
  • Word Cloud
  • Dialog Service
  • Toast Service
API DocumentationAI Agents & Skills
Home Get Started

Charts

TwWaterfallChart

TwWaterfallChart is a Blazor waterfall chart: floating columns that show how increases and decreases build up to a total.

Last updated 18 October 2026

Please be aware this component is new, may have bugs and/or be subject to change. Please report any bugs at https://github.com/twblazor/twblazor/issues.

Basic usage

TwWaterfallChart shows how a series of changes builds up to a result. Each ChartValue in Data is a change, positive or negative, and each column floats from where the previous one ended. A total column is added for you. Direction is shown by color and named in the legend and tooltips, so it never depends on color alone.
Profit bridgeThousands of pounds
  • Increase
  • Decrease
  • Total
0200400600800
0200400600800
SalesIncrease +520Total 520
ServicesIncrease +140Total 660
Cost of goodsDecrease -210Total 450
SalariesDecrease -180Total 270
MarketingDecrease -60Total 210
TotalTotal 210
SalesServicesCost of goodsSalariesMarketingTotal
RAZOR
<TwChart Title="Profit bridge" Description="Thousands of pounds">
    <TwWaterfallChart Data="@_bridge" />
</TwChart>
CSHARP
@code {
    private readonly ChartValue[] _bridge =
    [
        new("Sales", 520),
        new("Services", 140),
        new("Cost of goods", -210),
        new("Salaries", -180),
        new("Marketing", -60)
    ];
}

Value labels

Set ShowValues to label each column with its signed change.
Profit bridge
  • Increase
  • Decrease
  • Total
0200400600800
0200400600800
+520
+140
-210
-180
-60
SalesIncrease +520Total 520
ServicesIncrease +140Total 660
Cost of goodsDecrease -210Total 450
SalariesDecrease -180Total 270
MarketingDecrease -60Total 210
TotalTotal 210
SalesServicesCost of goodsSalariesMarketingTotal
RAZOR
<TwChart Title="Profit bridge">
    <TwWaterfallChart Data="@_bridge" ShowValues="true" />
</TwChart>

Total and labels

Set ShowTotal to false to leave out the final column. TotalLabel, IncreaseLabel and DecreaseLabel rename the legend entries.
Profit bridge
  • Income
  • Cost
  • Profit
0200400600800
0200400600800
SalesIncome +520Profit 520
ServicesIncome +140Profit 660
Cost of goodsCost -210Profit 450
SalariesCost -180Profit 270
MarketingCost -60Profit 210
ProfitProfit 210
SalesServicesCost of goodsSalariesMarketingProfit
RAZOR
<TwChart Title="Profit bridge">
    <TwWaterfallChart Data="@_bridge" TotalLabel="Profit" IncreaseLabel="Income" DecreaseLabel="Cost" />
</TwChart>

Summary

Tooltips and the table view give the change at each step. Tooltips also give the running total.

Shared features

The legend, tooltips, keyboard navigation, table view, value formatting, height and empty state work the same on every chart. See TwChart for those options.

Keyboard navigation

The plot is a single Tab stop. Each data point is announced with its series and value as focus reaches it, and the table view presents the same data without the plot.
Key What it does
Tab Moves focus into the plot, onto the data point last visited.
Arrow Right or Arrow Down Moves to the next data point.
Arrow Left or Arrow Up Moves to the previous data point.
Home or End Moves to the first or last data point.
Escape Hides the tooltip of the focused data point.
Enter or Space On a legend item: shows or hides that series. On the table button: switches between the chart and its data table.

On this page

  • Basic usage
  • Value labels
  • Total and labels
  • Summary
  • Shared features
  • Keyboard navigation
Discord (opens in a new tab) • GitHub (opens in a new tab) • Documentation (opens in a new tab) • MIT License (opens in a new tab) • llms.txt (opens in a new tab)

twblazor is and always will be free and open source.

An unhandled error has occurred. Reload