Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(733)

Unified Diff: chrome/common/extensions/docs/server2/templates/intros/fileBrowserHandler.html

Issue 10832042: Extensions Docs Server: Doc conversion script (Closed) Base URL: svn://svn.chromium.org/chrome/trunk/src
Patch Set: everything but svn stuff Created 8 years, 5 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
Index: chrome/common/extensions/docs/server2/templates/intros/fileBrowserHandler.html
diff --git a/chrome/common/extensions/docs/server2/templates/intros/fileBrowserHandler.html b/chrome/common/extensions/docs/server2/templates/intros/fileBrowserHandler.html
index 4774417cff1a6b9a5bbaab2d3f5617f9bcf9d0e5..40d681af103ef2e3298a01c9ea7b4acb282f70f9 100644
--- a/chrome/common/extensions/docs/server2/templates/intros/fileBrowserHandler.html
+++ b/chrome/common/extensions/docs/server2/templates/intros/fileBrowserHandler.html
@@ -1,14 +1,15 @@
-<!-- BEGIN AUTHORED CONTENT -->
<p id="classSummary">
Use the <code>chrome.fileBrowserHandler</code> module to
extend the Chrome OS file browser.
For example, you can use this API
to enable users to upload files to your website.
</p>
+
<p class="caution">
<b>Important:</b>
This API works <b>only on Chrome OS</b>.
</p>
+
<p>
The Chrome OS file browser comes up when
the user either presses Ctrl+M
@@ -18,6 +19,7 @@ Besides showing the files on external devices,
the file browser can also display files
that the user has previously saved to the system.
</p>
+
<p>
When the user selects one or more files,
the file browser adds buttons
@@ -26,11 +28,15 @@ For example, in the following screenshot,
selecting a file with a ".jpg" suffix
results in an "Upload to Picasa" button that the user can click.
</p>
+
<p>
<img src="{{static}}/images/filebrowserhandler.png"
width="640" height="400" alt="file browser screenshot" />
</p>
+
+
<h2 id="manifest">Manifest</h2>
+
<p>
You must declare the "fileBrowserHandler" permission
in the <a href="manifest.html">extension manifest</a>,
@@ -40,6 +46,7 @@ You should also provide a 16x16 icon
to be displayed on the button.
For example:
</p>
+
<pre>
{
"name": "My extension",
@@ -63,12 +70,15 @@ For example:
"128": "icon128.png" },
...
}</pre>
+
<p class="note">
<b>Note:</b>
You can specify locale-specific strings for the value of "default_title".
See <a href="i18n.html">Internationalization (i18n)</a> for details.
</p>
+
<h2 id="code">Implementing a file browser handler</h2>
+
<p>
To use this API,
you must implement a function that handles the <code>onExecute</code> event
@@ -80,6 +90,7 @@ In your function, use the HTML5
to get access to the file contents.
Here is an example:
</p>
+
<pre>
<em>//In background.html:</em>
chrome.fileBrowserHandler.onExecute.addListener(function(id, details) {
@@ -93,9 +104,11 @@ chrome.fileBrowserHandler.onExecute.addListener(function(id, details) {
}
});
</pre>
+
<p>
Your event handler is passed two arguments:
</p>
+
<dl>
<dt> id </dt>
<dd> The "id" value from the manifest file.
@@ -111,26 +124,31 @@ Your event handler is passed two arguments:
FileSystem <code>Entry</code> objects.
</dd>
</p>
+
+
<!--
<h2 id="manifest_details">Manifest details</h2>
+
<p class="authornote">
{PENDING: give details about "id" and "default_title".
It should be unique within your extension -- don't worry about other extensions.
"default_title" implies that you can change the title,
but you can't aside from internationalizing it.
</p>
+
<p class="authornote">
{PENDING: give details about the file_filters entry.
File filters are currently case-sensitive, but we plan to change that.
Mention <code>filesystem:*.*</code>.
</p>
-->
+
<!--
<h2 id="examples">Examples</h2>
+
<p>
For examples of using this API, see ...
For other examples and for help in viewing the source code, see
<a href="samples.html">Samples</a>.
</p>
--->
-<!-- END AUTHORED CONTENT -->
+-->

Powered by Google App Engine
This is Rietveld 408576698