Navegar no calendário / Navigate calendar to

Navegar no calendário / Navigate calendar to

O bloco altera a visualização do componente Calendário conforme a configuração definida, podendo ser: mês, ano, década ou século.

Figura 1 - Bloco Navegar no calendário

Compatibilidade

  • Bloco cliente: cronapi.calendar.navigateCalendarTo()

Retorno

O bloco não possui retorno.

Parâmetros

Id

Identificador (id) do componente Calendário. Para obtê-lo, é necessário vincular o bloco de programação a um formulário de referência, confira no tópico Propriedades do Blockly da documentação Bloco de Programação.

  • Posição: 1

  • Inglês: Id

  • Tipo: Objeto / Object

  • Exemplo: "crn-cron-calendar-212931"

Valor

Recebe o conteúdo em formato de data.

  • Posição: 2

  • Inglês: Value

  • Tipo: Data / Date

  • Exemplo: utilização do bloco Nova data

Visão do calendário

Modo como o calendário será exibido.

  • Posição: 3

  • Inglês: Calendar view

  • Tipo: Objeto / Object

  • Exemplo: Ano

  • Opções::

    • Mês: exibição padrão do calendário, com meses e dias.

    • Ano: exibe os anos e os meses.

    • Década: exibe o calendário por décadas. 

    • Século: exibe o calendário por séculos.

Exemplo

A função abaixo, recebe, no parâmetro Id, o identificador do componente Calendário e, no parâmetro Valor, recebe a data que irá iniciar o calendário. Por fim, no parâmetro Visão do calendário informamos que exibiremos o calendário a partir dos anos.

Figura 2 - Exemplo de uso do bloco Navegar no calendário

 

A figura 2.1 representa a exibição do calendário antes e depois da execução da função. Na imagem à esquerda (1) observamos o componente Calendário em seu formato padrão. Ao acionarmos o botão Navegar no calendário, sua exibição será alterada para exibir as informações a partir dos anos (2).

Figura 2.1 - Visão do calendário antes e depois da execução da função