Ticket #1617: 1617.patch

_whatsnew.html

@@ -37 +37 @@
         <p>
                 New Features and Improvements:</p>
         <ul>
-                <li></li>
+                <li>JavaScript integration file:
+                        <ul>
+                                <li>The new "<strong>FCKeditor.ReplaceAllTextareas</strong>" function is being introduced,
+                                        making it possible to replace many (or unknown) &lt;textarea&gt; elements in a single
+                                        call. The replacement can be also filtered by CSS class name, or by a custom function
+                                        evaluator.</li>
+                                <li>It is now possible to set the default BasePath for all editor instances by setting
+                                        <strong>FCKeditor.BasePath</strong>. This is extremely useful when working with
+                                        the ReplaceAllTextareas function.</li>
+                        </ul>
+                </li>
         </ul>
         <p>
                 Fixed Bugs:</p>

fckeditor.js

@@ -34 +34 @@
         this.Height                     = height                || '200' ;
         this.ToolbarSet         = toolbarSet    || 'Default' ;
         this.Value                      = value                 || '' ;
-        this.BasePath           = '/fckeditor/' ;
+        this.BasePath           = FCKeditor.BasePath ;
         this.CheckBrowser       = true ;
         this.DisplayErrors      = true ;
 
@@ -44 +44 @@
         this.OnError            = null ;        // function( source, errorNumber, errorDescription )
 }
 
+/**
+ * This is the default BasePath used by all editor instances.
+ */
+FCKeditor.BasePath = '/fckeditor/' ;
+
 FCKeditor.prototype.Version                     = '[Development]' ;
 FCKeditor.prototype.VersionBuild        = '[DEV]' ;
 
@@ -185 +190 @@
         return text ;
 }
 
+/**
+ * Replace all <textarea> elements available in the document with FCKeditor
+ * instances.
+ *
+ *      // Replace all <textarea> elements in the page.
+ *      FCKeditor.ReplaceAllTextareas() ;
+ *
+ *      // Replace all <textarea class="myClassName"> elements in the page.
+ *      FCKeditor.ReplaceAllTextareas( 'myClassName' ) ;
+ *
+ *      // Selectively replace <textarea> elements, based on custom assertions.
+ *      FCKeditor.ReplaceAllTextareas( function( textarea, editor )
+ *              {
+ *                      // Custom code to evaluate the replace, returning false if it
+ *                      // must not be done.
+ *                      // It also passes the "editor" parameter, so the developer can
+ *                      // customize the instance.
+ *              } ) ;
+ */
+FCKeditor.ReplaceAllTextareas = function()
+{
+        var textareas = document.getElementsByTagName( 'textarea' ) ;
+
+        for ( var i = 0 ; i < textareas.length ; i++ )
+        {
+                var editor = null ;
+                var textarea = textareas[i] ;
+                var name = textarea.name ;
+
+                // The "name" attribute must exist.
+                if ( !name || name.length == 0 )
+                        continue ;
+
+                if ( typeof arguments[0] == 'string' )
+                {
+                        // The textarea class name could be passed as the function
+                        // parameter.
+
+                        var classRegex = new RegExp( '(?:^| )' + arguments[0] + '(?:$| )' ) ;
+
+                        if ( !classRegex.test( textarea.className ) )
+                                continue ;
+                }
+                else if ( typeof arguments[0] == 'function' )
+                {
+                        // An assertion function could be passed as the function parameter.
+                        // It must explicitly return "false" to ignore a specific <textarea>.
+                        editor = new FCKeditor( name ) ;
+                        if ( arguments[0]( textarea, editor ) === false )
+                                continue ;
+                }
+
+                if ( !editor )
+                        editor = new FCKeditor( name ) ;
+
+                editor.ReplaceTextarea() ;
+        }
+}
+
 function FCKeditor_IsCompatibleBrowser()
 {
         var sAgent = navigator.userAgent.toLowerCase() ;