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" />