Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: DI-2172
A

Compartilhar URL

Função que chama a tela nativa de compartilhamento do dispositivo ou navegador para compartilhar um linkde 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.


Image Added

Figura 1 - Bloco Compartilhar URL


Notawarning

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.

Parâmetros de Entrada

Dica

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"
NomeTipoDocParâmetro 1TextoTítulo do compartilhamentoParâmetro 2

Texto

Texto que explica o compartilhamento

Parâmetro 3Texto

.

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

Retorno

Retorna uma tela nativa de compartilhamento.

Compatibilidade

Image Removed Cliente

Exemplo

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


Image RemovedImage Added

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


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


Image RemovedImage Added

Figura 2.1 - Retorno da tela nativa do Windows no navegador

Sobre a tela nativa


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

Android  (Figura

3

2.2).

Image Removed


Image Added

Figura

3

2.2 - Tela nativa do mobile Android


Nesta página

Índice

InformaçõesPara visualizar as formas de abrir links disponíveis no Cronapp, acesse Formulário.