Upgrade to ExtJS 3.3.0 - Released 10/06/2010

[extjs.git] / examples / docs / source / FieldReplicator.html
diff --git a/examples/docs/source/FieldReplicator.html b/examples/docs/source/FieldReplicator.html

new file mode 100644 (file)

index 0000000..7003e58
--- /dev/null
+++ b/examples/docs/source/FieldReplicator.html
@@ -0,0 +1,94 @@
+<html>
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />    
+  <title>The source code</title>
+    <link href="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />
+    <script type="text/javascript" src="../resources/prettify/prettify.js"></script>
+</head>
+<body  onload="prettyPrint();">
+    <pre class="prettyprint lang-js">/*!
+ * Ext JS Library 3.3.0
+ * Copyright(c) 2006-2010 Ext JS, Inc.
+ * licensing@extjs.com
+ * http://www.extjs.com/license
+ */
+Ext.ns("Ext.ux");
+
+<div id="cls-Ext.ux.FieldReplicator"></div>/**
+ * @class Ext.ux.FieldReplicator
+ * <p>A plugin for Field Components which creates clones of the Field for as
+ * long as the user keeps filling them. Leaving the final one blank ends the repeating series.</p>
+ * <p>Usage:</p>
+ * <pre><code>
+    {
+        xtype: 'combo',
+        plugins: [ Ext.ux.FieldReplicator ],
+        triggerAction: 'all',
+        fieldLabel: 'Select recipient',
+        store: recipientStore
+    }
+ * </code></pre>
+ */
+Ext.ux.FieldReplicator = {
+    init: function(f) {
+        f.replicator = this;
+        f.enableKeyEvents = true;
+        f.on('change', this.onChange, this);
+        f.onKeyDown = f.onKeyDown.createInterceptor(this.onKeyDown);
+    },
+
+//  If tabbing out and the change event will be fired, flag that
+//  the change handler must focus the correct sibling Field.
+    onKeyDown: function(e) {
+        if ((e.getKey() == Ext.EventObject.TAB) && (String(this.startValue) !== String(this.getValue()))) {
+            if (e.shiftKey) {
+                this.focusPrev = true;
+            } else if (!e.shiftKey && !e.altKey) {
+                this.focusNext = true;
+            }
+        }
+    },
+
+//  Handle the field either being changed to blank or from blank.
+    onChange: function(f, n, o) {
+
+//             Ensure that "change" is only fired once.
+       f.startValue = n;
+
+        var c = f.ownerCt, l,
+            ps = f.previousSibling(),
+            ns = f.nextSibling();
+        if (Ext.isEmpty(n)) {
+            if (!Ext.isEmpty(o)) {
+//              The Field has been blanked, and it is not the only one left, remove it
+                if ((ps && (ps.replicator === this)) || (ns && (ns.replicator === this))) {
+                    l = f.findParentBy(function(p) {
+                        return !Ext.isDefined(p.ownerCt);
+                    });
+                    c.remove(f);
+                    l.doLayout();
+                }
+            }
+        } else {
+            if (Ext.isEmpty(o)) {
+//              Field filled, insert a clone as the next sibling
+                ns = new f.constructor(f.cloneConfig());
+                c.insert(c.items.indexOf(f) + 1, ns);
+                c.doLayout();
+                l = f.findParentBy(function(p) {
+                    return !Ext.isDefined(p.ownerCt);
+                });
+                l.doLayout();
+            }
+        }
+        if (f.focusPrev) {
+            delete f.focusPrev;
+            ps.focus(false, true);
+        } else  if (f.focusNext) {
+            delete f.focusNext;
+            ns.focus(false, true);
+        }
+    }
+};</pre>    
+</body>
+</html>
+\ No newline at end of file