Primer ViewComponents v0.29.0

Previews

No matching results.

x
1
2
3
4
5
6
<span data-view-component="true">
  <clipboard-copy aria-label="Click to copy!" value="Text to copy" data-view-component="true">
    Click to copy!
  </clipboard-copy>  
  <div aria-live="polite" aria-atomic="true" class="sr-only" data-clipboard-copy-feedback></div>
</span>
1
render(Primer::Beta::ClipboardCopy.new(value: value, "aria-label": aria_label)) { "Click to copy!" }

No notes provided.

Param Description Input

—

—

app/components/primer/beta/clipboard_copy.ts

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
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
import '@github/clipboard-copy-element'
const CLIPBOARD_COPY_TIMER_DURATION = 2000
function showSVG(svg: SVGElement) {
  svg.style.display = 'inline-block'
}
function hideSVG(svg: SVGElement) {
  svg.style.display = 'none'
}
// Toggle a copy button.
function showCopy(button: HTMLElement) {
  const [copyIcon, checkIcon] = button.querySelectorAll<SVGElement>('.octicon')
  if (!copyIcon || !checkIcon) return
  showSVG(copyIcon)
  hideSVG(checkIcon)
}
// Toggle a copy button.
function showCheck(button: HTMLElement) {
  const [copyIcon, checkIcon] = button.querySelectorAll<SVGElement>('.octicon')
  if (!copyIcon || !checkIcon) return
  hideSVG(copyIcon)
  showSVG(checkIcon)
}
const clipboardCopyElementTimers = new WeakMap<HTMLElement, number>()
document.addEventListener('clipboard-copy', ({target}) => {
  if (!(target instanceof HTMLElement)) return
  if (!target.hasAttribute('data-view-component')) return
  const currentTimeout = clipboardCopyElementTimers.get(target)
  const clipboardCopyLiveRegion = target.parentNode?.querySelector<HTMLElement>('[data-clipboard-copy-feedback]')
  const copiedAnnouncement = 'Copied!'
  if (currentTimeout) {
    clearTimeout(currentTimeout)
    clipboardCopyElementTimers.delete(target)
  } else {
    showCheck(target)
    if (clipboardCopyLiveRegion) {
      if (clipboardCopyLiveRegion.textContent === copiedAnnouncement) {
        /* This is a hack due to the way the aria live API works.
        A screen reader will not read a live region again
        if the text is the same. Adding a space character tells
        the browser that the live region has updated,
        which will cause it to read again, but with no audible difference. */
        clipboardCopyLiveRegion.textContent = `${copiedAnnouncement}\u00A0`
      } else {
        clipboardCopyLiveRegion.textContent = copiedAnnouncement
      }
    }
  }
  clipboardCopyElementTimers.set(
    target,
    setTimeout(() => {
      showCopy(target)
      clipboardCopyElementTimers.delete(target)
    }, CLIPBOARD_COPY_TIMER_DURATION),
  )
})