Hantera presentationstillgänglighet i Java

Introduktion

Alternativ text hjälper personer som använder hjälpmedel att förstå betydelsen av bilder, diagram och andra informativa former. Den här artikeln förklarar hur man läser och uppdaterar titlar och beskrivningar för alternativ text med Aspose.Slides för Java, skiljer åt åtkomstbeskrivningar från figurnamn som används i kod, samt kontrollerar om en figur är markerad som dekorativ.

Dessa funktioner stödjer tillgänglighet i presentationer, men garanterar inte det. Läsordning, färgkontrast, läsbarhet av text och andra tillgänglighetskrav måste också granskas.

Hantera titlar och beskrivningar för alternativ text

Använd alternativ text för att förklara betydelsen av bilder, diagram och andra informativa former för personer som inte kan se dem. Följande metoder och innehåll har olika syften:

Metod eller innehåll Syfte
getAlternativeTextTitle En kort titel för den alternativa beskrivningen.
getAlternativeText En meningsfull beskrivning av figurens innehåll eller syfte i bildens kontext.
getName Figurens namn, som kod kan använda för att hitta en specifik figur i presentationen.
Visible text Innehåll som visas på bilden, såsom en figs text eller ett diagrammets titel och etiketter. Att uppdatera alternativ text ändrar inte detta innehåll.

När en presentation återanvänds som en mall kan kod hitta en figur genom namnet som returneras av getName innan den uppdateras. Detta namn har ett annat syfte än alternativ text, som förklarar vad den visuella delen kommunicerar till läsaren. Att söka på namn möjliggör för författare att förbättra eller översätta beskrivningar utan att ändra hur koden hittar figuren. Namn kan redigeras och är inte garanterade att vara unika, så kontrollera att namnet matchar den avsedda figuren; se Identify and Find Shapes.

Följande exempel kräver input.pptx med en bild av en kontorsentré som den första figuren på den första bilden. Bilden bör inte vara markerad som dekorativ. Exemplet läser och skriver ut dess nuvarande titel och beskrivning för alternativ text, uppdaterar båda värdena och sparar presentationen som output.pptx. Anpassa formuleringen till den faktiska bilden och den information den förmedlar.

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();
}

Att bara lägga till alternativ text garanterar inte presentationens tillgänglighet eller efterlevnad av tillgänglighetsstandarder. Granska beskrivningarna för noggrannhet och relevans, och kontrollera även läsordning, färgkontrast, läsbar text och andra tillgänglighetskrav. Informativa visuella element bör inte markeras som dekorativa; nästa avsnitt visar hur man kontrollerar isDecorative.

Markera som dekorativ

Markera som dekorativ flaggar rena dekorativa visuella element så att skärmläsare hoppar över dem, vilket minskar brus och behåller fokus på meningsfullt innehåll. Använd det på bakgrunder, utsmyckningar och avståndsmarkörer—aldrig på diagram, ikoner eller bilder som förmedlar information. Aspose.Slides exponerar denna flagga för detektering och validering, vilket möjliggör automatiska tillgänglighetskontroller och rensning.

Mark as Decorative

Följande kodexempel visar hur man avgör om en figur är markerad som dekorativ.

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();
}

Vanliga frågor

Vad bör jag skriva i titeln och beskrivningen för alternativ text?

Använd en kort titel för att identifiera ämnet och en beskrivning för att förklara den information som den visuella delen förmedlar i bildens kontext. För ett diagram, beskriv den relevanta trenden eller jämförelsen istället för att bara säga “diagram”.

Ska jag använda alternativ text för att hitta figurer i en mall?

Föredra att hitta figuren med namnet som returneras av getName och kontrollera att det är den förväntade figuren. Alternativ text kan redigeras eller översättas, vilket kan bryta kod som söker efter en exakt beskrivning; se Identify and Find Shapes.

När ska en figur markeras som dekorativ?

Använd den dekorativa flaggan för visuella element som inte tillför någon information, såsom ornamentala utsmyckningar. Bilder och diagram som förmedlar betydelse behöver en lämplig beskrivning istället.

Gör tillägg av alternativ text en presentation fullt tillgänglig?

Nej. Alternativ text adresserar bara en del av tillgängligheten. Granska även läsordning, färgkontrast, textläsbarhet och andra tillämpliga krav; att bara sätta dessa egenskaper skapar inte efterlevnad.