blazor server 默认不支持 url 片段（如 `#section2`）自动滚动至对应 id 元素，因为组件渲染异步发生，浏览器原生锚点行为在初始 dom 加载时失效；需结合 javascript 与 `navigationmanager` 监听路由变化，手动触发 `scrollintoview`。
在 Blazor Server 应用中，直接使用 或
解决此问题的核心思路是：在路由位置变更（包括哈希变化）且组件完成渲染后，主动提取 URL 中的 fragment（即 #xxx 部分），通过 JSRuntime 调用 JavaScript 方法查找并平滑滚动到对应 ID 元素。
✅ 推荐实现方案
1. 创建可复用的 AnchorNavigation.razor 组件
将以下代码保存为 Components/AnchorNavigation.razor：
@inject IJSRuntime JSRuntime
@inject NavigationManager NavigationManager
@implements IDisposable
@code {
protected override void OnInitialized()
{
NavigationManager.LocationChanged += OnLocationChanged;
}
protected override async Task OnAfterRenderAsync(bool firstRender)
{
await ScrollToFragment();
}
public void Dispose()
{
NavigationManager.LocationChanged -= OnLocationChanged;
}
private async void OnLocationChanged(object sender, LocationChangedEventArgs e)
{
await ScrollToFragment();
}
private async Task ScrollToFragment()
{
var uri = new Uri(NavigationManager.Uri, UriKind.Absolute);
var fragment = uri.Fragment;
if (fragment.StartsWith('#'))
{
// 兼容文本片段（Text Fragments API，如 #target:~:text=xxx）
var elementId = fragment.Substring(1);
var textFragmentIndex = elementId.IndexOf(":~:", StringComparison.Ordinal);
if (textFragmentIndex > 0)
elementId = elementId.Substring(0, textFragmentIndex);
if (!string.IsNullOrWhiteSpace(elementId))
await JSRuntime.InvokeVoidAsync("BlazorScrollToId", elementId);
}
}
}✅ 优势：组件自动订阅路由事件、自动清理资源（IDisposable）、兼容 Text Fragments API、仅在必要时执行滚动。
2. 注册全局 JavaScript 函数
在 _Host.cshtml（Server）或 index.html（WASM）的
中、⚠️ 关键注意：必须置于 Blazor 脚本之前，否则 BlazorScrollToId 在 JSRuntime 调用时未定义。
3. 在页面或布局中使用
- 方式一（局部启用）：在需要锚点跳转的 .razor 页面底部添加：
- 方式二（全局启用）：将其放入 Shared/MainLayout.razor 的 @Body 后方，使所有使用该布局的页面自动支持锚点导航。
4. 页面内正确标记锚点
确保目标元素具有 id 属性（不可用 name），例如：
第二节：核心功能说明
这里是详细内容...
? 补充说明与最佳实践
- NavLink 不适用片段导航：
专为路由导航设计，会触发完整页面级导航（即使 href 是 #xxx），应始终使用普通 标签。 - 性能优化：OnAfterRenderAsync 中调用 ScrollToFragment() 确保 DOM 已就绪；firstRender 参数无需特殊处理，因 fragment 变化总会触发重渲染。
- 无障碍支持：scrollIntoView({ block: "start" }) 保证元素顶部对齐视口，符合 WCAG 推荐；smooth 行为提升用户体验（现代浏览器均支持）。
- 调试技巧：若滚动失败，检查浏览器控制台是否报错 BlazorScrollToId is not defined（JS 位置错误），或 getElementById returned null（ID 拼写/大小写不一致、组件条件渲染未触发）。
通过以上三步集成，即可在 Blazor Server 中稳定、优雅地实现原生体验的锚点导航，无需第三方库，完全可控且轻量。
