@lazycatcloud/vue-media-preview 0.1.2 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -207,3 +207,15 @@ const resolveImageSource = (media, quality, targetWidth) =>
207
207
  组件不管理焦点:打开、关闭及清空列表均不主动聚焦或恢复焦点,不拦截 Tab / Shift+Tab,也不提供自定义焦点框样式。Demo 弹层遵循同一规则。按钮和视频进度条沿用浏览器正常的焦点行为,视频进度条仍支持方向键、Home / End 定位;`keyboardEnabled` 只控制预览快捷键。
208
208
 
209
209
  `goTo(index)` 在会话打开时同步宿主下标;相邻项平滑翻页,跨多项直接定位。列表窗口更新按稳定 ID 保留当前项,仅调整其下标,不取消翻页动画或拖动;页面引用也以媒体 ID 管理。删除当前媒体才重新定位到邻项。`element` 是预览根元素,`canvasElement()` 返回当前图片画布,`mediaElement()` 返回当前解码媒体,`togglePlayback()` 控制视频播放。`ready(index, quality)` 仅报告当前页真实就绪。
210
+
211
+ ### 缩放边界
212
+
213
+ 图片以适应屏幕时的大小作为 1 倍,默认最大缩放为 16 倍;双击仍按画幅选择 2–8 倍。双指越过 1 倍或 16 倍时允许少量阻尼拉伸,松手或取消后平滑回到边界。剩余单指只平移,不会把这次缩放转成翻页或下拉关闭;再次接手回弹时从当前可见大小继续。
214
+
215
+ ### 快速下滑与关闭画面
216
+
217
+ 下滑关闭统一采用屏幕短边 14% 的距离阈值;快速下甩超过 16 CSS 像素且速度超过 0.35 CSS 像素/毫秒也会关闭。打开阶段与打开后的速度采样规则一致,松手前停顿 100 毫秒后不再按轻甩判定。
218
+
219
+ 打开动画期间的单指接触会保留到打开交接完成,再继续跟手下滑;若下滑已达到关闭阈值并提前松手,直接反向收回打开动画。宿主应在 `opening` 和 `open` 阶段允许 `gesturesEnabled`,关闭及其他交互覆盖层仍禁用。
220
+
221
+ 关闭动画通过 `retainFrame()` 持有像素,清晰图切换、请求取消及渲染器卸载不会提前释放该帧。持有者必须在完成、失败或取消时调用返回值的 `release()`;MediaPreview 统一在 `finally` 中释放。原有 `captureFrame()` 保持即时借用语义,跨异步操作持有画面应使用 `retainFrame()`。独立视频、实况合成帧和普通图片采用同一个帧持有协议。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lazycatcloud/vue-media-preview",
3
- "version": "0.1.2",
3
+ "version": "0.1.3",
4
4
  "description": "Vue 3 canvas media preview with shared element transitions, gestures, and virtual paging.",
5
5
  "private": false,
6
6
  "type": "module",