Text Field Translator

# Text Field Translator User Guide Text Field Translator is a Chrome extension that translates text directly inside web input fields, comment boxes, reply boxes, and rich text editors. It is designed for users who write comments, replies, messages, or form text in one language and want to quickly convert it into another language before posting or submitting. The extension does not publish, send, or submit anything for you. It only replaces the text in the active input field. You should always review the translated result before posting. ## Main Features - Detects the active input field, text area, comment box, reply box, or editable text area. - Shows a floating `Translate` button near the field you are using. - Translates selected text, or the full field if no text is selected. - Replaces the original text with the translated result. - Supports target language switching from the extension popup. - Supports tone switching from the extension popup. - Skips translation when the text is already in the selected target language. - Works on normal websites as well as many common comment editors. ## Supported Input Areas The extension is built to work with general web input fields, not only specific websites. It tries to support: - Single-line text inputs - Search fields - Email fields - URL fields - Telephone fields - Multi-line text areas - `contenteditable` editors - Comment boxes - Reply boxes - Rich text editors used by many websites Some complex editors may require special handling. The extension includes extra support for certain editors used by sites such as YouTube, Reddit, and X/Twitter, but the main goal is broad support for regular web input fields. Very unusual editors, canvas-based editors, or closed Shadow DOM editors may not allow browser extensions to read or replace text reliably. ## Installation To install the extension locally: 1. Open Chrome. 2. Go to `chrome://extensions`. 3. Turn on `Developer mode`. 4. Click `Load unpacked`. 5. Select the `comment-box-translator-extension` folder. 6. Refresh any web pages that were already open before loading the extension. If you update the extension files, return to `chrome://extensions`, click the reload button on the extension card, and refresh the page where you want to use it. ## Basic Usage 1. Open any website with an input field, comment box, reply box, or editable text area. 2. Click inside the field. 3. Type the text you want to translate. 4. Wait for the floating `Translate` button to appear. 5. Click `Translate`. 6. The extension translates the text and replaces it inside the same field. 7. Review the translated text before posting, sending, or submitting. The extension does not click any submit, send, reply, or post button. ## Translating Selected Text You can translate only part of the text in a field: 1. Select the specific text you want to translate. 2. Click the floating `Translate` button. 3. Only the selected text will be replaced. If no text is selected, the extension translates the entire field. ## Changing the Target Language Click the extension icon in the Chrome toolbar to open the popup. Use the `Target language` menu to choose the language you want the text translated into. Supported target languages: - English - Spanish - French - German - Japanese - Korean - Portuguese - Arabic - Chinese The setting is saved automatically. The next translation will use the selected target language. Examples: - Target language: `English`; input: `太棒了`; result may be `Awesome.` - Target language: `Spanish`; input: `太棒了`; result may be `¡Genial!` - Target language: `Chinese`; input: `This is great.`; result may be `这太棒了。` ## Changing the Tone Click the extension icon and use the `Tone` menu to choose the style of the translation. Available tones: - `Natural`: fluent and neutral wording - `Casual`: relaxed everyday wording - `Friendly`: warm and approachable wording - `Professional`: polished and formal wording - `Short and direct`: concise wording - `Warm and polite`: polite and considerate wording Tone affects how the translation is phrased, but it should preserve the original meaning. ## Same-Language Detection If the input text is already in the selected target language, the extension skips translation. Examples: - Target language is `English`, and the input is `This is great.` The extension skips translation. - Target language is `Chinese`, and the input is `太棒了`. The extension skips translation. - Target language is `Japanese`, and the input is `すごいです`. The extension skips translation. When this happens, the text is not replaced and no translation API request is needed. ## Floating Translate Button The floating button appears near the current input field when the field contains text. You can drag the button to another position on the screen. The button position is saved for the current site. If the button does not appear: 1. Click inside the input field. 2. Type some text. 3. Try selecting the text. 4. Scroll the page slightly. 5. Refresh the page. 6. Reload the extension from `chrome://extensions`. ## Common Messages ### Translated and replaced in the comment box. The translation succeeded, and the translated text was inserted into the active input field. ### The text is already English. The input text is already in the selected target language, so the extension skipped translation. The language name changes depending on your selected target language. ### Type something first, then translate it. The current field does not contain any text that can be translated. ### Click inside a comment box first, then try again. The extension could not find an active input field. Click inside the field you want to translate, then try again. ### The extension was reloaded. Refresh this tab once, then translate again. The extension was reloaded while the current web page was still open. Refresh the page and try again. ### The site editor blocked the replacement. The translation request…