modalRoute static method

Widget modalRoute({
  1. required Widget child,
})

Fronteira de ROTA de uma superfície modal (dialog, bottom/side sheet).

scopesRoute diz à camada de acessibilidade que ali começa uma rota: o leitor de tela passa a tratar o conteúdo como a tela corrente em vez de mais um pedaço da anterior. Sem isso o modal abre e o usuário de leitor continua navegando a tela DE BAIXO, sem saber que algo apareceu na frente.

explicitChildNodes impede que o conteúdo inteiro colapse num nó só — numa sheet com formulário, isso viraria um parágrafo gigante.

Implementation

static Widget modalRoute({required Widget child}) =>
    Semantics(scopesRoute: true, explicitChildNodes: true, child: child);