跳到主要内容

尺寸预设

可用预设​

html2png 包含常用的视口尺寸预设，可快速配置。

预设宽度高度描述
mobile375667移动设备（iPhone SE）
tablet7681024平板设备（iPad）
laptop1366768笔记本屏幕
desktop / 1080p19201080桌面显示器（全高清）
2k256014402K 显示器（QHD）
4k384021604K 显示器（UHD）

用法​

CLI​

# 使用预设
html2png convert page.html --size mobile

# 覆盖一个维度
html2png convert page.html --size desktop --width 2560

Python API​

import html2png

# API 不直接支持预设
# 使用显式维度代替
html2png.render("page.html", "output.png",
                width=375, height=667)  # mobile

自定义尺寸​

可以使用 WxH 格式或单独选项指定自定义尺寸。

CLI​

# WxH 格式
html2png convert page.html --size 2560x1440

# 分开指定
html2png convert page.html --width 2560 --height 1440

Python API​

html2png.render("page.html", "output.png",
                width=2560, height=1440)

常见用例​

社交媒体卡片​

# Twitter/Facebook: 1200 x 630
html2png convert card.html --width 1200 --height 630 --dpr 2

# Instagram Post: 1080 x 1080
html2png convert card.html --width 1080 --height 1080 --dpr 2

文档截图​

# 全高清截图
html2png convert docs.html --size desktop --dpr 2

移动端预览​

# iPhone 预览
html2png convert page.html --size mobile --dpr 2

# 平板预览
html2png convert page.html --size tablet --dpr 2

DPR 推荐​

用例推荐 DPR
网页展示2.0 - 3.0
打印/高分辨率3.0 - 4.0
标准质量1.0 - 2.0
快速预览1.0