summaryrefslogtreecommitdiffstats
path: root/chrome/common/extensions/docs/template/api_template.html
diff options
context:
space:
mode:
Diffstat (limited to 'chrome/common/extensions/docs/template/api_template.html')
-rw-r--r--chrome/common/extensions/docs/template/api_template.html69
1 files changed, 43 insertions, 26 deletions
diff --git a/chrome/common/extensions/docs/template/api_template.html b/chrome/common/extensions/docs/template/api_template.html
index 1b47011..ae5a94d 100644
--- a/chrome/common/extensions/docs/template/api_template.html
+++ b/chrome/common/extensions/docs/template/api_template.html
@@ -21,7 +21,8 @@
<span class="enum" jsdisplay="enum">enumerated</span>
<span id="typeTemplate">
<span jsdisplay="getTypeRef($this)">
- <a jsvalues=".href: getTypeRefPage($this) + '#type-' + getTypeRef($this)" jscontent="getTypeRef($this)"> Type</a>
+ <a jsvalues=".href: getTypeRefPage($this) + '#type-' + getTypeRef($this)"
+ jscontent="getTypeRef($this)"> Type</a>
</span>
<span jsdisplay="!getTypeRef($this)">
<span jsdisplay="isArray($this)">
@@ -63,6 +64,20 @@
</dl>
</dd>
+ <!-- OBJECT METHODS -->
+ <dd jsdisplay="$this.type === 'object' &&
+ $this.functions && $this.functions.length > 0"
+ jsvalues="$scope:id">
+ <div transclude="methodsTemplate"></div>
+ </dd>
+
+ <!-- OBJECT EVENT FIELDS -->
+ <dd jsdisplay="$this.type === 'object' &&
+ $this.events && $this.events.length > 0"
+ jsvalues="$scope:id">
+ <div transclude="eventsTemplate"></div>
+ </dd>
+
<!-- FUNCTION PARAMETERS -->
<dd jsdisplay="isFunction($this) && $this.parameters &&
$this.name != 'callback'">
@@ -257,23 +272,23 @@
</ol>
</li>
<li jsdisplay="functions && functions.length > 0">
- <a href="#methods">Methods</a>
+ <a jsvalues=".href:'#' + getAnchorName('global', 'methods')">Methods</a>
<ol>
<li jsselect="functions.sort(sortByName)"
jsdisplay="!($this.nodoc)">
<a jscontent="name"
- jsvalues=".href:'#method-' + name"
+ jsvalues=".href:'#' + getAnchorName('method', name)"
href="#method-anchor">methodName</a>
</li>
</ol>
</li>
<li jsdisplay="events && events.length > 0">
- <a href="#events">Events</a>
+ <a jsvalues=".href:'#' + getAnchorName('global', 'events')">Events</a>
<ol>
<li jsselect="events.sort(sortByName)"
jsdisplay="!($this.nodoc)">
<a jscontent="name"
- jsvalues=".href:'#event-' + name"
+ jsvalues=".href:'#' + getAnchorName('event', name)"
href="#event-anchor">eventName</a>
</li>
</ol>
@@ -303,7 +318,7 @@
<div id="static"></div>
<!-- API PAGE -->
- <div class="apiPage" jsselect="apiDefinition">
+ <div class="apiPage" jsselect="apiDefinition" jsvalues="$scope:''">
<a name="apiReference"></a>
<h2 jscontent="'API reference: ' + getModuleName()">API reference: chrome.apiname </h2>
@@ -326,19 +341,20 @@
</div> <!-- /apiGroup -->
<!-- METHODS -->
- <div jsdisplay="functions && functions.length > 0" class="apiGroup" id="methods">
- <a name="methods"></a>
- <h3>Methods</h3>
+ <div id="methodsTemplate" class="apiGroup"
+ jsdisplay="$this.functions && $this.functions.length > 0">
+ <a jsvalues=".name:getAnchorName('global', 'methods', $scope)"></a>
+ <h3 jscontent="$scope ? 'Methods of ' + $scope : 'Methods'">Methods</h3>
<!-- iterates over all functions -->
<div class="apiItem" jsselect="functions.sort(sortByName)"
jsdisplay="!($this.nodoc)">
- <a jsvalues=".name:'method-' + name"></a> <!-- method-anchor -->
+ <a jsvalues=".name:getAnchorName('method', name, $scope)"></a> <!-- method-anchor -->
<h4 jscontent="name">method name</h4>
<div class="summary"><span jsdisplay="returns" jscontent="getTypeName(returns)">void</span>
<!-- Note: intentionally longer 80 columns -->
- <span jscontent="getFullyQualifiedFunctionName($this)">chrome.module.methodName</span>(<span jsselect="parameters" jsvalues="class:optional ? 'optional' : ''"><span jsdisplay="$index">, </span><span jscontent="getTypeName($this)"></span>
+ <span jscontent="getFullyQualifiedFunctionName($scope, $this)">chrome.module.methodName</span>(<span jsselect="parameters" jsvalues="class:optional ? 'optional' : ''"><span jsdisplay="$index">, </span><span jscontent="getTypeName($this)"></span>
<var><span jscontent="$this.name"></span></var></span>)</div>
<div class="description">
@@ -348,7 +364,7 @@
</p>
<!-- PARAMETERS -->
- <h4>Parameters</h4>
+ <h4 jsdisplay="$this.parameters && $this.parameters.length > 0">Parameters</h4>
<dl>
<div jsselect="parameters">
<div transclude="valueTemplate">
@@ -403,19 +419,19 @@
</div> <!-- /apiGroup -->
<!-- EVENTS -->
- <div jsdisplay="events && events.length > 0" class="apiGroup">
- <a name="events"></a>
- <h3 id="events">Events</h3>
-
+ <div id="eventsTemplate" class="apiGroup"
+ jsdisplay="$this.events && $this.events.length > 0">
+ <a jsvalues=".name:getAnchorName('global', 'events', $scope)"></a>
+ <h3 jscontent="$scope ? 'Events of ' + $scope : 'Events'">Events</h3>
<!-- iterates over all events -->
- <div jsselect="events.sort(sortByName)" class="apiItem"
+ <div class="apiItem" jsselect="$this.events.sort(sortByName)"
jsdisplay="!($this.nodoc)">
- <a jsvalues=".name:'event-' + name"></a>
+ <a jsvalues=".name:getAnchorName('event', name, $scope)"></a>
<h4 jscontent="name">event name</h4>
<div class="summary">
<!-- Note: intentionally longer 80 columns -->
- <span jscontent="getModuleName() + '.'" class="subdued">chrome.bookmarks</span><span jscontent="name">onEvent</span><span class="subdued">.addListener</span>(function(<span jscontent="getSignatureString(parameters)">Type param1, Type param2</span>) <span class="subdued">{...}</span>);
+ <span jscontent="(getObjectName($scope) || getModuleName()) + '.'" class="subdued">chrome.bookmarks</span><span jscontent="name">onEvent</span><span class="subdued">.addListener</span>(function(<span jscontent="getSignatureString($this.parameters)">Type param1, Type param2</span>) <span class="subdued">{...}</span>);
</div>
<div class="description">
@@ -425,14 +441,15 @@
</p>
<!-- PARAMETERS -->
- <h4>Parameters</h4>
- <dl>
- <div jsselect="parameters">
- <div transclude="valueTemplate">
+ <div jsdisplay="parameters && parameters.length > 0">
+ <h4>Parameters</h4>
+ <dl>
+ <div jsselect="parameters">
+ <div transclude="valueTemplate">
+ </div>
</div>
- </div>
- </dl>
-
+ </dl>
+ </div>
</div> <!-- /decription -->
</div> <!-- /apiItem -->