X-Git-Url: http://git.ithinksw.org/extjs.git/blobdiff_plain/7a654f8d43fdb43d78b63d90528bed6e86b608cc..3789b528d8dd8aad4558e38e22d775bcab1cbd36:/docs/source/DomHelper.html diff --git a/docs/source/DomHelper.html b/docs/source/DomHelper.html index 78ba52c6..212b9913 100644 --- a/docs/source/DomHelper.html +++ b/docs/source/DomHelper.html @@ -1,4 +1,21 @@ -Sencha Documentation Project
/**
+
+
+
+  
+  The source code
+  
+  
+  
+  
+
+
+  
/**
  * @class Ext.core.DomHelper
  * <p>The DomHelper class provides a layer of abstraction from DOM and transparently supports creating
  * elements via DOM or using HTML fragments. It also has the ability to create HTML fragment templates
@@ -17,6 +34,11 @@
  * for a DOM node, depending on whether DomHelper is using fragments or DOM.</div></li>
  * <li><b><tt>html</tt></b> : <div class="sub-desc">The innerHTML for the element</div></li>
  * </ul></div></p>
+ * <p><b>NOTE:</b> For other arbitrary attributes, the value will currently <b>not</b> be automatically
+ * HTML-escaped prior to building the element's HTML string. This means that if your attribute value
+ * contains special characters that would not normally be allowed in a double-quoted attribute value,
+ * you <b>must</b> manually HTML-encode it beforehand (see {@link Ext.String#htmlEncode}) or risk
+ * malformed HTML being created. This behavior may change in a future release.</p>
  *
  * <p><b><u>Insertion methods</u></b></p>
  * <p>Commonly used insertion methods:
@@ -281,7 +303,7 @@ Ext.core.DomHelper = function(){
         return el;
     }
 
-    /**
+    /**
      * @ignore
      * Nasty code for IE's broken table implementation
      */
@@ -315,7 +337,7 @@ Ext.core.DomHelper = function(){
         return node;
     }
     
-    /**
+    /**
      * @ignore
      * Fix for IE9 createContextualFragment missing method
      */   
@@ -337,7 +359,7 @@ Ext.core.DomHelper = function(){
     }
     
     pub = {
-        /**
+        /**
          * Returns the markup for the passed Element(s) config.
          * @param {Object} o The DOM object spec (and children)
          * @return {String}
@@ -346,7 +368,7 @@ Ext.core.DomHelper = function(){
             return createHtml(o);
         },
 
-        /**
+        /**
          * Applies a style specification to an element.
          * @param {String/HTMLElement} el The element to apply styles to
          * @param {String/Object/Function} styles A style specification string e.g. 'width:100px', or object in the form {width:'100px'}, or
@@ -367,7 +389,7 @@ Ext.core.DomHelper = function(){
             }
         },
 
-        /**
+        /**
          * Inserts an HTML fragment into the DOM.
          * @param {String} where Where to insert the html in relation to el - beforeBegin, afterBegin, beforeEnd, afterEnd.
          * @param {HTMLElement/TextNode} el The context element
@@ -451,7 +473,7 @@ Ext.core.DomHelper = function(){
             //</debug>
         },
 
-        /**
+        /**
          * Creates new DOM element(s) and inserts them before el.
          * @param {Mixed} el The context element
          * @param {Object/String} o The DOM object spec (and children) or raw HTML blob
@@ -462,7 +484,7 @@ Ext.core.DomHelper = function(){
             return doInsert(el, o, returnElement, beforebegin);
         },
 
-        /**
+        /**
          * Creates new DOM element(s) and inserts them after el.
          * @param {Mixed} el The context element
          * @param {Object} o The DOM object spec (and children)
@@ -473,7 +495,7 @@ Ext.core.DomHelper = function(){
             return doInsert(el, o, returnElement, afterend, 'nextSibling');
         },
 
-        /**
+        /**
          * Creates new DOM element(s) and inserts them as the first child of el.
          * @param {Mixed} el The context element
          * @param {Object/String} o The DOM object spec (and children) or raw HTML blob
@@ -484,7 +506,7 @@ Ext.core.DomHelper = function(){
             return doInsert(el, o, returnElement, afterbegin, 'firstChild');
         },
 
-        /**
+        /**
          * Creates new DOM element(s) and appends them to el.
          * @param {Mixed} el The context element
          * @param {Object/String} o The DOM object spec (and children) or raw HTML blob
@@ -495,7 +517,7 @@ Ext.core.DomHelper = function(){
             return doInsert(el, o, returnElement, beforeend, '', true);
         },
 
-        /**
+        /**
          * Creates new DOM element(s) and overwrites the contents of el with them.
          * @param {Mixed} el The context element
          * @param {Object/String} o The DOM object spec (and children) or raw HTML blob
@@ -510,17 +532,18 @@ Ext.core.DomHelper = function(){
 
         createHtml : createHtml,
         
-        /**
+        /**
          * Creates new DOM element(s) without inserting them to the document.
          * @param {Object/String} o The DOM object spec (and children) or raw HTML blob
          * @return {HTMLElement} The new uninserted node
+         * @method
          */
         createDom: createDom,
         
-        /** True to force the use of DOM instead of html fragments @type Boolean */
+        /** True to force the use of DOM instead of html fragments @type Boolean */
         useDom : false,
         
-        /**
+        /**
          * Creates a new Ext.Template from the DOM object spec.
          * @param {Object} o The DOM object spec (and children)
          * @return {Ext.Template} The new template
@@ -532,4 +555,6 @@ Ext.core.DomHelper = function(){
     };
     return pub;
 }();
-

\ No newline at end of file
+
+ +