From cd4c5b43d74b7bb3c9f1de67c00bf31f0dd1a9bd Mon Sep 17 00:00:00 2001
From: MattMo <matt@montoyatech.com>
Date: Tue, 27 May 2025 18:24:00 -0700
Subject: [PATCH] Added an OnEscape helper function to capture when the escape
 key is pressed on an element quickly.

---
 ignite-template.js | 48 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/ignite-template.js b/ignite-template.js
index a5270f5..8ad00c6 100644
--- a/ignite-template.js
+++ b/ignite-template.js
@@ -763,6 +763,54 @@ class IgniteTemplate {
         return this;
     }
 
+    /**
+     * Adds a on escape key press event handler to this template.
+     * @param {Function|IgniteProperty} eventCallback The callback function to be invoked by the event once it fires.
+     * @returns {IgniteTemplate} This ignite template so function calls can be chained.
+     */
+    onEscape(eventCallback) {
+        var eventName = "keydown";
+
+        if (!this._events[eventName]) {
+            this._events[eventName] = [];
+        }
+
+        if (eventCallback instanceof IgniteProperty) {
+            this._callbacks.push(eventCallback.attachOnChange((oldValue, newValue) => {
+                //Create a new wrapped function to check for the escape key being pressed.
+                var wrapped = (e) => {
+                    if (e.key === 'Escape') {
+                        newValue(e);
+                    }
+                };
+
+                eventCallback._value = wrapped; //Store the wrapped function into the property so we can remove it later
+                this.onEventChanged(oldValue, wrapped, eventName); //Invoke event changed with the old value and wrapped one.
+            }));
+
+            //Create the initial wrapper
+            var target = eventCallback._value;
+            var wrapped = (e) => {
+                if (e.key === 'Escape') {
+                    target(e);
+                }
+            };
+
+            //Store the wrapped so that it's the old value next time around.
+            eventCallback._value = wrapped;
+
+            this._events[eventName].push(wrapped);
+        } else {
+            this.on(eventName, (e) => {
+                if (e.key === 'Escape') {
+                    eventCallback(e);
+                }
+            });
+        }
+
+        return this;
+    }
+
     /**
     * Adds a on backspace key press event handler to this template.
     * @param {Function|IgniteProperty} eventCallback The callback function to be invoked by the event once it fires.