README.zh-CN.md

modern-screenshot

使用 HTML5 canvas 和 SVG 从 DOM 节点快速生成图像

Fork from html-to-image

English | 简体中文

📦 安装

npm i modern-screenshot

🦄 使用

import { domToPng } from 'modern-screenshot'

domToPng(document.querySelector('#app')).then(dataUrl => {
  const link = document.createElement('a')
  link.download = 'screenshot.png'
  link.href = dataUrl
  link.click()
})

CDN

<script src="https://unpkg.com/modern-screenshot"></script>
<script>
  modernScreenshot.domToPng(document.querySelector('body')).then(dataUrl => {
    const link = document.createElement('a')
    link.download = 'screenshot.png'
    link.href = dataUrl
    link.click()
  })
</script>

浏览器控制台

⚠️ 由于 CORS 部分嵌入将失败

const script = document.createElement('script')
script.src = "https://unpkg.com/modern-screenshot"
document.getElementsByTagName('head')[0].appendChild(script)

script.onload = () => {
  modernScreenshot
    .domToImage(document.querySelector('body'), {
      debug: true,
      progress: (current, total) => {
        console.log(`${ current }/${ total }`)
      }
    })
    .then(img => {
      const width = 600
      const height = img.height * (width / img.width)
      console.log('%c ', [
        `padding: 0 ${ width / 2 }px;`,
        `line-height: ${ height }px;`,
        `background-image: url('${ img.src }');`,
        `background-size: 100% 100%;`,
      ].join(''))
    })
}

方法

method(node: Node, options?: Options)

DOM 转 dataURL

• domToPng
• domToSvg
• domToJpeg
• domToWebp
• domToDataUrl

DOM 转 data

• domToBlob
• domToPixel

DOM 转 HTMLElement

• domToForeignObjectSvg
• domToImage
• domToCanvas

选项

请查看 options.ts

单例上下文和 web worker

通过重用上下文和 web worker，每秒快速截图

// use vite
import workerUrl from 'modern-screenshot/worker?url'
import { createContext, destroyContext, domToPng } from 'modern-screenshot'

async function screenshotsPerSecond() {
  const context = await createContext(document.querySelector('#app'), {
    workerUrl,
    workerNumber: 1,
  })
  for (let i = 0; i < 10; i++) {
    domToPng(context).then(dataUrl => {
      const link = document.createElement('a')
      link.download = `screenshot-${ i + 1 }.png`
      link.href = dataUrl
      link.click()
      if (i + 1 === 10) {
        destroyContext(context)
      }
    })
    await new Promise(resolve => setTimeout(resolve, 1000))
  }
}

screenshotsPerSecond()

请查看 context.ts

待办事项

• 无法克隆 css 计数器

  content: counter(step);