TypeScript Lab: Decorative SVG Assist

LAB / EXPLORATION

TypeScript Lab: Decorative SVG Assist

Planned

LAB 080 — Semantic HTML
Hide unnamed decorative SVG icons from assistive technology.

LAB TypeScript Lab: Decorative SVG Assist Preview coming soon

LAB 080

TypeScript Lab: Decorative SVG Assist

Concept

Unnamed icon SVG can be marked decorative when no accessible naming exists.

Concept

Unnamed icon SVG can be marked decorative when no accessible naming exists.

Objective & Explanation

What the project should make visible and why the concept matters.

Learning Target

Objective

Hide unnamed decorative SVG icons from assistive technology.

Explanation

Unnamed icon SVG can be marked decorative when no accessible naming exists.

Project Plan

Structure, technologies, data boundary, and source connection.

Structure

project/
├── package.json
├── tsconfig.json
├── index.html
├── styles.css
└── src/
    └── app.ts

Technologies

TypeScript
DOM
HTML
CSS

Data Layer

No persistent data layer. Keep all demonstration values inside the standalone project.

Sandbox Source

src/local-editor/client.ts → semanticAssistHtml()

Build Instructions

Build only the focused behavior, then use the visual layer to inspect it.

Setup

Create the standalone project folder and listed files.

Implement

Implement the smallest version that demonstrates the concept.

Run & Inspect

Change one input and observe the visible output change.

Code & Configuration

Starter configuration plus the focused implementation example.

Focused TypeScript

Implement this behavior first, then alter the input.

document.querySelectorAll("svg").forEach(svg => {
  if (!svg.hasAttribute("aria-label") && !svg.querySelector("title")) {
    svg.setAttribute("aria-hidden", "true");
    svg.setAttribute("focusable", "false");
  }
});

Starter Configuration

Keep the project independently buildable.

package.json

{
  "type": "module",
  "scripts": { "build": "tsc" },
  "devDependencies": { "typescript": "^7.0.2" }
}

tsconfig.json

{
  "compilerOptions": {
    "rootDir": "./src",
    "outDir": "./dist",
    "target": "ES2022",
    "module": "ES2022",
    "lib": ["ES2022", "DOM"],
    "strict": true,
    "sourceMap": true
  },
  "include": ["src/**/*.ts"]
}

Expected Visual Result

The output is the proof that the concept is working.

Visible Proof

The browser should visibly demonstrate: hide unnamed decorative SVG icons from assistive technology.

Data: None