Quản lý Siêu Liên Kết Bản Trình Bày trong PHP
Giới thiệu
Một siêu liên kết kết nối nội dung bản trình bày với một trang web hoặc một vị trí trong bản trình bày. Trong PowerPoint, siêu liên kết thường phục vụ hai mục đích:
- Mở một trang web từ văn bản, hình dạng, hoặc khung phương tiện.
- Điều hướng đến một slide khác, ví dụ, từ mục lục.
Aspose.Slides for PHP via Java cho phép bạn thêm các liên kết này, kiểm soát giao diện và âm thanh của chúng, cập nhật thuộc tính và xóa chúng. Các ví dụ dưới đây cho thấy cách làm việc với siêu liên kết trên các phần tử riêng lẻ và cách truy cập siêu liên kết ở mức bản trình bày, slide hoặc khung văn bản. Chúng giả định rằng PHP/Java Bridge và wrapper Aspose.Slides cho PHP đã được khởi tạo. Các thành viên API không có trang tham chiếu PHP sẽ liên kết tới API Java nền.
Note
Bạn cũng có thể chỉnh sửa bản trình bày bằng trình chỉnh sửa PowerPoint trực tuyến miễn phí của Aspose.Thêm Siêu Liên Kết URL
Bạn có thể gán một URL trang web cho văn bản, hình dạng hoặc khung phương tiện. Thành phần mà bạn gán siêu liên kết quyết định vùng có thể nhấp: một phần văn bản sẽ liên kết văn bản đã chọn, trong khi một hình dạng hoặc khung sẽ liên kết đối tượng slide.
Đối với các bản trình bày chứa siêu liên kết tương đối, xem Quản lý Cơ Sở Siêu Liên Kết để đọc, thay đổi hoặc xóa cơ sở cấp tài liệu.
Thêm Siêu Liên Kết URL vào Văn Bản
Để liên kết văn bản với một trang web, truyền một Hyperlink vào phương thức setHyperlinkClick của phần văn bản, như được hiển thị bên dưới. Chỉ phần văn bản đó sẽ trở nên có thể nhấp.
use aspose\slides\Hyperlink;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
$presentation = new Presentation();
try {
$textShape = $presentation->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 600, 50, false);
$textShape->addTextFrame("Aspose: File Format APIs");
$portionFormat = $textShape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->getPortionFormat();
$portionFormat->setHyperlinkClick(new Hyperlink("https://www.aspose.com/"));
$portionFormat->getHyperlinkClick()->setTooltip("Explore Aspose file format APIs");
$portionFormat->setFontHeight(32);
$presentation->save("presentation-out.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Thêm Siêu Liên Kết URL vào Hình Dạng và Khung Phương Tiện
Gọi setHyperlinkClick trên hình chữ nhật để làm cho toàn bộ khu vực của nó có thể nhấp. Sử dụng setTooltip để hiển thị cho người đọc một gợi ý về đích khi họ di chuột qua hình chữ nhật. Cả hai phương thức này cũng áp dụng cho khung hình, âm thanh và video.
use aspose\slides\Hyperlink;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
$presentation = new Presentation();
try {
$shape = $presentation->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 600, 50);
$shape->setHyperlinkClick(new Hyperlink("https://www.aspose.com/"));
$shape->getHyperlinkClick()->setTooltip("Explore Aspose file format APIs");
$presentation->save("presentation-out.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Sử Dụng Siêu Liên Kết Để Tạo Mục Lục
Siêu liên kết nội bộ cho phép người đọc nhảy từ mục lục đến một slide cụ thể. Ví dụ dưới đây sử dụng setInternalHyperlinkClick để liên kết văn bản “Page 2” trên slide đầu tiên tới slide thứ hai.
use aspose\slides\FillType;
use aspose\slides\Paragraph;
use aspose\slides\Portion;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
$presentation = new Presentation();
try {
$firstSlide = $presentation->getSlides()->get_Item(0);
$secondSlide = $presentation->getSlides()->addEmptySlide($firstSlide->getLayoutSlide());
$tableOfContents = $firstSlide->getShapes()->addAutoShape(ShapeType::Rectangle, 40, 40, 300, 100);
$tableOfContents->getFillFormat()->setFillType(FillType::NoFill);
$tableOfContents->getLineFormat()->getFillFormat()->setFillType(FillType::NoFill);
$tableOfContents->getTextFrame()->getParagraphs()->clear();
$paragraph = new Paragraph();
$paragraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
$paragraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
$paragraph->setText("Title of slide 2 .......... ");
$linkPortion = new Portion();
$linkPortion->setText("Page 2");
$linkPortion->getPortionFormat()->getHyperlinkManager()->setInternalHyperlinkClick($secondSlide);
$paragraph->getPortions()->add($linkPortion);
$tableOfContents->getTextFrame()->getParagraphs()->add($paragraph);
$presentation->save("link_to_slide.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Định Dạng Siêu Liên Kết
Bạn có thể thay đổi màu của văn bản được liên kết, phát hoặc dừng âm thanh khi người đọc kích hoạt liên kết, và đặt tooltip hiển thị khi di chuột.
Màu Sắc
Phương thức setColorSource của Hyperlink xác định liệu một siêu liên kết có sử dụng màu siêu liên kết của bản trình bày hay định dạng của phần văn bản. Để áp dụng màu văn bản tùy chỉnh, chọn HyperlinkColorSource::PortionFormat và đặt màu nền cho phần. Tính năng này được giới thiệu trong PowerPoint 2019; các phiên bản cũ hơn không áp dụng thiết lập này.
Trong ví dụ này, setColorSource làm cho liên kết đầu tiên sử dụng màu nền đỏ của phần văn bản. Liên kết thứ hai giữ màu siêu liên kết của bản trình bày.
use aspose\slides\FillType;
use aspose\slides\Hyperlink;
use aspose\slides\HyperlinkColorSource;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
$presentation = new Presentation();
try {
$coloredShape = $presentation->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 450, 50, false);
$coloredShape->addTextFrame("This hyperlink uses a custom color.");
$coloredPortionFormat = $coloredShape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->getPortionFormat();
$coloredPortionFormat->setHyperlinkClick(new Hyperlink("https://www.aspose.com/"));
$coloredPortionFormat->getHyperlinkClick()->setColorSource(HyperlinkColorSource::PortionFormat);
$coloredPortionFormat->getFillFormat()->setFillType(FillType::Solid);
$coloredPortionFormat->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
$defaultShape = $presentation->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 200, 450, 50, false);
$defaultShape->addTextFrame("This hyperlink uses the default color.");
$defaultShape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->getPortionFormat()->setHyperlinkClick(new Hyperlink("https://www.aspose.com/"));
$presentation->save("presentation-out-hyperlink.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Âm Thanh
Một siêu liên kết có thể phát âm thanh khi được kích hoạt hoặc dừng âm thanh đang phát. Sử dụng các phương thức sau để cấu hình các hành vi này:
- Hyperlink::setSound chỉ định âm thanh liên quan đến siêu liên kết.
- Hyperlink::setStopSoundOnClick kiểm soát việc kích hoạt siêu liên kết có dừng âm thanh trước đó hay không.
Thêm Âm Thanh Siêu Liên Kết
Nút trên slide đầu tiên sử dụng Hyperlink::setSound để phát âm thanh từ sampleaudio.wav khi người đọc nhấp để tiến tới. Trên slide thứ hai, một nút riêng biệt sử dụng Hyperlink::setStopSoundOnClick để dừng phát và giữ người đọc trên slide đó.
use aspose\slides\Hyperlink;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
$presentation = new Presentation();
try {
$audioFile = new Java("java.io.File", "sampleaudio.wav");
$audioPath = $audioFile->toPath();
$audioData = java("java.nio.file.Files")->readAllBytes($audioPath);
$hyperlinkSound = $presentation->getAudios()->addAudio($audioData);
$firstSlide = $presentation->getSlides()->get_Item(0);
$playButton = $firstSlide->getShapes()->addAutoShape(ShapeType::SoundButton, 100, 100, 100, 50);
$playButton->setHyperlinkClick(Hyperlink::getNextSlide());
if (!java_values($playButton->getHyperlinkClick()->getStopSoundOnClick()) && java_is_null($playButton->getHyperlinkClick()->getSound()))
{
$playButton->getHyperlinkClick()->setSound($hyperlinkSound);
}
$secondSlide = $presentation->getSlides()->addEmptySlide($firstSlide->getLayoutSlide());
$stopButton = $secondSlide->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 100, 50);
$stopButton->setHyperlinkClick(Hyperlink::getNoAction());
$stopButton->getHyperlinkClick()->setStopSoundOnClick(true);
$presentation->save("hyperlink-sound.pptx", SaveFormat::Pptx);
} catch (JavaException $exception) {
echo "Unable to read the audio file: " . $exception->getMessage() . PHP_EOL;
} finally {
$presentation->dispose();
}
Trích Xuất Âm Thanh Siêu Liên Kết
Ví dụ dưới đây mở bản trình bày đã tạo ở trên và đọc âm thanh siêu liên kết của hình dạng đầu tiên vào bộ nhớ qua getSound và getBinaryData.
use aspose\slides\Presentation;
$presentation = new Presentation("hyperlink-sound.pptx");
try {
if (java_values($presentation->getSlides()->size()) > 0 && java_values($presentation->getSlides()->get_Item(0)->getShapes()->size()) > 0) {
$hyperlink = $presentation->getSlides()->get_Item(0)->getShapes()->get_Item(0)->getHyperlinkClick();
$sound = java_is_null($hyperlink) ? null : $hyperlink->getSound();
if (!java_is_null($sound)) {
$audioData = $sound->getBinaryData();
echo "Extracted " . strlen(java_values($audioData)) . " bytes of hyperlink audio." . PHP_EOL;
} else {
echo "The first shape has no hyperlink sound." . PHP_EOL;
}
} else {
echo "The presentation has no first slide or shape to inspect." . PHP_EOL;
}
} finally {
$presentation->dispose();
}
Cài Đặt Tooltip và Tương Tác
Bạn có thể gọi các phương thức Hyperlink sau khi gán siêu liên kết cho văn bản hoặc hình dạng:
- setTooltip đặt văn bản mà người xem có thể hiển thị như gợi ý cho liên kết.
- setTargetFrame chỉ định khung đích trong một khung HTML cha, khi áp dụng.
- setHistory kiểm soát việc kích hoạt liên kết có thêm đích vào danh sách siêu liên kết đã xem hay không.
- setHighlightClick kiểm soát việc siêu liên kết có được làm nổi bật khi nhấp hay không.
Xóa Siêu Liên Kết khỏi Bản Trình Bày
Sử dụng getAnyHyperlinks để thu thập các container siêu liên kết, bao gồm các liên kết phần văn bản, trước khi thay đổi chúng. Ví dụ dưới đây xóa cả hai kiểu kích hoạt khỏi slide đầu tiên. Để xóa chỉ một kiểu, gọi chỉ removeHyperlinkClick hoặc removeHyperlinkMouseOver; việc xóa hành động nhấp không loại bỏ hành động di chuột.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation("pres.pptx");
try {
if (java_values($presentation->getSlides()->size()) > 0) {
$containers = [];
foreach ($presentation->getSlides()->get_Item(0)->getHyperlinkQueries()->getAnyHyperlinks() as $container) {
$containers[] = $container;
}
foreach ($containers as $container) {
$container->getHyperlinkManager()->removeHyperlinkClick();
$container->getHyperlinkManager()->removeHyperlinkMouseOver();
}
$presentation->save("pres-removed-hyperlinks.pptx", SaveFormat::Pptx);
} else {
echo "The presentation has no slides to process." . PHP_EOL;
}
} finally {
$presentation->dispose();
}
Đối với việc xóa không điều kiện, removeAllHyperlinks xóa cả hai kiểu kích hoạt trong phạm vi đã chọn trong một lần gọi. Đối với việc làm sạch có chọn lọc và bao phủ các master, layout và notes, xem Báo Cáo, Làm Sạch và Xác Thực Siêu Liên Kết.
Xóa Siêu Liên Kết Trước Khi Thay Thế Văn Bản SmartArt
Khi bạn thay thế một đoạn trong một nút SmartArt hiện có, việc xóa các phần văn bản có thể để lại một siêu liên kết cũ còn hiệu lực. Lấy đoạn qua SmartArtNode::getTextFrame. Trước khi xóa các phần, gọi getHyperlinkQueries trên khung văn bản của hình dạng nút hiển thị đoạn, sau đó gọi removeAllHyperlinks trên đối tượng trả về. Điều này xóa mọi siêu liên kết trong khung đó, bao gồm các liên kết trong các đoạn khác.
Ví dụ giả định rằng hình dạng thứ ba trên slide đầu tiên của SmartArtHyperlink.pptx là một đồ thị SmartArt. Nó thay thế đoạn đầu tiên của nút thứ tư. Trong bản trình bày này, hình dạng đầu tiên của nút hiển thị đoạn đó.
Sau khi thêm cả hai phần, ví dụ đọc định dạng hiệu lực của chúng bằng getEffective. Trên định dạng đó, getHyperlinkClick trả về siêu liên kết mới cho phần đầu tiên và null cho phần thứ hai.
use aspose\slides\Hyperlink;
use aspose\slides\Portion;
use aspose\slides\Presentation;
$presentation = new Presentation("SmartArtHyperlink.pptx");
try {
$slide = $presentation->getSlides()->get_Item(0);
$smartArt = $slide->getShapes()->get_Item(2);
$node = $smartArt->getAllNodes()->get_Item(3);
$paragraph = $node->getTextFrame()->getParagraphs()->get_Item(0);
$node->getShapes()->get_Item(0)->getTextFrame()->getHyperlinkQueries()->removeAllHyperlinks();
$paragraph->getPortions()->clear();
$link = new Portion("New reference");
$link->getPortionFormat()->setHyperlinkClick(new Hyperlink("https://example.com/new"));
$paragraph->getPortions()->add($link);
$text = new Portion(" (updated)");
$paragraph->getPortions()->add($text);
echo java_values($link->getPortionFormat()->getEffective()->getHyperlinkClick()->getExternalUrl()), PHP_EOL; // https://example.com/new
var_dump(java_is_null($text->getPortionFormat()->getEffective()->getHyperlinkClick())); // bool(true): phần thứ hai không có siêu liên kết.
} finally {
$presentation->dispose();
}
Xây Dựng Danh Mục Siêu Liên Kết Đầy Đủ
Trước khi phân phối một bản trình bày, hãy kiểm kê các hành động tương tác cũng như các liên kết web của nó. getAnyHyperlinks trả về các đối tượng IHyperlinkContainer, không phải một danh sách phẳng các chuỗi URL. Kiểm tra cả getHyperlinkClick và getHyperlinkMouseOver trên mỗi container. Chúng độc lập: cùng một container có thể bật cả hai hành động, vì vậy một báo cáo đầy đủ có thể cần tới hai hàng cho mỗi container.
Quét chỉ các siêu liên kết ở mức hình dạng có thể bỏ sót các liên kết gắn vào các phần văn bản. Thay vào đó, truy vấn phạm vi thích hợp và giữ lại các container trả về để sau này có thể cập nhật hoặc xóa các hành động của chúng.
Truy Vấn Phạm Vi Bản Trình Bày, Slide và Khung Văn Bản
Lớp HyperlinkQueries có sẵn qua Presentation::getHyperlinkQueries, IBaseSlide::getHyperlinkQueries, và TextFrame::getHyperlinkQueries. Mỗi phạm vi hỗ trợ cùng các truy vấn:
- getHyperlinkClicks trả về các container có hành động nhấp.
- getHyperlinkMouseOvers trả về các container có hành động di chuột.
- getAnyHyperlinks trả về các container có một hoặc cả hai hành động.
Ví dụ này gán các hành động nhấp và di chuột cho một hình dạng và văn bản của nó, và một hành động macro cho một nút riêng. Nó so sánh số lượng container trả về bởi getAnyHyperlinks với số lượng cho mỗi kiểu kích hoạt. Một truy vấn khung văn bản chỉ đếm các liên kết trong văn bản. Các hành động riêng của hình dạng bao bọc xuất hiện trong các truy vấn slide và bản trình bày.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
function printQueryCounts($scope, $queries) {
$clickCount = java_values($queries->getHyperlinkClicks()->size());
$mouseOverCount = java_values($queries->getHyperlinkMouseOvers()->size());
$anyCount = java_values($queries->getAnyHyperlinks()->size());
echo "$scope: click=$clickCount, mouse-over=$mouseOverCount, any=$anyCount" . PHP_EOL;
}
$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$destination = $presentation->getSlides()->addEmptySlide($slide->getLayoutSlide());
$shape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 20, 20, 400, 60);
$shape->getTextFrame()->setText("Click the text to go to slide 2");
$shape->getHyperlinkManager()->setExternalHyperlinkClick("https://example.com/");
$shape->getHyperlinkClick()->setTooltip("Public website");
$shape->getHyperlinkManager()->setExternalHyperlinkMouseOver("file:///C:/private/report.xlsx");
$portionFormat = $shape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->getPortionFormat();
$portionFormat->getHyperlinkManager()->setInternalHyperlinkClick($destination);
$portionFormat->getHyperlinkManager()->setExternalHyperlinkMouseOver("https://example.com/help");
$macroButton = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 20, 120, 200, 60);
$macroButton->getHyperlinkManager()->setMacroHyperlinkClick("ReviewPresentation");
printQueryCounts("Presentation", $presentation->getHyperlinkQueries());
printQueryCounts("Slide 1", $slide->getHyperlinkQueries());
printQueryCounts("Text frame", $shape->getTextFrame()->getHyperlinkQueries());
$presentation->save("hyperlink-audit-input.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Trong ví dụ này, các truy vấn bản trình bày và slide mỗi đều báo cáo ba container nhấp, hai container di chuột và ba container có một trong hai hành động. Truy vấn khung văn bản báo cáo một container trong mỗi danh mục.
Phân Loại Hành Động và Đích Đến
Sử dụng Hyperlink::getActionType để diễn giải một hành động trước khi diễn giải đích đến của nó. Các giá trị HyperlinkActionType bao gồm hơn chỉ điều hướng web:
| Giá Trị | Ý Nghĩa cho Kiểm Toán |
|---|---|
Hyperlink |
Siêu liên kết bên ngoài; kiểm tra URL và scheme của nó. |
JumpSpecificSlide |
Điều hướng nội bộ đến một slide cụ thể. |
JumpFirstSlide, JumpPreviousSlide, JumpNextSlide, JumpLastSlide, JumpLastViewedSlide |
Điều hướng trình chiếu tích hợp, được giải quyết trong ngữ cảnh trình chiếu. |
JumpEndShow, StartCustomSlideShow |
Kết thúc buổi chiếu hiện tại hoặc bắt đầu một buổi chiếu tùy chỉnh. |
StartMacro |
Thực thi macro. |
StartProgram |
Khởi chạy chương trình. |
OpenFile, OpenPresentation |
Mở tệp hoặc bản trình bày khác; xem xét riêng biệt so với URL web. |
StartStopMedia |
Bắt đầu hoặc dừng phát phương tiện. |
NoAction, Unknown |
Không có hành động điều hướng, hoặc hành động không xác định cần xem xét. |
Đọc các đích đến bên ngoài từ getExternalUrl và các đích đến nội bộ cụ thể từ getTargetSlide. Các hành động nội bộ và lệnh tích hợp có thể không có URL bên ngoài; một URL trống không có nghĩa là container không có hành động. Giữ lại giá trị trả về bởi getExternalUrlOriginal khi nó khác URL đã chuẩn hoá, và bao gồm tooltip trả về bởi getTooltip khi có.
Báo Cáo, Làm Sạch và Xác Thực Siêu Liên Kết
Ví dụ này mở bản trình bày từ ví dụ trước và ghi một bản ghi JSON cho mỗi hành động. Nó sử dụng getAnyHyperlinks để thu thập các container trên các slide thường, master, layout và notes, bao gồm cả master notes và handout khi có. Nó dùng so sánh tham chiếu để đếm mỗi container một lần, áp dụng chính sách mô tả dưới đây, và mở lại bản trình bày đã lưu để kiểm tra cả hành động nhấp và di chuột.
Báo cáo ghi lại chỉ mục slide tính từ 1 và getSlideId khi có. ISlideComponent::getSlide cung cấp slide sở hữu cho các container được hỗ trợ. Các master, layout và notes không có chỉ mục slide thường và được xác định bằng phạm vi của chúng. Các container hình dạng và container định dạng phần văn bản được gắn nhãn riêng; các loại container khác giữ tên kiểu chạy thời gian. Mỗi container nhận một ID báo cáo cục bộ để hai hành động của nó có thể được liên kết. Báo cáo lưu trữ loại hành động dưới dạng các hằng số nguyên được định nghĩa bởi enum PHP.
Chính sách ứng dụng có chọn lọc này chỉ cho phép các URL HTTPS tuyệt đối và các đích slide nội bộ hợp lệ. Nó loại bỏ macro, chương trình, hành động tệp, các hành động trình chiếu khác, hành động không xác định và các scheme URL khác. Những loại loại bỏ này là quyết định chính sách, không phải một phán quyết an toàn của Aspose.Slides. HTTPS một mình không tạo niềm tin: hãy thêm danh sách cho phép host và các kiểm tra khác cho ứng dụng của bạn. Cả URL bên ngoài gốc và đã chuẩn hoá đều được kiểm tra. Ví dụ kiểm toán siêu dữ liệu mà không theo liên kết hay chạy hành động.
Để khắc phục, getHyperlinkManager của container hỗ trợ setExternalHyperlinkClick, removeHyperlinkClick và removeHyperlinkMouseOver. Ở đây, các liên kết click bên ngoài bị cấm được thay thế bằng một trang đích HTTPS cố định; các click và hành động di chuột bị cấm khác được xóa độc lập. Đặt $replaceExternalClicks thành false để xóa tất cả các vi phạm chính sách thay thế. Chọn một trang thay thế thuộc sở hữu ứng dụng trước khi triển khai.
Cờ xuất khẩu của báo cáo sử dụng một chính sách xem xét PDF thận trọng: đánh dấu các hành động di chuột và bất kỳ gì không phải là liên kết bên ngoài hoặc chuyển slide cụ thể là có khả năng không được hỗ trợ. Đây là một gợi ý xem xét, không phải một bài kiểm tra khả năng hay bảo đảm rằng các liên kết không bị đánh dấu sẽ tồn tại sau khi xuất. Các xuất khẩu PDF và HTML được hỗ trợ (PDF, HTML) có thể giữ lại siêu liên kết, tùy thuộc vào hành động, tùy chọn xuất và trình xem. Các hình ảnh raster (images) và video (video) không thể giữ lại siêu liên kết tương tác; đánh dấu mọi hành động khi kiểm toán cho các đầu ra đó.
use aspose\slides\HyperlinkActionType;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
class HyperlinkAudit {
public function slideIndex($presentation, $slide) {
if (java_is_null($slide)) return null;
for ($index = 0; $index < java_values($presentation->getSlides()->size()); $index++) {
if (java_values($presentation->getSlides()->get_Item($index)->equals($slide))) return $index + 1;
}
return null;
}
public function isHttps($value) {
if ($value === null || $value === '') return false;
$parts = parse_url($value);
return $parts !== false && isset($parts['scheme'], $parts['host']) && strcasecmp($parts['scheme'], 'https') === 0 && $parts['host'] !== '';
}
public function policyViolation($link) {
if (java_is_null($link)) return null;
$action = java_values($link->getActionType());
if ($action === HyperlinkActionType::JumpSpecificSlide) {
return java_is_null($link->getTargetSlide()) ? 'Missing target slide' : null;
}
if ($action !== HyperlinkActionType::Hyperlink) return 'Action is not allowed';
if (!$this->isHttps(java_values($link->getExternalUrl()))) return 'Normalized URL is not absolute HTTPS';
$original = java_values($link->getExternalUrlOriginal());
if ($original !== null && $original !== '' && !$this->isHttps($original)) return 'Original URL is not absolute HTTPS';
return null;
}
public function addScope(&$found, $slide) {
if (!java_is_null($slide)) {
foreach ($slide->getHyperlinkQueries()->getAnyHyperlinks() as $container) {
$found[] = $container;
}
}
}
public function collectContainers($presentation) {
$found = [];
foreach ($presentation->getHyperlinkQueries()->getAnyHyperlinks() as $container) {
$found[] = $container;
}
$masters = $presentation->getMasters();
for ($index = 0; $index < java_values($masters->size()); $index++) {
$this->addScope($found, $masters->get_Item($index));
}
$layouts = $presentation->getLayoutSlides();
for ($index = 0; $index < java_values($layouts->size()); $index++) {
$this->addScope($found, $layouts->get_Item($index));
}
$slides = $presentation->getSlides();
for ($index = 0; $index < java_values($slides->size()); $index++) {
$this->addScope($found, $slides->get_Item($index)->getNotesSlideManager()->getNotesSlide());
}
$this->addScope($found, $presentation->getMasterNotesSlideManager()->getMasterNotesSlide());
$this->addScope($found, $presentation->getMasterHandoutSlideManager()->getMasterHandoutSlide());
$seen = new Java('java.util.IdentityHashMap');
$unique = [];
foreach ($found as $container) {
if (!java_values($seen->containsKey($container))) {
$seen->put($container, true);
$unique[] = $container;
}
}
return $unique;
}
public function addRow(&$rows, $presentation, $link, $activation, $container, $containerId) {
if (java_is_null($link)) return;
$ownerSlide = java_instanceof($container, java('com.aspose.slides.ISlideComponent')) ? $container->getSlide() : null;
$targetSlide = $link->getTargetSlide();
$violation = $this->policyViolation($link);
$ownerType = java_instanceof($container, java('com.aspose.slides.IShape')) ? 'Shape' : (java_instanceof($container, java('com.aspose.slides.IPortionFormat')) ? 'Text portion' : java_values($container->getClass()->getSimpleName()));
$action = java_values($link->getActionType());
$ordinaryAction = $action === HyperlinkActionType::Hyperlink || $action === HyperlinkActionType::JumpSpecificSlide;
$externalUrl = java_values($link->getExternalUrl());
$originalUrl = java_values($link->getExternalUrlOriginal());
$rows[] = [
'ContainerId' => $containerId,
'SlideIndex' => $this->slideIndex($presentation, $ownerSlide),
'SlideId' => java_is_null($ownerSlide) ? null : java_values($ownerSlide->getSlideId()),
'Scope' => java_is_null($ownerSlide) ? null : java_values($ownerSlide->getClass()->getSimpleName()),
'OwnerType' => $ownerType,
'Activation' => $activation,
'ActionType' => $action,
'ExternalUrl' => $externalUrl,
'TargetSlideIndex' => $this->slideIndex($presentation, $targetSlide),
'TargetSlideId' => java_is_null($targetSlide) ? null : java_values($targetSlide->getSlideId()),
'Tooltip' => java_values($link->getTooltip()),
'OriginalExternalUrl' => $originalUrl === $externalUrl ? null : $originalUrl,
'PotentiallyUnsafe' => $violation !== null,
'PolicyViolation' => $violation,
'TargetExport' => 'PDF',
'PotentiallyUnsupportedByExport' => $activation === 'mouse-over' || !$ordinaryAction
];
}
}
$replaceExternalClicks = true;
$replacementUrl = 'https://example.com/blocked-link';
$audit = new HyperlinkAudit();
$presentation = new Presentation('hyperlink-audit-input.pptx');
try {
$containers = $audit->collectContainers($presentation);
$rows = [];
foreach ($containers as $index => $container) {
$audit->addRow($rows, $presentation, $container->getHyperlinkClick(), 'click', $container, $index + 1);
$audit->addRow($rows, $presentation, $container->getHyperlinkMouseOver(), 'mouse-over', $container, $index + 1);
}
$json = json_encode($rows, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
if ($json === false) {
echo 'Unable to encode the audit report: ' . json_last_error_msg() . PHP_EOL;
} elseif (file_put_contents('hyperlink-audit.json', $json . PHP_EOL) === false) {
echo 'Unable to write the audit report.' . PHP_EOL;
} else {
foreach ($containers as $container) {
$click = $container->getHyperlinkClick();
if ($audit->policyViolation($click) !== null) {
if ($replaceExternalClicks && java_values($click->getActionType()) === HyperlinkActionType::Hyperlink) {
$container->getHyperlinkManager()->setExternalHyperlinkClick($replacementUrl);
} else {
$container->getHyperlinkManager()->removeHyperlinkClick();
}
}
if ($audit->policyViolation($container->getHyperlinkMouseOver()) !== null) {
$container->getHyperlinkManager()->removeHyperlinkMouseOver();
}
}
$presentation->save('hyperlink-sanitized.pptx', SaveFormat::Pptx);
$reopened = new Presentation('hyperlink-sanitized.pptx');
try {
$remainingContainers = $audit->collectContainers($reopened);
$violations = 0;
foreach ($remainingContainers as $container) {
if ($audit->policyViolation($container->getHyperlinkClick()) !== null) $violations++;
if ($audit->policyViolation($container->getHyperlinkMouseOver()) !== null) $violations++;
}
echo 'Audit rows: ' . count($rows) . '; prohibited actions after reopening: ' . $violations . PHP_EOL;
if ($violations !== 0) {
echo 'Verification failed: do not distribute the saved presentation.' . PHP_EOL;
}
} finally {
$reopened->dispose();
}
}
} finally {
$presentation->dispose();
}
Với đầu vào được tạo ở trên, báo cáo chứa năm hàng hành động. Liên kết di chuột của tệp và click macro bị xóa, trong khi các liên kết HTTPS và điều hướng slide nội bộ vẫn còn. Kiểm tra xác nhận không có hành động bị cấm. Một đầu vào chứa URL click bên ngoài bị cấm cũng thực hiện nhánh thay thế. Một container có click được cho phép và di chuột bị cấm vẫn giữ hành động click của nó.
Quy trình làm sạch có chọn lọc này khác với removeAllHyperlinks, cái mà xóa cả hai kiểu kích hoạt trên toàn phạm vi đã chọn bất kể chính sách. Việc xác thực ở đây chỉ kiểm tra các hành động siêu liên kết; nó không xóa các dự án VBA nhúng, đối tượng OLE hoặc nội dung hoạt động khác, và không xác thực tệp PDF hoặc HTML đã xuất.
Câu Hỏi Thường Gặp
Làm thế nào tôi có thể liên kết tới một phần hoặc slide đầu tiên của nó?
Các phần trong PowerPoint nhóm các slide, nhưng một siêu liên kết nội bộ nhắm tới một slide cá nhân. Để tạo điều hướng tới một phần, hãy liên kết tới slide đầu tiên trong phần đó.
Tôi có thể gắn siêu liên kết vào các phần tử master slide để nó hoạt động trên mọi slide không?
Có. Các phần tử master slide và layout hỗ trợ siêu liên kết. Các liên kết trên các phần tử này khả dụng trong chế độ trình chiếu trên các slide sử dụng master hoặc layout tương ứng.
Liệu siêu liên kết có được giữ lại khi xuất sang PDF, HTML, hình ảnh hoặc video không?
Các xuất khẩu PDF và HTML được hỗ trợ có thể giữ lại siêu liên kết; các hình ảnh raster và video không thể. Xem xét các lưu ý xuất khẩu trong Báo Cáo, Làm Sạch và Xác Thực Siêu Liên Kết.