1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
|
<!-- contributed by Felipe Gomes [felipc@gmail.com] -->
The `windows` module provides easy access to browser windows, their
tabs, and open/close related functions and events.
This module currently only supports browser windows and does not provide
access to non-browser windows such as the Bookmarks Library, preferences
or other non-browser windows created via add-ons.
<api name="browserWindows">
@property {List}
An object that contains various properties and methods to access
functionality from browser windows, such as opening new windows, accessing
their tabs or switching the current active window.
`browserWindows` provides access to all the currently open browser windows:
var windows = require("windows");
for each (var window in windows.browserWindows) {
console.log(window.title);
}
console.log(windows.browserWindows.length);
Object emits all the events listed under "Events" section.
####Examples####
var windows = require("windows").browserWindows;
// add a listener to the 'open' event
windows.on('open', function(window) {
myOpenWindows.push(window);
});
// add a listener to the 'close' event
windows.on('close', function(window) {
console.log("A window was closed.");
});
<api name="activeWindow">
@property {BrowserWindow}
The currently active window. This property is read-only.
**Example**
// get
var windows = require("windows");
console.log("title of active window is " +
windows.browserWindows.activeWindow.title);
anotherWindow.activate();
// set
windows.activeWindow == anotherWindow // true
</api>
</api>
<api name="open">
@function
Open a new window.
var windows = require("windows").browserWindows;
// Open a new window.
windows.open("http://www.example.com");
// Open a new window and set a listener for "open" event.
windows.open({
url: "http://www.example.com",
onOpen: function(window) {
// do stuff like listen for content
// loading.
}
});
Returns the window that was opened:
var widgets = require("widget");
var windows = require("windows").browserWindows;
var example = windows.open("http://www.example.com");
var widget = widgets.Widget({
id: "close-window",
label: "Close window",
contentURL: "http://www.mozilla.org/favicon.ico",
onClick: function() {
example.close();
}
});
@param options {object}
An object containing configurable options for how this window will be opened,
as well as a callback for being notified when the window has fully opened.
If the only option being used is `url`, then a bare string URL can be passed to
`open` instead of specifying it as a property of the `options` object.
@prop url {string}
String URL to be opened in the new window.
This is a required property.
@prop [onOpen] {function}
A callback function that is called when the window has opened. This does not
mean that the URL content has loaded, only that the window itself is fully
functional and its properties can be accessed. This is an optional property.
@prop [onClose] {function}
A callback function that is called when the window will be called.
This is an optional property.
@returns {BrowserWindow}
</api>
<api name="BrowserWindow">
@class
A `BrowserWindow` instance represents a single open window. They can be
retrieved from the `browserWindows` property exported by this module.
var windows = require("windows").browserWindows;
//Print how many tabs the current window has
console.log("The active window has " +
windows.activeWindow.tabs.length +
" tabs.");
// Print the title of all browser windows
for each (var window in windows) {
console.log(window.title);
}
// close the active window
windows.activeWindow.close();
windows.activeWindow.close(function() {
console.log("The active window was closed");
});
<api name="title">
@property {string}
The current title of the window. Usually the title of the active tab,
plus an app identifier.
This property is read-only.
</api>
<api name="tabs">
@property {TabList}
A live list of tabs in this window. This object has the same interface as the
[`tabs` API](packages/addon-kit/docs/tabs.html), except it contains only the
tabs in this window, not all tabs in all windows. This property is read-only.
</api>
<api name="activate">
@method
Makes window active, which will focus that window and bring it to the
foreground.
</api>
<api name="close">
@method
Close the window.
@param [callback] {function}
A function to be called when the window finishes its closing process.
This is an optional argument.
</api>
</api>
<api name="open">
@event
Event emitted when a new window is open.
This does not mean that the content has loaded, only that the browser window
itself is fully visible to the user.
@argument {Window}
Listeners are passed the `window` object that triggered the event.
</api>
<api name="close">
@event
Event emitted when a window is closed.
@argument {Window}
Listeners are passed the `window` object that triggered the event.
</api>
|
