--- localeCode: en-US order: 55 category: Show title: Highlight icon: doc-highlight dir: column noInline: true brief: highlight specific content --- ## code demo ### How to import Semi support `Highlight` component since v2.24.0 ```jsx import import { Highlight } from '@douyinfe/semi-ui'; ``` ### Basic usage You can specify keywords to be highlighted with `searchWords` and source text with `sourceString` ```jsx live=true dir="column" import React from 'react'; import { Highlight } from '@douyinfe/semi-ui'; () => { const sourceString = 'From Semi Design,To Any Design. Quickly define your design system and apply it to design drafts and code'; const searchWords = ['Any Design', 'Semi Design']; return (

); }; ``` ### Specify highlight style By default, the highlighted text will have its own text style, the text color is black, and the background color is `--semi-yellow-4`. In dark mode, the text color is white, and the background color is `--semi-yellow-2`. When you need to customize different highlight styles, you can specify them through `highlightClassName`, `highlightStyle` ```jsx live=true dir="column" import React from 'react'; import { Highlight } from '@douyinfe/semi-ui'; () => { const sourceString = 'From Semi Design,To Any Design. Quickly define your design system and apply it to design drafts and code'; const searchWords = ['Any Design', 'Semi Design']; return (

); }; ``` ### Specify the highlight tag Semi will wrap the text matching searchWords in sourceString with mark tag by default, you can also re-specify the tag through `component` ```jsx live=true dir="column" import React from 'react'; import { Highlight } from '@douyinfe/semi-ui'; () => { const sourceString = 'From Semi Design,To Any Design. Quickly define your design system and apply it to design drafts and code'; const searchWords = ['Any Design', 'Semi Design']; return (

); }; ``` ## API Reference ### Highlight | property | description | type | default value | | ------------ | ------------------------------------ -------------------- | ----------------------------- --- | ---------- | | searchWords | expected highlighted text | string[] | '' | | sourceString | source text | string | | | component | Highlight label | string | `mark` | | highlightClassName | The style class name of the highlight tag | ReactNode | - | | highlightStyle | Inline style for highlight tags | ReactNode | - | | caseSensitive | Is case sensitive | false | - | | autoEscape | Whether to automatically escape | true | - |