SxHighlighter (文本高亮)

  • Implemented

用于高亮显示文本中匹配特定关键词的部分。对齐 Microsoft Fluent UI Blazor Highlighter (v4.13.2) 的 API 结构,并说明 NextUI 当前实现状态。

使用场景

  • 搜索结果关键词高亮
  • 说明文档重点提示
  • 日志/描述文本匹配

约束说明

  • SearchText 为空时不高亮。
  • Delimiters 会拆分多个关键词进行匹配。

行为说明

  • CaseSensitive 控制大小写匹配规则。
  • UntilFound 为真时仅高亮第一个匹配项。

API

Parameters (参数)

状态 参数名 类型 默认值 描述
Implemented Text string? null 需要进行高亮处理的原始完整文本。
Implemented SearchText string? null 需要高亮的关键词(由 Delimiters 分割)。
Implemented Delimiters string? null 用于分割关键词的分隔符。
Implemented CaseSensitive bool false 是否对大小写敏感。
Implemented HighlightStyle string? null 应用于高亮部分的自定义样式。
Implemented UntilFound bool false 是否只高亮第一个匹配项。
Implemented Id (继承) string? null 组件的物理 Id。
Implemented Class (继承) string? null 自定义 CSS 类名。
Implemented Style (继承) string? null 自定义样式。
Implemented Title (继承) string? null HTML title 属性。
Implemented AdditionalAttributes (继承) IEnumerable<KeyValuePair<string, object>>? null 捕获不匹配的 HTML 属性。

示例

<SxHighlighter Text="NextUI is awesome" SearchText="NextUI" />

参考设计 (References)