Skip to content

Repository files navigation

CodeBox

Code syntax highlighting tool for Editor.js

Setup

Install the package via NPM

npm i @bomdi/codebox

Add to your module/application

importCodeBoxfrom'@bomdi/codebox';ORconstCodeBox=require('@bomdi/codebox');

Usage

Add CodeBox tools property of the CodeX Editor initial config.

constCodexEditor=require('@editorjs/editorjs');leteditor=newCodexEditor({
...
tools: {
...
codeBox: {class: CodeBox,config: {themeURL: 'https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@9.18.1/build/styles/dracula.min.css',// OptionalthemeName: 'atom-one-dark',// OptionaluseDefaultTheme: 'light'// Optional. This also determines the background color of the language select drop-down}},}
...
});

Config Params

All parameters are optional

FieldTypeDescription
themeURLstringURL pointing to CSS file that can be used by highlight.js. This could also point o your own custom CSS syntax file. If themeURL is provided, themeName and useDefaultTheme will be ignored
themeNamestringAny one of the accepted theme names used by highlight.js. Only the name is required, not the full URL (example "a11y-dark"). If themeName is provided, useDefaultTheme will be ignored
useDefaultThemestringCodeBox has 2 default themes - 1 light and 1 dark. You can specify what default should be applied by passing the string 'light' or 'dark' to this parameter. Note that setting themeURL or themeName overrides this setting for the main code block, however, the background of the language select element/dropdown menu is set by this value

If no parameters are specified, CodeBox defaults to a dark theme.

Output data

CodeBox returns the following data

{
"type": "codeBox",
"data": {
"code": "consttest = newTest();.codeBoxTextArea{\n width: 100%;\n min-height: 30px;\n padding: 10px;\n border-radius: 2px 2px 2px 0;\n border: none !important;\n outline: none !important;\n font: 14px monospace;\n}\n\n.codeBoxSelectDiv{\n display: flex;\n flex-direction: column;\n justify-content: flex-start;\n align-items: flex-start;\n position: relative;\n}",
"language": "css",
"theme": "https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@9.18.1/build/styles/atom-one-dark.min.css"
}
}

Render saved data as component

If you use react, you can pass your saved data to the library editorjs-react-renderer to render a code block component

import{CodeBoxOutput}from'editorjs-react-renderer';constdata={"type": "codeBox","data": {"code": ".codeBoxTextArea{\n width: 100%;\n min-height: 30px;\n padding: 10px;\n border-radius: 2px 2px 2px 0;\n border: none !important;\n outline: none !important;\n font: 14px monospace;\n}\n\n.codeBoxSelectDiv{\n display: flex;\n flex-direction: column;\n justify-content: flex-start;\n align-items: flex-start;\n position: relative;\n}","language": "css","theme": "https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@9.18.1/build/styles/atom-one-dark.min.css"}};constCodeBlock=()=>CodeBoxOutput(data);exportdefaultCodeBlock;

Author

Dev Juju

Contact Us

Learn

About

Code highlighting tool for Editor.js

Resources

Code of conduct

Contributing

Stars

40 stars

Watchers

2 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages