跳到主要内容

文件类型与预览

字节粘贴不仅保存文本,也保存文件。不同文件的预览和输出策略不同。

文本和富文本

纯文本格子显示 text 标记。富文本格子显示 richtext 标记,并生成预览图。富文本会尽量保持字体、颜色、段落和亮暗模式表现。

图片

图片格子显示 image 标记。图片通常只有一套预览图。导出到相册和导出到文件都应该可用。

PDF

PDF 格子显示 pdf 标记。预览通常使用第一页。用户进入编辑界面时,应该看到可上下滑动的完整 PDF 预览,而不是只看到格子缩略图。

Markdown

Markdown 文件显示 md 标记。格子首页使用渲染后的预览图,编辑界面应该使用与 Markdown 编辑页面一致的渲染器。用户可以从文件预览进入 Markdown 编辑器继续编辑原文件。

画布文件

.pkdrawing 文件是 PencilKit 绘图数据。它在格子中应该显示真实预览,而不是通用文件图标。亮暗模式相关的笔迹颜色需要使用同一套语义色处理逻辑,避免 iOS 和 macOS 互相打开后黑白反转。

视频

视频文件显示扩展名,例如 mp4。编辑界面应该显示播放器和首帧封面。用户点击播放后,播放器开始播放实际内容。

任意文件

对于系统可以预览的文件,iOS 可以通过 Quick Look 或自定义预览显示内容。macOS 可以在选中文件格子后按空格打开预览窗口。对于系统无法预览的格式,格子至少应该显示文件名、扩展名、大小和通用图标。