Xuất Trình chiếu sang XAML trong JavaScript

Trang này nói về điều gì

Chuyển đổi các slide PowerPoint và OpenDocument sang XAML trong JavaScript bằng Aspose.Slides—giải pháp nhanh, không cần Office, giữ nguyên bố cục của bạn.

Tổng quan

Bài viết này giải thích cách xuất bản trình chiếu PowerPoint sang XAML bằng Aspose.Slides. Nó bao gồm phần giới thiệu ngắn gọn về XAML, chỉ cách lưu trình chiếu dưới dạng XAML với các thiết lập mặc định, và trình bày cách tùy chỉnh quá trình xuất qua XamlOptions, bao gồm việc xuất các slide ẩn. Bài viết cũng trả lời một số câu hỏi thường gặp liên quan đến phông chữ dự phòng, khả năng tương thích của ngăn xếp XAML, và hành vi xuất slide ẩn.

Về XAML

XAML là ngôn ngữ đánh dấu dựa trên XML dùng để mô tả giao diện người dùng trong các khung như WPF (Windows Presentation Foundation), UWP (Universal Windows Platform) và Xamarin.Forms.

Bạn có thể làm việc với các tệp XAML trong một trình thiết kế trực quan hoặc viết và chỉnh sửa mã đánh dấu trực tiếp.

Xuất trình chiếu sang XAML với tùy chọn mặc định

Ví dụ JavaScript sau cho thấy cách xuất một trình chiếu sang XAML với các thiết lập mặc định:

const aspose = { slides: require("aspose.slides.via.java") };

const presentation = new aspose.slides.Presentation("input.pptx");
try {
    const xamlOptions = new aspose.slides.XamlOptions();
    presentation.save(xamlOptions);
} finally {
    presentation.dispose();
}

Mặc định, các slide đã xuất được lưu trong thư mục phụ input của thư mục làm việc hiện tại của tiến trình. Thư mục này được tạo tự động và bất kỳ hình ảnh cần thiết nào cũng được lưu ở đó.

Tên thư mục đầu ra được lấy từ tên tệp nguồn mà không có phần mở rộng. Trong Aspose.Slides for Node.js via Java 26.8, việc xuất input.pptx tạo ra một đường dẫn lồng nhau như input/input/Slide_1.xaml. Giữ nguyên các đường dẫn đã tạo khi xử lý đầu ra. Đầu ra mặc định là tương đối so với thư mục làm việc hiện tại, chứ không nhất thiết phải nằm cùng vị trí với tệp đầu vào.

Xuất trình chiếu sang XAML với tùy chọn tùy chỉnh

Sử dụng giao diện IXamlOptions để kiểm soát cách Aspose.Slides xuất trình chiếu sang XAML.

Để lưu đầu ra vào một vị trí tùy chỉnh, triển khai IXamlOutputSaver và truyền một thể hiện của triển khai của bạn vào phương thức setOutputSaver của XamlOptions.

Để bao gồm các slide ẩn trong đầu ra XAML, gọi setExportHiddenSlides với giá trị true, như trong ví dụ JavaScript sau:

const aspose = { slides: require("aspose.slides.via.java") };

const presentation = new aspose.slides.Presentation("input.pptx");
try {
    const xamlOptions = new aspose.slides.XamlOptions();
    xamlOptions.setExportHiddenSlides(true);
    presentation.save(xamlOptions);
} finally {
    presentation.dispose();
}

Thu thập mọi đối tượng XAML được tạo

Quá trình xuất XAML có thể tạo ra một tài liệu XAML cho mỗi slide đã xuất, cộng với các hình ảnh và tài nguyên hỗ trợ riêng biệt. Gán một IXamlOutputSaver tùy chỉnh cho XamlOptions.setOutputSaver để nhận các đối tượng này thay vì sử dụng bộ lưu mặc định của hệ thống tệp. Bắt đầu xuất bằng phương thức quá tải của Presentation.save chuyên dụng cho XAML, chấp nhận các tùy chọn XAML.

Trong Node.js, triển khai giao diện Java bằng java.newProxy từ gói java được Aspose.Slides sử dụng. Giữ proxy khả dụng cho tới khi quá trình xuất hoàn tất.

Hiểu vòng đời Callback

Trình xuất sẽ gọi IXamlOutputSaver.save riêng biệt cho mỗi đối tượng được tạo:

path xác định đối tượng và có thể bao gồm các thư mục tương đối. Giữ lại thông tin này vì XAML có thể tham chiếu tài nguyên bằng các đường dẫn tương đối.
data chứa byte của đối tượng. Hình ảnh và các tài nguyên nhị phân khác không được giải mã thành văn bản.
Bộ lưu chịu trách nhiệm giữ hoặc lưu trữ dữ liệu trước khi trả về. Các ví dụ sao chép mỗi mảng byte Java vào một bộ đệm Node.js do ứng dụng sở hữu.
Xem việc xuất là thành công chỉ khi hành động lưu trình chiếu trả về và mọi callback đã hoàn thành thành công. Không bỏ qua lỗi lưu trữ hay khởi chạy các ghi nền không được giám sát. Nếu việc lưu diễn ra sau đó, chỉ báo cáo thành công chung sau khi bước đó cũng thành công.

XamlOptions.setExportHiddenSlides cũng áp dụng cho bộ lưu tùy chỉnh. Cài đặt mặc định, false, loại bỏ các tài liệu XAML của slide ẩn. Khi truyền true thì bao gồm chúng và bất kỳ tài nguyên nào cần cho việc xuất. Số lượng tài nguyên phụ thuộc vào trình chiếu; không giả định có một callback cho mỗi slide hay một thứ tự callback cố định.

Xuất ra bộ nhớ và kiểm tra các đối tượng

Ví dụ đầy đủ này tải input.pptx, thu thập mọi đối tượng vào một Map JavaScript từ tên tới bộ đệm, và in ra tên, kiểu và số byte của chúng. Nó giữ nguyên các tên đã cung cấp. Các tên trùng lặp làm cho bộ sưu tập không hợp lệ thay vì ghi đè im lặng. Ví dụ kiểm tra điều này trước khi sử dụng kết quả.

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const artifacts = new Map();
let valid = true;
const saver = java.newProxy("com.aspose.slides.IXamlOutputSaver", {
    save: function(path, data) {
        const name = String(path);
        if (artifacts.has(name)) {
            valid = false;
            console.error("Export rejected: duplicate artifact name: " + name);
            return;
        }
        const retainedData = Buffer.from(data);
        artifacts.set(name, retainedData);
    }
});

const presentation = new aspose.slides.Presentation("input.pptx");
try {
    const options = new aspose.slides.XamlOptions();
    options.setOutputSaver(saver);
    options.setExportHiddenSlides(true);
    presentation.save(options);
} finally {
    presentation.dispose();
}

if (!valid) {
    console.error("Export rejected: the artifact collection is invalid.");
} else {
    const inspectXamlText = false;
    for (const [name, data] of artifacts) {
        const isXaml = /\.xaml$/i.test(name);
        const isImage = /\.(png|jpg|jpeg|gif|bmp|tif|tiff|svg)$/i.test(name);
        const kind = isXaml ? "slide XAML" : isImage ? "image" : "supporting resource";
        console.log(name + ": " + data.length + " bytes (" + kind + ")");

        // Giải mã chỉ XAML và chỉ khi cần kiểm tra văn bản.
        if (isXaml && inspectXamlText) {
            console.log(data.toString("utf8"));
        }
    }
}

Kiểm tra phần mở rộng hữu ích cho việc kiểm tra; giữ mọi đối tượng, kể cả các loại tài nguyên không quen thuộc. Khi lưu hoặc truyền đi, không thay đổi các byte. Chỉ sử dụng giải mã UTF-8 cho XAML cần xử lý văn bản.

Đóng gói các đối tượng đã thu thập vào tệp ZIP

Ví dụ độc lập này thu thập kết quả xuất, xác thực các tên, và ghi các byte gốc vào một tệp ZIP bằng cầu nối Java. ZIP được lắp ráp trong bộ nhớ trước khi lưu ra đĩa. Một tên lưu trữ duy nhất tách các công việc xuất đồng thời. Các mục ZIP dùng dấu gạch chéo xuôi và giữ lại các thư mục tương đối. Tên không an toàn hoặc tên trùng nhau sau chuẩn hoá sẽ khiến toàn bộ gói bị từ chối trước khi ghi.

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const artifacts = new Map();
let valid = true;
const saver = java.newProxy("com.aspose.slides.IXamlOutputSaver", {
    save: function(path, data) {
        const name = String(path);
        if (artifacts.has(name)) {
            valid = false;
            console.error("Export rejected: duplicate artifact name: " + name);
            return;
        }
        const retainedData = Buffer.from(data);
        artifacts.set(name, retainedData);
    }
});

const presentation = new aspose.slides.Presentation("input.pptx");
try {
    const options = new aspose.slides.XamlOptions();
    options.setOutputSaver(saver);
    options.setExportHiddenSlides(false);
    presentation.save(options);
} finally {
    presentation.dispose();
}

const entries = new Map();
const entryNames = new Set();
for (const [name, data] of artifacts) {
    const entryName = name.replace(/\\/g, "/");
    const segments = entryName.split("/");
    const unsafeName = entryName.startsWith("/") || entryName.includes(":") || segments.some(segment => segment.trim() === "" || segment === "." || segment === "..");
    const comparisonName = entryName.toLowerCase();
    if (unsafeName || entryNames.has(comparisonName)) {
        valid = false;
        console.error("Export rejected: unsafe or duplicate artifact name: " + name);
        break;
    }
    entryNames.add(comparisonName);
    entries.set(entryName, data);
}

if (!valid) {
    console.error("Export rejected: the artifact collection is invalid.");
} else {
    const fs = require("node:fs");
    const crypto = require("node:crypto");
    const archivePath = "xaml-" + crypto.randomUUID() + ".zip";
    const output = java.newInstanceSync("java.io.ByteArrayOutputStream");
    const archive = java.newInstanceSync("java.util.zip.ZipOutputStream", output);
    try {
        for (const [name, data] of entries) {
            const entry = java.newInstanceSync("java.util.zip.ZipEntry", name);
            archive.putNextEntry(entry);
            const signedBytes = Array.from(data, value => value > 127 ? value - 256 : value);
            const bytes = java.newArray("byte", signedBytes);
            archive.write(bytes);
            archive.closeEntry();
        }
    } finally {
        archive.close();
    }

    // Đóng hoàn tất thư mục ZIP trước khi kho lưu được ghi lại.
    const archiveData = Buffer.from(output.toByteArray());
    try {
        fs.writeFileSync(archivePath, archiveData, { flag: "wx" });
        console.log("Saved " + entries.size + " artifacts to " + archivePath);
    } catch (error) {
        console.error("Archive persistence failed: " + error.message);
    }
}

Ví dụ sử dụng ZipOutputStream để ghi một kho lưu cục bộ; trình xuất không ghi ra các tệp XAML hay hình ảnh rời rạc. Đối với lưu trữ từ xa, thay thế giai đoạn ghi kho bằng việc tải lên các mảng byte đã thu thập. Sử dụng định danh công việc xuất cộng với tên tài nguyên tương đối đầy đủ làm khóa blob, hoặc lưu định danh công việc, tên tương đối và dữ liệu nhị phân trong một hàng cơ sở dữ liệu. Công bố công việc chỉ sau khi mọi tải lên hoàn tất hoặc giao dịch cơ sở dữ liệu được cam kết. Dọn dẹp đầu ra một phần nếu việc lưu trữ thất bại.

Đối với các trình chiếu lớn, bộ lưu tùy chỉnh có thể lưu mỗi đối tượng trực tiếp vào kho lưu của ứng dụng để tránh việc giữ một bản sao bổ sung của toàn bộ xuất trong bộ nhớ ứng dụng. Giữ mỗi callback đồng bộ từ quan điểm của trình xuất: chỉ trả về sau khi đích đã chấp nhận các byte, và cho phép lỗi truyền tới người gọi.

Bảo vệ tên tài nguyên và xác minh các tham chiếu

Chuẩn hoá dấu phân cách đường dẫn khi đích yêu cầu, nhưng vẫn giữ các thư mục tương đối. Không chỉ sử dụng tên cơ bản trừ khi mọi tên được tạo đều đã được đảm bảo là duy nhất và các tham chiếu tài nguyên vẫn hợp lệ.
Áp dụng kiểm tra hợp lệ tên theo đích. Khi ghi các tệp rời rạc, từ chối các đường dẫn gốc và các đoạn di chuyển, giải quyết đích thành đường dẫn tuyệt đối, và xác minh nó nằm dưới thư mục xuất dự định, bao gồm dấu phân cách thư mục trong kiểm tra chứa. Sử dụng một thư mục do ứng dụng kiểm soát, không có liên kết biểu tượng có thể chuyển hướng ghi.
Dùng một bộ lưu và không gian tên lưu trữ riêng cho mỗi công việc xuất. Phát hiện va chạm sau khi chuẩn hoá dấu phân cách và theo quy tắc phân biệt chữ hoa/chữ thường của đích.
Trước khi công bố, phân tích mỗi tài liệu XAML dưới dạng XML và kiểm tra các tham chiếu tài nguyên dựa trên tệp, chẳng hạn thuộc tính Source của hình ảnh hoặc ImageSource. Giải quyết mỗi URI tương đối dựa trên thư mục của tài liệu XAML chứa, chuẩn hoá tên lưu trữ nhận được, và xác nhận rằng khóa map tương ứng, mục ZIP, hoặc đối tượng lưu tồn tại. Xử lý các URI bên ngoài và các biểu thức đánh dấu XAML riêng biệt so với các tên tệp tương đối.

Ví dụ, nếu input/Slide_1.xaml tham chiếu tới images/image1.png, tài nguyên đã lưu phải có sẵn dưới dạng input/images/image1.png. Chỉ giữ image1.png sẽ phá vỡ mối quan hệ này. Đối với lưu trữ đối tượng, giữ cùng bố cục dưới tiền tố công việc và làm cho các URL tài nguyên đó có thể truy cập bởi người tiêu dùng XAML. Mở lại ZIP đã hoàn thành để xác minh tên mục và byte tài nguyên, và tải các slide mẫu trong môi trường XAML đích để xác nhận hình ảnh được resolve đúng.

Câu hỏi thường gặp

Làm sao để đảm bảo phông chữ dự đoán được nếu phông chữ gốc không có trên máy?

Gọi setDefaultRegularFont trong XamlOptions — nó được dùng làm phông chữ dự phòng trong quá trình xuất khi phông chữ gốc thiếu. Điều này không đảm bảo XAML tạo ra sẽ tham chiếu tới phông chữ dự phòng hoặc phông chữ đó có sẵn trên máy đích. Đảm bảo các phông chữ được XAML tham chiếu có sẵn trong môi trường nơi nó được hiển thị.

XAML đã xuất chỉ dùng cho WPF hay có thể dùng trong các ngăn xếp XAML khác không?

Aspose.Slides xuất XAML cho WPF thông qua API công khai. Tương thích với các ngăn xếp XAML khác, như UWP và Xamarin.Forms, không được đảm bảo. Hãy kiểm tra markup đã tạo trong môi trường đích của bạn.

Các slide ẩn có được hỗ trợ không, và làm sao ngăn chúng được xuất theo mặc định?

Mặc định, các slide ẩn không được bao gồm. Bạn có thể kiểm soát hành vi này qua setExportHiddenSlides trong XamlOptions — giữ nó tắt nếu không cần xuất chúng.

Chuyển đổi bài thuyết trình PowerPoint trong JavaScript | HTML, PNG, PDF, Word, TIFF Chuyển đổi Bài thuyết trình sang HTML5 trong JavaScript