1
0
mirror of https://github.com/ianstormtaylor/slate.git synced 2025-02-22 08:02:25 +01:00
slate/site/examples/code-highlighting.tsx
Sergei Dedkov 9635b992a0
Compare only decorations offsets in MemoizedText. Code highlighting example improvements. (#5271)
* add basePath prop to Range inside slate-react custom types, calculate absolute ranges on passing them into TextComponent

* code highlighting example improvements, minor markdown preview refactoring

* changeset added

* Revert "add basePath prop to Range inside slate-react custom types, calculate absolute ranges on passing them into TextComponent"

This reverts commit afa085c289bc67ce3d27dd33b1f074ab8153efe8.

* add basePath prop to Point inside slate-react custom types, resolve relative ranges on passing them to TextComponent

* Update changeset

* linter fixes

* remove redundant checks inside renderElement function

* custom types fixes for Range and Point in examples

* wrap intervals and ranges extractors in useMemo hook for running them only if editor.children is changed

* revert basePath changes, compare only offsets for MemoizedText decorations

* use an element as a key in decorations ranges map instead of id

* simplify code highlighting implementation, make code block nested

* fix code-highlighting example, add toolbar code block button

* remove redundant code

* fix code highlighting playwright integration test
2023-02-09 11:53:21 -07:00

506 lines
11 KiB
TypeScript

import Prism from 'prismjs'
import 'prismjs/components/prism-javascript'
import 'prismjs/components/prism-jsx'
import 'prismjs/components/prism-typescript'
import 'prismjs/components/prism-tsx'
import 'prismjs/components/prism-markdown'
import 'prismjs/components/prism-python'
import 'prismjs/components/prism-php'
import 'prismjs/components/prism-sql'
import 'prismjs/components/prism-java'
import React, { useCallback, useMemo, useState } from 'react'
import {
createEditor,
Node,
Editor,
Range,
Element,
Transforms,
NodeEntry,
} from 'slate'
import {
withReact,
Slate,
Editable,
RenderElementProps,
RenderLeafProps,
useSlate,
ReactEditor,
useSlateStatic,
} from 'slate-react'
import { withHistory } from 'slate-history'
import isHotkey from 'is-hotkey'
import { css } from '@emotion/css'
import { CodeBlockElement } from './custom-types'
import { normalizeTokens } from '../utils/normalize-tokens'
import { Button, Icon, Toolbar } from '../components'
const ParagraphType = 'paragraph'
const CodeBlockType = 'code-block'
const CodeLineType = 'code-line'
const CodeHighlightingExample = () => {
const [editor] = useState(() => withHistory(withReact(createEditor())))
const decorate = useDecorate(editor)
const onKeyDown = useOnKeydown(editor)
return (
<Slate editor={editor} value={initialValue}>
<ExampleToolbar />
<SetNodeToDecorations />
<Editable
decorate={decorate}
renderElement={renderElement}
renderLeaf={renderLeaf}
onKeyDown={onKeyDown}
/>
<style>{prismThemeCss}</style>
</Slate>
)
}
const renderElement = (props: RenderElementProps) => {
const { attributes, children, element } = props
const editor = useSlateStatic()
if (element.type === CodeBlockType) {
const setLanguage = (language: string) => {
const path = ReactEditor.findPath(editor, element)
Transforms.setNodes(editor, { language }, { at: path })
}
return (
<div
{...attributes}
className={css(`
font-family: monospace;
font-size: 16px;
line-height: 20px;
margin-top: 0;
background: rgba(0, 20, 60, .03);
padding: 5px 13px;
`)}
style={{ position: 'relative' }}
spellCheck={false}
>
<LanguageSelect
value={element.language}
onChange={e => setLanguage(e.target.value)}
/>
{children}
</div>
)
}
if (element.type === CodeLineType) {
return (
<div {...attributes} style={{ position: 'relative' }}>
{children}
</div>
)
}
const Tag = editor.isInline(element) ? 'span' : 'div'
return (
<Tag {...attributes} style={{ position: 'relative' }}>
{children}
</Tag>
)
}
const ExampleToolbar = () => {
return (
<Toolbar>
<CodeBlockButton />
</Toolbar>
)
}
const CodeBlockButton = () => {
const editor = useSlateStatic()
const handleClick = () => {
Transforms.wrapNodes(
editor,
{ type: CodeBlockType, language: 'html', children: [] },
{
match: n => Element.isElement(n) && n.type === ParagraphType,
split: true,
}
)
Transforms.setNodes(
editor,
{ type: CodeLineType },
{ match: n => Element.isElement(n) && n.type === ParagraphType }
)
}
return (
<Button
data-test-id="code-block-button"
active
onMouseDown={event => {
event.preventDefault()
handleClick()
}}
>
<Icon>code</Icon>
</Button>
)
}
const renderLeaf = (props: RenderLeafProps) => {
const { attributes, children, leaf } = props
const { text, ...rest } = leaf
return (
<span {...attributes} className={Object.keys(rest).join(' ')}>
{children}
</span>
)
}
const useDecorate = (editor: Editor) => {
return useCallback(([node, path]) => {
if (Element.isElement(node) && node.type === CodeLineType) {
const ranges = editor.nodeToDecorations.get(node) || []
return ranges
}
return []
}, [])
}
const getChildNodeToDecorations = ([block, blockPath]: NodeEntry<
CodeBlockElement
>) => {
const nodeToDecorations = new Map<Element, Range[]>()
const text = block.children.map(line => Node.string(line)).join('\n')
const language = block.language
const tokens = Prism.tokenize(text, Prism.languages[language])
const normalizedTokens = normalizeTokens(tokens) // make tokens flat and grouped by line
const blockChildren = block.children as Element[]
for (let index = 0; index < normalizedTokens.length; index++) {
const tokens = normalizedTokens[index]
const element = blockChildren[index]
if (!nodeToDecorations.has(element)) {
nodeToDecorations.set(element, [])
}
let start = 0
for (const token of tokens) {
const length = token.content.length
if (!length) {
continue
}
const end = start + length
const path = [...blockPath, index, 0]
const range = {
anchor: { path, offset: start },
focus: { path, offset: end },
token: true,
...Object.fromEntries(token.types.map(type => [type, true])),
}
nodeToDecorations.get(element)!.push(range)
start = end
}
}
return nodeToDecorations
}
// precalculate editor.nodeToDecorations map to use it inside decorate function then
const SetNodeToDecorations = () => {
const editor = useSlate()
useMemo(() => {
const blockEntries = Array.from(
Editor.nodes(editor, {
at: [],
mode: 'highest',
match: n => Element.isElement(n) && n.type === CodeBlockType,
})
)
const nodeToDecorations = mergeMaps(
...blockEntries.map(getChildNodeToDecorations)
)
editor.nodeToDecorations = nodeToDecorations
}, [editor.children])
return null
}
const useOnKeydown = (editor: Editor) => {
const onKeyDown: React.KeyboardEventHandler = useCallback(e => {
if (isHotkey('tab', e)) {
// handle tab key, insert spaces
e.preventDefault()
Editor.insertText(editor, ' ')
}
}, [])
return onKeyDown
}
const LanguageSelect = (props: JSX.IntrinsicElements['select']) => {
return (
<select
data-test-id="language-select"
contentEditable={false}
className={css`
position: absolute;
right: 5px;
top: 5px;
z-index: 1;
`}
{...props}
>
<option value="css">CSS</option>
<option value="html">HTML</option>
<option value="java">Java</option>
<option value="javascript">JavaScript</option>
<option value="jsx">JSX</option>
<option value="markdown">Markdown</option>
<option value="php">PHP</option>
<option value="python">Python</option>
<option value="sql">SQL</option>
<option value="tsx">TSX</option>
<option value="typescript">TypeScript</option>
</select>
)
}
const mergeMaps = <K, V>(...maps: Map<K, V>[]) => {
const map = new Map<K, V>()
for (const m of maps) {
for (const item of m) {
map.set(...item)
}
}
return map
}
const toChildren = (content: string) => [{ text: content }]
const toCodeLines = (content: string): Element[] =>
content
.split('\n')
.map(line => ({ type: CodeLineType, children: toChildren(line) }))
const initialValue: Element[] = [
{
type: ParagraphType,
children: toChildren(
"Here's one containing a single paragraph block with some text in it:"
),
},
{
type: CodeBlockType,
language: 'jsx',
children: toCodeLines(`// Add the initial value.
const initialValue = [
{
type: 'paragraph',
children: [{ text: 'A line of text in a paragraph.' }]
}
]
const App = () => {
const [editor] = useState(() => withReact(createEditor()))
return (
<Slate editor={editor} value={initialValue}>
<Editable />
</Slate>
)
}`),
},
{
type: ParagraphType,
children: toChildren(
'If you are using TypeScript, you will also need to extend the Editor with ReactEditor and add annotations as per the documentation on TypeScript. The example below also includes the custom types required for the rest of this example.'
),
},
{
type: CodeBlockType,
language: 'typescript',
children: toCodeLines(`// TypeScript users only add this code
import { BaseEditor, Descendant } from 'slate'
import { ReactEditor } from 'slate-react'
type CustomElement = { type: 'paragraph'; children: CustomText[] }
type CustomText = { text: string }
declare module 'slate' {
interface CustomTypes {
Editor: BaseEditor & ReactEditor
Element: CustomElement
Text: CustomText
}
}`),
},
{
type: ParagraphType,
children: toChildren('There you have it!'),
},
]
// Prismjs theme stored as a string instead of emotion css function.
// It is useful for copy/pasting different themes. Also lets keeping simpler Leaf implementation
// In the real project better to use just css file
const prismThemeCss = `
/**
* prism.js default theme for JavaScript, CSS and HTML
* Based on dabblet (http://dabblet.com)
* @author Lea Verou
*/
code[class*="language-"],
pre[class*="language-"] {
color: black;
background: none;
text-shadow: 0 1px white;
font-family: Consolas, Monaco, 'Andale Mono', 'Ubuntu Mono', monospace;
font-size: 1em;
text-align: left;
white-space: pre;
word-spacing: normal;
word-break: normal;
word-wrap: normal;
line-height: 1.5;
-moz-tab-size: 4;
-o-tab-size: 4;
tab-size: 4;
-webkit-hyphens: none;
-moz-hyphens: none;
-ms-hyphens: none;
hyphens: none;
}
pre[class*="language-"]::-moz-selection, pre[class*="language-"] ::-moz-selection,
code[class*="language-"]::-moz-selection, code[class*="language-"] ::-moz-selection {
text-shadow: none;
background: #b3d4fc;
}
pre[class*="language-"]::selection, pre[class*="language-"] ::selection,
code[class*="language-"]::selection, code[class*="language-"] ::selection {
text-shadow: none;
background: #b3d4fc;
}
@media print {
code[class*="language-"],
pre[class*="language-"] {
text-shadow: none;
}
}
/* Code blocks */
pre[class*="language-"] {
padding: 1em;
margin: .5em 0;
overflow: auto;
}
:not(pre) > code[class*="language-"],
pre[class*="language-"] {
background: #f5f2f0;
}
/* Inline code */
:not(pre) > code[class*="language-"] {
padding: .1em;
border-radius: .3em;
white-space: normal;
}
.token.comment,
.token.prolog,
.token.doctype,
.token.cdata {
color: slategray;
}
.token.punctuation {
color: #999;
}
.token.namespace {
opacity: .7;
}
.token.property,
.token.tag,
.token.boolean,
.token.number,
.token.constant,
.token.symbol,
.token.deleted {
color: #905;
}
.token.selector,
.token.attr-name,
.token.string,
.token.char,
.token.builtin,
.token.inserted {
color: #690;
}
.token.operator,
.token.entity,
.token.url,
.language-css .token.string,
.style .token.string {
color: #9a6e3a;
/* This background color was intended by the author of this theme. */
background: hsla(0, 0%, 100%, .5);
}
.token.atrule,
.token.attr-value,
.token.keyword {
color: #07a;
}
.token.function,
.token.class-name {
color: #DD4A68;
}
.token.regex,
.token.important,
.token.variable {
color: #e90;
}
.token.important,
.token.bold {
font-weight: bold;
}
.token.italic {
font-style: italic;
}
.token.entity {
cursor: help;
}
`
export default CodeHighlightingExample