shadimage
prosekit
blocklit-example-block-handlesource: ok · hit

lit-example-block-handle

A handle that appears on hover, allowing you to drag and re-order blocks.

npx shadcn add "https://prosekit.dev/r/lit-example-block-handle.json"
free

Interaction

scroll-revealdrag

Tags auto-generated by rules on 9/24/2026 — empty means no evidence, not lack of support.

Dependencies

Bundle weight · light
@lit/contextprosekit@^0.22.2

Registry dependencies

https://unpkg.com/prosekit-registry/dist/r/lit-sample-sample-doc-block-handle.jsonhttps://unpkg.com/prosekit-registry/dist/r/lit-ui-block-handle.jsonhttps://unpkg.com/prosekit-registry/dist/r/lit-ui-code-block-view.jsonhttps://unpkg.com/prosekit-registry/dist/r/lit-ui-drop-indicator.jsonhttps://unpkg.com/prosekit-registry/dist/r/lit-ui-editor-context.json

Files3 · source cached 10/9/2026, 10:18:29 PM

registry/src/lit/examples/block-handle/editor.ts
import 'prosekit/basic/style.css'
import 'prosekit/basic/typography.css'

import { ContextProvider } from '@lit/context'
import { html, LitElement, type PropertyDeclaration, type PropertyValues } from 'lit'
import { createRef, ref, type Ref } from 'lit/directives/ref.js'
import type { Editor, NodeJSON } from 'prosekit/core'
import { createEditor } from 'prosekit/core'

import { sampleContent } from '../../sample/sample-doc-block-handle.ts'
import { registerLitEditorBlockHandle } from '../../ui/block-handle/index.ts'
import { registerLitEditorDropIndicator } from '../../ui/drop-indicator/index.ts'
import { editorContext } from '../../ui/editor-context.ts'

import { defineExtension } from './extension.ts'

export class LitEditor extends LitElement {
  static override properties = {
    initialContent: {
      attribute: false,
    } satisfies PropertyDeclaration<NodeJSON | undefined>,
  }

  initialContent?: NodeJSON

  private editor?: Editor
  private ref: Ref<HTMLDivElement>

  constructor() {
    super()
    this.ref = createRef<HTMLDivElement>()
  }

  override createRenderRoot() {
    return this
  }

  override disconnectedCallback() {
    this.editor?.unmount()
    super.disconnectedCallback()
  }

  override willUpdate() {
    if (this.editor) {
      return
    }

    const extension = defineExtension()
    this.editor = createEditor({
      extension,
      defaultContent: this.initialContent ?? sampleContent,
    })
    new ContextProvider(this, {
      context: editorContext,
      initialValue: this.editor,
    })
  }

  override updated(changedProperties: PropertyValues) {
    super.updated(changedProperties)
    this.editor?.mount(this.ref.value)
  }

  override render() {
    return html`<div class="box-border h-full w-full min-h-36 overflow-y-hidden overflow-x-hidden rounded-md border border-solid border-gray-200 dark:border-gray-700 shadow-sm flex flex-col bg-[canvas] text-black dark:text-white">
      <div class="relative w-full flex-1 box-border overflow-y-auto">
        <div ${ref(this.ref)} class="ProseMirror box-border min-h-full px-[max(4rem,calc(50%-20rem))] py-8 outline-hidden outline-0 [&_span[data-mention=user]]:text-blue-500 [&_span[data-mention=tag]]:text-violet-500"></div>
        <lit-editor-block-handle></lit-editor-block-handle>
        <lit-editor-drop-indicator></lit-editor-drop-indicator>
      </div>
    </div>`
  }
}

export function registerLitEditor() {
  registerLitEditorBlockHandle()
  registerLitEditorDropIndicator()

  if (customElements.get('lit-editor-example-block-handle')) return
  customElements.define('lit-editor-example-block-handle', LitEditor)
}

declare global {
  interface HTMLElementTagNameMap {
    'lit-editor-example-block-handle': LitEditor
  }
}
registry/src/lit/examples/block-handle/extension.ts
import { defineBasicExtension } from 'prosekit/basic'
import { union } from 'prosekit/core'

import { defineCodeBlockView } from '../../ui/code-block-view/index.ts'

export function defineExtension() {
  return union(defineBasicExtension(), defineCodeBlockView())
}

export type EditorExtension = ReturnType<typeof defineExtension>
registry/src/lit/examples/block-handle/index.ts
export { LitEditor as ExampleEditor, registerLitEditor } from './editor.ts'

More from prosekit

Browse all components in this library →