Uso de bibliotecas de terceiros
Todo desenvolvedor aprende um dos princípios mais importantes da engenharia de software no início de sua carreira: DRY (Don’t Repeat Yourself). O uso de bibliotecas de terceiros pode economizar seu tempo, pois você não precisa desenvolver a funcionalidade que a biblioteca oferece. PocketBlocks fornece algumas bibliotecas integradas de terceiros para usos comuns, e você pode importar manualmente outras bibliotecas sob demanda.
Bibliotecas integradas
PocketBlocks fornece algumas bibliotecas JavaScript integradas para uso.
Biblioteca | Documentação | Versão |
---|---|---|
lodash | 4.17.21 | |
moment | 2.29.3 | |
uuid | 8.3.2(Support v1/v3/v4/v5) | |
numbro | 2.3.6 | |
papaparse(Papa) | 5.3.2 | |
PocketBase SDK(pb) | 0.21.3 | |
TanStack QueryClient(qc) | 5.44.0 |
Importando manualmente bibliotecas de terceiros
PocketBlocks suporta a configuração de JavaScript pré-carregado e bibliotecas que podem estar no nível do aplicativo ou no nível do espaço de trabalho.
Bibliotecas em nível de aplicativo são carregadas somente no aplicativo onde definido. Além disso, o aplicativo A não pode usar bibliotecas configuradas para o aplicativo B.
Bibliotecas no nível do espaço de trabalho serão carregadas quando você abrir qualquer aplicativo no seu espaço de trabalho. Todos os aplicativos podem acessar essas bibliotecas. Pode haver um certo impacto no desempenho do aplicativo, especialmente quando você tem funções JavaScript complexas que não estão sendo usadas em todos os aplicativos.
Dicas que você deve saber antes de configurar bibliotecas:
Bibliotecas externas são carregadas e executadas no navegador.
Bibliotecas somente NodeJS não são suportadas.
URLs de bibliotecas externas precisam oferecer suporte a vários domínios.
A exportação da biblioteca deve ser configurada diretamente no objeto window, variáveis globais como
var xxx = xxx
não têm efeito.As bibliotecas externas são executadas em um ambiente sandbox restrito e as seguintes variáveis globais não estão disponíveis:
parent
document
location
chrome
setTimeout
fetch
setInterval
clearInterval
setImmediate
XMLHttpRequest
importScripts
Navigator
MutationObserver
Agora vamos pegar cowsay como exemplo e importá-lo no nível do aplicativo e no nível do espaço de trabalho.
Página do GitHub: https://github.com/piuccio/cowsay
Link da Biblioteca: https://unpkg.com/cowsay@1.5.0/build/cowsay.umd.js
No nível do aplicativo
Navegue até a página de configurações e clique no sinal de mais + na guia Biblioteca JavaScript. Cole o link cowsay e clique em Adicionar novo.
Crie uma consulta JS e insira o código.
Você pode obter o mesmo resultado chamando o método cowsay.say()
no valor do componente de texto.
Observe que a biblioteca cowsay é importada no nível do aplicativo e você não pode usá-la em nenhum outro aplicativo em seu espaço de trabalho.
No nível do espaço de trabalho
Vá para a página inicial do PocketBlocks, selecione Configurações > Avançado e clique em Adicionar na guia Biblioteca JavaScript. Cole o link da biblioteca JS de terceiros e clique em Adicionar novo para adicioná-la ao seu espaço de trabalho. As bibliotecas instaladas podem ser acessadas de qualquer aplicativo em seu espaço de trabalho.
Last updated