查看
要以只读模式打开文档,请将 editorConfig.mode 设置为 "view"。用户可以阅读文档,但无法修改。
实时查看器与通用查看器
ONLYOFFICE 文档支持文本文档、电子表格、演示文稿和PDF的两种查看模式:
- 实时查看器 — 实时显示正在编辑文档的其他用户所做的更改,包括其光标。这是默认模式。
- 通用查看器 — 显示文档的静态快照。用户在重新加载页面之前看不到其他用户的编辑。
备注
实时查看器从7.2版开始可用。实时查看器的服务器连接数与编辑连接数分开计算,并受许可证中 connections_view 参数的限制。开源版本的限制为20。对于较旧的许可证,实时查看器不可用。
要控制使用哪种查看模式,请配置 editorConfig.coEditing 参数:
-
mode: "fast"且change: true— 默认打开实时查看器。用户可以通过文件 > 高级设置... > 显示其他用户的更改在实时查看器和通用查看器之间切换,无需重新加载页面。这是默认配置:const config = {editorConfig: {coEditing: {mode: "fast",change: true,},mode: "view",},};const docEditor = new DocsAPI.DocEditor("placeholder", config);
-
mode: "fast"且change: false— 默认打开实时查看器。用户无法切换到通用查看器:const config = {editorConfig: {coEditing: {mode: "fast",change: false,},mode: "view",},};const docEditor = new DocsAPI.DocEditor("placeholder", config); -
mode: "strict"且change: true— 默认打开通用查看器。用户可以通过文件 > 高级设置... > 显示其他用户的更改切换到实时查看器:const config = {editorConfig: {coEditing: {mode: "strict",change: true,},mode: "view",},};const docEditor = new DocsAPI.DocEditor("placeholder", config); -
mode: "strict"且change: false— 默认打开通用查看器。用户无法切换到实时查看器:const config = {editorConfig: {coEditing: {mode: "strict",change: false,},mode: "view",},};const docEditor = new DocsAPI.DocEditor("placeholder", config);
在实时查看器中,会显示其他用户的光标。通过 document.permissions.userInfoGroups 参数配置显示哪些用户的光标。

在通用查看器中,文档显示为静态快照:

在以下情况下,仅使用通用查看器:
移动编辑器支持与Web版本相同的查看模式和 coEditing 配置。