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
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