src/cm/media/js/lib/yui/yui_3.10.3/docs/uploader/uploader-data.html
changeset 525 89ef5ed3c48b
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/src/cm/media/js/lib/yui/yui_3.10.3/docs/uploader/uploader-data.html	Tue Jul 16 14:29:46 2013 +0200
@@ -0,0 +1,488 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <title>Example: Multiple Files Uploader with POST Variables and Server Data Retrieval</title>
+    <link rel="stylesheet" href="http://fonts.googleapis.com/css?family=PT+Sans:400,700,400italic,700italic">
+    <link rel="stylesheet" href="../../build/cssgrids/cssgrids-min.css">
+    <link rel="stylesheet" href="../assets/css/main.css">
+    <link rel="stylesheet" href="../assets/vendor/prettify/prettify-min.css">
+    <link rel="shortcut icon" type="image/png" href="../assets/favicon.png">
+    <script src="../../build/yui/yui-min.js"></script>
+    
+</head>
+<body>
+<!--
+<a href="https://github.com/yui/yui3"><img style="position: absolute; top: 0; right: 0; border: 0;" src="https://s3.amazonaws.com/github/ribbons/forkme_right_darkblue_121621.png" alt="Fork me on GitHub"></a>
+-->
+<div id="doc">
+    <div id="hd">
+        <h1><img src="http://yuilibrary.com/img/yui-logo.png"></h1>
+    </div>
+    
+
+            <h1>Example: Multiple Files Uploader with POST Variables and Server Data Retrieval</h1>
+    <div class="yui3-g">
+        <div class="yui3-u-3-4">
+            <div id="main">
+                <div class="content"><div class="intro">
+<p>In this example, the Uploader is used to send multiple images or videos to the server and monitor
+   their upload progress with individual counters. If the Uploader is used in a browser with HTML5
+   support, it is progressively enhanced to enable dragging-and-dropping files into the browser window.
+   Along with each file, this example also submits an additional POST variable (the file's name).
+   Once each upload completes, the server sends the received file name POST variable back, along with a time
+   stamp, and the example displays them next to the file.</p>
+   
+<p><strong>Please note:</strong> This example will not work when run from a local filesystem because of security restrictions in the transport protocols used. If you’d like to run this example locally, set up a local web server and launch it from there.</p>
+
+<p><strong>Also note:</strong> The uploader is not supported on iOS devices (iPhone and iPad), because they lack file upload capability. This example provides a graceful degradation message for all such systems.</p>
+
+<p><strong>Also note:</strong> The backend script used in these examples does not store any information it receives. Nevertheless, do not submit any sensitive or private data and keep
+your tests to a few small files to avoid overloading the system.</p>
+</div>
+
+<div class="example yui3-skin-sam">
+    <style>
+#filelist {
+    margin-top: 15px;
+}
+
+#uploadFilesButtonContainer, #selectFilesButtonContainer, #overallProgress {
+    display: inline-block;
+}
+
+#overallProgress {
+    float: right;
+}
+
+.yellowBackground {
+  background: #F2E699;
+}
+
+.serverdata {
+  font-size: 0.8em;
+}
+</style>
+
+<div id="exampleContainer">
+<div id="uploaderContainer">
+    <div id="selectFilesButtonContainer">
+    </div>
+    <div id="uploadFilesButtonContainer">
+      <button type="button" id="uploadFilesButton"
+              class="yui3-button" style="width:250px; height:35px;">Upload Files</button>
+    </div>
+    <div id="overallProgress">
+    </div>
+</div>
+
+<div id="filelist">
+  <table id="filenames">
+    <thead>
+       <tr><th>File name</th><th>File size</th><th>Percent uploaded</th><th>Data from Server</th></tr>
+       <tr id="nofiles">
+        <td colspan="4" id="ddmessage">
+            <strong>No files selected.</strong>
+        </td>
+       </tr>
+    </thead>
+    <tbody>
+    </tbody>
+  </table>
+</div>
+</div>
+
+<script>
+
+YUI({filter:"raw"}).use("uploader", function(Y) {
+Y.one("#overallProgress").set("text", "Uploader type: " + Y.Uploader.TYPE);
+   if (Y.Uploader.TYPE != "none" && !Y.UA.ios) {
+       var uploader = new Y.Uploader({width: "250px",
+                                      height: "35px",
+                                      multipleFiles: true,
+                                      swfURL: "../../build/uploader/assets/flashuploader.swf?t=" + Math.random(),
+                                      uploadURL: "http://yuilibrary.com/sandbox/upload/",
+                                      simLimit: 2,
+                                      withCredentials: false
+                                     });
+       var uploadDone = false;
+
+       if (Y.Uploader.TYPE == "html5") {
+          uploader.set("dragAndDropArea", "body");
+
+          Y.one("#ddmessage").setHTML("<strong>Drag and drop files here.</strong>");
+
+          uploader.on(["dragenter", "dragover"], function (event) {
+              var ddmessage = Y.one("#ddmessage");
+              if (ddmessage) {
+                ddmessage.setHTML("<strong>Files detected, drop them here!</strong>");
+                ddmessage.addClass("yellowBackground");
+              }
+           });
+
+           uploader.on(["dragleave", "drop"], function (event) {
+              var ddmessage = Y.one("#ddmessage");
+              if (ddmessage) {
+                ddmessage.setHTML("<strong>Drag and drop files here.</strong>");
+                ddmessage.removeClass("yellowBackground");
+              }
+           });
+       }
+
+       uploader.render("#selectFilesButtonContainer");
+
+       uploader.after("fileselect", function (event) {
+
+          var fileList = event.fileList;
+          var fileTable = Y.one("#filenames tbody");
+          if (fileList.length > 0 && Y.one("#nofiles")) {
+            Y.one("#nofiles").remove();
+          }
+
+          if (uploadDone) {
+            uploadDone = false;
+            fileTable.setHTML("");
+          }
+
+          var perFileVars = {};
+
+          Y.each(fileList, function (fileInstance) {
+              fileTable.append("<tr id='" + fileInstance.get("id") + "_row" + "'>" +
+                                    "<td class='filename'>" + fileInstance.get("name") + "</td>" +
+                                    "<td class='filesize'>" + fileInstance.get("size") + "</td>" +
+                                    "<td class='percentdone'>Hasn't started yet</td>" +
+                                    "<td class='serverdata'>&nbsp;</td>");
+
+              perFileVars[fileInstance.get("id")] = {filename: fileInstance.get("name")};
+                             });
+
+              uploader.set("postVarsPerFile", Y.merge(uploader.get("postVarsPerFile"), perFileVars));
+       });
+
+       uploader.on("uploadprogress", function (event) {
+            var fileRow = Y.one("#" + event.file.get("id") + "_row");
+                fileRow.one(".percentdone").set("text", event.percentLoaded + "%");
+       });
+
+       uploader.on("uploadstart", function (event) {
+            uploader.set("enabled", false);
+            Y.one("#uploadFilesButton").addClass("yui3-button-disabled");
+            Y.one("#uploadFilesButton").detach("click");
+       });
+
+       uploader.on("uploadcomplete", function (event) {
+            var fileRow = Y.one("#" + event.file.get("id") + "_row");
+                fileRow.one(".percentdone").set("text", "Finished!");
+                fileRow.one(".serverdata").setHTML(event.data);
+       });
+
+       uploader.on("totaluploadprogress", function (event) {
+                Y.one("#overallProgress").setHTML("Total uploaded: <strong>" + event.percentLoaded + "%" + "</strong>");
+       });
+
+       uploader.on("alluploadscomplete", function (event) {
+                     uploader.set("enabled", true);
+                     uploader.set("fileList", []);
+                     Y.one("#uploadFilesButton").removeClass("yui3-button-disabled");
+                     Y.one("#uploadFilesButton").on("click", function () {
+                          if (!uploadDone && uploader.get("fileList").length > 0) {
+                             uploader.uploadAll();
+                          }
+                     });
+                     Y.one("#overallProgress").set("text", "Uploads complete!");
+                     uploadDone = true;
+       });
+
+       Y.one("#uploadFilesButton").on("click", function () {
+         if (!uploadDone && uploader.get("fileList").length > 0) {
+            uploader.uploadAll();
+         }
+       });
+   }
+   else {
+       Y.one("#uploaderContainer").set("text", "We are sorry, but to use the uploader, you either need a browser that support HTML5 or have the Flash player installed on your computer.");
+   }
+
+
+});
+
+</script>
+
+</div>
+
+<h2>Sending and Retrieving Data from the Server</h2>
+<p>This example is based on the <a href="uploader-dd.html">Uploader with HTML5 Drag-and-Drop Support</a>, but adds custom POST variables along with each file upload,
+   and retrieves and displays data received from the server in response to each file upload.</p>
+
+<p>To send additional POST variables along with files, we populate the <code>postVarsPerFile</code> attribute when files are selected:
+
+<pre class="code prettyprint">uploader.after(&quot;fileselect&quot;, function (event) {
+
+   ...
+            
+   var perFileVars = {};
+   
+   Y.each(fileList, function (fileInstance) {
+       fileTable.append(&quot;&lt;tr id=&#x27;&quot; + fileInstance.get(&quot;id&quot;) + &quot;_row&quot; + &quot;&#x27;&gt;&quot; + 
+                             &quot;&lt;td class=&#x27;filename&#x27;&gt;&quot; + fileInstance.get(&quot;name&quot;) + &quot;&lt;&#x2F;td&gt;&quot; + 
+                             &quot;&lt;td class=&#x27;filesize&#x27;&gt;&quot; + fileInstance.get(&quot;size&quot;) + &quot;&lt;&#x2F;td&gt;&quot; + 
+                             &quot;&lt;td class=&#x27;percentdone&#x27;&gt;Hasn&#x27;t started yet&lt;&#x2F;td&gt;&quot; +
+                             &quot;&lt;td class=&#x27;serverdata&#x27;&gt;&amp;nbsp;&lt;&#x2F;td&gt;&quot;); 
+  
+       perFileVars[fileInstance.get(&quot;id&quot;)] = {filename: fileInstance.get(&quot;name&quot;)};
+   });
+   
+   uploader.set(&quot;postVarsPerFile&quot;, Y.merge(uploader.get(&quot;postVarsPerFile&quot;), perFileVars));
+});</pre>
+
+
+<p>When uploads complete, we can retrieve and display the data received from the server (in this case, the <code>filename</code> POST variable that we transmitted,
+   along with the server timestamp):
+
+<pre class="code prettyprint">uploader.on(&quot;uploadcomplete&quot;, function (event) {
+
+    ...
+
+    fileRow.one(&quot;.serverdata&quot;).setHTML(event.data);
+});</pre>
+
+
+<h2>Full Source Code For this Example</h2>
+
+<pre class="code prettyprint">&lt;style&gt;
+#filelist {
+    margin-top: 15px;
+}
+
+#uploadFilesButtonContainer, #selectFilesButtonContainer, #overallProgress {
+    display: inline-block;
+}
+
+#overallProgress {
+    float: right;
+}
+
+.yellowBackground {
+  background: #F2E699;
+}
+
+.serverdata {
+  font-size: 0.8em;
+}
+&lt;&#x2F;style&gt;
+
+&lt;div id=&quot;exampleContainer&quot;&gt;
+&lt;div id=&quot;uploaderContainer&quot;&gt;
+    &lt;div id=&quot;selectFilesButtonContainer&quot;&gt;
+    &lt;&#x2F;div&gt;
+    &lt;div id=&quot;uploadFilesButtonContainer&quot;&gt;
+      &lt;button type=&quot;button&quot; id=&quot;uploadFilesButton&quot;
+              class=&quot;yui3-button&quot; style=&quot;width:250px; height:35px;&quot;&gt;Upload Files&lt;&#x2F;button&gt;
+    &lt;&#x2F;div&gt;
+    &lt;div id=&quot;overallProgress&quot;&gt;
+    &lt;&#x2F;div&gt;
+&lt;&#x2F;div&gt;
+
+&lt;div id=&quot;filelist&quot;&gt;
+  &lt;table id=&quot;filenames&quot;&gt;
+    &lt;thead&gt;
+       &lt;tr&gt;&lt;th&gt;File name&lt;&#x2F;th&gt;&lt;th&gt;File size&lt;&#x2F;th&gt;&lt;th&gt;Percent uploaded&lt;&#x2F;th&gt;&lt;th&gt;Data from Server&lt;&#x2F;th&gt;&lt;&#x2F;tr&gt;
+       &lt;tr id=&quot;nofiles&quot;&gt;
+        &lt;td colspan=&quot;4&quot; id=&quot;ddmessage&quot;&gt;
+            &lt;strong&gt;No files selected.&lt;&#x2F;strong&gt;
+        &lt;&#x2F;td&gt;
+       &lt;&#x2F;tr&gt;
+    &lt;&#x2F;thead&gt;
+    &lt;tbody&gt;
+    &lt;&#x2F;tbody&gt;
+  &lt;&#x2F;table&gt;
+&lt;&#x2F;div&gt;
+&lt;&#x2F;div&gt;
+
+&lt;script&gt;
+
+YUI({filter:&quot;raw&quot;}).use(&quot;uploader&quot;, function(Y) {
+Y.one(&quot;#overallProgress&quot;).set(&quot;text&quot;, &quot;Uploader type: &quot; + Y.Uploader.TYPE);
+   if (Y.Uploader.TYPE != &quot;none&quot; &amp;&amp; !Y.UA.ios) {
+       var uploader = new Y.Uploader({width: &quot;250px&quot;,
+                                      height: &quot;35px&quot;,
+                                      multipleFiles: true,
+                                      swfURL: &quot;..&#x2F;..&#x2F;build&#x2F;uploader&#x2F;assets&#x2F;flashuploader.swf?t=&quot; + Math.random(),
+                                      uploadURL: &quot;http:&#x2F;&#x2F;yuilibrary.com&#x2F;sandbox&#x2F;upload&#x2F;&quot;,
+                                      simLimit: 2,
+                                      withCredentials: false
+                                     });
+       var uploadDone = false;
+
+       if (Y.Uploader.TYPE == &quot;html5&quot;) {
+          uploader.set(&quot;dragAndDropArea&quot;, &quot;body&quot;);
+
+          Y.one(&quot;#ddmessage&quot;).setHTML(&quot;&lt;strong&gt;Drag and drop files here.&lt;&#x2F;strong&gt;&quot;);
+
+          uploader.on([&quot;dragenter&quot;, &quot;dragover&quot;], function (event) {
+              var ddmessage = Y.one(&quot;#ddmessage&quot;);
+              if (ddmessage) {
+                ddmessage.setHTML(&quot;&lt;strong&gt;Files detected, drop them here!&lt;&#x2F;strong&gt;&quot;);
+                ddmessage.addClass(&quot;yellowBackground&quot;);
+              }
+           });
+
+           uploader.on([&quot;dragleave&quot;, &quot;drop&quot;], function (event) {
+              var ddmessage = Y.one(&quot;#ddmessage&quot;);
+              if (ddmessage) {
+                ddmessage.setHTML(&quot;&lt;strong&gt;Drag and drop files here.&lt;&#x2F;strong&gt;&quot;);
+                ddmessage.removeClass(&quot;yellowBackground&quot;);
+              }
+           });
+       }
+
+       uploader.render(&quot;#selectFilesButtonContainer&quot;);
+
+       uploader.after(&quot;fileselect&quot;, function (event) {
+
+          var fileList = event.fileList;
+          var fileTable = Y.one(&quot;#filenames tbody&quot;);
+          if (fileList.length &gt; 0 &amp;&amp; Y.one(&quot;#nofiles&quot;)) {
+            Y.one(&quot;#nofiles&quot;).remove();
+          }
+
+          if (uploadDone) {
+            uploadDone = false;
+            fileTable.setHTML(&quot;&quot;);
+          }
+
+          var perFileVars = {};
+
+          Y.each(fileList, function (fileInstance) {
+              fileTable.append(&quot;&lt;tr id=&#x27;&quot; + fileInstance.get(&quot;id&quot;) + &quot;_row&quot; + &quot;&#x27;&gt;&quot; +
+                                    &quot;&lt;td class=&#x27;filename&#x27;&gt;&quot; + fileInstance.get(&quot;name&quot;) + &quot;&lt;&#x2F;td&gt;&quot; +
+                                    &quot;&lt;td class=&#x27;filesize&#x27;&gt;&quot; + fileInstance.get(&quot;size&quot;) + &quot;&lt;&#x2F;td&gt;&quot; +
+                                    &quot;&lt;td class=&#x27;percentdone&#x27;&gt;Hasn&#x27;t started yet&lt;&#x2F;td&gt;&quot; +
+                                    &quot;&lt;td class=&#x27;serverdata&#x27;&gt;&amp;nbsp;&lt;&#x2F;td&gt;&quot;);
+
+              perFileVars[fileInstance.get(&quot;id&quot;)] = {filename: fileInstance.get(&quot;name&quot;)};
+                             });
+
+              uploader.set(&quot;postVarsPerFile&quot;, Y.merge(uploader.get(&quot;postVarsPerFile&quot;), perFileVars));
+       });
+
+       uploader.on(&quot;uploadprogress&quot;, function (event) {
+            var fileRow = Y.one(&quot;#&quot; + event.file.get(&quot;id&quot;) + &quot;_row&quot;);
+                fileRow.one(&quot;.percentdone&quot;).set(&quot;text&quot;, event.percentLoaded + &quot;%&quot;);
+       });
+
+       uploader.on(&quot;uploadstart&quot;, function (event) {
+            uploader.set(&quot;enabled&quot;, false);
+            Y.one(&quot;#uploadFilesButton&quot;).addClass(&quot;yui3-button-disabled&quot;);
+            Y.one(&quot;#uploadFilesButton&quot;).detach(&quot;click&quot;);
+       });
+
+       uploader.on(&quot;uploadcomplete&quot;, function (event) {
+            var fileRow = Y.one(&quot;#&quot; + event.file.get(&quot;id&quot;) + &quot;_row&quot;);
+                fileRow.one(&quot;.percentdone&quot;).set(&quot;text&quot;, &quot;Finished!&quot;);
+                fileRow.one(&quot;.serverdata&quot;).setHTML(event.data);
+       });
+
+       uploader.on(&quot;totaluploadprogress&quot;, function (event) {
+                Y.one(&quot;#overallProgress&quot;).setHTML(&quot;Total uploaded: &lt;strong&gt;&quot; + event.percentLoaded + &quot;%&quot; + &quot;&lt;&#x2F;strong&gt;&quot;);
+       });
+
+       uploader.on(&quot;alluploadscomplete&quot;, function (event) {
+                     uploader.set(&quot;enabled&quot;, true);
+                     uploader.set(&quot;fileList&quot;, []);
+                     Y.one(&quot;#uploadFilesButton&quot;).removeClass(&quot;yui3-button-disabled&quot;);
+                     Y.one(&quot;#uploadFilesButton&quot;).on(&quot;click&quot;, function () {
+                          if (!uploadDone &amp;&amp; uploader.get(&quot;fileList&quot;).length &gt; 0) {
+                             uploader.uploadAll();
+                          }
+                     });
+                     Y.one(&quot;#overallProgress&quot;).set(&quot;text&quot;, &quot;Uploads complete!&quot;);
+                     uploadDone = true;
+       });
+
+       Y.one(&quot;#uploadFilesButton&quot;).on(&quot;click&quot;, function () {
+         if (!uploadDone &amp;&amp; uploader.get(&quot;fileList&quot;).length &gt; 0) {
+            uploader.uploadAll();
+         }
+       });
+   }
+   else {
+       Y.one(&quot;#uploaderContainer&quot;).set(&quot;text&quot;, &quot;We are sorry, but to use the uploader, you either need a browser that support HTML5 or have the Flash player installed on your computer.&quot;);
+   }
+
+
+});
+
+&lt;&#x2F;script&gt;</pre>
+
+
+</div>
+            </div>
+        </div>
+
+        <div class="yui3-u-1-4">
+            <div class="sidebar">
+                
+
+                
+                    <div class="sidebox">
+                        <div class="hd">
+                            <h2 class="no-toc">Examples</h2>
+                        </div>
+
+                        <div class="bd">
+                            <ul class="examples">
+                                
+                                    
+                                        <li data-description="A simple multiple file uploader with progress tracking">
+                                            <a href="uploader-multiple.html">Simple Multiple Files Uploader with Progress Tracking</a>
+                                        </li>
+                                    
+                                
+                                    
+                                        <li data-description="A multiple file uploader with HTML5 Drag-and-Drop Support">
+                                            <a href="uploader-dd.html">Multiple Files Uploader with HTML5 Drag-and-Drop Support</a>
+                                        </li>
+                                    
+                                
+                                    
+                                        <li data-description="A multiple file uploader that submits additional POST vars with each file and receives data from the server">
+                                            <a href="uploader-data.html">Multiple Files Uploader with POST Variables and Server Data Retrieval</a>
+                                        </li>
+                                    
+                                
+                            </ul>
+                        </div>
+                    </div>
+                
+
+                
+            </div>
+        </div>
+    </div>
+</div>
+
+<script src="../assets/vendor/prettify/prettify-min.js"></script>
+<script>prettyPrint();</script>
+
+<script>
+YUI.Env.Tests = {
+    examples: [],
+    project: '../assets',
+    assets: '../assets/uploader',
+    name: 'uploader-data',
+    title: 'Multiple Files Uploader with POST Variables and Server Data Retrieval',
+    newWindow: '',
+    auto:  false 
+};
+YUI.Env.Tests.examples.push('uploader-multiple');
+YUI.Env.Tests.examples.push('uploader-dd');
+YUI.Env.Tests.examples.push('uploader-data');
+
+</script>
+<script src="../assets/yui/test-runner.js"></script>
+
+
+
+</body>
+</html>