Packaged apps "Disabled Web Features" doc.

TBR=mkearney@google.com,yoz@chromium.org BUG=none TEST=none Review URL: https://chromiumcodereview.appspot.com/10677012 git-svn-id: svn://svn.chromium.org/chrome/trunk/src@144318 0039d316-1c4b-4281-b951-d872f2087c98
author: benwells@chromium.org <benwells@chromium.org@0039d316-1c4b-4281-b951-d872f2087c98> 2012-06-26 23:17:58 +0000
committer: benwells@chromium.org <benwells@chromium.org@0039d316-1c4b-4281-b951-d872f2087c98> 2012-06-26 23:17:58 +0000
commit: 7ffeb27fd61abfd55a615f4e9c83aac706bb00d5 (patch)
tree: cd1606b5132e6f3f7fa3eb4b0d1c0351d8b4e1bf /chrome
parent: 3e88497601c407eb078c5c29ded67c555b754960 (diff)
download: chromium_src-7ffeb27fd61abfd55a615f4e9c83aac706bb00d5.zip
chromium_src-7ffeb27fd61abfd55a615f4e9c83aac706bb00d5.tar.gz
chromium_src-7ffeb27fd61abfd55a615f4e9c83aac706bb00d5.tar.bz2
2 files changed, 412 insertions, 0 deletions
diff --git a/chrome/common/extensions/docs/apps/app_deprecated.html b/chrome/common/extensions/docs/apps/app_deprecated.html
new file mode 100644
index 0000000..794615f
--- /dev/null
+++ b/chrome/common/extensions/docs/apps/app_deprecated.html
@@ -0,0 +1,312 @@
+<!DOCTYPE html><!-- This page is a placeholder for generated extensions api doc. Note:
+    1) The <head> information in this page is significant, should be uniform
+       across api docs and should be edited only with knowledge of the
+       templating mechanism.
+    3) All <body>.innerHTML is genereated as an rendering step. If viewed in a
+       browser, it will be re-generated from the template, json schema and
+       authored overview content.
+    4) The <body>.innerHTML is also generated by an offline step so that this
+       page may easily be indexed by search engines.
+--><html xmlns="http://www.w3.org/1999/xhtml"><head>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+    <link href="../css/print.css" rel="stylesheet" type="text/css" media="print">
+    <script type="text/javascript" src="../../../../third_party/jstemplate/jstemplate_compiled.js">
+    </script>
+    <script type="text/javascript" src="../../../../../third_party/json_minify/minify-sans-regexp.js">
+    </script>
+    <script type="text/javascript" src="../js/api_page_generator.js"></script>
+    <script type="text/javascript" src="../js/bootstrap.js"></script>
+    <script type="text/javascript" src="../js/sidebar.js"></script>
+  <title>Disabled Web Features - Google Chrome Extensions - Google Code</title></head>
+  <body><link href="../css/ApiRefStyles_apps.css" rel="stylesheet" type="text/css">
+<link href="../css/prettify.css" rel="stylesheet" type="text/css">
+  <div id="devModeWarning" class="displayModeWarning">
+    You are viewing extension docs in chrome via the 'file:' scheme: are you expecting to see local changes when you refresh? You'll need run chrome with --allow-file-access-from-files.
+  </div>
+  <div id="branchWarning" class="displayModeWarning">
+    <span>WARNING: This is the <span id="branchName">BETA</span> documentation.
+    It may not work with the stable release of Chrome.</span>
+    <select id="branchChooser">
+      <option>Choose a different version...
+      </option><option value="">Stable
+      </option><option value="beta">Beta
+      </option><option value="dev">Dev
+      </option><option value="trunk">Trunk
+    </option></select>
+  </div>
+  <div id="unofficialWarning" class="displayModeWarning">
+    <span>WARNING: This is unofficial documentation. It may not work with the
+    current release of Chrome.</span>
+    <button id="goToOfficialDocs">Go to the official docs</button>
+  </div>
+  <div id="gc-container" class="labs">
+      <!-- SUBTEMPLATES: DO NOT MOVE FROM THIS LOCATION -->
+      <!-- In particular, sub-templates that recurse, must be used by allowing
+           jstemplate to make a copy of the template in this section which
+           are not operated on by way of the jsskip="true" -->
+       <!-- /SUBTEMPLATES -->
+  <a id="top"></a>
+    <div id="skipto">
+      <a href="#gc-pagecontent">Skip to page content</a>
+      <a href="#gc-toc">Skip to main navigation</a>
+    </div>
+    <!-- API HEADER -->
+    <table id="header" width="100%" cellspacing="0" border="0">
+      <tbody><tr>
+        <td valign="middle"><a href="http://code.google.com/"><img src="../images/chrome_logo.gif" alt="Google Code" style="border:0; margin:0;"></a></td>
+        <td valign="middle" width="100%" style="padding-left:0.6em;">
+          <form action="http://www.google.com/cse" id="cse" style="margin-top:0.5em">
+            <div id="gsc-search-box">
+              <input type="hidden" name="cx" value="002967670403910741006:61_cvzfqtno">
+              <input type="hidden" name="ie" value="UTF-8">
+              <input id="gsc-search-input" type="text" name="q" value="" size="55">
+              <button class="gsc-search-button" type="submit" name="sa">
+                <img class="gsc-search-button-lens" src="../images/search.png" alt="Search">
+              </button>
+              <br>
+              <span class="greytext">e.g. "page action" or "tabs"</span>
+            </div>
+          </form>
+          <script type="text/javascript" src="https://www.google.com/jsapi"></script>
+          <script type="text/javascript">google.load("elements", "1", {packages: "transliteration"});</script>
+          <script type="text/javascript" src="https://www.google.com/coop/cse/t13n?form=cse&amp;t13n_langs=en"></script>
+          <script type="text/javascript" src="https://www.google.com/coop/cse/brand?form=cse&amp;lang=en"></script>
+        </td>
+      </tr>
+    </tbody></table>
+    <div id="codesiteContent" class="">
+      <a id="gc-topnav-anchor"></a>
+      <div id="gc-topnav">
+        <h1>Packaged Apps</h1>
+        <ul id="home" class="gc-topnav-tabs">
+          <li id="home_link">
+            <a href="app_landing.html" title="Packaged Apps home page"><span>Home</span></a>
+          </li>
+          <li id="docs_link">
+            <a href="about_apps.html" title="Official Packaged apps documentation"><span>Docs</span></a>
+          </li>
+          <li id="samples_link">
+            <a href="app_samples.html" title="Sample apps (with source code)"><span>Samples</span></a>
+          </li>
+          <li id="group_link">
+            <a href="http://groups.google.com/a/chromium.org/group/chromium-extensions" title="Google Chrome Extensions developer forum"><span>Group</span></a>
+          </li>
+          <li id="so_link">
+            <a href="http://stackoverflow.com/questions/tagged/google-chrome-extension" title="[google-chrome-extension] tag on Stack Overflow"><span>Questions?</span></a>
+          </li>
+        </ul>
+      </div> <!-- end gc-topnav -->
+    <div class="g-section g-tpl-170">
+      <!-- SIDENAV -->
+      <div class="g-unit g-first" id="gc-toc">
+        <ul>
+          <li><h2>Getting Started</h2>
+            <ul>
+              <li><a href="about_apps.html">What Are Packaged Apps?</a></li>
+              <li><a href="app_architecture.html">Understand the Architecture</a></li>
+              <li><a href="first_app.html">Create Your First App</a></li>
+            </ul>
+          </li>
+          <li><h2>Developing</h2>
+            <ul>
+              <li><a href="develop_apps.html">Before You Start</a></li>
+              <li><span>The Fundamentals</span>
+                <ul>
+                  <li><a href="app_lifecycle.html">Manage App Lifecycle</a></li>
+                  <li><a href="app_storage.html">Manage Data</a></li>
+                  <li><a href="offline_apps.html">Offline First</a></li>
+                  <li><a href="app_external.html">Embed Content</a></li>
+                </ul>
+              </li>
+              <li><span>Security &amp; Privacy</span>
+                <ul>
+                  <li><a href="app_security.html">About Security &amp; Privacy</a></li>
+                  <li><a href="app_identity.html">Identify User</a></li>
+                  <li><a href="app_permissions.html">Manage User Permissions</a></li>
+                  <li><a href="app_csp">Comply with CSP</a></li>
+                </ul>
+              </li>
+              <li><span>Advanced Technologies</span>
+                <ul>
+                  <li><a href="app_network.html">Communicate across Network</a></li>
+                  <li><a href="app_hardware.html">Access Hardware Devices</a></li>
+                  <li><a href="app_intents.html">Connect Apps with Web Intents</a></li>
+                </ul>
+              </li>
+              <li><a href="app_frameworks.html">Recommended Frameworks</a></li>
+            </ul>
+          </li>
+          <li><h2>Deploying</h2>
+            <ul>
+              <li><a href="publish_app.html">Publish</a></li>
+              <li><a href="sell_app.html">Sell</a></li>
+            </ul>
+          </li>
+          <li><h2>Reference</h2>
+            <ul>
+              <li><a href="manifest.html">Manifest Files</a></li>
+              <li><a href="api_index.html">Chrome JavaScript APIs</a></li>
+              <li><a href="experimental.html">Experimental APIs</a></li>
+              <li><a href="api_other.html">Supported Libraries</a></li>
+              <li class="leftNavSelected">Disabled Web Features</li>
+            </ul>
+          </li>
+          <li><h2><a href="app_samples.html">Samples</a></h2></li>
+        </ul>
+      </div>
+      <script>
+        initToggles();
+      </script>
+    <div class="g-unit" id="gc-pagecontent">
+      <div id="pageTitle">
+        <h1 class="page_title">Disabled Web Features</h1>
+      </div>
+        <!-- TABLE OF CONTENTS -->
+        <!-- /TABLE OF CONTENTS -->
+        <!-- Standard content lead-in for experimental API pages -->
+        <!-- STATIC CONTENT PLACEHOLDER -->
+        <div id="static"><div id="pageData-name" class="pageData">Disabled Web Features</div>
+<!-- <div id="pageData-showTOC" class="pageData">true</div> -->
+<p>
+Though packaged apps use the web platform,
+some web features have been disabled
+or else are used in a different way.
+Mainly this is to avoid security issues and
+to improve programming practices.
+Below is a summary of the disabled features
+of the web platform
+and potential work-arounds:
+</p>
+<table border="0">
+  <tbody><tr>
+    <th scope="col"> Disabled </th>
+    <th scope="col"> Work-around </th>
+  </tr>
+  <tr>
+    <td><code>alert</code></td>
+    <td>Use a custom lightbox/popup.</td>
+  </tr>
+  <tr>
+    <td>Browser chrome APIs</td>
+    <td>N/A.</td>
+  </tr>
+  <tr>
+    <td><code>confirm</code></td>
+    <td>Use a custom lightbox/popup.</td>
+  </tr>
+  <tr>
+    <td><code>document.cookie</code></td>
+    <td>Packaged app pages are not rendered on the server, so there is no need to use these.</td>
+  </tr>
+  <tr>
+    <td><code>document.close</code></td>
+    <td>N/A.</td>
+  </tr>
+  <tr>
+    <td><code>document.open</code></td>
+    <td>N/A.</td>
+  </tr>
+  <tr>
+    <td><code>document.write</code></td>
+    <td>Use document.createElement.</td>
+  </tr>
+  <tr>
+    <td>External resources</td>
+    <td>Use the <code>object</code> tag for iframes
+      See <a href="app_external.html">Embed Content</a>.
+      Video and audio are allowed to have non-local URLs.</td>
+  </tr>
+  <tr>
+    <td>Flash</td>
+    <td>Use HTML5 Platform.</td>
+  </tr>
+  <tr>
+    <td>Form submission</td>
+    <td>Use JavaScript to process form content
+      (listen for submit event, process data locally first
+      before sending to server).</td>
+  </tr>
+  <tr>
+    <td>javascript: urls</td>
+    <td>You cannot use bookmarklets for inline javascript on anchors.
+      Use the traditional click handler instead.</td>
+  </tr>
+  <tr>
+    <td>localStorage</td>
+    <td>Use IndexedDB or the Storage API (which also syncs to the cloud).</td>
+  </tr>
+  <tr>
+    <td>Navigation</td>
+    <td>Links open up with the system web browser.
+      <code>window.history</code> and <code>window.location</code>
+      are disabled.</td>
+  </tr>
+  <tr>
+    <td>Non-sandboxed plugins</td>
+    <td>N/A.</td>
+  </tr>
+  <tr>
+    <td><code>showModalDialog</code></td>
+    <td>Use a custom lightbox/popup.</td>
+  </tr>
+  <tr>
+    <td>Synchronous <code>XMLHttpRequest</code></td>
+    <td>Use async-only <code>XMLHttpRequest</code>:
+      <a href="http://updates.html5rocks.com/2012/01/Getting-Rid-of-Synchronous-XHRs">Getting Rid of Synchrounous XXRs</a>.</td>
+  </tr>
+  <tr>
+    <td>webSql</td>
+    <td>Use IndexedDB or
+      <a href="app_storage.html">Filesystem API</a>.</td>
+  </tr>
+</tbody></table>
+<p class="backtotop"><a href="#top">Back to top</a></p>
+</div>
+        <!-- API PAGE -->
+         <!-- /apiPage -->
+      </div> <!-- /gc-pagecontent -->
+    </div> <!-- /g-section -->
+  </div> <!-- /codesiteContent -->
+    <div id="gc-footer" --="">
+      <div class="text">
+  <p>
+  Except as otherwise <a href="http://code.google.com/policies.html#restrictions">noted</a>,
+  the content of this page is licensed under the <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons
+  Attribution 3.0 License</a>, and code samples are licensed under the
+  <a rel="license" href="http://code.google.com/google_bsd_license.html">BSD License</a>.
+  </p>
+  <p>
+  ©2011 Google
+  </p>
+<!-- begin analytics -->
+<script src="https://www.google-analytics.com/urchin.js" type="text/javascript"></script>
+<script src="https://www.google-analytics.com/ga.js" type="text/javascript"></script>
+<script src="../js/prettify.js" type="text/javascript"></script>
+<script>
+  // Auto syntax highlight all pre tags.
+  var pres = document.querySelectorAll('pre');
+  for (var i = 0, pre; pre = pres[i]; ++i) {
+    pre.className += ' prettyprint';
+  };
+  prettyPrint();
+</script>
+<script type="text/javascript">
+  // chrome doc tracking
+  try {
+    var engdocs = _gat._getTracker("YT-10763712-2");
+    engdocs._trackPageview();
+  } catch(err) {}
+  // code.google.com site-wide tracking
+  try {
+    _uacct="UA-18071-1";
+    _uanchor=1;
+    _uff=0;
+    urchinTracker();
+  }
+  catch(e) {/* urchinTracker not available. */}
+</script>
+<!-- end analytics -->
+      </div>
+    </div> <!-- /gc-footer -->
+  </div> <!-- /gc-container -->
+</body></html>
diff --git a/chrome/common/extensions/docs/static/app_deprecated.html b/chrome/common/extensions/docs/static/app_deprecated.html
new file mode 100644
index 0000000..14bbd50
--- /dev/null
+++ b/chrome/common/extensions/docs/static/app_deprecated.html
@@ -0,0 +1,100 @@
+<div id="pageData-name" class="pageData">Disabled Web Features</div>
+<!-- <div id="pageData-showTOC" class="pageData">true</div> -->
+
+<p>
+Though packaged apps use the web platform,
+some web features have been disabled
+or else are used in a different way.
+Mainly this is to avoid security issues and
+to improve programming practices.
+Below is a summary of the disabled features
+of the web platform
+and potential work-arounds:
+</p>
+
+<table border="0">
+  <tr>
+    <th scope="col"> Disabled </th>
+    <th scope="col"> Work-around </th>
+  </tr>
+  <tr>
+    <td><code>alert</code></td>
+    <td>Use a custom lightbox/popup.</td>
+  </tr>
+  <tr>
+    <td>Browser chrome APIs</td>
+    <td>N/A.</td>
+  </tr>
+  <tr>
+    <td><code>confirm</code></td>
+    <td>Use a custom lightbox/popup.</td>
+  </tr>
+  <tr>
+    <td><code>document.cookie</code></td>
+    <td>Packaged app pages are not rendered on the server, so there is no need to use these.</td>
+  </tr>
+  <tr>
+    <td><code>document.close</code></td>
+    <td>N/A.</td>
+  </tr>
+  <tr>
+    <td><code>document.open</code></td>
+    <td>N/A.</td>
+  </tr>
+  <tr>
+    <td><code>document.write</code></td>
+    <td>Use document.createElement.</td>
+  </tr>
+  <tr>
+    <td>External resources</td>
+    <td>Use the <code>object</code> tag for iframes
+      See <a href="app_external.html">Embed Content</a>.
+      Video and audio are allowed to have non-local URLs.</td>
+  </tr>
+  <tr>
+    <td>Flash</td>
+    <td>Use HTML5 Platform.</td>
+  </tr>
+  <tr>
+    <td>Form submission</td>
+    <td>Use JavaScript to process form content
+      (listen for submit event, process data locally first
+      before sending to server).</td>
+  </tr>
+  <tr>
+    <td>javascript: urls</td>
+    <td>You cannot use bookmarklets for inline javascript on anchors.
+      Use the traditional click handler instead.</td>
+  </tr>
+  <tr>
+    <td>localStorage</td>
+    <td>Use IndexedDB or the Storage API (which also syncs to the cloud).</td>
+  </tr>
+  <tr>
+    <td>Navigation</td>
+    <td>Links open up with the system web browser.
+      <code>window.history</code> and <code>window.location</code>
+      are disabled.</td>
+  </tr>
+  <tr>
+    <td>Non-sandboxed plugins</td>
+    <td>N/A.</td>
+  </tr>
+  <tr>
+    <td><code>showModalDialog</code></td>
+    <td>Use a custom lightbox/popup.</td>
+  </tr>
+  <tr>
+    <td>Synchronous <code>XMLHttpRequest</code></td>
+    <td>Use async-only <code>XMLHttpRequest</code>:
+      <a href="http://updates.html5rocks.com/2012/01/Getting-Rid-of-Synchronous-XHRs">Getting Rid of Synchrounous XXRs</a>.</td>
+  </tr>
+  <tr>
+    <td>webSql</td>
+    <td>Use IndexedDB or
+      <a href="app_storage.html">Filesystem API</a>.</td>
+  </tr>
+</table>
+
+<p class="backtotop"><a href="#top">Back to top</a></p>
+
author	benwells@chromium.org <benwells@chromium.org@0039d316-1c4b-4281-b951-d872f2087c98>	2012-06-26 23:17:58 +0000
committer	benwells@chromium.org <benwells@chromium.org@0039d316-1c4b-4281-b951-d872f2087c98>	2012-06-26 23:17:58 +0000
commit	7ffeb27fd61abfd55a615f4e9c83aac706bb00d5 (patch)
tree	cd1606b5132e6f3f7fa3eb4b0d1c0351d8b4e1bf /chrome
parent	3e88497601c407eb078c5c29ded67c555b754960 (diff)
download	chromium_src-7ffeb27fd61abfd55a615f4e9c83aac706bb00d5.zip chromium_src-7ffeb27fd61abfd55a615f4e9c83aac706bb00d5.tar.gz chromium_src-7ffeb27fd61abfd55a615f4e9c83aac706bb00d5.tar.bz2