Função que chama a tela nativa de compartilhamento de links. As formas de compartilhamento disponíveis dependem do dispositivo, mas podem incluir a área de transferência, contatos, aplicativos de e-mail, entre outros. Este bloco utiliza o método navigate.share() do JavaScript, consulte a documentação para mais detalhes.


Figura 1 - Bloco Compartilhar URL


O bloco irá funcionar normalmente em mobile, pois a função será chamada nativamente. Mas em projetos Web e PWA será necessário que o navegador esteja na versão mínima compatível, para verificar clique aqui e acesse o tópico de compatibilidade com navegadores.

Para visualizar as formas de abrir links disponíveis no Cronapp, acesse a documentação Formulário.

Compatibilidade

  • Bloco cliente: cronapi.util.share()

Retorno

Retorna um objeto Promise contendo informações sobre o compartilhamento. Além do objeto, uma string também é retornada contendo a mensagem "Successful share", no caso de sucesso no compartilhamento, ou "Error sharing", caso contrário. 

Parâmetros

Título

Título do compartilhamento.

  • Posição: 1
  • Inglês: Title
  • Tipo: Texto / String
  • Exemplo: "Blog Cronapp"

Texto

Texto que explica o compartilhamento.

  • Posição: 2
  • Inglês: Text
  • Tipo: Texto / String
  • Exemplo: "Como desenvolver aplicações web e mobile na prática?"

URL

Link a ser compartilhado (URL, vídeo, arquivo). 

Exemplo

A função abaixo recebe na variável "url" o bloco Compartilhar URL com o Título, Texto e URL a ser compartilhada.


Figura 2 - Função utilizada para compartilhar uma URL


Após associar a função ao evento Ao Clicar do botão e clicar nele no navegador web, a tela nativa de compartilhamento será exibida (Figura 2.1). Escolha uma das opções disponíveis para compartilhar o link.


Figura 2.1 - Retorno da tela nativa do Windows no navegador


O mesmo ocorre para a visualização mobile, a tela nativa de compartilhamento muda de acordo com o sistema operacional utilizado. Nos exemplos, utilizamos os sistemas Windows (Figura 2.1) e Android  (Figura 2.2).


Figura 2.2 - Tela nativa do mobile Android


Nesta página