Este post pretende dar uma pequena introdução ao uso da LibSAPO.js e aos seus componentes mais básicos.
A LibSAPO.js tem como dependência principal o objecto SAPO.
Deste objecto dependem todas as outras classes utilitárias e widgets do SAPO. Assim, para a utilização de qualquer outra classe, será necessário incluir o ficheiro https://js.sapo.pt/SAPO/
Este é um ficheiro muito pequeno que apenas trata da inicialização da lib e inclui alguns utilitários básicos necessários para o uso da lib.
O objecto SAPO e o método s$, que é um alias para o método document.getElementById são as únicas variáveis globais declaradas pela LibSAPO.js. Mesmo assim, apesar não "poluirmos" o DOM, disponibilizamos mais dois métodos, como extensão do objecto Function:
bindObj() e bindObjEvent()
Para quem está familiarizado com o Prototype, estes métodos são semelhates ao bind() e ao bindAsEventListener().
Sem a adição de quaisquer módulos, o objecto SAPO fornece os seguintes métodos:
SAPO.namespace() - cria o namespace no objecto "SAPO"
SAPO.Browser - Objecto que nos dá a informação do browser. Deve apenas ser usado em casos muito específicos, pois não é boa prática detectar funcionalidades pela designação do browser, mas sim pela detecção da funcionalidade.
As propriedades que podemos encontrar são:
. LibSAPO.js - Documentação...
. SAPO