探索 Tiptap V3 的最新功能

图片扩展

版本下载次数

使用此扩展来渲染 <img> HTML 标签。默认情况下,这些图片是块级元素。如果您想将图像与文本内联渲染,请将 inline 选项设置为 true

无服务器功能

此扩展仅负责显示图像。它不会将图像上传到您的服务器, 对此您可以集成 FileHandler 扩展

安装

npm install @tiptap/extension-image

设置

inline

将图像节点作为内联元素渲染,例如在段落标签中:<p><img src="spacer.gif"></p>。默认情况下,图像与段落处于同一层级。

这完全取决于您希望拥有的编辑体验,但如果您(例如)从 Quill 迁移到 Tiptap,这可能会很有用。

默认值:false

Image.configure({
  inline: true,
})

allowBase64

允许图像被解析为 base64 字符串 <img src="data:image/jpg;base64...">

默认值:false

Image.configure({
  allowBase64: true,
})

HTMLAttributes

应添加到渲染的 HTML 标签中的自定义 HTML 属性。

Image.configure({
  HTMLAttributes: {
    class: 'my-custom-class',
  },
})

命令

setImage()

使当前节点成为一张图片。

editor.commands.setImage({ src: 'https://example.com/foobar.png' })
editor.commands.setImage({
  src: 'https://example.com/foobar.png',
  alt: '一张无聊的示例图片',
  title: '示例',
})

源代码

packages/extension-image/