Um dos grandes problemas do JavaScript como linguagem de programação não é a falta de documentação mas a quantidade de maus exemplos e documentação desactualizada que existe na web.
Na última JSConf.eu o criador da JSConf original, Chris Williams, juntamente com outros membros da comunidade, decidiram lançar um esforço para tentar minimizar este problema.
Assim nasceu o PromoteJS, cujo propósito muito simples é gerar pequenas snippets de HTML que qualquer pessoa pode incluir no seu site, e que criam links para a Mozilla Developer Network, que é possivelmente o melhor recurso para documentação de JavaScript na web e, apesar de ser da Mozilla, muitas das páginas contemplam também as alternativas existentes noutros browsers.
Por isso vamos fazer a nossa parte e incluir também uma snippet para documentação de JavaScript. Sugerimos a todos os fãs da linguagem que façam o mesmo.
Novo widget na LibSAPO.js :-) É apenas um simples carrossel. Tem várias opções, mas este é apenas um exemplo duma implementação simples.
A documentação está neste link.
A source aqui.
E o sample aqui.
Exemplo:
--------------------------------------
Code:
-------------------------------
<!--- SimpleSlide --> <div id="sapo_widget_simpleslide" style="position:relative;"></div> <script type="text/javascript"> // Food for Carrossel var rawData = [ { url: 'http%3A%2F%2Fjs.sapo.pt%2F', img: 'https://js.sapo.pt/Assets/Images/SimpleSlide/Sample01.png', title: 'SAPO::Widget.SimpleSlide - 1' }, { url: 'http%3A%2F%2Fjs.sapo.pt%2F', img: 'https://js.sapo.pt/Assets/Images/SimpleSlide/Sample02.png', title: 'SAPO::Widget.SimpleSlide - 2' }, { url: 'http%3A%2F%2Fjs.sapo.pt%2F', img: 'https://js.sapo.pt/Assets/Images/SimpleSlide/Sample03.png', title: 'SAPO::Widget.SimpleSlide - 3' } ]; new SAPO.Widget.SimpleSlide({ target: 'sapo_widget_simpleslide', id: 'sapo_widget_simpleslide_sample', delay: 6, width: '480px', height: '211px', data: rawData, play:false }); </script>
Ver post no blog antigo: http://libjs.blogs.sapo.pt/1060.html
Para usarem basta incluir a seguinte chamada JavaScript:
<!-- --> <script type="text/javascript" src="https://js.sapo.pt/Snippets/Search.js[?opções]" ></script>
Nas opções podem usar os seguintes parametros:
width: largura do snippet, o default é 180px;
domain: dominio no qual quer fazer a pesquisa, o default é o proprio dominio do site;
new_win: se pretende abrir a página de pesquisa numa nova janela, o default é "false", ou seja, não vai abrir numa nova janela.
search_spot: id do elemento se pretende que o snippet apareça noutro elemento da página e não naquele em que é feita a chamada do javascript.
inputtip: Texto que pretende que apareça na caixa de pesquisa.
sitename: Texto opcional do nome do site.
Um exemplo prático:
Imaginemos que queremos usar os seguintes dados.
width: 180px domain: libjs.blogs.sapo.pt new_win: false search_spot: o_meu_id inputtip: Pesquisar sitename: LibSAPOJS
a chamada que teriamos que incluir seria:
<!-- Snippet SAPO - Search --> <script type="text/javascript" src="https://js.sapo.pt/Snippets/Search.js?width=180&domain=libsapojs.blogs.sapo.pt&new_win=false&search_spot=o_meu_id&inputtip=Pesquisar&sitename=LibSAPOJS" type="text/javascript"></script>
O resultado seria este:
Para mais informações consultem o wiki da lib
Para usar nos blogs do sapo, adicione estas chamadas como um componente. Para saber pormenores consulte a ajuda dos blogs SAPO ou o blog oficial.
. SAPO.Widget.SimpleSlide o...