flows.md · documentação · Blocos

@track#

O percurso que uma linha de uma coleção guarda — uma corrida, um pedal, uma trilha, uma entrega — desenhado na página: só a linha, um círculo onde começa e um quadrado onde termina. Não há mapa por baixo, e a página não carrega nada de nenhum serviço de mapas: ninguém de fora fica sabendo por onde alguém correu.

Ao vivo#

Os exemplos leem a coleção percursos-exemplo, declarada nesta página (um leitor não vê a declaração), com três percursos inventados.

```@track collection:percursos-exemplo field:percurso
@filter codigo eq lagoa
```

Embaixo do desenho, a distância calculada pelos pontos e, quando os pontos trazem altitude, o ganho de elevação. Quem usa leitor de tela ouve o desenho em palavras: "Percurso, 12,3 km".

O que o campo guarda#

Um campo text ou long_text com os pontos em ordem, cada um latitude,longitude — e um terceiro número, se houver, é a altitude em metros. Os pontos vêm separados por espaço, quebra de linha ou ;:

-27.59000,-48.52000,12 -27.59086,-48.51903,13 -27.59171,-48.51806,15

Uma lista JSON de [lat, lng] ou [lat, lng, altitude] também vale. O percurso é lido inteiro ou não é lido: um ponto que não é um par de números, uma latitude além de 90 ou uma longitude além de 180, e nada é desenhado — aparece o texto de empty:, nunca um erro.

Qual linha#

O bloco desenha uma linha: a primeira que os @filter deixam, na ordem de sort:. Os filtros são os do @data, então o valor pode vir da página — num layout com uma ```route, @filter codigo eq params.codigo desenha o percurso da atividade de cada endereço. Sem filtro, sort:-quando desenha a mais recente:

```@track collection:percursos-exemplo field:percurso sort:-quando height:short
```

Variações#

```@track collection:percursos-exemplo field:percurso height:tall stats:false
@filter codigo eq morro
```

```@track collection:percursos-exemplo field:percurso
@filter codigo eq orla
```

Argumentos#

• collection — a coleção do espaço que guarda as linhas.
• field — o campo text ou long_text com o percurso.
• sort — a ordem em que a linha é escolhida quando os filtros deixam mais de uma; um menos na frente inverte (-quando).
• height — short (uma faixa), medium (o padrão) ou tall. O desenho ocupa a largura que tem e mantém as proporções do percurso.
• stats — false tira a distância e o ganho de elevação de baixo do desenho.
• empty — o que dizer quando não há linha, ou o campo não guarda um percurso.

Quem pode ver o percurso é quem pode ler a coleção: numa coleção privada, quem não lê as linhas vê "Dados privados" no lugar do desenho. Um percurso longo é desenhado com no máximo 2.000 pontos, espaçados por igual.