htmlArea v2.00
Turn any <textarea> into a WYSIWYG editor, a free script
from your friends at interactivetools.com

Introduction

What is htmlArea?
Is it really free? What's the catch?
What are the browser requirements?
Can I see an example of what it looks like?
Where can I find out more info, download the latest version, and talk to other htmlArea users?

Installation / Setup

How do I add htmlArea to my web page?
I want to change the editor settings, how do I do that?
How can I change what controls are displayed on the toolbar?
How can I change what fonts are in the font list?
How can I change what sizes are in the font size?
How can I change what styles are in the font style (CSS) list?
How can I specify an external stylesheet for my styles?

Frequently Asked Questions

What the project goals for htmlArea?
This editor is pretty neat, so how does it actually work?
You don't happen to have one of these for (Netscape, Mozilla, Opera, etc) do you?
Why doesn't htmlArea output XHTML instead of regular HTML? Can you make it do that?
I'd like to be able to upload images from my hard drive, can you add that feature?
I'd like to be insert & modify tables, can you add that feature?
I'd like to <insert idea here>, can you add that feature?
Can I change the toolbar/button colors?
I love htmlArea, is there anything I can do to help the project?

Known Bugs & Issues

Undo/Redo doesn't work
Relative paths are converted to absolute paths
HTML header info (eg: <head>, <body>, etc) doesn't get preserved
Some tags (eg: noframes, noscript, etc) doesn't get preserved
htmlArea doesn't work when multiple textareas that have the same name

Change Log

View Change Log

Introduction back to top

What is htmlArea?
  htmlArea is a free WYSIWYG (what you see is what you get) editor replacement for <textarea> fields. By adding a few simple lines of JavaScript to your web page you can replace a regular textarea with a rich text editor that let your users do the following:

  - Format text to be bold, italicized, or underlined.
  - Change the face, size, style and colour.
  - Left, centre, or right-justify paragraphs.
  - Make bulleted or numbered lists.
  - Indent or un-indent paragraphs.
  - Insert a horizontal line.
  - Insert hyperlinks and images.
  - View the raw HTML source of what they're editing.
  - and much more...

  Some of the interesting features of htmlArea that set's it apart from other web based WYSIWYG editors are as follows:

  - It's lightweight, fast loading and can transform a regular textarea into a rich-text editor with a single line of JavaScript.
  - It's 100% backwards compatable with older or non-supported browsers (they get the original textarea field).
  - It's free and can be incorporated into any free or commericial program.
  - It works with any programming language (ASP, PHP, Perl, Java, etc).
  - It's written in simple JavaScript and can be easily viewed, modified or extended.
  - It remembers entered content when a user navigates away and then hits "back" in their browser.
  - Since it replaces existing textareas it doesn't require a lot of code to add it to your pages (just one line).
  - Did we mention it was free? : )

Is it really free? What's the catch?
  Yes! It's really free. You can use it, modify it, distribute it with your software, or do just about anything you like with it. The only thing we ask is that you don't remove the "about this editor" info button. We want everybody to be able to make use of htmlArea, but we'd also like other users to be able to find out about it so they can download it as well. Having a single button on the interface that pops up an "About this editor" window seemed to be the most low-key way to do this. The info button looks like this .

What are the browser requirements?
  htmlArea requires Internet Explorer 5.5 or better on Windows to run. This is because it makes use of some advanced features of IE5.5 that aren't available in other browsers yet. It is backwards compatible with other browsers, though. They will get a regular textarea field instead of a WYSIWYG editor.

Can I see an example of what it looks like?
  Sure, make sure you're using IE5.5 or better on windows and see below.

  Here is a regular <textarea> field.
  Here is some sample text in a regular <textarea>. There's not much you can do besides, well, enter plain text...

  And here is a <textarea> transformed with htmlArea (with a single line of JavaScript code).

  Here is some sample text in textarea thats been transformed with <font color="#0000CC"><b>htmlArea</b></font>.<br> You can make things <b>bold</b>, <i>italic</i>, <u>underline</u>. You can change the <font size=3>size</font> and <b><font color="#0000CC">c</font><font color="#00CC00">o</font><font color="#00CCCC">l</font><font color="#CC0000">o</font><font color="#CC00CC">r</font><font color="#CCCC00">s</font><font color="#CCCCCC">!</font></b> And lots more... <P align=center><FONT size=4 color=#ff0000><b><U>Try htmlArea today!</U></b></FONT><BR>

Where can I find out more info, download the latest version, and talk to other htmlArea users?
  You can find out more about htmlArea and download the latest version on the htmlArea homepage and you can talk to other htmlArea users and post any comments or suggestions you have in the htmlArea forum.

Installation / Setup back to top

How do I add htmlArea to my web page?
  It's easy, first you need to upload the htmlArea files to your website. Just follow these steps:

  1. Download the latest version from the htmlArea homepage.
  2. Unzip the files onto your local computer (making sure to maintain the directory structure contained in the zip).
  3. Create a new folder on your website called /htmlarea/ (make sure it's NOT inside the cgi-bin).
  4. Transfer all the htmlArea files from your local computer into the /htmlarea/ folder on your website.
  5. Open the example page /htmlarea/example.html with your browser to make sure everything works.
  Once htmlArea is on your website all you need to do is add some JavaScript to any pages that you want to add WYSIWYG editors to. Here's how to do that.

  1. Open the page you want to add a WYSIWYG editor to. Add the following to the top of the page in the <head></head> of the HTML document.
     <script><!-- // load htmlArea files
     _editor_url = "/htmlarea/"; // URL to htmlarea files
     document.write('<scr'+'ipt src="' +_editor_url+ 'editor.js"');
     document.write('language="JavaScript1.2"></scr'+'ipt>');
     //--></script>
     If you've installed htmlArea anywhere other than /htmlarea/ then be sure to change _editor_url to point to your htmlarea directory (ending with a forward slash "/").

  2. For each <textarea> that you want to change, add the following code to the page.
     <script language="JavaScript1.2" defer>
     editor_generate('fieldname');
     </script>
     Be sure to change "fieldname" to be the name (not id) of the textarea you want to change.

  3. And you're done, open your page in your browser and see if it worked. If you run into any problems, keep trying and feel free to visit the htmlArea forum.

I want to change the editor settings, how do I do that?
  While it's true that all you need is one line of JavaScript to create an htmlArea WYSIWYG editor you can also specify more config settings in the code to control how the editor works and looks. Here's an example of some of the available settings:
  <script language="JavaScript1.2" defer>
  var config = new Object(); // create new config object
  config.width = "90%";
  config.height = "200px";
  config.bodyStyle = 'background-color: white; font-family: "Verdana"; font-size: x-small;';
  config.debug = 0;
  // Add additional editor config settings here...
  editor_generate('fieldname',config);
  </script>
  See below for even more configuration options that can be added. All of these settings will use default values in editor.js if you don't specify them yourself.

  Width | specifies the width of the editor (in pixels or as a percentage).
  Height | specifies the height of the editor (in pixels or as a percentage).
  bodyStyle | specifies CSS style of the editor window including color, default font face, and size. Note, the default font information isn't saved, it just controls how text is displayed if no other font formatting has been applied.
  debug | if set to 1, displays a debug field with the actual contents of the editor (in raw html) which is updated as your type.

How can I change what controls are displayed on the toolbar?
  You can add a config.toolbar config setting to control exactly what's shown on the toolbar. Here's an example.
  config.toolbar = [
  ['fontname'],
  ['fontsize'],
  ['fontstyle'],
  ['linebreak'],
  ['bold','italic','underline','separator'],
  ['strikethrough','subscript','superscript','separator'],
  ['justifyleft','justifycenter','justifyright','separator'],
  ['OrderedList','UnOrderedList','Outdent','Indent','separator'],
  ['forecolor','backcolor','separator'],
  //['custom1','custom2','custom3','separator'],
  ['HorizontalRule','Createlink','InsertImage','htmlmode','separator'],
  ['about','help']
  ];
  The square brackets control how the buttons are "grouped" together. You can either erase or comment out (by adding // to the beginning of the line) buttons or button groups you don't want displayed. Most of the buttons do pretty much just what you'd expect, but here's a few odd ones for reference.

  linebreak | adds a linebreak to the toolbar, all buttons after this are on the next line.
  separator | adds a vertical separator between buttons, helps to visually group buttons together
  customN | these are custom buttons that can be defined by JavaScript programmers who want to extend htmlArea.

How can I change what fonts are in the font list?
  There is a config.fontnames setting that let's you control this. See below.
  config.fontnames = {
  "Arial": "arial, helvetica, sans-serif",
  "Courier New": "courier new, courier, mono",
  "Georgia": "Georgia, Times New Roman, Times, Serif",
  "Tahoma": "Tahoma, Arial, Helvetica, sans-serif",
  "Times New Roman": "times new roman, times, serif",
  "Verdana": "Verdana, Arial, Helvetica, sans-serif",
  "impact": "impact",
  "WingDings": "WingDings"
  };
  The name on the left is what is displayed to the user. The list of fonts on the right is what is actually put into the font tag in the code.

How can I change what sizes are in the font size?
  There is a config.fontsizes setting that let's you control this. See below.
  config.fontsizes = {
  "1 (8 pt)": "1",
  "2 (10 pt)": "2",
  "3 (12 pt)": "3",
  "4 (14 pt)": "4",
  "5 (18 pt)": "5",
  "6 (24 pt)": "6",
  "7 (36 pt)": "7"
  };
  The value on the right is what the user sees, the value on the left is the actual font size used.

How can I change what styles are in the font style (CSS) list?
  As you can probably guess, there's a config.fontstyles setting for this. Now remember, the styles defined here control how the text looks in the editor. These styles ALSO have to be defined on any page where you display content created with the editor. htmlArea will save the class name with the content but nothing else. It's up to you to define the class style in your pages.
  config.fontstyles = [{
  name: "headline",
  className: "headline",
  classStyle: "font-family: arial; font-size: 28px;"
  },{
  name: "red text",
  className: "saletext2",
  classStyle: ""
  }];
  The "name" is what's displayed to users, "className" is the name of the CSS class to use, and classStyle defines the attributes of the style in the editor. If you leave classStyle blank you have to be sure to also specify an external stylesheet with all the style information (and matching classNames!). See the next question on how to do that.

How can I specify an external stylesheet for my styles?
  You can specify a stylesheet to avoid entering the class style data for each class name. You STILL have to specify which classNames you want to have available though, see the previous question for information on that.
  config.stylesheet = "/style.css";

Frequently Asked Questions back to top

What are the project goals for htmlArea?
  When we originally started the htmlArea project we had some pretty specific goals in mind for how it would work and what issues were important to us. Those goals still lead the direction of development today and are listed below in order of priority.

  1. Compatability
  htmlArea has to always be backwards compatable with older and unsupported browsers. This ensures that even if a user with an older and unsupported browser can't use htmlArea, they'll always be able to, at a minimum, enter text in a plain textarea like they would have done before. htmlArea should also be compatable with as many programming languages as possible by being completely DHTML and JavaScript based.

- Ease of Use
  htmlArea needs to be easy for developers to integrate into their applications and customize, easy for programmers to extend and modify, and easy for end users to "use". That's why you only have to add a single line of JavaScript for each textarea you want to convert, and why all the code is stored in a single, easy to follow JavaScript file. That's why htmlArea can be used with almost any programming language (ASP, PHP, Perl, Java, etc), and that the toolbar is streamlined, customizable by developers, and follows the conventions of common word processing programs.

- Lightweight
  htmlArea needs to be fast loading, allow the user to perform word processing functions at a reasonable speed, and not put a lot of strain on a user's browser. To these ends we've managed to keep the main editor program in a single file of only 40k and we've written the editor in such a way that it has a minimal impact on the resources of the browser it is running in. In addition, where we make use of popup windows to perform additional functions we try to put as much code as possible in the popup window so it doesn't increase the size of the base editor.

This editor is pretty neat, so how does it actually work?
  htmlArea is based on the MSHTML Editing Platform in Internet Explorer 5.5+ on windows. Basically, Internet Explorer includes some functionality to make sections of a webpage edittable by defining a "contentEditable" attribute or "designMode" property. It also provides some built in commands for performing common web editting operations (bold, italic, center, insert image, etc).

  htmlArea builds on the features provided by Internet Explorer and adds its own user definable toolbar, an easy method to include a WYSIWYG editor in a web page (replacing textareas), an easy way to save user changes, as well as a number of custom web editting commands of its own.

  How htmlArea actually works is it replaces a textarea with an (user definable) toolbar, an iframe that has the "contentEditable" attribute set to true, and a hidden field with the same name as your original textarea that gets updated automatically when you modify content in the editor.

  The user can enter or modify text as well as use keyboard shortcuts and toolbar buttons to perform operations on the content. A lot of the editor commands are built into IE and called via the execCommand method, but htmlArea also includes other custom commands and functions written in JavaScript and stored in the editor.js file or the popup windows (in the /popups/ folder).

You don't happen to have one of these for (Netscape, Mozilla, Opera, Mac IE, etc) do you?
  No. None of these other browsers (including IE for Mac) support "contentEditable" or a way to make existing content in the page editable. It might be possible to emulate this in JavaScript, but it would be a lot of work. Other problems include displaying or emulating the flashing | bar cursor you see when editting. The cross-platform Mozilla browser has some bug entries related to adding contentEditable functionality, and perhaps in the future it may be possible to create something for that browser.

  Although it's a longshot, you might want to send a friendly letter to Microsoft to encourage them to make the "contentEditable" functionality work on IE for the Macintosh. Once they implement it, we can offer it.

Why doesn't htmlArea output XHTML instead of regular HTML? Can you make it do that?
  The HTML output by htmlArea is generated by the built in functionality of Internet Explorer. For that reason, there is no easy way to have it output XHTML. If we were going to do it, the way to do so would be to parse the HTML after it's output by IE and convert it to XHTML. That's something we hope to do at some point.

I'd like to be able to upload images from my hard drive, can you add that feature?
  No. We want htmlArea to be compatable with as many programming languages as possible. Because it's written in client side JavaScript, it should work with any programming language. If we start adding language specific features htmlArea won't be as useful to as many people. That said, there's a lot of free "file upload" scripts available, and htmlArea does include a function called editor_insertHTML()\ for inserting text or HTML tags. If you want to write your own program for doing this it should be that hard. Alternatively, you might check in the forum to see if someone already has.

I'd like to be insert & modify tables, can you add that feature?
  It's definately something that can be done, and something we'd really like to add. We hope to do so sometime in the neat future. Sign up to our newsletter and watch the forum for futher developments.

I'd like to <insert idea here>, can you add that feature?
  Maybe, maybe not. If it's a good feature and it fits in with the goals of our project we'll likely consider it. The best thing to do is post your suggestions to the forum. At the very least we'll try to give you some suggestions and point you in the right direction. At best you might find somebody else has already implemented the feature you were hoping for.

Can I change the toolbar/button colors?
  Yes, just search for "buttonface" and "buttonhighlight" in editor.js and change those to whatever colors you like. If you haven't heard of those colors before, it's because they're special windows colors that match whatever color scheme the user has selected for their desktop. For example, if someone has changed their desktop color scheme to "lilac", the WYSIWYG editor toolbar and buttons will match that theme. Try it, it's really neat.

I love htmlArea, is there anything I can do to help the project?
  The number one thing you can do to help is also the easiest thing to do; give us a link on your website. The more people who can find out about htmlArea the better it will be.

  The next best thing you can do is participate in our forum and post a message or two to help other htmlArea users (or learn something new yourself).

  Lastly, any code improvements you want to share would certianly be welcome as well.

Known Bugs and Issues back to top

Undo/Redo doesn't work
  We update a hidden field everytime you make a change in the editor so the hidden field will be submitted when you submit the form. The way undo/redo works in Internet Explorer it seems to reset the undo buffer everytime you use JavaScript to set the value of a form element or otherwise make changes to the page. Because of this the built in undo/redo functionality of the browser doesn't work. We hope to implement our own undo/redo functionality at a future point.

Relative paths are converted to absolute paths
  Internet Explorer has a tendency to convert relative paths into absolute paths. We've seen some implentations of WYSIWYG editors that maintain relative paths "better" than others but certain operations (such as dragging and dropping, etc) still convert relative paths to absolute paths. We hope to find a workaround for this in a future version.

HTML header info (eg: <head>, <body>, etc) doesn't get preserved
  This is due to Internet Explorer and the way the editor works. The editor already has a HTML header of its own so inserting another one confuses the browser and the content gets thrown away. The best solution is to have another plain text textarea field for HTML header information.

Some tags (eg: noframes, noscript, etc) doesn't get preserved
  This is a result of how Internet Explorer works. It seems to discard certain tags that it doesn't need to display. Because htmlArea reads the content back from the browser it cannot preserve content the browser has "thrown away".

htmlArea doesn't work with multiple textareas that have the same name
  If you have two or more textareas with the same name on the same page and you try to convert one of more of them into a WYSIWYG editor htmlArea won't work. This is because htmlArea looks up the textareas by name in the entire page, not just inside a specific form. There's currently no workaround for this. We hope to resolve it in a future release.

Change Log back to top

Version 2.00 (beta2) (Released: October 16, 2002)

New Docs
- created new readme.html with install instructions, faq, and lots of information

  New Features
- added support for stylesheets
- get enlarge/shrink window working
- get context menu working (still disabled by default, needs more code for functionality)
- allow user to change ANY option in internal config from calling page
- added _editor_filterOutput function that's called on form submit
- added insert table button

  Bug Fixes / Optimizations
- organized associated files into directories
- fixed bug that caused htmlarea to sometimes not display last entered content when user pressed back in their browser.
- moved about window into a seperate file to reduce size of editor

Version 2.00 (beta1) (Released: August 19, 2002)

visual changes
- added mouseover/mouseoff events and style for toolbar ui buttons
- update toolbar to take up less space and be smaller
- display point sizes beside HTML font sizes (eg: 7 (36px)
- change "about this editor" icon to an "i"
- created a help popup (content still needs to be written).
- added version number to about page.

  code changes
- added "defer" to script tag to prevent editor from being created untill page loads
- simplified header that needs to be added to pages that contain editor
- generated script include tag using _editor_url so users don't have to enter URL twice
- moved CSS for editor toolbar buttons into editor.js
- switched to using object to pass configuration arguments to editor_generate
- general code improvements, optimizations and re-organization
- added hooks for keypress events for future use

  new features
- added pulldown for CSS style classnames
- added many many more config options including:
- ability to select which toolbar elements you want displayed
- ability to specify the order of toolbar elements
- ability to specify fonts, sizes, and CSS styles for pulldowns
- ability to set default font and style used in editor window
- debug flag that lets the see the source of the wysiwyg field at all times
- add more sample code and comments showing how to add custom buttons

  bug fixes
- fixed error caused when height/width were manually specified (reported by jpeto, thanks!)
- "about this editor" window now works when in textedit mode

Version 1.05 (Released: August 28, 2002)

- - Added support for textareas with underscores ("_") in their names.

Version 1.04 (Released: August 27, 2002)

- Even more speed improvements (wysiwyg editor is now much faster on older computers).
- General code improvements and optimizations.

Version 1.03 (Released: August 26, 2002)

- Beta release only

Version 1.02 (Released: August 21, 2002)

- added editor_insertHTML() function. Developers can now easily add buttons that insert HTML or surround selected text with HTML.
- removed unneeded debug code and comments to reduce editor.js filesize (and load time).

Version 1.01 (Released: August 20, 2002)

- optimized code to improve speed (wysiwyg editor is now much faster)
- added addition event handlers to update UI on mouse events.

Version 1.00 (Released: August 19, 2002)

- Initial Release