OLD | NEW |
1 <div id="pageData-name" class="pageData">Page Actions</div> | |
2 | |
3 <!-- BEGIN AUTHORED CONTENT --> | |
4 <p> | 1 <p> |
5 Use page actions to put icons inside the address bar. | 2 Use page actions to put icons inside the address bar. |
6 Page actions represent actions | 3 Page actions represent actions |
7 that can be taken on the current page, | 4 that can be taken on the current page, |
8 but that aren't applicable to all pages. | 5 but that aren't applicable to all pages. |
9 Some examples: | 6 Some examples: |
10 </p> | 7 </p> |
11 <ul> | 8 <ul> |
12 <li> Subscribe to this page's RSS feed </li> | 9 <li> Subscribe to this page's RSS feed </li> |
13 <li> Make a slideshow out of this page's photos </li> | 10 <li> Make a slideshow out of this page's photos </li> |
14 </ul> | 11 </ul> |
15 | 12 |
16 <p> | 13 <p> |
17 The RSS icon in the following screenshot | 14 The RSS icon in the following screenshot |
18 represents a page action | 15 represents a page action |
19 that lets you subscribe to | 16 that lets you subscribe to |
20 the RSS feed for the current page. | 17 the RSS feed for the current page. |
21 </p> | 18 </p> |
22 | 19 |
23 <img src="../images/page-action.png" | 20 <img src="{{static}}/images/page-action.png" |
24 width="361" height="79" /> | 21 width="361" height="79" /> |
25 | 22 |
26 <p> | 23 <p> |
27 If you want the extension's icon to always be visible, | 24 If you want the extension's icon to always be visible, |
28 use a <a href="browserAction.html">browser action</a> instead. | 25 use a <a href="browserAction.html">browser action</a> instead. |
29 </p> | 26 </p> |
30 | 27 |
31 <p class="caution"> | 28 <p class="caution"> |
32 <strong>Note:</strong> | 29 <strong>Note:</strong> |
33 Packaged apps cannot use page actions. | 30 Packaged apps cannot use page actions. |
(...skipping 38 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
72 <a href="#method-hide">hide()</a> methods, respectively. | 69 <a href="#method-hide">hide()</a> methods, respectively. |
73 By default, a page action is hidden. | 70 By default, a page action is hidden. |
74 When you show it, you specify the tab | 71 When you show it, you specify the tab |
75 in which the icon should appear. | 72 in which the icon should appear. |
76 The icon remains visible | 73 The icon remains visible |
77 until the tab is closed | 74 until the tab is closed |
78 or starts displaying a different URL | 75 or starts displaying a different URL |
79 (because the user clicks a link, for example). | 76 (because the user clicks a link, for example). |
80 </p> | 77 </p> |
81 | 78 |
82 <!-- [PENDING: We should discuss how tabs and page actions are related. All met
hods take a tab ID argument. How do you get that tab ID? What's the usual way
of arranging the code that monitors pages? Point to examples.] --> | 79 |
83 | 80 |
84 | 81 |
85 <h2 id="tips">Tips</h2> | 82 <h2 id="tips">Tips</h2> |
86 | 83 |
87 <p>For the best visual impact, | 84 <p>For the best visual impact, |
88 follow these guidelines:</p> | 85 follow these guidelines:</p> |
89 | 86 |
90 <ul> | 87 <ul> |
91 <li><b>Do</b> use page actions | 88 <li><b>Do</b> use page actions |
92 for features that make sense | 89 for features that make sense |
93 for only a few pages. | 90 for only a few pages. |
94 <li><b>Don't</b> use page actions | 91 <li><b>Don't</b> use page actions |
95 for features that make sense | 92 for features that make sense |
96 for most pages. | 93 for most pages. |
97 Use <a href="browserAction.html">browser actions</a> instead. | 94 Use <a href="browserAction.html">browser actions</a> instead. |
98 <li><b>Don't</b> constantly animate your icon. | 95 <li><b>Don't</b> constantly animate your icon. |
99 That's just annoying. | 96 That's just annoying. |
100 </ul> | 97 </ul> |
101 | 98 |
102 | 99 |
103 <h2 id="examples"> Examples </h2> | 100 <h2 id="examples"> Examples </h2> |
104 | 101 |
105 <p> | 102 <p> |
106 You can find simple examples of using page actions in the | 103 You can find simple examples of using page actions in the |
107 <a href="http://src.chromium.org/viewvc/chrome/trunk/src/chrome/common/extension
s/docs/examples/api/pageAction/">examples/api/pageAction</a> | 104 <a href="http://src.chromium.org/viewvc/chrome/trunk/src/chrome/common/extension
s/docs/examples/api/pageAction/">examples/api/pageAction</a> |
108 directory. | 105 directory. |
109 For other examples and for help in viewing the source code, see | 106 For other examples and for help in viewing the source code, see |
110 <a href="samples.html">Samples</a>. | 107 <a href="samples.html">Samples</a>. |
111 </p> | 108 </p> |
112 | |
113 <!-- END AUTHORED CONTENT --> | |
OLD | NEW |