tauri 2.11.0

Make tiny, secure apps for all desktop platforms with Tauri
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
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129

// Copyright 2019-2024 Tauri Programme within The Commons Conservancy
// SPDX-License-Identifier: Apache-2.0
// SPDX-License-Identifier: MIT

;(function () {
  //-----------------------//
  // drag on mousedown and maximize on double click on Windows and Linux
  // while macOS maximization should be on mouseup and if the mouse
  // moves after the double click, it should be cancelled (see https://github.com/tauri-apps/tauri/issues/8306)
  //-----------------------//
  const TAURI_DRAG_REGION_ATTR = 'data-tauri-drag-region'
  const CLICKABLE_TAGS = new Set([
    'A',
    'BUTTON',
    'INPUT',
    'SELECT',
    'TEXTAREA',
    'LABEL',
    'SUMMARY'
  ])
  const INTERACTIVE_ROLES = new Set([
    'button',
    'link',
    'menuitem',
    'tab',
    'checkbox',
    'radio',
    'switch',
    'option'
  ])

  function isClickableElement(el) {
    return (
      CLICKABLE_TAGS.has(el.tagName)
      || (el.hasAttribute('contenteditable')
        && el.getAttribute('contenteditable') !== 'false')
      || (el.hasAttribute('tabindex') && el.getAttribute('tabindex') !== '-1')
      || INTERACTIVE_ROLES.has(el.getAttribute('role'))
    )
  }

  // Walk the composed path from target upward.
  //
  // Supported values for data-tauri-drag-region:
  //   (bare / no value / "true") -> self: only direct clicks on this element trigger drag
  //   "deep"                   -> deep: clicks anywhere in the subtree trigger drag
  //   "false"                  -> disabled: drag is blocked here (and for ancestors)
  //
  // Clickable elements (buttons, links, etc.) normally block dragging,
  // but if they themselves carry data-tauri-drag-region they act as drag regions.
  function isDragRegion(composedPath) {
    for (const el of composedPath) {
      if (!(el instanceof HTMLElement)) continue

      const attr = el.getAttribute(TAURI_DRAG_REGION_ATTR)

      // clickable without explicit drag region → blocks drag
      if (isClickableElement(el) && attr === null) return false
      // no attr → keep walking up
      if (attr === null) continue
      // explicitly disabled
      if (attr === 'false') return false
      // subtree drag — any descendant triggers
      if (attr === 'deep') return true
      // bare or "true" attr — only direct clicks on this element
      if (attr === '' || attr === 'true') return el === composedPath[0]
    }

    return false
  }

  const osName = __TEMPLATE_os_name__

  // initial mousedown position for macOS
  let initialX = 0
  let initialY = 0

  document.addEventListener('mousedown', (e) => {
    if (
      // was left mouse button
      e.button === 0
      // and was normal click to drag or double click to maximize
      && (e.detail === 1 || e.detail === 2)
      // and is drag region
      && isDragRegion(e.composedPath())
    ) {
      // macOS maximization happens on `mouseup`,
      // so we save needed state and early return
      if (osName === 'macos' && e.detail === 2) {
        initialX = e.clientX
        initialY = e.clientY
        return
      }

      // prevents text cursor
      e.preventDefault()

      // fix #2549: double click on drag region edge causes content to maximize without window sizing change
      // https://github.com/tauri-apps/tauri/issues/2549#issuecomment-1250036908
      e.stopImmediatePropagation()

      // start dragging if the element has a `tauri-drag-region` data attribute and maximize on double-clicking it
      const cmd = e.detail === 2 ? 'internal_toggle_maximize' : 'start_dragging'
      window.__TAURI_INTERNALS__.invoke('plugin:window|' + cmd)
    }
  })

  // on macOS we maximize on mouseup instead, to match the system behavior where maximization can be canceled
  // if the mouse moves outside the data-tauri-drag-region
  if (osName === 'macos') {
    document.addEventListener('mouseup', (e) => {
      if (
        // was left mouse button
        e.button === 0
        // and was double click
        && e.detail === 2
        // and the cursor hasn't moved from initial mousedown
        && e.clientX === initialX
        && e.clientY === initialY
        // and the event path contains a drag region (with no clickable element in between)
        && isDragRegion(e.composedPath())
      ) {
        window.__TAURI_INTERNALS__.invoke(
          'plugin:window|internal_toggle_maximize'
        )
      }
    })
  }
})()