Lightweight picture lightbox component
npm install @oblivionocean/litebox一个超轻量级的图片灯箱组件,使用原生JavaScript和CSS实现,无需任何外部依赖。
它提供了丰富的图片查看功能,同时保持极小的代码体积(JS ~5.5KiB + CSS ~2.5KiB, Gzip后JS ~2KiB + CSS ~900B)
- 核心代码仅8KiB, Gzip后2.87KiB (JS ~5.5KiB + CSS ~2.5KiB, Gzip后JS ~2KiB + CSS ~900B)
- 零外部依赖,纯原生实现
- 流畅动画效果
- 图片缩放:支持放大/缩小查看细节
- 翻页浏览:左右箭头切换图片
- 图片旋转:90度旋转功能
- 重置视图:一键恢复原始大小和位置
- 键盘快捷键:支持ESC关闭、方向键翻页等
- 现代化卡片式布局
- 半透明玻璃态控制面板
- 平滑的过渡动画效果
- 直观的图标按钮控制
``html
`
`html`
| 属性 | 说明 |
| --- | --- |
| data-src | 高清晰图片地址,没有高清图片地址时,会自动使用 src 属性作为图片地址 |
| src | 缩略图地址 |
| alt | 图片描述 |
| data-title | 图片标题 |
| data-caption | 图片描述 |
1. 点击任意缩略图打开灯箱
2. 使用控制按钮进行操作:
- ← → 按钮:前后切换图片
- +/- 按钮:放大/缩小图片
- ↻ 按钮:旋转图片
- ↔ 按钮:重置缩放和位置
- × 按钮:关闭灯箱
- ESC:关闭灯箱
- 左右箭头:切换图片
- +/-:放大/缩小图片
- 0:重置缩放
- R:旋转图片
- 使用HTML5
LiteBox支持所有现代浏览器,包括:
- Chrome (最新版)
- Firefox (最新版)
- Safari (最新版)
- Edge (最新版)
对于不支持
欢迎贡献代码和提出改进建议!本项目采用MIT许可证开源。
MIT License - 自由使用、修改和分发代码