zeyn 0.0.8

Rust web framework for data heavy applications, written by AI agents and reviewed by people
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

/**
 * Share buttons (`zeyn::ui::Share`). components.js loads this module the first time a page holds
 * one. It shows the buttons, which the server renders hidden so pages without script have no
 * button that does nothing. Pressing one opens the system share sheet when the browser has the
 * Web Share API, and otherwise copies the link and says so in a toast of the runtime.
 * @module share
 */

/** Shows the share buttons inside `root`. */
function init(root) {
  for (const button of root.querySelectorAll('button[data-zeyn-share][hidden]')) button.hidden = false;
}

/** Shows a toast through zeyn.js, which owns the toast region. */
function toast(message, tone) {
  document.dispatchEvent(new CustomEvent('zeyn:run', { detail: { effects: [{ effect: 'toast', message, tone }] } }));
}

/** Shares or copies the link of a button. */
async function share(button) {
  const url = new URL(button.dataset.url || location.href, location.href).href;
  const title = button.dataset.title || document.title;
  if (typeof navigator.share === 'function') {
    try {
      await navigator.share({ url, title });
      return;
    } catch (err) {
      if (err?.name === 'AbortError') return;
    }
  }
  try {
    await navigator.clipboard.writeText(url);
    toast(button.dataset.copied, 'success');
  } catch {
    toast(button.dataset.failed, 'danger');
  }
}

document.addEventListener('click', (e) => {
  const button = e.target instanceof Element ? e.target.closest('button[data-zeyn-share]') : null;
  if (button) share(button);
});

document.addEventListener('zeyn:content', (e) => init(e.detail instanceof Element ? e.detail : document));
init(document);