# 在 Java 中管理演示文稿可访问性

> 了解 Aspose.Slides for Java 如何帮助自动化 PPT、PPTX 和 ODP 文件的演示文稿可访问性检查——提升屏幕阅读器体验并增强合规性。

Source: https://docs.aspose.com/slides/zh/java/presentation-accessibility/
Updated: 2026-09-25

## **简介**

替代文本帮助使用辅助技术的人员了解图像、图表和其他信息形状的含义。本文介绍如何使用 Aspose.Slides for Java 读取和更新替代文本标题和描述，区分代码中使用的形状名称与可访问性描述，并检查形状是否标记为装饰性。

这些功能支持演示文稿的可访问性，但并不能保证完全可访问。还需要检查阅读顺序、颜色对比、文本可读性以及其他可访问性要求。

## **管理替代文本标题和描述**

使用替代文本向看不到图像的人员解释图像、图表和其他信息形状的含义。以下方法和内容各有不同用途：

| 方法或内容 | 目的 |
| --- | --- |
| [getAlternativeTextTitle](https://reference.aspose.com/slides/zh/java/com.aspose.slides/ishape/#getAlternativeTextTitle--) | 替代描述的简短标题。 |
| [getAlternativeText](https://reference.aspose.com/slides/zh/java/com.aspose.slides/ishape/#getAlternativeText--) | 对形状内容或在幻灯片上下文中目的的有意义描述。 |
| [getName](https://reference.aspose.com/slides/zh/java/com.aspose.slides/ishape/#getName--) | 形状的名称，代码可使用它在演示文稿中查找特定形状。 |
| Visible text | 幻灯片上显示的内容，如形状的文本或图表的标题和标签。更新替代文本不会更改此内容。 |

当演示文稿作为模板重复使用时，代码可能会先通过 [getName](https://reference.aspose.com/slides/zh/java/com.aspose.slides/ishape/#getName--) 返回的名称找到形状再进行更新。该名称的作用与替代文本不同，后者解释视觉内容向阅读者传达了什么。通过名称查找可让作者在不影响代码定位形状的前提下改进或翻译描述。名称可以编辑且不一定唯一，因此请检查名称是否匹配预期的形状；参见 [Identify and Find Shapes](/slides/zh/java/shape-manipulations/#identify-and-find-shapes)。

下面的示例需要 `input.pptx`，其中第一张幻灯片的第一个形状是办公室入口的图片，并且该图片未标记为装饰性。示例读取并打印当前的替代文本标题和描述，更新这两个值后将演示文稿保存为 `output.pptx`。请根据实际图片及其所传递的信息调整文案。

```java
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](https://reference.aspose.com/slides/zh/java/com.aspose.slides/ishape/#isDecorative--)。

## **标记为装饰性**

标记为装饰性用于纯装饰性的视觉内容，使屏幕阅读器跳过它们，减少噪音并将注意力集中在有意义的内容上。应将其应用于背景、花纹和间隔元素——绝不能用于传递信息的图表、图标或图像。Aspose.Slides 为此标志提供检测和验证功能，从而实现自动化的可访问性检查和清理。

![标记为装饰性](mark_as_decorative.png)

以下代码示例演示如何判断形状是否标记为装饰性。

```java
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](https://reference.aspose.com/slides/zh/java/com.aspose.slides/ishape/#getName--) 返回的名称来找到形状，并确认它是期望的形状。替代文本可能会被编辑或翻译，这会导致搜索精确描述的代码失效；参见 [Identify and Find Shapes](/slides/zh/java/shape-manipulations/)。

**何时应该将形状标记为装饰性？**

对不提供任何信息的视觉元素使用装饰性标志，例如纯装饰性的花纹。传递意义的图片和图表需要相应的描述，而不是标记为装饰性。

**添加替代文本就能使演示文稿完全可访问吗？**

不能。替代文本只解决可访问性的一部分。还需审查阅读顺序、颜色对比、文本可读性以及其他适用要求，仅设置这些属性并不能实现合规。