跳到主要内容

评论

评论功能允许您对文档中特定的单词、短语、句子以及其他部分添加评论，还能对这些评论进行编辑和删除操作。所有评论都会被保存下来，并展示给其他使用该文档的用户。

评论

评论权限​

为了启用评论功能，在文档初始化时的权限部分中，必须将评论参数设置为true。此时文档的侧边栏会包含评论菜单选项。

如果edit 参数设置为true，并且comment参数也设置为true，那么用户将能够编辑文档并添加评论。

评论

如果edit 参数设置为 false，而 comment参数设置为 true，那么该文档将仅可用于添加评论。

const docEditor = new DocsAPI.DocEditor("placeholder", {
  document: {
    permissions: {
      edit: false,
      comment: true,
    },
  },
})

请注意，如果mode参数设置为edit，文档编辑器才会具备文档评论功能。

按作者区分评论权限​

  1. 如果您希望仅允许评论的作者对评论进行编辑，在编辑器初始化的权限部分中，将editCommentAuthorOnly参数设置为true。

    const docEditor = new DocsAPI.DocEditor("placeholder", {
      document: {
        permissions: {
          editCommentAuthorOnly: true,
        },
      },
    })

2.如果您希望仅允许评论的作者删除评论，在编辑器初始化的权限部分中，将deleteCommentAuthorOnly 参数设置为true。

const docEditor = new DocsAPI.DocEditor("placeholder", {
  document: {
    permissions: {
      deleteCommentAuthorOnly: true,
    },
  },
})

按群组区分评论权限​

  1. 在 editorConfig 部分的user参数中添加 group 字段，以此指定用户所属的群组（或者多个群组，群组之间用逗号分隔）。
const docEditor = new DocsAPI.DocEditor("placeholder", {
  editorConfig: {
    user: [{
      id: "78e1e841",
      name: "John Smith",
      group: "Group1,Group2",
    },
    {
      id: "78e1e841",
      name: "John Smith",
      group: "Group1,Group2",
    }],
  },
})

  1. 在编辑器初始化的权限部分中，使用commentGroups参数指定访问权限。

    如果在编辑器配置中指定了commentGroups参数，那么查看、编辑和 / 或删除所有评论的访问权限将被禁用。否则，如果当前用户不属于任何一个群组，那么他或她可以编辑、删除和 / 或查看所有群组的评论。

    const docEditor = new DocsAPI.DocEditor("placeholder", {
      document: {
        permissions: {
          commentGroups: {
            edit: ["Group2", ""],
            remove: [""],
            view: "",
          },
        },
      },
    })
    • "edit": ["Group2", ""] 表示用户可以编辑来自** Group2**的用户以及不属于任何群组的用户所添加的评论（例如，在第三方编辑器中添加评论的文档）。
    • "remove": [""] 表示用户可以删除不属于这些群组的人所添加的评论（例如，在第三方编辑器中添加评论的文档）。
    • "view": "" 表示用户可以查看任何用户所添加的评论。

电子表格中的线程式评论​

为了在其他编辑器中正确显示 ONLYOFFICE 电子表格的评论，所有评论会以两种格式保存：原始格式和线程式格式：

  1. 原始评论格式 如下所示：

    ${author1}:
    comment
    ${author2}:
    reply1
    ${author2}:
    reply2

    线程式评论

  2. 要将原始评论格式转换为线程式评论，如果评论以*"${author}:\n"* 字符串开头，则会删除该字符串。

编辑器中打开文件的情况如下：

  • 如果文件中有线程式评论，打开文件时会使用这些线程式评论。
  • 如果文件中只有原始的 ONLYOFFICE 格式的评论，它们会被转换为线程式评论。