Ticket #1617: 1617_2.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/' ;
+
+/**
+ * The minimum height used when replacing textareas.
+ */
+FCKeditor.MinHeight = 200 ;
+
+/**
+ * The minimum width used when replacing textareas.
+ */
+FCKeditor.MinWidth = 750 ;
+
 FCKeditor.prototype.Version                     = '[Development]' ;
 FCKeditor.prototype.VersionBuild        = '[DEV]' ;
 
@@ -185 +200 @@
         return text ;
 }
 
+;(function()
+{
+        var textareaToEditor = function( textarea )
+        {
+                var editor = new FCKeditor( textarea.name ) ;
+                
+                editor.Width = Math.max( textarea.offsetWidth, FCKeditor.MinWidth ) ;
+                editor.Height = Math.max( textarea.offsetHeight, FCKeditor.MinHeight ) ;
+                
+                return editor ;
+        }
+        
+        /**
+         * 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 = textareaToEditor( textarea ) ;
+                                if ( arguments[0]( textarea, editor ) === false )
+                                        continue ;
+                        }
+
+                        if ( !editor )
+                                editor = textareaToEditor( textarea ) ;
+
+                        editor.ReplaceTextarea() ;
+                }
+        }
+})() ;
+
 function FCKeditor_IsCompatibleBrowser()
 {
         var sAgent = navigator.userAgent.toLowerCase() ;