Setiap teknologi yang cukup canggih tidak dapat dibedakan dari keajaiban. Kecuali jika Anda memahaminya. Nama saya Thomas Steiner, saya bekerja di Developer Relations di Google dan dalam artikel tentang presentasi saya di Google I/O ini, saya akan membahas beberapa API Fugu baru dan cara API tersebut meningkatkan perjalanan pengguna inti di PWA Excalidraw, sehingga Anda dapat mengambil inspirasi dari ide-ide ini dan menerapkannya ke aplikasi Anda sendiri.
Cara saya menemukan Excalidraw
Saya ingin memulai dengan sebuah cerita. Pada 1 Januari 2020, Christopher Chedeau, seorang software engineer di Facebook, membuat tweet tentang aplikasi menggambar kecil yang mulai ia kerjakan. Dengan alat ini, Anda dapat menggambar kotak dan panah yang terlihat seperti kartun dan digambar tangan. Keesokan harinya, Anda juga dapat menggambar elips dan teks, serta memilih objek dan memindahkannya. Pada 3 Januari, aplikasi ini diberi nama Excalidraw, dan, seperti setiap project sampingan yang bagus, membeli nama domain adalah salah satu tindakan pertama Christopher. Sekarang, Anda dapat menggunakan warna dan mengekspor seluruh gambar sebagai PNG.

Pada 15 Januari, Christopher memublikasikan postingan blog yang menarik banyak perhatian di Twitter, termasuk perhatian saya. Postingan tersebut dimulai dengan beberapa statistik yang mengesankan:
- 12 ribu pengguna aktif unik
- 1,5 ribu bintang di GitHub
- 26 kontributor
Untuk project yang baru dimulai dua minggu lalu, ini adalah pencapaian yang cukup bagus. Namun, hal yang benar-benar menarik minat saya ada di bagian bawah postingan. Christopher menulis bahwa dia mencoba sesuatu yang baru kali ini: memberikan akses commit tanpa syarat kepada semua orang yang mendapatkan permintaan pull. Pada hari yang sama saat membaca postingan blog tersebut, saya mengajukan permintaan pull yang menambahkan dukungan File System Access API ke Excalidraw, sehingga memperbaiki permintaan fitur yang diajukan seseorang.

Permintaan pull saya digabungkan sehari kemudian dan sejak saat itu, saya memiliki akses commit penuh. Tentu saja, saya tidak menyalahgunakan kekuasaan saya. Begitu juga dengan 149 kontributor lainnya sejauh ini.
Saat ini, Excalidraw adalah progressive web app yang dapat diinstal sepenuhnya dengan dukungan offline, mode gelap yang menakjubkan, dan kemampuan untuk membuka dan menyimpan file berkat File System Access API.

Lipis tentang alasannya mendedikasikan begitu banyak waktunya untuk Excalidraw
Jadi, ini menandai akhir dari cerita "bagaimana saya mengenal Excalidraw", tetapi sebelum saya membahas beberapa fitur luar biasa Excalidraw, saya dengan senang hati memperkenalkan Panayiotis. Panayiotis Lipiridis, di Internet yang dikenal sebagai lipis, adalah kontributor paling produktif untuk Excalidraw. Saya bertanya kepada lipis apa yang memotivasinya untuk mendedikasikan begitu banyak waktunya untuk Excalidraw:
Seperti orang lain, saya mengetahui project ini dari tweet Christopher. Kontribusi pertama saya adalah menambahkan library Open Color, warna yang masih menjadi bagian dari Excalidraw saat ini. Seiring berkembangnya project dan banyaknya permintaan, kontribusi besar saya berikutnya adalah membangun backend untuk menyimpan gambar agar pengguna dapat membagikannya. Namun, yang benar-benar mendorong saya untuk berkontribusi adalah siapa pun yang mencoba Excalidraw akan mencari alasan untuk menggunakannya lagi.
Saya sepenuhnya setuju dengan lipis. Siapa pun yang mencoba Excalidraw akan mencari alasan untuk menggunakannya lagi.
Excalidraw beraksi
Sekarang, kami ingin menunjukkan cara menggunakan Excalidraw dalam praktik. Saya bukan seniman hebat, tetapi logo Google I/O cukup sederhana, jadi saya akan mencobanya. Kotak adalah "i", garis bisa berupa garis miring, dan "o" adalah lingkaran. Saya menahan tombol shift, sehingga saya mendapatkan lingkaran sempurna. Saya akan memindahkan garis miringnya sedikit, agar terlihat lebih baik. Sekarang, tambahkan warna untuk "i" dan "o". Biru itu bagus. Mungkin gaya isian yang berbeda? Semua solid, atau arsiran silang? Tidak, hachure terlihat bagus. Meskipun tidak sempurna, itulah konsep Excalidraw, jadi saya akan menyimpannya.
Saya mengklik ikon simpan dan memasukkan nama file dalam dialog simpan file. Di Chrome, browser yang mendukung File System Access API, ini bukan download, melainkan operasi penyimpanan yang sebenarnya, tempat saya dapat memilih lokasi dan nama file, dan tempat, jika saya melakukan pengeditan, saya dapat menyimpannya ke file yang sama.
Saya akan mengubah logo dan membuat huruf "i" berwarna merah. Jika sekarang saya mengklik simpan lagi, modifikasi saya akan disimpan ke file yang sama seperti sebelumnya. Sebagai bukti, saya akan menghapus kanvas dan membuka kembali file tersebut. Seperti yang Anda lihat, logo merah-biru yang dimodifikasi ada lagi di sana.
Bekerja dengan file
Di browser yang saat ini tidak mendukung File System Access API, setiap operasi penyimpanan adalah download, jadi saat saya melakukan perubahan, saya akan mendapatkan beberapa file dengan nomor yang bertambah di nama file yang mengisi folder Download saya. Namun, terlepas dari kelemahan ini, saya masih dapat menyimpan file.
Membuka file
Jadi, apa rahasianya? Bagaimana cara kerja membuka dan menyimpan di berbagai browser yang mungkin atau mungkin tidak
mendukung File System Access API? Membuka file di Excalidraw terjadi dalam fungsi yang disebut
loadFromJSON)(), yang kemudian memanggil fungsi yang disebut 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);
};
Fungsi fileOpen() yang berasal dari library kecil yang saya tulis bernama
browser-fs-access yang kami gunakan di
Excalidraw. Library ini menyediakan akses sistem file melalui
File System Access API dengan penggantian lama, sehingga dapat digunakan di browser
apa pun.
Pertama-tama, kami akan menunjukkan implementasi saat API didukung. Setelah menegosiasikan
jenis MIME dan ekstensi file yang diterima, bagian utamanya adalah memanggil fungsi File System Access API
showOpenFilePicker(). Fungsi ini menampilkan array file atau satu file, bergantung pada apakah beberapa file dipilih. Jadi, yang tersisa hanyalah menempatkan pengendali file pada objek file, sehingga dapat diambil lagi.
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;
};
};
Implementasi penggantian mengandalkan elemen input berjenis "file". Setelah negosiasi
jenis dan ekstensi MIME yang akan diterima, langkah berikutnya adalah mengklik elemen input
secara terprogram sehingga dialog buka file ditampilkan. Saat terjadi perubahan, yaitu saat pengguna telah memilih satu atau
beberapa file, promise akan di-resolve.
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();
});
};
Menyimpan file
Sekarang, mari kita bahas cara menyimpan. Di Excalidraw, penyimpanan terjadi dalam fungsi yang disebut saveAsJSON(). Pertama-tama, kode ini
melakukan serialisasi array elemen Excalidraw ke JSON, mengonversi JSON menjadi blob, lalu memanggil
fungsi yang disebut fileSave(). Fungsi ini juga disediakan oleh library 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 };
};
Sekali lagi, mari kita lihat implementasi untuk browser dengan dukungan File System Access API. Beberapa baris pertama terlihat agak rumit, tetapi semuanya hanya menegosiasikan jenis MIME dan ekstensi file. Jika saya telah menyimpan sebelumnya dan sudah memiliki proses penanganan file, dialog simpan tidak perlu ditampilkan. Namun, jika ini adalah penyimpanan pertama, dialog file akan ditampilkan dan aplikasi akan mendapatkan kembali handle file untuk penggunaan di masa mendatang. Sisanya adalah menulis ke file, yang terjadi melalui aliran data yang dapat ditulis.
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;
};
Fitur "simpan sebagai"
Jika saya memutuskan untuk mengabaikan handle file yang sudah ada, saya dapat menerapkan fitur "simpan sebagai" untuk membuat file baru berdasarkan file yang ada. Untuk menunjukkan hal ini, saya akan membuka file yang ada, melakukan beberapa modifikasi, lalu tidak menimpa file yang ada, tetapi membuat file baru menggunakan fitur simpan sebagai. Tindakan ini akan membuat file asli tetap utuh.
Implementasi untuk browser yang tidak mendukung File System Access API sangat singkat, karena hanya
membuat elemen anchor dengan atribut download yang nilainya adalah nama file yang diinginkan dan
URL blob sebagai nilai atribut href-nya.
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();
};
Elemen anchor kemudian diklik secara terprogram. Untuk mencegah kebocoran memori, URL blob harus dicabut setelah digunakan. Karena ini hanya download, dialog simpan file tidak akan pernah ditampilkan, dan semua
file akan masuk ke folder Downloads default.
Tarik lalu lepas
Salah satu integrasi sistem favorit saya di desktop adalah tarik lalu lepas. Di Excalidraw, saat saya meletakkan
file .excalidraw ke aplikasi, file tersebut akan langsung terbuka dan saya dapat mulai mengedit. Di browser
yang mendukung File System Access API, saya bahkan dapat langsung menyimpan perubahan. Tidak perlu melalui dialog penyimpanan file karena handle file yang diperlukan telah diperoleh dari operasi tarik lalu lepas.
Rahasia untuk mewujudkannya adalah dengan memanggil getAsFileSystemHandle() pada item
transfer data saat File System Access API didukung. Kemudian, saya meneruskan
handle file ini ke loadFromBlob(), yang mungkin Anda ingat dari beberapa paragraf di atas. Ada banyak hal yang dapat Anda lakukan dengan file: membuka, menyimpan, menyimpan ulang, menarik, melepas. Saya dan rekan saya, Pete,
telah mendokumentasikan semua trik ini dan lainnya dalam artikel kami agar Anda dapat
mengikutinya jika semua ini berjalan terlalu cepat.
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 });
});
}
Membagikan file
Integrasi sistem lain yang saat ini ada di Android, ChromeOS, dan Windows adalah melalui
Web Share Target API. Saya sedang membuka aplikasi File di folder Downloads. Saya
dapat melihat dua file, salah satunya dengan nama yang tidak deskriptif untitled dan stempel waktu. Untuk memeriksa isinya, saya mengklik tiga titik, lalu bagikan, dan salah satu opsi yang muncul adalah
Excalidraw. Saat mengetuk ikon, saya dapat melihat bahwa file tersebut hanya berisi logo I/O lagi.
Lipis di versi Electron yang tidak digunakan lagi
Satu hal yang dapat Anda lakukan dengan file yang belum saya bahas adalah mengklik dua kali file tersebut. Biasanya, saat Anda mengklik dua kali file, aplikasi yang terkait dengan jenis MIME file akan terbuka. Misalnya, untuk .docx, ini adalah Microsoft Word.
Excalidraw pernah memiliki versi Electron dari aplikasi yang
mendukung pengaitan jenis file tersebut, sehingga saat Anda mengklik dua kali file .excalidraw, aplikasi
Excalidraw Electron akan terbuka. Lipis, yang sudah Anda temui sebelumnya, adalah pembuat
dan penghentian Excalidraw Electron. Saya bertanya kepadanya mengapa dia merasa mungkin untuk menghentikan penggunaan
versi Electron:
Sejak awal, orang-orang telah meminta aplikasi Electron, terutama karena mereka ingin membuka file dengan mengklik dua kali. Kami juga bermaksud menempatkan aplikasi di app store. Secara paralel, seseorang menyarankan untuk membuat PWA, jadi kami melakukan keduanya. Untungnya, kami diperkenalkan dengan API Project Fugu seperti akses sistem file, akses papan klip, penanganan file, dan lainnya. Dengan sekali klik, Anda dapat menginstal aplikasi di desktop atau perangkat seluler, tanpa beban tambahan Electron. Sangat mudah untuk memutuskan penghentian penggunaan versi Electron, berkonsentrasi hanya pada aplikasi web, dan menjadikannya PWA terbaik. Selain itu, kini kita dapat memublikasikan PWA ke Google Play Store dan Microsoft Store. Itu adalah jumlah yang sangat besar.
Dapat dikatakan bahwa Excalidraw untuk Electron tidak dihentikan karena Electron buruk, sama sekali tidak, tetapi karena web telah menjadi cukup baik. Saya suka ini!
Proses penanganan file
Saat saya mengatakan "web telah menjadi cukup baik", itu karena fitur seperti Penanganan File yang akan datang.
Ini adalah penginstalan macOS Big Sur biasa. Sekarang, lihat apa yang terjadi saat saya mengklik kanan file Excalidraw. Saya dapat memilih untuk membukanya dengan Excalidraw, PWA yang diinstal. Tentu saja, mengklik dua kali juga akan berfungsi, hanya saja kurang dramatis untuk didemonstrasikan dalam screencast.
Jadi, bagaimana cara kerjanya? Langkah pertama adalah membuat jenis file yang dapat ditangani aplikasi saya diketahui oleh
sistem operasi. Saya melakukannya di kolom baru bernama file_handlers dalam manifes aplikasi web. Nilainya
adalah array objek dengan tindakan dan properti accept. Tindakan ini menentukan jalur URL tempat sistem operasi meluncurkan aplikasi Anda dan objek penerima adalah key-value pair jenis MIME dan ekstensi file terkait.
{
"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"]
}
}
]
}
Langkah berikutnya adalah menangani file saat aplikasi diluncurkan. Hal ini terjadi di antarmuka launchQueue
tempat saya perlu menetapkan konsumen dengan memanggil, setConsumer(). Parameter untuk fungsi ini adalah fungsi asinkron yang menerima launchParams. Objek launchParams ini
memiliki kolom bernama files yang memberi saya array handle file untuk digunakan. Saya hanya memerlukan yang pertama dan dari proses penanganan file ini, saya mendapatkan BLOB yang kemudian saya teruskan ke teman lama kita, 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 });
});
});
}
Sekali lagi, jika ini terlalu cepat, Anda dapat membaca selengkapnya tentang File Handling API di artikel saya. Anda dapat mengaktifkan penanganan file dengan menyetel flag fitur platform web eksperimental. Fitur ini dijadwalkan akan tersedia di Chrome pada akhir tahun ini.
Integrasi papan klip
Fitur keren lainnya dari Excalidraw adalah integrasi papan klip. Saya dapat menyalin seluruh gambar atau hanya sebagian ke papan klip, mungkin menambahkan watermark jika mau, lalu menempelkannya ke aplikasi lain. Ini adalah versi web dari aplikasi Paint Windows 95.
Cara kerjanya sangat sederhana. Yang saya perlukan hanyalah kanvas sebagai blob, yang kemudian saya tulis
ke papan klip dengan meneruskan array satu elemen dengan ClipboardItem dengan blob ke
fungsi navigator.clipboard.write(). Untuk mengetahui informasi selengkapnya tentang hal yang dapat Anda lakukan dengan API
papan klip, lihat artikel saya dan Jason.
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);
}
});
};
Berkolaborasi dengan orang lain
Membagikan URL sesi
Tahukah Anda bahwa Excalidraw juga memiliki mode kolaboratif? Beberapa orang dapat mengerjakan dokumen yang sama secara bersamaan. Untuk memulai sesi baru, saya mengklik tombol kolaborasi live, lalu memulai sesi. Saya dapat membagikan URL sesi kepada kolaborator dengan mudah berkat Web Share API yang telah diintegrasikan Excalidraw.
Kolaborasi live
Saya telah menyimulasikan sesi kolaborasi secara lokal dengan mengerjakan logo Google I/O di Pixelbook, ponsel Pixel 3a, dan iPad Pro. Anda dapat melihat bahwa perubahan yang saya buat di satu perangkat akan terlihat di semua perangkat lainnya.
Saya bahkan dapat melihat semua kursor bergerak. Kursor Pixelbook bergerak stabil karena dikontrol oleh trackpad, tetapi kursor ponsel Pixel 3a dan kursor tablet iPad Pro melompat-lompat karena saya mengontrol perangkat ini dengan mengetuk menggunakan jari.
Melihat status kolaborator
Untuk meningkatkan pengalaman kolaborasi real-time, ada sistem deteksi tidak ada aktivitas yang berjalan. Kursor iPad Pro menampilkan titik hijau saat saya menggunakannya. Titik berubah menjadi hitam saat saya beralih ke tab browser atau aplikasi lain. Dan saat saya berada di aplikasi Excalidraw, tetapi tidak melakukan apa pun, kursor menunjukkan saya tidak aktif, yang disimbolkan dengan tiga zZZ.
Pembaca setia publikasi kami mungkin cenderung berpikir bahwa deteksi tidak ada aktivitas diwujudkan melalui Idle Detection API, proposal tahap awal yang telah dikerjakan dalam konteks Project Fugu. Peringatan spoiler: tidak. Meskipun kami memiliki implementasi berdasarkan API ini di Excalidraw, pada akhirnya, kami memutuskan untuk menggunakan pendekatan yang lebih tradisional berdasarkan pengukuran pergerakan pointer dan visibilitas halaman.

Kami mengajukan masukan tentang alasan Idle Detection API tidak menyelesaikan kasus penggunaan yang kami miliki. Semua API Project Fugu dikembangkan secara terbuka, sehingga semua orang dapat ikut serta dan menyampaikan pendapatnya.
Lipis tentang hal yang menghambat Excalidraw
Terkait hal ini, saya mengajukan satu pertanyaan terakhir kepada lipis tentang apa yang menurutnya tidak ada di platform web yang menghambat Excalidraw:
File System Access API memang bagus, tetapi tahukah Anda? Sebagian besar file yang saya perhatikan saat ini berada di Dropbox atau Google Drive, bukan di hard disk saya. Saya berharap File System Access API akan menyertakan lapisan abstraksi untuk penyedia sistem file jarak jauh seperti Dropbox atau Google untuk berintegrasi dan developer dapat membuat kode. Pengguna kemudian dapat merasa tenang dan mengetahui bahwa file mereka aman dengan penyedia cloud yang mereka percayai.
Saya sepenuhnya setuju dengan lipis, saya juga tinggal di cloud. Semoga fitur ini akan segera diterapkan.
Mode aplikasi tab
Wow! Kami telah melihat banyak integrasi API yang sangat bagus di Excalidraw. Sistem file, penanganan file, papan klip, berbagi web, dan target berbagi web. Namun, ada satu hal lagi. Hingga saat ini, saya hanya bisa mengedit satu dokumen dalam satu waktu. Jangan khawatir. Nikmati untuk pertama kalinya versi awal mode aplikasi bertab di Excalidraw. Tampilannya seperti ini.
Saya membuka file yang ada di PWA Excalidraw yang diinstal dan berjalan dalam mode mandiri. Sekarang, saya membuka tab baru di jendela mandiri. Ini bukan tab browser biasa, melainkan tab PWA. Di tab baru ini, saya dapat membuka file sekunder, dan mengerjakannya secara independen dari jendela aplikasi yang sama.
Mode aplikasi tab masih dalam tahap awal dan belum semuanya ditetapkan. Jika Anda tertarik, pastikan untuk membaca status fitur ini saat ini di artikel saya.
Penutup
Agar selalu mendapatkan info terbaru tentang fitur ini dan fitur lainnya, pastikan untuk menonton pelacak API Fugu kami. Kami sangat senang dapat memajukan web dan memungkinkan Anda melakukan lebih banyak hal di platform ini. Semoga Excalidraw terus berkembang, dan semoga Anda dapat membangun berbagai aplikasi yang luar biasa. Mulai buat diagram di excalidraw.com.
Kami tidak sabar untuk melihat beberapa API yang telah kami tunjukkan hari ini muncul di aplikasi Anda. Nama saya Tom, Anda dapat menemukan saya sebagai @tomayac di Twitter dan internet secara umum. Terima kasih banyak telah menonton, dan selamat menikmati sisa acara Google I/O.