Handling accidental double-taps on buttons with MMSingleClickMouseArea (

#3532)

* updating all versions after release

* MMSingleClickMouseArea draft

* code adjustments

* preventing click from propagating to the background

* adding new SingleClickMouseArea to photo procedures

* new component description and added to gallery qrc, timer set to 2 seconds

* how-to use new component

* version fix

* post review fixes

* small code layout fix

* MMSingleClickMouseArea on openLinkedFeature

* adding MMSingleClickMouseArea to MMPhoto

app/qml/CMakeLists.txt

@@ -50,6 +50,7 @@ set(MM_QML
     components/MMText.qml
     components/MMToolbar.qml
     components/MMToolbarButton.qml
+    components/MMSingleClickMouseArea.qml
     components/private/MMBaseInput.qml
     components/private/MMBaseSingleLineInput.qml
     components/private/MMToolbarLongButton.qml

app/qml/components/MMPhoto.qml

@@ -52,9 +52,9 @@ Image {
     }
   }
 
-  MouseArea {
+  MMSingleClickMouseArea {
     anchors.fill: parent
-    onClicked: root.clicked(root.photoUrl)
+    onSingleClicked: root.clicked(root.photoUrl)
   }
 
   onStatusChanged: {

app/qml/components/MMSingleClickMouseArea.qml

@@ -0,0 +1,38 @@
+/***************************************************************************
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the GNU General Public License as published by  *
+ *   the Free Software Foundation; either version 2 of the License, or     *
+ *   (at your option) any later version.                                   *
+ *                                                                         *
+ ***************************************************************************/
+
+import QtQuick
+
+/**
+  * MMSingleClickMouseArea enhances MouseArea by preventing multiple clicks within a
+  * specified time frame, ensuring consistent behavior and avoiding unintended actions
+  * Similar to MouseArea, but it should be used with onSingleClicked signal handling instead of onClicked
+*/
+
+MouseArea {
+  id: root
+
+  signal singleClicked()
+
+  onClicked: {
+    if ( timer.running ) {
+      mouse.accepted = true;
+      return;
+    }
+
+    singleClicked()
+    timer.start()
+  }
+
+  Timer {
+    id: timer
+    interval: 2000
+    repeat: false
+  }
+}

app/qml/form/components/photo/MMPhotoAttachment.qml

@@ -63,9 +63,9 @@ Rectangle {
         }
       }
 
-      MouseArea {
+      MMComponents.MMSingleClickMouseArea{
         anchors.fill: parent
-        onClicked: root.capturePhotoClicked()
+        onSingleClicked: root.capturePhotoClicked()
       }
     }
 
@@ -102,9 +102,9 @@ Rectangle {
         }
       }
 
-      MouseArea {
+      MMComponents.MMSingleClickMouseArea{
         anchors.fill: parent
-        onClicked: root.chooseFromGalleryClicked()
+        onSingleClicked: root.chooseFromGalleryClicked()
       }
     }
   }

app/qml/form/editors/MMFormGalleryEditor.qml

@@ -89,9 +89,9 @@ MMPrivateComponents.MMBaseInput {
           size: __style.icon32
         }
 
-        MouseArea {
+        MMComponents.MMSingleClickMouseArea {
           anchors.fill: parent
-          onClicked: {
+          onSingleClicked: {
             root.createLinkedFeature( root._fieldFeatureLayerPair, root._fieldAssociatedRelation )
           }
         }

app/qml/form/editors/MMFormRelationEditor.qml

@@ -85,9 +85,9 @@ MMPrivateComponents.MMBaseInput {
           height: width
         }
 
-        MouseArea {
+        MMComponents.MMSingleClickMouseArea{
           anchors.fill: parent
-          onClicked: {
+          onSingleClicked: {
             root.forceActiveFocus() // clear focus from all elements to prevent freezing #3483
             root.createLinkedFeature( root._fieldFeatureLayerPair, root._fieldAssociatedRelation )
           }
@@ -135,9 +135,9 @@ MMPrivateComponents.MMBaseInput {
             verticalAlignment: Text.AlignVCenter
           }
 
-          MouseArea {
+          MMComponents.MMSingleClickMouseArea {
             anchors.fill: parent
-            onClicked: root.openLinkedFeature( model.FeaturePair )
+            onSingleClicked: root.openLinkedFeature( model.FeaturePair )
           }
 
           onVisibleChanged: root.recalculateVisibleItems()

gallery/qml.qrc

@@ -75,6 +75,7 @@
         <file>../app/qml/components/MMDrawer.qml</file>
         <file>../app/qml/components/MMDrawerHeader.qml</file>
         <file>../app/qml/components/MMBusyIndicator.qml</file>
+        <file>../app/qml/components/MMSingleClickMouseArea.qml</file>
         <file>../app/qml/account/components/MMAccountPageItem.qml</file>
         <file>../app/qml/account/components/MMIconCheckBoxHorizontal.qml</file>
         <file>../app/qml/account/components/MMIconCheckBoxVertical.qml</file>