Qualquer tecnologia suficientemente avançada é indistinguível da magia. A menos que você entenda. Meu nome é Thomas Steiner, trabalho em relações com desenvolvedores no Google e, neste artigo da minha palestra no Google I/O, vou analisar algumas das novas APIs do Fugu e como elas melhoram as principais jornadas do usuário no PWA do Excalidraw. Assim, você pode se inspirar nessas ideias e aplicá-las aos seus próprios apps.
Como cheguei ao Excalidraw
Quero começar com uma história. Em 1º de janeiro de 2020, Christopher Chedeau, engenheiro de software do Facebook, postou no Twitter sobre um pequeno app de desenho em que ele tinha começado a trabalhar. Com essa ferramenta, você pode desenhar caixas e setas que parecem desenhos animados e feitos à mão. No dia seguinte, você também pode desenhar elipses e texto, além de selecionar objetos e movê-los. Em 3 de janeiro, o app recebeu o nome de Excalidraw e, como em todo bom projeto paralelo, comprar o nome de domínio foi uma das primeiras ações de Christopher. Agora, você pode usar cores e exportar todo o desenho como um PNG.

Em 15 de janeiro, Christopher publicou uma postagem de blog que chamou muita atenção no Twitter, inclusive a minha. A postagem começou com algumas estatísticas impressionantes:
- 12 mil usuários ativos únicos
- 1,5 mil estrelas no GitHub
- 26 colaboradores
Para um projeto que começou há apenas duas semanas, nada mal. Mas o que realmente despertou meu interesse estava mais abaixo no post. Christopher escreveu que tentou algo novo desta vez: dar acesso de commit incondicional a todos que conseguiram uma solicitação de pull. No mesmo dia em que li o post do blog, fiz uma solicitação de pull que adicionou suporte à API de Acesso a Sistemas de Arquivos ao Excalidraw, corrigindo uma solicitação de recurso que alguém havia enviado.

Minha solicitação de pull foi mesclada um dia depois e, a partir daí, tive acesso total ao commit. Nem preciso dizer que não abusei do meu poder. E ninguém mais entre os 149 colaboradores até agora.
Hoje, o Excalidraw é um app da Web progressivo instalável completo com suporte off-line, um modo escuro incrível e, sim, a capacidade de abrir e salvar arquivos graças à API File System Access.

Lipis sobre por que ele dedica tanto tempo ao Excalidraw
Isso marca o fim da minha história de "como cheguei ao Excalidraw", mas antes de falar sobre alguns dos recursos incríveis do Excalidraw, tenho o prazer de apresentar o Panayiotis. Panayiotis Lipiridis, conhecido na Internet como lipis, é o colaborador mais prolífico do Excalidraw. Perguntei ao lipis o que o motiva a dedicar tanto tempo ao Excalidraw:
Como todo mundo, fiquei sabendo desse projeto pelo tweet do Christopher. Minha primeira contribuição foi adicionar a biblioteca Open Color, as cores que ainda fazem parte do Excalidraw hoje. À medida que o projeto cresceu e recebemos muitas solicitações, minha próxima grande contribuição foi criar um back-end para armazenar desenhos para que os usuários pudessem compartilhá-los. Mas o que realmente me motiva a contribuir é que quem já usou o Excalidraw está sempre procurando desculpas para usá-lo novamente.
Concordo totalmente com o lipis. Quem já usou o Excalidraw está procurando desculpas para usar de novo.
Excalidraw em ação
Agora, quero mostrar como usar o Excalidraw na prática. Não sou um grande artista, mas o logotipo do Google I/O é simples o suficiente, então vou tentar. Uma caixa é o "i", uma linha pode ser a barra e o "o" é um círculo. Vou pressionar Shift para fazer um círculo perfeito. Vou mover a barra um pouco para ficar melhor. Agora, um pouco de cor para o "i" e o "o". Azul é bom. Talvez um estilo de preenchimento diferente? Tudo sólido ou hachurado? Não, hachura é ótimo. Não está perfeito, mas essa é a ideia do Excalidraw. Vou salvar.
Clique no ícone de salvar e insira um nome para o arquivo na caixa de diálogo. No Chrome, um navegador que oferece suporte à API File System Access, essa não é uma operação de download, mas de salvamento, em que posso escolher o local e o nome do arquivo e, se fizer edições, posso salvá-las no mesmo arquivo.
Vou mudar o logotipo e deixar o "i" vermelho. Se eu clicar em "Salvar" novamente, minha modificação será salva no mesmo arquivo de antes. Para provar, vou limpar a tela e reabrir o arquivo. Como você pode ver, o logotipo vermelho e azul modificado está lá de novo.
Como trabalhar com arquivos
Em navegadores que não são compatíveis com a API File System Access, cada operação de salvamento é um download. Portanto, quando faço alterações, acabo com vários arquivos com um número crescente no nome do arquivo que preenchem minha pasta de downloads. Mas, apesar dessa desvantagem, ainda posso salvar o arquivo.
Abrir arquivos
Qual é o segredo? Como a abertura e o salvamento podem funcionar em navegadores diferentes que podem ou não
oferecer suporte à API File System Access? A abertura de um arquivo no Excalidraw acontece em uma função chamada
loadFromJSON)(, que, por sua vez, chama uma função chamada fileOpen().
export const loadFromJSON = async (localAppState: AppState) => {
const blob = await fileOpen({
description: 'Excalidraw files',
extensions: ['.json', '.excalidraw', '.png', '.svg'],
mimeTypes: ['application/json', 'image/png', 'image/svg+xml'],
});
return loadFromBlob(blob, localAppState);
};
A função fileOpen() que vem de uma pequena biblioteca que escrevi chamada
browser-fs-access, que usamos no
Excalidraw. Essa biblioteca fornece acesso ao sistema de arquivos pela
API File System Access com um substituto legado, para que possa ser usada em qualquer
navegador.
Primeiro, vou mostrar a implementação para quando a API é compatível. Depois de negociar os
tipos MIME e as extensões de arquivo aceitos, a parte central é chamar a função showOpenFilePicker() da API File System Access. Essa função retorna uma matriz de arquivos ou um único arquivo, dependendo
da seleção de vários arquivos. Depois, basta colocar o identificador de processamento de arquivos no objeto de arquivo para que ele possa ser recuperado novamente.
export default async (options = {}) => {
const accept = {};
// Not shown: deal with extensions and MIME types.
const handleOrHandles = await window.showOpenFilePicker({
types: [
{
description: options.description || '',
accept: accept,
},
],
multiple: options.multiple || false,
});
const files = await Promise.all(handleOrHandles.map(getFileWithHandle));
if (options.multiple) return files;
return files[0];
const getFileWithHandle = async (handle) => {
const file = await handle.getFile();
file.handle = handle;
return file;
};
};
A implementação substituta depende de um elemento input do tipo "file". Após a negociação dos
tipos MIME e das extensões que serão aceitos, a próxima etapa é clicar de forma programática no elemento de entrada
para que a caixa de diálogo de abertura de arquivo seja mostrada. Na mudança, ou seja, quando o usuário seleciona um ou
vários arquivos, a promessa é resolvida.
export default async (options = {}) => {
return new Promise((resolve) => {
const input = document.createElement('input');
input.type = 'file';
const accept = [
...(options.mimeTypes ? options.mimeTypes : []),
options.extensions ? options.extensions : [],
].join();
input.multiple = options.multiple || false;
input.accept = accept || '*/*';
input.addEventListener('change', () => {
resolve(input.multiple ? Array.from(input.files) : input.files[0]);
});
input.click();
});
};
Salvando arquivos
Agora vamos falar sobre como economizar. No Excalidraw, o salvamento acontece em uma função chamada saveAsJSON(). Primeiro,
ele serializa a matriz de elementos do Excalidraw para JSON, converte o JSON em um blob e, em seguida, chama uma
função chamada fileSave(). Essa função também é fornecida pela biblioteca
browser-fs-access.
export const saveAsJSON = async (
elements: readonly ExcalidrawElement[],
appState: AppState,
) => {
const serialized = serializeAsJSON(elements, appState);
const blob = new Blob([serialized], {
type: 'application/vnd.excalidraw+json',
});
const fileHandle = await fileSave(
blob,
{
fileName: appState.name,
description: 'Excalidraw file',
extensions: ['.excalidraw'],
},
appState.fileHandle,
);
return { fileHandle };
};
Primeiro, vamos analisar a implementação para navegadores com suporte à API File System Access. As primeiras linhas parecem um pouco complexas, mas tudo o que elas fazem é negociar os tipos MIME e as extensões de arquivo. Quando eu já tiver salvado antes e já tiver um identificador de arquivo, nenhuma caixa de diálogo de salvamento precisará ser mostrada. No entanto, se for o primeiro salvamento, uma caixa de diálogo de arquivo será exibida, e o app vai receber um identificador de arquivo para uso futuro. O restante é apenas gravar no arquivo, o que acontece por um stream gravável.
export default async (blob, options = {}, handle = null) => {
options.fileName = options.fileName || 'Untitled';
const accept = {};
// Not shown: deal with extensions and MIME types.
handle =
handle ||
(await window.showSaveFilePicker({
suggestedName: options.fileName,
types: [
{
description: options.description || '',
accept: accept,
},
],
}));
const writable = await handle.createWritable();
await writable.write(blob);
await writable.close();
return handle;
};
O recurso "Salvar como"
Se eu decidir ignorar um identificador de arquivo já existente, posso implementar um recurso "salvar como" para criar um novo arquivo com base em um arquivo existente. Para mostrar isso, vou abrir um arquivo, fazer algumas modificações e, em vez de substituir o arquivo, vou criar um novo usando o recurso "Salvar como". Isso deixa o arquivo original intacto.
A implementação para navegadores que não são compatíveis com a API File System Access é curta, já que tudo o que ela faz é criar um elemento de âncora com um atributo download, cujo valor é o nome de arquivo desejado, e um URL de blob como o valor do atributo href.
export default async (blob, options = {}) => {
const a = document.createElement('a');
a.download = options.fileName || 'Untitled';
a.href = URL.createObjectURL(blob);
a.addEventListener('click', () => {
setTimeout(() => URL.revokeObjectURL(a.href), 30 * 1000);
});
a.click();
};
Em seguida, o elemento âncora é clicado de forma programática. Para evitar vazamentos de memória, o URL do blob precisa
ser revogado após o uso. Como é apenas um download, nenhuma caixa de diálogo para salvar arquivos é mostrada, e todos
os arquivos vão para a pasta padrão Downloads.
Arrastar e soltar
Uma das minhas integrações de sistema favoritas no computador é o recurso de arrastar e soltar. No Excalidraw, quando solto um arquivo
.excalidraw no aplicativo, ele é aberto imediatamente e posso começar a editar. Em navegadores
que oferecem suporte à API File System Access, posso até salvar minhas mudanças imediatamente. Não é necessário passar
por uma caixa de diálogo de salvamento de arquivo, já que o identificador de arquivo necessário foi obtido na operação de
arrastar e soltar.
O segredo para que isso aconteça é chamar getAsFileSystemHandle() no item de
transferência de dados quando a API de Acesso ao Sistema de Arquivos é compatível. Em seguida, transmito esse
identificador de arquivo para loadFromBlob(), que você deve se lembrar de alguns parágrafos acima. Há tantas
coisas que você pode fazer com arquivos: abrir, salvar, salvar por cima, arrastar, soltar. Meu colega Pete
e eu documentamos todos esses truques e muito mais no nosso artigo para você
se atualizar caso tudo isso tenha sido um pouco rápido demais.
const file = event.dataTransfer?.files[0];
if (file?.type === 'application/json' || file?.name.endsWith('.excalidraw')) {
this.setState({ isLoading: true });
// Provided by browser-fs-access.
if (supported) {
try {
const item = event.dataTransfer.items[0];
file as any.handle = await item as any
.getAsFileSystemHandle();
} catch (error) {
console.warn(error.name, error.message);
}
}
loadFromBlob(file, this.state).then(({ elements, appState }) =>
// Load from blob
).catch((error) => {
this.setState({ isLoading: false, errorMessage: error.message });
});
}
Compartilhamento de arquivos
Outra integração de sistema atualmente no Android, ChromeOS e Windows é feita pela
API Web Share Target. Aqui estou no app Arquivos, na minha pasta Downloads. Posso
ver dois arquivos, um deles com o nome não descritivo untitled e um carimbo de data/hora. Para conferir o que
ele contém, clico nos três pontos, depois em "Compartilhar" e uma das opções que aparece é
Excalidraw. Ao tocar no ícone, posso ver que o arquivo contém apenas o logotipo do I/O novamente.
Lipis na versão descontinuada do Electron
Uma coisa que você pode fazer com os arquivos e que ainda não mencionei é clicar duas vezes neles. Normalmente,
quando você clica duas vezes em um arquivo, o app associado ao tipo MIME do arquivo
é aberto. Por exemplo, para .docx, seria o Microsoft Word.
O Excalidraw costumava ter uma versão do Electron do app que
oferecia suporte a essas associações de tipo de arquivo. Assim, quando você clicava duas vezes em um arquivo .excalidraw, o
app Excalidraw Electron era aberto. Lipis, que você já conhece, foi o criador
e o responsável pela descontinuação do Excalidraw Electron. Perguntei a ele por que ele achava que era possível descontinuar a
versão do Electron:
As pessoas pedem um app Electron desde o início, principalmente porque queriam abrir arquivos clicando duas vezes. Também pretendíamos colocar o app nas app stores. Em paralelo, alguém sugeriu criar um PWA, então fizemos as duas coisas. Felizmente, conhecemos as APIs do Project Fugu, como acesso ao sistema de arquivos, acesso à área de transferência, processamento de arquivos e muito mais. Com um único clique, você pode instalar o app no computador ou dispositivo móvel, sem o peso extra do Electron. Foi uma decisão fácil descontinuar a versão do Electron, concentrar-se apenas no app da Web e torná-lo o melhor PWA possível. Além disso, agora podemos publicar PWAs na Google Play Store e na Microsoft Store. Isso é muito!
Pode-se dizer que o Excalidraw para Electron não foi descontinuado porque o Electron é ruim, de forma alguma, mas porque a Web se tornou boa o suficiente. Gostei!
Processamento de arquivos
Quando digo que "a Web se tornou boa o suficiente", é por causa de recursos como o próximo processamento de arquivos.
Esta é uma instalação normal do macOS Big Sur. Agora, veja o que acontece quando clico com o botão direito do mouse em um arquivo do Excalidraw. Posso abrir o arquivo com o Excalidraw, o PWA instalado. É claro que clicar duas vezes também funcionaria, mas é menos dramático para demonstrar em um screencast.
Como isso funciona? A primeira etapa é informar ao sistema operacional os tipos de arquivo que o aplicativo pode processar. Para isso, use um novo campo chamado file_handlers no manifesto do app da Web. O valor
é uma matriz de objetos com uma ação e uma propriedade accept. A ação determina o caminho do URL
em que o sistema operacional inicia o app, e o objeto de aceitação são pares de chave-valor de tipos MIME
e as extensões de arquivo associadas.
{
"name": "Excalidraw",
"description": "Excalidraw is a whiteboard tool...",
"start_url": "/",
"display": "standalone",
"theme_color": "#000000",
"background_color": "#ffffff",
"file_handlers": [
{
"action": "/",
"accept": {
"application/vnd.excalidraw+json": [".excalidraw"]
}
}
]
}
A próxima etapa é processar o arquivo quando o aplicativo for iniciado. Isso acontece na interface launchQueue,
em que preciso definir um consumidor chamando setConsumer(). O parâmetro para essa
função é uma função assíncrona que recebe o launchParams. Esse objeto launchParams
tem um campo chamado files que me dá uma matriz de identificadores de arquivo para trabalhar. Só me importo com o
primeiro e, desse identificador de arquivo, recebo um blob que passo para nosso velho amigo
loadFromBlob().
if ('launchQueue' in window && 'LaunchParams' in window) {
window as any.launchQueue
.setConsumer(async (launchParams: { files: any[] }) => {
if (!launchParams.files.length) return;
const fileHandle = launchParams.files[0];
const blob: Blob = await fileHandle.getFile();
blob.handle = fileHandle;
loadFromBlob(blob, this.state).then(({ elements, appState }) =>
// Initialize app state.
).catch((error) => {
this.setState({ isLoading: false, errorMessage: error.message });
});
});
}
Se você achou que foi rápido demais, leia mais sobre a API de processamento de arquivos no meu artigo. Para ativar o processamento de arquivos, defina a flag de recursos experimentais da plataforma da Web. Ele será lançado no Chrome ainda este ano.
Integração com a área de transferência
Outro recurso legal do Excalidraw é a integração com a área de transferência. Posso copiar todo o desenho ou apenas partes dele para a área de transferência, talvez adicionando uma marca-d'água se eu quiser, e depois colá-lo em outro app. Essa é uma versão para Web do app Paint do Windows 95, aliás.
O funcionamento é surpreendentemente simples. Tudo o que preciso é da tela como um blob, que eu gravo
na área de transferência transmitindo uma matriz de um elemento com um ClipboardItem com o blob para a
função navigator.clipboard.write(). Para mais informações sobre o que você pode fazer com a API Clipboard, consulte o artigo do Jason e meu artigo.
export const copyCanvasToClipboardAsPng = async (canvas: HTMLCanvasElement) => {
const blob = await canvasToBlob(canvas);
await navigator.clipboard.write([
new window.ClipboardItem({
'image/png': blob,
}),
]);
};
export const canvasToBlob = async (canvas: HTMLCanvasElement): Promise<Blob> => {
return new Promise((resolve, reject) => {
try {
canvas.toBlob((blob) => {
if (!blob) {
return reject(new CanvasError(t('canvasError.canvasTooBig'), 'CANVAS_POSSIBLY_TOO_BIG'));
}
resolve(blob);
});
} catch (error) {
reject(error);
}
});
};
Como colaborar com outras pessoas
Como compartilhar o URL de uma sessão
Você sabia que o Excalidraw também tem um modo colaborativo? Pessoas diferentes podem trabalhar juntas no mesmo documento. Para iniciar uma nova sessão, clico no botão de colaboração ao vivo e, em seguida, inicio uma sessão. Posso compartilhar o URL da sessão com meus colaboradores facilmente graças à API Web Share que o Excalidraw integrou.
Colaboração dinâmica
Simulei uma sessão de colaboração localmente trabalhando no logotipo do Google I/O no meu Pixelbook, no meu smartphone Pixel 3a e no meu iPad Pro. As mudanças que faço em um dispositivo são refletidas em todos os outros.
Posso até ver todos os cursores se movendo. O cursor do Pixelbook se move de forma constante, já que é controlado por um trackpad, mas o cursor do smartphone Pixel 3a e o do tablet iPad Pro pulam de um lado para o outro, já que eu controlo esses dispositivos tocando com o dedo.
Como ver o status dos colaboradores
Para melhorar a experiência de colaboração em tempo real, há até um sistema de detecção de inatividade em execução. O cursor do iPad Pro mostra um ponto verde quando eu o uso. O ponto fica preto quando mudo para outra guia do navegador ou app. E quando estou no app Excalidraw, mas não estou fazendo nada, o cursor mostra que estou inativo, simbolizado pelos três zZZs.
Os leitores assíduos das nossas publicações podem pensar que a detecção de inatividade é realizada pela API Idle Detection, uma proposta em estágio inicial que está sendo desenvolvida no contexto do Projeto Fugu. Alerta de spoiler: não é. Embora tivéssemos uma implementação baseada nessa API no Excalidraw, no final, decidimos usar uma abordagem mais tradicional baseada na medição do movimento do ponteiro e da visibilidade da página.

Enviamos um feedback (link em inglês) explicando por que a API Idle Detection não estava resolvendo nosso caso de uso. Todas as APIs do Project Fugu estão sendo desenvolvidas de forma aberta, para que todos possam participar e serem ouvidos.
Lipis sobre o que está impedindo o Excalidraw
Por falar nisso, fiz uma última pergunta ao lipis sobre o que ele acha que está faltando na plataforma da Web que impede o Excalidraw:
A API File System Access é ótima, mas sabe de uma coisa? A maioria dos arquivos que me interessam hoje em dia está no meu Dropbox ou Google Drive, não no meu disco rígido. Eu gostaria que a API File System Access incluísse uma camada de abstração para que provedores de sistemas de arquivos remotos, como o Dropbox ou o Google, pudessem se integrar e os desenvolvedores pudessem programar. Os usuários podem relaxar e saber que os arquivos estão seguros com o provedor de nuvem em que confiam.
Concordo plenamente com o lipis, eu também vivo na nuvem. Esperamos que isso seja implementado em breve.
Modo de aplicativo com guias
Uau! Vimos muitas integrações de API excelentes no Excalidraw. Sistema de arquivos, processamento de arquivos, área de transferência, compartilhamento na Web e destino de compartilhamento na Web. Mas tem mais uma coisa. Até agora, eu só podia editar um documento por vez. Nada disso. Aproveite pela primeira vez uma versão inicial do modo de aplicativo com guias no Excalidraw. Veja como fica.
Tenho um arquivo aberto no PWA do Excalidraw instalado que está sendo executado no modo independente. Agora, abro uma nova guia na janela independente. Essa não é uma guia normal do navegador, mas sim uma guia de PWA. Nessa nova guia, posso abrir um arquivo secundário e trabalhar nele de forma independente na mesma janela do app.
O modo de aplicativo com guias está nos estágios iniciais, e nem tudo está definido. Se você tiver interesse, leia sobre o status atual desse recurso no meu artigo.
Encerramento
Para ficar por dentro desse e de outros recursos, acompanhe nosso rastreador de APIs do Fugu. Estamos muito felizes em impulsionar a Web e permitir que você faça mais na plataforma. Esperamos que o Excalidraw continue melhorando e que você crie aplicativos incríveis. Comece a criar em excalidraw.com.
Mal posso esperar para ver algumas das APIs que mostrei hoje nos seus apps. Meu nome é Tom, você pode me encontrar como @tomayac no Twitter e na Internet em geral. Agradecemos por assistir e aproveite o restante do Google I/O.