管理 Java 中的簡報可存取性
簡介
替代文字可協助使用輔助技術的人士了解圖像、圖表和其他資訊圖形的含義。本文說明如何使用 Aspose.Slides for Java 讀取與更新替代文字標題與說明,如何將可存取說明與程式碼中使用的形狀名稱區分,並檢查形狀是否被標示為裝飾性。
這些功能支援簡報的可存取性,但並不保證完整可存取。仍需檢查閱讀順序、色彩對比、文字可讀性以及其他可存取性需求。
管理替代文字標題與說明
使用替代文字向無法看到圖像的人解釋圖像、圖表和其他資訊圖形的含義。下列方法與內容各有不同用途:
| 方法或內容 | 目的 |
|---|---|
| getAlternativeTextTitle | 替代說明的簡短標題。 |
| getAlternativeText | 在投影片情境中,說明形狀內容或目的的有意義描述。 |
| getName | 形狀的名稱,程式碼可用於在簡報中找到特定形狀。 |
| Visible text | 投影片上顯示的內容,例如形狀文字或圖表的標題與標籤。更新替代文字不會改變此內容。 |
當簡報作為範本重複使用時,程式碼可能會先透過 getName 取得的名稱找到形狀,再進行更新。此名稱的用途不同於說明視覺內容傳遞給讀者的替代文字。以名稱搜尋允許作者在不改變程式碼尋找方式的前提下,改善或翻譯說明。名稱可以編輯且不保證唯一,因此請確認名稱與目標形狀相符;詳情請參閱 Identify and Find Shapes。
以下範例需要 input.pptx,其中第一張投影片的第一個形狀是一張辦公室入口的圖片,且該圖片未被標示為裝飾性。範例會讀取並列印其目前的替代文字標題與說明,更新兩個值,然後將簡報儲存為 output.pptx。請依實際圖片與其傳遞的資訊調整文字內容。
import com.aspose.slides.*;
Presentation presentation = new Presentation("input.pptx");
try {
IShape shape = presentation.getSlides().get_Item(0).getShapes().get_Item(0);
System.out.println("Alternative text title: " + shape.getAlternativeTextTitle());
System.out.println("Alternative text description: " + shape.getAlternativeText());
shape.setAlternativeTextTitle("Office entrance");
shape.setAlternativeText("The office entrance has a wheelchair ramp to the right of the steps.");
presentation.save("output.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
僅加入替代文字並不保證簡報可存取或符合可存取性標準。請檢查說明的正確性與相關性,同時審視閱讀順序、色彩對比、可讀文字以及其他可存取性需求。資訊性視覺不應被標示為裝飾性;下一節將說明如何檢查 isDecorative。
標示為裝飾性
將純裝飾性的視覺標示為裝飾性,可讓螢幕閱讀器略過它們,減少噪音並將焦點保留在有意義的內容上。此標記適用於背景、裝飾圖樣與間距物件——絕不適用於傳遞資訊的圖表、圖示或圖像。Aspose.Slides 為此旗標提供偵測與驗證功能,支援自動化的可存取性檢查與清理。

以下程式碼範例示範如何判斷形狀是否被標示為裝飾性。
import com.aspose.slides.*;
Presentation presentation = new Presentation("sample.pptx");
try {
IShape shape = presentation.getSlides().get_Item(0).getShapes().get_Item(0);
System.out.println("Is shape decorative: " + shape.isDecorative());
} finally {
presentation.dispose();
}
常見問題
應在替代文字標題與說明中填寫什麼內容?
使用簡短的標題辨識主題,並以說明文字闡述視覺在投影片情境中傳遞的資訊。對於圖表,描述相關的趨勢或比較,而非僅寫「圖表」。
我應該使用替代文字來定位範本中的形狀嗎?
建議以 getName 回傳的名稱尋找形狀,並確認其為預期的形狀。替代文字可能會被編輯或翻譯,若以精確說明搜尋可能會導致程式碼失效;請參閱 Identify and Find Shapes。
什麼時候應將形狀標示為裝飾性?
對於不提供資訊、僅具裝飾性的視覺使用裝飾性旗標。傳遞意義的圖像與圖表則需要適當的說明文字。
加入替代文字就能使簡報完全可存取嗎?
不能。替代文字只解決可存取性的一部份。仍需檢查閱讀順序、色彩對比、文字可讀性以及其他相關需求;僅設定這些屬性並不代表符合規範。