News Flash (April 21, '09): Mike Almond from MadeByPi has ported the JSTextReader to AS3!
The JSTextReader works around a bug that occurs with text input in flash when the swf is embedded with the wmode="transparent" parameter (which allows the browser content to show through the background of the swf). This bug occurs in several browsers / flash player combinations (especially earlier browser/flash player versions), albeit manifesting itself differently.
In Firefox, no matter what keyboard layout the user has, the swf receives keystrokes as if a US keyboard were used.
In Safari 3.1.2 on Windows only (tested on XP), and in Google Chrome (0.2.149.29 and 5.0.375.86) on Windows XP the bug appears to manifest the same way as in Firefox.
In Internet Explorer, it appears that we get the "2 for 1" bug, where the true 4-byte unicode characters received by the swf are split into two 2-byte characters (which appear as "garbage").
This works in Firefox, Internet Explorer, and in later versions of Chrome (5.0.375.86).
In Safari (tested 3.1.2 and 5.0.7533.16 on Windows), there is a bug due to which the keypress event is not fired when flash (with wmode="transparent") absorbs the keyboard events. (keydown is in fact fired, but this does not help since we only receive the keyCode and not the charCode in this case). For this reason, the JSTextReader does not work on such Webkit-based browsers, in which the bug also manifests in some configurations. This problem also affected early Google Chrome (tested 0.2.149.29 on Windows), but in later Chrome versions (tested 5.0.375.86 on Windows) JSTextReader works as designed. If you have ideas on how to make JSTextReader work for these problematic Webkit-based browsers, please tell us.
Below we see two test SWFs embedded with wmode="transparent", which allows the image-tiled background in the browser to show through. The first test SWF has JSTextReader enabled automatically, while the second one does not. Please switch your keyboard to a non-USA keyboard layout (e.g., FR, UK or RU) to see the difference between the SWF in which JSTextReader is enabled and the one in which it is not.
For the first SWF, hopefully everything should work fine. (Note: some languages such as Japanese do not work with JSTextReader, sorry.) For the second SWF, in Firefox you will see the input show up as if you were typing on a keyboard with USA layout. In Internet Explorer, for 4-byte unicode chars such as found in RU (cyrillic), you will see some garbage - each 4-byte char will be split up into two 2-byte chars and then rendered.
The table below contains results for testing the latest version of JSTextReader in various browser/OS combinations.
|Browser||OS||Flash Player Version||JSTextReader Results||Bug Manifestation|
|IE 8.0.6001.18928||Win Vista||10.1.53.64||Works.||The bug does not manifest.|
|IE 7.0.6001.18000||Win Vista||10.1.53.64||Works.||The bug does not manifest.|
|IE7||WinXP/SP2||18.104.22.168||Works.|| "2-for-1" bug.|
|FF 3.5.10||Win Vista||10.1.53.64||Works.||The bug does not manifest.|
|FF3||Mac OS X/10.4.11||22.214.171.124||Works.||"US-keyboard" bug.|
|Google Chrome 5.0.375.86||Win Vista||10.1.53.64||Works.|| "US-keyboard" bug.|
|Google Chrome 0.2.149.29||Win XP/SP2||126.96.36.199||Does nothing and cannot be fixed for reasons described above (keypress is not triggered when flash absorbs key events).||"US-keyboard" bug.|
|Safari 5.0.7533.16||Win Vista||10.1.53.64||Does nothing and cannot be fixed for reasons described above (keypress is not triggered when flash absorbs key events).||"US-keyboard" bug.|
|Safari 3.1.2||Win XP/SP2||188.8.131.52||Does nothing and cannot be fixed for reasons described above (keypress is not triggered when flash absorbs key events). ||"US-keyboard" bug.|
|Safari 4.0.5||Max OS X/10.5.8||10.0.42.34||Does nothing.||The bug does not manifest.|
|Safari 4 (beta)||Max OS X/10.4||Unspecified||Reportedly doesn't work (nothing is entered into the text input at all.)||The bug does not manifest (?).|
|Safari 3.1.2||Mac OS X/10.4.11||184.108.40.206|| Does nothing.|| The bug does not manifest. (There are reports however that for some keyboard layouts the "US-keyboard" bug manifests as well.).|
Future Features / Suggestions
The JSTextReader is distributed under the Creative Commons Attribution 3.0 United States License (human readable version).
The JSTextReader is currently being distributed for free. If you have used this code and feel like donating a couple bucks, it will be greatly appreaciated.
Download JSTextReader 1.1a Beta (Sep 09, 2008).
Mike Almond from MadeByPi
has ported the JSTextReader to AS3
You can write to me at if you want, but better yet contribute your feedback to the JSTextReader actionscript.org thread. The JSTextReader is still in beta and needs testing with as many browsers and languages as we can get our hands on, so your feedback on this is invaluable. If you test a browser / OS combo not in the Browser Testing table above, please let us know and we'll add the results to the table.