Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

[ui/accessibility] Update web-accessibility.md for Flutter 3.50 WCAG 2.1 AA improvements and fix duplicated sentence

Abierto
  • ¿Algo no está bien?
#13,963 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

@kevmoo ya está trabajando en esto.

Desde el 16/10/2026.

  • #13987 de @kevmoo — abierto

Evaluación

Dificultad
3/5
Tiempo estimado
1-2 días
Aptitud para principiantes
65/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
dart, flutter, markdown
Área
accessibility, documentation

Línea de trabajo

Start with sites/docs/src/content/ui/accessibility/web-accessibility.md and sites/docs/src/content/ui/accessibility/accessibility-testing.md, then verify the Flutter 3.50 behavior against the linked Flutter pull requests. Remove the duplicated sentence, document the listed web accessibility changes, and add the debugShowSemanticsNodes guidance. Done when both pages reflect the requested updates and the documentation checks pass.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

a.rn.release-notes d.enhancement e1-hours fix.typo from.team p2-medium t.a11y target.web
Page URL
Describe the problem

sites/docs/src/content/ui/accessibility/web-accessibility.md and sites/docs/src/content/ui/accessibility/accessibility-testing.md need a copy fix and updates for the Flutter 3.50 Web accessibility (WCAG 2.1 AA) improvements (cc @parlough @sfshaza2):

  1. Duplicated sentence in web-accessibility.md: web-accessibility.md#L49-L50 repeats "to users. For example, a role can indicate if/whether a widget is a button, a link," on two consecutive lines.
  2. Missing Flutter 3.50 Web accessibility & SemanticsRole improvements: web-accessibility.md#L64-L80 and accessibility-testing.md#L103-L115 can be expanded to cover SemanticsRole.slider, multi-view semantics placeholder scoping, browser zoom support, and debugShowSemanticsNodes.
Detailed page breakdown & affected targets (AI-assisted)
Expected fix
1. sites/docs/src/content/ui/accessibility/web-accessibility.md (https://docs.flutter.dev/ui/accessibility/web-accessibility)
  • Fix duplicated line (L49-L51): Remove line 49 (to users. For example, a role can indicate if a widget is a button, a link,) and keep line 50.
  • Expand ### Using SemanticsRole in Flutter for web (L64-L80) and Web Accessibility behavior:
    • SemanticsRole.slider & <input type="range">: RangeSlider assigns SemanticsRole.slider to each thumb (flutter/flutter#193324), and the web engine's SemanticIncrementable (used by Slider) and SemanticSlider (used by SemanticsRole.slider) expose a focusable <input type="range"> element with synchronized aria-valuenow / aria-valuetext and keyboard handling in the web semantics DOM (flutter/flutter#192964).
    • Landmark & menu ARIA roles: Named routes with scopesRoute: true and a non-empty namesRoute label emit role="region" landmarks (flutter/flutter#192965).
    • Focus preservation & keyboard navigation: The web engine now preserves DOM focus across semantic role changes via focusWithoutScroll() (flutter/flutter#192963), restores focus properly when dialogs/modals close in WidgetsApp.router apps (flutter/flutter#192601), and dismisses visible Tooltips when pressing Escape (flutter/flutter#193192).
    • Browser zoom & multi-view scoping: Note that Flutter Web's <meta flt-viewport> supports browser pinch-to-zoom up to maximum-scale=5.0 (flutter/flutter#182047), prevents unintended iOS Safari auto-zoom on text inputs (flutter/flutter#192328), and scopes the Enable accessibility <flt-semantics-placeholder> button inside each <flutter-view> in embedded/multi-view apps (flutter/flutter#190856).
2. sites/docs/src/content/ui/accessibility/accessibility-testing.md (https://docs.flutter.dev/ui/accessibility/accessibility-testing)
  • Under ## Testing accessibility on the web (L103-L115), mention that developers can also enable semantic node visualization at runtime in flutter_bootstrap.js via debugShowSemanticsNodes: true in _flutter.loader.load({ config: { debugShowSemanticsNodes: true } }) (linking to /platform-integration/web/initialization).
Lenguaje dominante
Dart
Estrellas
3.1k
Forks
3.5k
Merge medio
2 d 3 h
PR fusionados (30 d)
49

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de flutter/website

Todos los issues de flutter/website

Issues similares

Más issues de Dart

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.