Merge branch 'main' of https://github.com/ttop32/MouseTooltipTranslator

Author: ttop32

doc/intro.md

@@ -1,48 +1,63 @@
 # How to use
 
-- Basic uses : Hover or select (highlight) on text to translate. 
+- Basic Uses: Hover over or select (highlight) text to translate. 
   - Test hover with example text:  
 ```console
 Proletarier aller Länder, vereinigt euch!
 ```
-  - If not working, check current target language
+  - If the translation isn't working, verify that the correct target language is selected.
     - Check [how to change language](https://github.com/ttop32/MouseTooltipTranslator/blob/main/doc/intro.md#change-language)
-    - This translator will skip text if source text language and target language are same.
+    - This translator will omit text if the source and target languages are identical.
 
 ![Alt Text](/doc/result_0.gif)
-- Hold <kbd>left ctrl</kbd> to listen tts pronunciation when tooltip is shown(Press <kbd>esc</kbd> to stop voice)
+
+- Hold the <kbd>left-ctrl</kbd> key (default) key to hear the TTS pronunciation when a tooltip appears. Press <kbd>Esc</kbd> to stop the voice.
+
 ![result](/doc/20.gif)
-- Use <kbd>right alt</kbd> to translate writing text (or highlighted text) in input box. (Do undo, press <kbd>ctrl</kbd> +<kbd>z</kbd>)
-  - If not working, check current target language and writing language.
+
+- Press the <kbd>right-alt</kbd> key (default) key to translate the text you're writing (or any highlighted text) in the input box. If needed, you can undo the action by pressing <kbd>ctrl</kbd> + <kbd>z</kbd>.
+  - If the translation isn't working, ensure that your current target language matches your writing language.
+
 ![result](/doc/11.gif)
-- Translate url search box text by <kbd>/</kbd>+<kbd>space</kbd> before typing. 
+
+- Translate url search box text by <kbd>/</kbd>+<kbd>space</kbd> before typing.
+
 ![result](/doc/21.gif)
+
 - Support online pdf to display translated tooltip using PDF.js (local computer pdf file need additional permission, see [exception](https://github.com/ttop32/MouseTooltipTranslator/blob/main/doc/intro.md#exception))
+
 ![result](/doc/12.gif)
-- Support dual subtitles for youtube video. 
+
+- Support dual subtitles for YouTube videos.
+
 ![result](/doc/16.gif)
-- Process OCR when hold <kbd>left shift</kbd> + <kbd>mouse over</kbd> on image (ex manga)
+
+- Process OCR when holding <kbd>left-shift</kbd> key (default) + mouse over on an image (e.g., manga)
+
 ![result](/doc/15.gif)
-- Activate speech recognition translator with holding <kbd>right ctrl</kbd>
-  - Default speech recognition language is english
-  - If speech recognition language and target language are same, it will skip
+
+- Activate the speech recognition translator by holding down the <kbd>right-ctrl</kbd> key (default).
+  - Default speech recognition language is English.
+  - If the speech recognition language and target language are the same, it skips.
   - Audio permission is required
-  - Only works on chrome and edge
+  - Only compatible with Chromium-based browsers, such as Google Chrome, MS-Edge, Vivaldi, Opera, Brave, Arc, and Yandex.
 - Customize shortcut key
-  - From chrome://extensions/shortcuts
+  - From chrome://extensions/shortcuts or the equivalent browser internal configuration page, accessible by replacing chrome:// with your browser's internal URL (e.g., edge://, browser://, or brave:// etc).
 # Change Language
 - Change current language in setting page
-  -  Setting page can be found in browser top right puzzle button
+  -  The Settings page can be accessed by clicking the puzzle (extension) button  located at the top right of your browser.
+
 ![result](/doc/14.gif)
 
 
 # Exception
 
 - If source text language and translate language are same, it will skip. 
-- If web status is offline, it will not work. 
+- The application will not function if the web status is offline. 
 - If site is <https://chrome.google.com/extensions>, it does not work because Chrome security reason. 
 - If no local file permission given, local pdf cannot be handled.
-  - If not working, darg and drop file on tab
-  - It will give no permission warning and it redirect to permission page
-  - In the redirecetd page, make sure to check "allow access to file urls" for accessing file    
+  - If the file doesn't open, try dragging and dropping it onto the tab.
+  - It will not display a permission warning and instead redirect to the permission page.
+  - On the redirected page, ensure that you select "allow access to file URLs" to access files.
+    
 ![result](/doc/10.gif)

src/event/mouseover.js

@@ -5,6 +5,7 @@
 // 4. range to text
 
 import * as util from "/src/util";
+import {debounce} from "lodash";
 
 var clientX = 0;
 var clientY = 0;
@@ -15,16 +16,15 @@ const PARENT_TAGS_TO_EXCLUDE = ["STYLE", "SCRIPT", "TITLE"];
 
 export function enableMouseoverTextEvent(
   _window = window,
-  textDetectTime = 0.7
+  textDetectTime = 0.1
 ) {
   _win = _window;
   textDetectTime = Number(textDetectTime) * 1000;
-
-  setInterval(async () => {
+  const triggerMouseoverTextWithDelay = debounce(async() => {
     triggerMouseoverText(await getMouseoverText(clientX, clientY));
   }, textDetectTime);
 
-  window.addEventListener("mousemove", (e) => {
+  window.addEventListener("mousemove", async (e) => {
     //if is ebook viewer event, take ebook window
     if (e.ebookWindow) {
       _win = e.ebookWindow;
@@ -38,6 +38,8 @@ export function enableMouseoverTextEvent(
     //else record mouse xy
     clientX = e.clientX;
     clientY = e.clientY;
+
+    triggerMouseoverTextWithDelay();
   });
 }
 
@@ -66,6 +68,7 @@ async function getMouseoverText(x, y) {
   //get text from range
   var mouseoverText = await getTextFromRange(range);
   textElement?.remove();
+
   return mouseoverText;
 }
 async function getTextFromRange(range) {

src/event/selection.js

@@ -2,14 +2,14 @@
  * Selection related functions
  */
 import $ from "jquery";
-import { debounce, throttle } from "lodash";
+import { debounce } from "lodash";
 import * as util from "/src/util";
 
 var _win;
 var prevNoneSelect = false;
 export function enableSelectionEndEvent(
   _window = window,
-  textDetectTime = 0.7
+  textDetectTime = 0.1
 ) {
   _win = _window;
   textDetectTime = Number(textDetectTime) * 1000;

src/pages/index.vue

@@ -182,7 +182,7 @@ var voiceRateList = util.getRangeOption(0.5, 2.1, 0.1, 1);
 var voiceRepeatList = util.getRangeOption(1, 11);
 var tooltipBackgroundBlurList = util.getRangeOption(0, 21);
 var distanceList = util.getRangeOption(0, 41);
-var tooltipIntervalTimeList = util.getRangeOption(0.5, 2.1, 0.1, 1);
+var tooltipIntervalTimeList = util.getRangeOption(0.1, 2.1, 0.1, 1);
 
 var tooltipPositionList = {
   Follow: "follow",

src/util/index.js

@@ -89,7 +89,7 @@ export var defaultData = {
   ignoreCallbackOptionList: ["historyList"],
   popupCount: "0",
   langPriority: { auto: 9999999, null: 9999999 },
-  tooltipIntervalTime: "0.7",
+  tooltipIntervalTime: "0.1",
 
   cardPlayMeta: ["image"],
   cardTagSelected: [],