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