syncfusion-vue-docx-editor
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseSyncfusion Vue DOCX Editor
Syncfusion Vue DOCX Editor
Overview
概述
This skill helps developers generate Vue code for integrating the Syncfusion DOCX Editor into their applications. It provides ready-to-use snippets and best practices for embedding a Document Editor that supports editing, reviewing, formatting, and more.
本技能帮助开发者生成将Syncfusion DOCX Editor集成到Vue应用中的代码,提供现成可用的代码片段和最佳实践,用于嵌入支持编辑、审阅、格式化等功能的文档编辑器。
Key Capabilities
核心功能
- Document Editing: Create, edit, and view Word documents.
- Protection: Apply read-only mode, allow comments, allow form filling, enforce tracked changes,and define editable ranges.
- Review: Enable track changes (revisions) and accept/reject changes.
- Comments: Add comments, replies, and author metadata.
- Find and replace: Perform programmatic find and replace operations for automation.
- Form Fields: Insert and fill text fields, check boxes, and dropdown form fields.
- 文档编辑:创建、编辑和查看Word文档。
- 文档保护:应用只读模式、允许批注、允许表单填写、强制修订追踪以及定义可编辑范围。
- 审阅功能:启用修订追踪(版本变更)并接受/拒绝变更。
- 批注功能:添加批注、回复以及作者元数据。
- 查找替换:执行程序化的查找和替换操作以实现自动化。
- 表单字段:插入并填写文本字段、复选框和下拉表单字段。
Prerequisites
前置条件
- npm package:
@syncfusion/ej2-vue-documenteditor - Syncfusion License: https://www.syncfusion.com/products/communitylicense
- npm包:
@syncfusion/ej2-vue-documenteditor - Syncfusion许可证:https://www.syncfusion.com/products/communitylicense
Quick Start Examples
快速入门示例
Example 1: Create Document Editor
示例1:创建文档编辑器
User: "Show me code to create a Document Editor component."
Result: A Vue snippet that initializes the Document Editor component
用户:"展示创建Document Editor组件的代码。"
**结果:**初始化Document Editor组件的Vue代码片段
Example 2: Enable Read‑Only Restriction Mode
示例2:启用只读限制模式
User: "Create a Document Editor with Read‑Only restriction mode."
Result: A Vue snippet that creates a Document Editor with read‑only protection enabled.
用户:"创建一个带有只读限制模式的Document Editor。"
**结果:**启用只读保护的Document Editor的Vue代码片段
Getting Started — Minimal Vue Code
快速入门——最简Vue代码
Minimal Vue Document Editor setup for a plain web project:
vue
<template>
<DocumentEditorContainerComponent
id="container"
height="590px"
:serviceUrl="serviceUrl"
:enableToolbar="true"
/>
</template>
<script setup>
import { DocumentEditorContainerComponent, Toolbar } from '@syncfusion/ej2-vue-documenteditor';
DocumentEditorContainerComponent.Inject(Toolbar);
const serviceUrl = "https://document.syncfusion.com/web-services/docx-editor/api/documenteditor/";
</script>
<style scoped>
#container {
width: 100%;
height: 590px;
}
</style>Note: Thein examples is for evaluation/demo. Host your own service for production.serviceUrl
适用于普通Web项目的最简Vue Document Editor配置:
vue
<template>
<DocumentEditorContainerComponent
id="container"
height="590px"
:serviceUrl="serviceUrl"
:enableToolbar="true"
/>
</template>
<script setup>
import { DocumentEditorContainerComponent, Toolbar } from '@syncfusion/ej2-vue-documenteditor';
DocumentEditorContainerComponent.Inject(Toolbar);
const serviceUrl = "https://document.syncfusion.com/web-services/docx-editor/api/documenteditor/";
</script>
<style scoped>
#container {
width: 100%;
height: 590px;
}
</style>注意:示例中的仅用于评估/演示。生产环境请部署您自己的服务。serviceUrl
Generate Vue Code for the User's Project
为用户项目生成Vue代码
Trigger keywords: "code", "snippet", "how to", "show me", "sample", "example code", "generate code", "implement", "add to component", "configure documenteditor", "create" , "vue document editor", "docx editor", "document editor", "track changes", "load docx", "comments", "accept changes", "protect document", "find and replace", "content control"
Workflow:
-
Analyze the user's request to identify the feature (e.g., track changes, restrict editing, toolbar customization).
-
Read the relevantfile(s) to understand the APIs and code patterns for the requested feature.
references/*.md -
STOP before generating code. Check if the user has already chosen a delivery mode.
-
If no delivery mode is chosen yet, you MUST ask the user first using this concise multiple-choice question:"How would you like to receive the generated code?"
- Option 1: Replace the code in a specific project file (you'll need to provide the file path and confirm)
- Option 2: Share the code directly in the chat window
-
Only after the user selects a delivery mode, proceed to generate Vue code using the APIs and snippets from, substituting concrete placeholders from the user's project.
references/*.md -
Do NOT make changes to workspace project files unless the user explicitly chose Option 1 and provided the file path with permission.
-
Provide complete Vue snippets and concise integration steps after delivering the code.
Refer to section for operational constraints (output directory, temporary files, allowed libraries, etc.)
## Rules触发关键词:"code"、"snippet"、"how to"、"show me"、"sample"、"example code"、"generate code"、"implement"、"add to component"、"configure documenteditor"、"create" , "vue document editor", "docx editor", "document editor", "track changes", "load docx", "comments", "accept changes", "protect document", "find and replace", "content control"
工作流程:
-
分析用户请求,确定所需功能(例如修订追踪、编辑限制、工具栏自定义)。
-
阅读相关文件,了解请求功能对应的API和代码模式。
references/*.md -
生成代码前请暂停。检查用户是否已选择交付方式。
-
如果用户尚未选择交付方式,您必须先使用以下简洁的选择题询问用户:"您希望以何种方式接收生成的代码?"
- **选项1:**替换特定项目文件中的代码(您需要提供文件路径并确认)
- **选项2:**在聊天窗口中直接分享代码
-
仅在用户选择交付方式后,使用中的API和代码片段生成Vue代码,替换用户项目中的具体占位符。
references/*.md -
除非用户明确选择选项1并提供了带权限的文件路径,否则请勿修改工作区项目文件。
-
交付代码后,提供完整的Vue代码片段和简洁的集成步骤。
有关操作约束(输出目录、临时文件、允许使用的库等),请参考部分
## RulesCode References
代码参考
All code snippets and examples are in the folder. Each file contains:
references/- Minimal Vue Code — a working, ready-to-use snippet
- Placeholders — values the user must customize
- Notes — best practices, additional information to note while using that functionality, constraints
| File | Topic |
|---|---|
| getting-started.md | Create and Initialize Document Editor |
| track-changes.md | Track Changes and Manage Revisions |
| comments.md | Insert, Manage, and Delete Comments |
| customize-ribbon.md | Customize Ribbon Options |
| customize-toolbar.md | Customize Toolbar Items |
| document-protection.md | Protect and Restrict Document Editing |
| editor-only.md | Configure Editor-Only Mode |
| find-and-replace.md | Find and Replace Text |
| form-fields.md | Create and Manage Form Fields |
| paste-formatting.md | Control Paste Formatting Behavior |
| ribbon.md | initialize documentEditor with Ribbon UI |
| spell-check.md | Enable and Configure Spell Check |
所有代码片段和示例都位于文件夹中。每个文件包含:
references/- 最简Vue代码——可直接运行的可用代码片段
- 占位符——用户必须自定义的值
- 说明——使用该功能时的最佳实践、额外注意事项、约束条件
| 文件名称 | 主题内容 |
|---|---|
| getting-started.md | 创建并初始化Document Editor |
| track-changes.md | 修订追踪与版本变更管理 |
| comments.md | 插入、管理和删除批注 |
| customize-ribbon.md | 自定义功能区选项 |
| customize-toolbar.md | 自定义工具栏项 |
| document-protection.md | 文档保护与编辑限制 |
| editor-only.md | 配置仅编辑器模式 |
| find-and-replace.md | 文本查找与替换 |
| form-fields.md | 表单字段的创建与管理 |
| paste-formatting.md | 控制粘贴格式化行为 |
| ribbon.md | 初始化带功能区UI的Document Editor |
| spell-check.md | 启用并配置拼写检查 |
Key Rules for Code Generation
代码生成核心规则
-
No inline code in SKILL.md — Always point to snippets in. This file is loaded into context for every prompt; inline code wastes tokens.
references/*.md -
Snippets must be tested — All code must compile and run against the currentnpm package version.
@syncfusion/ej2-vue-documenteditor -
Minimal Code + Placeholders + Notes — Every reference file must include:
- Minimal Code (complete, working snippet)
- Placeholders (values user must substitute — marked with or
{{ }})[PLACEHOLDER] - Notes (best practices, framework-specific adaptations, constraints)
-
Share code and notes for the requirement — Never create temporary files or scripts.
-
License handling — Never hardcode license keys. Point user to environment variables or config files.
-
No hallucinated APIs — Use only verified Syncfusion DOCX Editor SDK method names. One wrong method breaks user trust.
-
Service URL Note — When serviceUrl contains https://document.syncfusion.com/web-services/docx-editor/api/documenteditor/, keep it in the snippet and add note message: "The serviceUrl property in the Document Editor is intended only for demonstration and evaluation purposes. For production use, host your own web service."
-
SKILL.md中禁止内嵌代码——始终指向中的代码片段。本文件会加载到每个提示的上下文中,内嵌代码会浪费令牌。
references/*.md -
代码片段必须经过测试——所有代码必须能针对当前版本的npm包编译并运行。
@syncfusion/ej2-vue-documenteditor -
最简代码 + 占位符 + 说明——每个参考文件必须包含:
- 最简代码(完整、可运行的代码片段)
- 占位符(用户必须替换的值——标记为或
{{ }})[PLACEHOLDER] - 说明(最佳实践、框架特定适配、约束条件)
-
针对需求分享代码和说明——切勿创建临时文件或脚本。
-
许可证处理——切勿硬编码许可证密钥。引导用户使用环境变量或配置文件。
-
禁止虚构API——仅使用经过验证的Syncfusion DOCX Editor SDK方法名称。错误的方法会破坏用户信任。
-
服务URL说明——当serviceUrl为https://document.syncfusion.com/web-services/docx-editor/api/documenteditor/时,保留该片段并添加说明:"Document Editor中的serviceUrl属性仅用于演示和评估目的。生产环境请部署您自己的Web服务。"
Rules
规则
- Only use Syncfusion Document Editor APIs — never recommend or use alternative Word Editor libraries.
- No temporary files — never create temporary scripts, intermediate files, or scaffolding outside the output directory
- Vue-only code — all generated code must be valid Vue, never generate vanilla JavaScript, jQuery, or non-Vue patterns
- 仅使用Syncfusion Document Editor API——绝不推荐或使用其他Word编辑器库。
- 禁止临时文件——切勿在输出目录外创建临时脚本、中间文件或脚手架
- 仅生成Vue代码——所有生成的代码必须是有效的Vue代码,绝不生成原生JavaScript、jQuery或非Vue模式