Skip to content

Ações de UI ​

Use ui.actions para conectar os botões de chamada para ação da plataforma (login, assinatura, compartilhamento...) aos modais ou fluxos do seu próprio site.


js
MindtrainingPlatform.init('mindtraining', {
  ui: {
    mode: 'web', // 'web' (padrão) | 'app'
    actions: {
      openLogin: function () {
        // abre o seu modal de login
      },
      openRegister: function () {
        // abre o seu modal de cadastro
      },
      openSubscribe: function () {
        // abre a sua página ou modal de assinatura
      },
      openUrl: function (url) {
        window.open(url, '_blank')
      },
      share: function (payload) {
        // payload: { url?: string, title?: string }
        navigator.share({ url: payload.url, title: payload.title })
      },
    },
  },
})

Defina ui.mode como 'app' quando incorporar a plataforma dentro de uma WebView nativa mobile para ajustar determinados comportamentos de UI.

showBackNavigation é um booleano opcional de nível superior que controla a visibilidade dos botões de voltar da plataforma. O valor padrão é true.

Defina-o como false quando a aplicação hospedeira fornecer sua própria navegação para voltar e avançar:

js
MindtrainingPlatform.init('mindtraining', {
  showBackNavigation: false,
})

Esta opção oculta os botões de voltar no jogo, na subpágina inicial, no arquivo, nas estatísticas e nos painéis de jogo apresentados como páginas. Não desativa o histórico do navegador nem altera os eventos de navegação, as regras de acesso ou os controles para fechar caixas de diálogo e painéis laterais.

A aplicação hospedeira deve oferecer uma forma de voltar dessas telas. Para mostrar os botões novamente sem remontar a plataforma:

js
MindtrainingPlatform.updateConfig({ showBackNavigation: true })

Chamadas a updateConfig() que alteram outras opções preservam o valor atual. setConfig() substitui a configuração; portanto, omitir esta opção restaura seu valor para true.

Esquema de cores ​

ui.colorScheme seleciona a paleta de cores nos sites em que esse recurso está habilitado. Os sites compatíveis incluem Entrenamentes e Le Monde.

  • 'light' (padrão): força a paleta clara.
  • 'dark': força a paleta escura.
  • 'system': segue a preferência do dispositivo por meio de prefers-color-scheme e responde às mudanças enquanto a plataforma está montada.

Configure a preferência inicial ao montar a plataforma:

js
MindtrainingPlatform.init('mindtraining', {
  ui: { colorScheme: 'system' },
})

A aplicação hospedeira pode alterá-la durante a execução sem montar a plataforma novamente:

js
MindtrainingPlatform.updateConfig({ ui: { colorScheme: 'dark' } })
MindtrainingPlatform.updateConfig({ ui: { colorScheme: 'light' } })
MindtrainingPlatform.updateConfig({ ui: { colorScheme: 'system' } })

A plataforma não adiciona botões nem seletores de tema; a aplicação hospedeira controla a preferência e qualquer interface usada para alterá-la. Essa propriedade é independente de ui.mode ('web' / 'app'). Sites sem suporte a esquemas de cores mantêm a apresentação atual.

Chamadas a updateConfig() que modificam outras opções preservam a preferência selecionada. setConfig() substitui a configuração; portanto, omitir ui.colorScheme restaura 'light'.

As paletas clara e escura são editadas separadamente no painel administrativo. As configurações existentes começam com as mesmas cores nos dois modos: selecionar o modo escuro não escurece a paleta automaticamente; personalize suas cores no painel administrativo.

Visibilidade da tela de jogo ​

Estes booleanos opcionais de nível superior têm valor padrão true nos layouts de jogo compatíveis.

showMobileGameHeader: false oculta a barra móvel de título e data abaixo dos controles. O título no desktop e os controles permanecem visíveis.

showOtherGames: false oculta a seção de outros jogos abaixo do tabuleiro em qualquer largura do contêiner, incluindo o espaço reservado. Os diretórios em outras telas e as recomendações de fim de partida não são afetados.

As duas opções são independentes de ui.mode e das permissões de acesso. Layouts sem suporte mantêm a apresentação atual.

js
MindtrainingPlatform.init('mindtraining', {
  showMobileGameHeader: false,
  showOtherGames: false,
})

Use updateConfig() para alterar cada opção sem remontar a plataforma. Atualizações não relacionadas preservam os dois valores. setConfig() substitui a configuração; opções omitidas voltam a true.

js
MindtrainingPlatform.updateConfig({
  showMobileGameHeader: true,
  showOtherGames: true,
})

Os sites filhos herdam estas opções do layout de jogo do site pai, salvo quando substituem explicitamente esse comportamento.

Interceptação de navegação ​

Todos os sites herdam o callback opcional ui.actions.navigate, que recebe uma solicitação serializável antes da navegação do SDK, nos modos web e app. Interceptação de navegação.

Client integration documentation maintained in-repo.