Allows eventcatcher to be disabled

[saqimtiaz]

This PR extends $eventcatcher with an optional disabled attribute that can be used to toggle the event listeners and thus the functionality of the $eventcatcher widget.

The salient code changes involve refactoring to introduce a new toggleEventListeners method, and updating the refresh logic to handle disabling and enabling the widget by removing and adding the event listeners respectively.

To do:

• update documentation

[netlify]

✅ Deploy Preview for tiddlywiki-previews ready!

Name	Link
🔨 Latest commit	5502f62
🔍 Latest deploy log	https://app.netlify.com/projects/tiddlywiki-previews/deploys/684f1fcf9343fe0008023b58
😎 Deploy Preview	https://deploy-preview-9096--tiddlywiki-previews.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[github-actions]

Confirmed: saqimtiaz has already signed the Contributor License Agreement (see contributing.md)

[github-actions]

📊 Build Size Comparison: empty.html

Branch	Size
Base (master)	2528.0 KB
PR	2529.1 KB

Diff: ⬆️ Increase: +1.1 KB

[pmario]

I think the implementation is OK, but I am not happy with the toggleListeners name. It seems to be a "switchListeners" function, which takes a parameter, that defines the actual state of the listeners.

[saqimtiaz]

@pmario the method in question removes or adds the event listeners depending on its argument. I am open to alternative names, however switchListeners does not seem appropriate as it implies swapping between one listener and another.

[pmario]

hmmm. The thesaurus also suggested "adjust" -- May be adjustListeners

[saqimtiaz]

@pmario I do not find either of the proposed method names preferable to toggleListeners. Adjust would imply that the listeners are somehow modified, not that they are added or removed.

Toggle seems an apt description of what the method does, it adds and removes listeners. configureListeners could be an acceptable alternative, though toggleListeners feels more intuitive and self-explanatory to me.