在 Node.JS 中转换 Word 页面方向

Wed, 26 Aug 2026 08:28:34 +0000

转换 Word 文档的布局在生成报告、合同或可打印手册时是常见需求。GroupDocs.Merger Cloud SDK for Node.js 使开发者能够通过几行代码以编程方式 在 Node.JS 中转换 Word 页面方向。本指南将带您逐步完成所需步骤，展示完整的工作示例，演示等效的 cURL 调用，并解释安装和配置，以便您将页面方向更改集成到 Node.js 应用程序中。

在 Node.JS 中转换 Word 页面方向的步骤

安装 SDK 并配置凭据：使用 npm 添加库并设置您的客户端 ID 和密钥。
```
npm install groupdocs-merger-cloud
```
创建 API 实例：使用配置对象初始化 ChangePageOrientationApi。

const GroupDocsMergerCloud = require('groupdocs-merger-cloud');
const clientId = 'YOUR_CLIENT_ID';
const clientSecret = 'YOUR_CLIENT_SECRET';
const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);
const orientationApi = new GroupDocsMergerCloud.ChangePageOrientationApi(config);

构建请求选项：定义源文件、页面范围、所需方向和输出路径。

const options = new GroupDocsMergerCloud.ChangePageOrientationOptions();
options.fileInfo = new GroupDocsMergerCloud.FileInfo();
options.fileInfo.filePath = 'input.docx';
options.pages = ['1-']; // all pages
options.orientation = GroupDocsMergerCloud.Orientation.Landscape; // or Portrait
options.outputPath = 'output.docx';

执行方向更改：发送请求并处理响应。

const request = new GroupDocsMergerCloud.ChangePageOrientationRequest(options);
orientationApi.changePageOrientation(request)
    .then(response => {
        console.log('Page orientation conversion completed.');
        console.log('Output stored at:', response.path);
    })
    .catch(error => {
        console.error('Error during orientation conversion:', error);
    });

（可选）调整其他设置: 您可以修改 pages 数组以定位特定页面，或将 orientation 枚举切换为 Portrait 以获得不同的布局。

Word 页面方向更改 - 完整代码示例

以下示例演示了使用 GroupDocs.Merger Cloud SDK for Node.js 更改 DOCX 文件方向的完整工作流。

const GroupDocsMergerCloud = require('groupdocs-merger-cloud');

// ==== Configuration ====
// Replace with your actual credentials
const clientId = 'YOUR_CLIENT_ID';
const clientSecret = 'YOUR_CLIENT_SECRET';
const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);

// ==== API Instance ====
const orientationApi = new GroupDocsMergerCloud.ChangePageOrientationApi(config);

// ==== Request Construction ====
const options = new GroupDocsMergerCloud.ChangePageOrientationOptions();
options.fileInfo = new GroupDocsMergerCloud.FileInfo();
options.fileInfo.filePath = 'input.docx';               // source Word document
options.pages = ['1-'];                                 // apply to all pages (1 to end)
options.orientation = GroupDocsMergerCloud.Orientation.Landscape; // Portrait or Landscape
options.outputPath = 'output.docx';                     // destination file

const request = new GroupDocsMergerCloud.ChangePageOrientationRequest(options);

// ==== Execution ====
orientationApi.changePageOrientation(request)
    .then(response => {
        console.log('Page orientation conversion completed.');
        console.log('Output stored at:', response.path);
    })
    .catch(error => {
        console.error('Error during orientation conversion:', error);
    });

注意： 此代码示例演示了核心功能。在将其用于项目之前，请确保更新文件路径（input.docx、output.docx）以匹配实际文件位置，验证所有必需的依赖项已正确安装，并在开发环境中彻底测试。如遇到任何问题，请参阅官方文档或联系支持团队获取帮助。

使用 cURL 通过 REST API 更改页面方向

如果您更喜欢纯 HTTP 方法，可以使用针对 GroupDocs.Merger Cloud REST 端点的 cURL 命令执行相同的操作。

获取访问令牌

curl -X POST "https://api.groupdocs.cloud/v1.0/oauth2/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

响应中包含 access_token。

上传源 DOCX 文件

curl -X POST "https://api.groupdocs.cloud/v1.0/merger/storage/upload" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@input.docx" \
     -F "path=/input.docx"

请求更改方向

curl -X POST "https://api.groupdocs.cloud/v1.0/merger/words/changePageOrientation" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "/input.docx" },
           "pages": ["1-"],
           "orientation": "Landscape",
           "outputPath": "/output.docx"
         }'

下载生成的文件

curl -X GET "https://api.groupdocs.cloud/v1.0/merger/storage/download?path=/output.docx" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -o output.docx

有关请求负载和支持的参数的更多详细信息，请参阅官方 API 文档。

安装和配置 GroupDocs.Merger Cloud SDK for Node.js

要开始使用，请从 npm 安装该包并配置您的凭据。

npm install groupdocs-merger-cloud

const GroupDocsMergerCloud = require('groupdocs-merger-cloud');
const clientId = 'YOUR_CLIENT_ID';
const clientSecret = 'YOUR_CLIENT_SECRET';
const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);

如果需要特定版本，请从发布页面下载最新库。确保您的环境运行 Node.js 12 或更高版本，并且拥有有效的 GroupDocs Cloud 帐户。

配置页面方向选项

SDK 暴露了多个您可以调整的属性：

pages - 定义要影响的页面（例如，['1-5'] 表示前五页）。
```
options.pages = ['1-5'];
```
orientation - 选择 GroupDocsMergerCloud.Orientation.Portrait 或 Landscape。
```
options.orientation = GroupDocsMergerCloud.Orientation.Portrait;
```

outputPath - 指定云存储中的目标路径。

options.outputPath = 'converted/output.docx';

这些选项是 ChangePageOrientationOptions 类的一部分，已在API 参考中记录。

结论

使用 GroupDocs.Merger Cloud SDK for Node.js 以编程方式更改 Word 文件的布局非常简单。按照上述步骤，您可以 在 Node.JS 中转换 Word 页面方向，实现批量处理自动化，并将方向更改集成到任何文档工作流中。请记得为生产环境获取合适的许可证；定价详情请参阅产品页面，您也可以从临时许可证页面获取临时许可证。安装并配置好 SDK 后，您即可使用灵活的文档操作功能来增强您的应用程序。

FAQs

如何在使用 Node.js 的 Word 文档中更改页面方向？
使用来自 GroupDocs.Merger Cloud SDK for Node.js 的 ChangePageOrientationApi，在请求选项中设置所需的 orientation，并执行 API 调用。
是否有办法在 Node.JS 中导出 Word 页面方向而无需编写代码？
是的，可以通过使用 cURL 命令的 REST API 执行相同的操作，这对于快速脚本或与其他系统的集成非常有用。
Word 文档支持哪些方向？
SDK 通过 Orientation 枚举支持 Portrait（纵向）和 Landscape（横向）两种模式。您还可以指定页范围以选择性地应用更改。
我需要许可证才能在生产环境中运行吗？
有效的许可证是生产部署所必需的。您可以从临时许可证页面获取临时许可证，并随着使用量的增长升级为完整许可证。

page orientation conversion on Document Processing REST APIs | GroupDocs Cloud

在 Node.JS 中转换 Word 页面方向