Blazor中实现“滚动到顶部”需通过JS Interop调用window.scrollTo或scrollIntoView方法:在JS中定义scrollToTop函数,C#中注入IJSRuntime并调用;也可滚动到指定元素ID;路由跳转后需监听LocationChanged事件自动触发。

在 Blazor 中实现“滚动到顶部”功能很简单,核心是调用浏览器原生的 scrollTo 或 scrollIntoView 方法,通过 JS Interop 从 C# 触发。
使用 JS Interop 调用 window.scrollTo
这是最直接、兼容性最好的方式。先在 wwwroot/js/site.js(或任意 JS 文件)中添加一个滚动函数:
window.scrollToTop = () => {
window.scrollTo({ top: 0, behavior: 'smooth' });
};然后在 Blazor 组件(如 .razor 文件)中注入 IJSRuntime 并调用:
@inject IJSRuntime JSRuntime@code { private async Task OnClickScrollToTop() { await JSRuntime.InvokeVoidAsync("scrollToTop"); } }
在按钮或链接中使用:
滚动到某个元素(如页面顶部的 div)
如果希望滚动到特定元素(比如一个带 id="top" 的容器),可以这样写:
JS 端定义:
window.scrollToElement = (elementId) => {
const el = document.getElementById(elementId);
if (el) {
el.scrollIntoView({ behavior: 'smooth' });
}
};C# 端调用:
await JSRuntime.InvokeVoidAsync("scrollToElement", "top");自动在导航后滚动到顶部(SPA 路由场景)
Blazor WebAssembly 或 Server 的路由跳转不会自动滚回顶部,需监听导航事件:
- 在
App.razor或根组件中注入NavigationManager - 订阅
LocationChanged事件,在每次导航后触发滚动 - 注意避免重复注册,建议在
OnInitialized注册,Dispose解绑
示例代码片段:
@inject NavigationManager Navigation @implements IDisposable@code { protected override void OnInitialized() => Navigation.LocationChanged += OnLocationChanged;
private async void OnLocationChanged(object? sender, LocationChangedEventArgs e) => await JSRuntime.InvokeVoidAsync("scrollToTop"); public void Dispose() => Navigation.LocationChanged -= OnLocationChanged;}
注意事项
- 确保 JS 函数在页面加载完成后再调用,Blazor 通常已满足此条件
-
behavior: 'smooth'在部分旧浏览器中不支持,可降级为'auto' - Server 渲染模式下,JS Interop 需等待连接建立,建议加
try/catch或判断JSRuntime是否可用 - 若使用第三方布局组件(如 MudBlazor、AntDesign),部分已内置
ScrollToTop按钮,可直接启用
基本上就这些。不需要额外库,几行 JS + 几行 C# 就能搞定。










