Widget ShareThis - SAPO developers blog

« post anterior | home | post seguinte »

Quinta-feira, 23 de Julho de 2009

O Widget ShareThis do SAPO permite, de uma forma simples, adicionar funcionalidades de partilha via serviços de link, mail ou impressão para pdf a uma página de um site

O Widget depende do Prototype e da LibSAPO.js e possui duas formas de invocação. A mais simples é utilizando o snippet:

    <script type="text/javascript" src="http://js.sapo.pt/Snippets/ShareThis.js"></script>

O botão para partilhar o conteúdo da página é adicionado automaticamente.

Para usar, por exemplo, num blog, e para prevenir o carregamento múltiplo das dependências nas páginas com listagens de vários artigos, a forma correcta é incluir as seguintes linhas no head do HTML:

    <script type="text/javascript" src="http://js.sapo.pt/Prototype/1.8/"></script>
    <script type="text/javascript" src="http://js.sapo.pt/SAPO/"></script>
    <script type="text/javascript" src="http://js.sapo.pt/SAPO/Widget/ShareThis/0.1/"></script>

O widget tem 4 modos de funcionamento (por omissão é usado o modo 3):

* 0 => Mostra apenas os ícones dos serviços

* 1 => Mostra apenas os nomes dos serviços

* 2 => Mostra os nomes e os ícones dos serviços

* 3 => Modo Tooltip

A chamada do widget pode ser feita inline:

    <script type="text/javascript">
	    new SAPO.Widget.ShareThis();
    </script>

Ou para incluir num determinado elemento do DOM:

    <script type="text/javascript">
    /**
    * A chamada é feita no dom:loaded do prototype para o elemento já estar disponivel.
    */
        Element.observe(document, 'dom:loaded',function(){  
            new SAPO.Widget.ShareThis({target: 'id_do_elemento'});
        });
    </script>

Como se pode ver no segundo exemplo, o widget recebe um objecto de inicialização para definição de algumas propriedades. As opções que esse objecto pode receber são descritas com mais detalhe no blog da LibSAPO.js, onde se encontram também alguns exemplos de utilização.

O widget pode ser visto em funcionamento neste mesmo blog (no final de cada post, no lado direito, encontra-se o botão "Partilhar").