Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wayou/vscode-todo-highlight
a vscode extension to highlighting todos, fixmes, and any annotations...
https://github.com/wayou/vscode-todo-highlight
annotation-processor todo vscode-extension
Last synced: 4 days ago
JSON representation
a vscode extension to highlighting todos, fixmes, and any annotations...
- Host: GitHub
- URL: https://github.com/wayou/vscode-todo-highlight
- Owner: wayou
- License: mit
- Created: 2016-12-22T13:45:18.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2024-05-30T13:20:54.000Z (5 months ago)
- Last Synced: 2024-10-30T14:55:04.429Z (4 days ago)
- Topics: annotation-processor, todo, vscode-extension
- Language: JavaScript
- Homepage: https://marketplace.visualstudio.com/items?itemName=wayou.vscode-todo-highlight
- Size: 21.3 MB
- Stars: 509
- Watchers: 14
- Forks: 98
- Open Issues: 111
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
README
VSCODE-TODO-HIGHLIGHT
===
[](https://opensource.org/licenses/MIT) [](https://travis-ci.org/wayou/vscode-todo-highlight) [](https://marketplace.visualstudio.com/items?itemName=wayou.vscode-todo-highlight) [](https://marketplace.visualstudio.com/items?itemName=wayou.vscode-todo-highlight) [](https://marketplace.visualstudio.com/items?itemName=wayou.vscode-todo-highlight)
Highlight `TODO`, `FIXME` and other annotations within your code.
Sometimes you forget to review the TODOs you've added while coding before you publish the code to production.
So I've been wanting an extension for a long time that highlights them and reminds me that there are notes or things not done yet.
Hope this extension helps you as well.
*NOTICE*
Many report that the `List highlighted annotations` command is not working, make sure you have the file types included via `todohighlight.include`.
### Preview
- with `material night` color theme:
- with `material night eighties` color theme:
### Config
`TODO:`,`FIXME:` are built-in keywords. You can override the look by customizing the setting.
To customize the keywords and other stuff, command + , (Windows / Linux: File -> Preferences -> User Settings) open the vscode file `settings.json`.
| | type | default | description |
|---|---|---|---|
| todohighlight.isEnable | boolean | true | Toggle the highlight, default is true. |
| todohighlight.isCaseSensitive | boolean | true | Whether the keywords are case sensitive or not. |
| todohighlight.keywords | array | N/A | An array of keywords that will be hilighted. You can also specify the style for each keywords here. See example below for more infomation. |
| todohighlight.keywordsPattern | string | N/A | Specify keywords via RegExp instead of `todohighlight.keywords` one by one. NOTE that if this presents, `todohighlight.keywords` will be ignored. And REMEMBER to escapse the back slash if there's any in your regexp (using \\ instead of signle back slash). |
| todohighlight.defaultStyle | object | N/A | Specify the default style for custom keywords, if not specified, build in default style will be applied. [See all available properties on VSCode doc DecorationRenderOptions section](https://code.visualstudio.com/api/references/vscode-api#DecorationRenderOptions) |
| todohighlight.include | array | [
`"**/*.js"`,
`"**/*.jsx"`,
`"**/*.ts"`,
`"**/*.tsx",`
`"**/*.html"`,
`"**/*.php"`,
`"**/*.css",`
`"**/*.scss"`
] | Glob patterns that defines the files to search for. Only include files you need, DO NOT USE `{**/*.*}` for both permormance and avoiding binary files reason.
For backwards compatability, a string combine all the patterns is also valid `"{**/*.js,**/*.jsx,**/*.ts,**/*.tsx,**/*.html,**/*.php,**/*.css,**/*.scss}"` |
| todohighlight.exclude | array | [
`"**/node_modules/**"`,
`"**/dist/**",`
`"**/bower_components/**"`,
`"**/build/**",`
`"**/.vscode/**"`,
`"**/.github/**"`,
`"**/_output/**"`,
`"**/*.min.*"`,
`"**/*.map"`
] | Glob pattern that defines files and folders to exclude while listing annotations.
For backwards compatability, a string combine all the patterns is also valid `"{**/node_modules/**,**/bower_components/**,**/dist/**,**/build/**,**/.vscode/**,**/_output/**,**/*.min.*,**/*.map}"` |
| todohighlight.maxFilesForSearch | number | 5120 | Max files for searching, mostly you don't need to configure this. |
| todohighlight.toggleURI | boolean | false | If the file path within the output channel not clickable, set this to true to toggle the path patten between `#` and `::`. |
an example of customizing configuration:
```js
{
"todohighlight.isEnable": true,
"todohighlight.isCaseSensitive": true,
"todohighlight.keywords": [
"DEBUG:",
"REVIEW:",
{
"text": "NOTE:",
"color": "#ff0000",
"backgroundColor": "yellow",
"overviewRulerColor": "grey"
},
{
"text": "HACK:",
"color": "#000",
"isWholeLine": false,
},
{
"text": "TODO:",
"color": "red",
"border": "1px solid red",
"borderRadius": "2px", //NOTE: using borderRadius along with `border` or you will see nothing change
"backgroundColor": "rgba(0,0,0,.2)",
//other styling properties goes here ...
}
],
"todohighlight.keywordsPattern": "TODO:|FIXME:|\\(([^)]+)\\)", //highlight `TODO:`,`FIXME:` or content between parentheses
"todohighlight.defaultStyle": {
"color": "red",
"backgroundColor": "#ffab00",
"overviewRulerColor": "#ffab00",
"cursor": "pointer",
"border": "1px solid #eee",
"borderRadius": "2px",
"isWholeLine": true,
//other styling properties goes here ...
},
"todohighlight.include": [
"**/*.js",
"**/*.jsx",
"**/*.ts",
"**/*.tsx",
"**/*.html",
"**/*.php",
"**/*.css",
"**/*.scss"
],
"todohighlight.exclude": [
"**/node_modules/**",
"**/bower_components/**",
"**/dist/**",
"**/build/**",
"**/.vscode/**",
"**/.github/**",
"**/_output/**",
"**/*.min.*",
"**/*.map",
"**/.next/**"
],
"todohighlight.maxFilesForSearch": 5120,
"todohighlight.toggleURI": false
}
```
### Commands
This extension contributes the following commands to the Command palette.
- `Toggle highlight` : turn on/off the highlight
- `List highlighted annotations` : list annotations and reveal from corresponding file
### Known issue
The clickable file pattern within the output channel differs from OS platform(`#` for Mac/Windows and `::` for Linux, for details see this [issue](https://github.com/Microsoft/vscode/issues/586) ).
Basically the extension auto detects the OS platform.
If you find that the file path is not clickable, set `todohighlight.toggleURI` to `true` to toggle the file pattern.