Line wrap 80-col
This commit is contained in:
parent
00de81771c
commit
c282d4c0ff
3 changed files with 56 additions and 24 deletions
|
@ -1,6 +1,7 @@
|
||||||
# BrowserWindow
|
# BrowserWindow
|
||||||
|
|
||||||
The `BrowserWindow` class gives you the ability to create a browser window, for example:
|
The `BrowserWindow` class gives you the ability to create a browser window, for
|
||||||
|
example:
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
var BrowserWindow = require('browser-window');
|
var BrowserWindow = require('browser-window');
|
||||||
|
@ -79,14 +80,14 @@ Properties `width` and `height` are required.
|
||||||
textured window. Defaults to `true`.
|
textured window. Defaults to `true`.
|
||||||
* `web-preferences` Object - Settings of web page's features, properties:
|
* `web-preferences` Object - Settings of web page's features, properties:
|
||||||
* `javascript` Boolean
|
* `javascript` Boolean
|
||||||
* `web-security` Boolean - When setting `false`, it will disable the same-origin
|
* `web-security` Boolean - When setting `false`, it will disable the
|
||||||
policy (Usually using testing websites by people), and set `allow_displaying_insecure_content`
|
same-origin policy (Usually using testing websites by people), and set `allow_displaying_insecure_content`
|
||||||
and `allow_running_insecure_content` to `true` if these two options are not
|
and `allow_running_insecure_content` to `true` if these two options are not
|
||||||
set by user.
|
set by user.
|
||||||
* `allow-displaying-insecure-content` Boolean - Allow an https page to display
|
* `allow-displaying-insecure-content` Boolean - Allow an https page to display
|
||||||
content like images from http URLs.
|
content like images from http URLs.
|
||||||
* `allow-running-insecure-content` Boolean - Allow a https page to run JavaScript,
|
* `allow-running-insecure-content` Boolean - Allow a https page to run
|
||||||
CSS or plugins from http URLs.
|
JavaScript, CSS or plugins from http URLs.
|
||||||
* `images` Boolean
|
* `images` Boolean
|
||||||
* `java` Boolean
|
* `java` Boolean
|
||||||
* `text-areas-are-resizable` Boolean
|
* `text-areas-are-resizable` Boolean
|
||||||
|
@ -147,8 +148,13 @@ window.onbeforeunload = function(e) {
|
||||||
// Unlike usual browsers, in which a string should be returned and the user is
|
// Unlike usual browsers, in which a string should be returned and the user is
|
||||||
// prompted to confirm the page unload, Electron gives developers more options.
|
// prompted to confirm the page unload, Electron gives developers more options.
|
||||||
// Returning an empty string or `false` will prevent the unloading.
|
// Returning an empty string or `false` will prevent the unloading.
|
||||||
|
<<<<<<< HEAD
|
||||||
// You can also use the dialog API to let the user confirm closing the application.
|
// You can also use the dialog API to let the user confirm closing the application.
|
||||||
e.returnValue = false;
|
e.returnValue = false;
|
||||||
|
=======
|
||||||
|
// You can also use the dialog API to let the user confirm closing the app.
|
||||||
|
return false;
|
||||||
|
>>>>>>> Line wrap 80-col
|
||||||
};
|
};
|
||||||
```
|
```
|
||||||
|
|
||||||
|
@ -235,7 +241,9 @@ Emitted when devtools is focused / opened.
|
||||||
|
|
||||||
### Event: 'app-command':
|
### Event: 'app-command':
|
||||||
|
|
||||||
Emitted when an [App Command](https://msdn.microsoft.com/en-us/library/windows/desktop/ms646275(v=vs.85).aspx is invoked. These are typically related to keyboard media keys or browser commands, as well as the "Back" button built into some mice on Windows.
|
Emitted when an [App Command](https://msdn.microsoft.com/en-us/library/windows/desktop/ms646275(v=vs.85).aspx
|
||||||
|
is invoked. These are typically related to keyboard media keys or browser
|
||||||
|
commands, as well as the "Back" button built into some mice on Windows.
|
||||||
|
|
||||||
```js
|
```js
|
||||||
someWindow.on('app-command', function(e, cmd) {
|
someWindow.on('app-command', function(e, cmd) {
|
||||||
|
@ -304,7 +312,8 @@ var win = new BrowserWindow({ width: 800, height: 600 });
|
||||||
The `WebContents` object this window owns, all web page related events and
|
The `WebContents` object this window owns, all web page related events and
|
||||||
operations will be done via it.
|
operations will be done via it.
|
||||||
|
|
||||||
See the [`webContents` documentation](web-contents.md) for its methods and events.
|
See the [`webContents` documentation](web-contents.md) for its methods and
|
||||||
|
events.
|
||||||
|
|
||||||
**Note:** Users should never store this object because it may become `null`
|
**Note:** Users should never store this object because it may become `null`
|
||||||
when the renderer process (web page) has crashed.
|
when the renderer process (web page) has crashed.
|
||||||
|
@ -395,14 +404,25 @@ Returns a boolean, whether the window is in fullscreen mode.
|
||||||
|
|
||||||
### `win.setAspectRatio(aspectRatio[, extraSize])`
|
### `win.setAspectRatio(aspectRatio[, extraSize])`
|
||||||
|
|
||||||
* `aspectRatio` The aspect ratio we want to maintain for some portion of the content view.
|
* `aspectRatio` The aspect ratio we want to maintain for some portion of the
|
||||||
* `rect` Object - The extra size to not be included in the aspect ratio to be maintained. Properties:
|
content view.
|
||||||
|
* `rect` Object - The extra size to not be included in the aspect ratio to be
|
||||||
|
maintained. Properties:
|
||||||
* `width` Integer
|
* `width` Integer
|
||||||
* `height` Integer
|
* `height` Integer
|
||||||
|
|
||||||
This will have a window maintain an aspect ratio. The extra size allows a developer to have space, specified in pixels, not included within the aspect ratio calculations. This API already takes into account the difference between a window's size and its content size.
|
This will have a window maintain an aspect ratio. The extra size allows a
|
||||||
|
developer to have space, specified in pixels, not included within the aspect ratio calculations. This API already takes into account the difference between a
|
||||||
|
window's size and its content size.
|
||||||
|
|
||||||
Consider a normal window with an HD video player and associated controls. Perhaps there are 15 pixels of controls on the left edge, 25 pixels of controls on the right edge and 50 pixels of controls below the player. In order to maintain a 16:9 aspect ratio (standard aspect ratio for HD @1920x1080) within the player itself we would call this function with arguments of 16/9 and [ 40, 50 ]. The second argument doesn't care where the extra width and height are within the content view--only that they exist. Just sum any extra width and height areas you have within the overall content view.
|
Consider a normal window with an HD video player and associated controls.
|
||||||
|
Perhaps there are 15 pixels of controls on the left edge, 25 pixels of controls
|
||||||
|
on the right edge and 50 pixels of controls below the player. In order to
|
||||||
|
maintain a 16:9 aspect ratio (standard aspect ratio for HD @1920x1080) within
|
||||||
|
the player itself we would call this function with arguments of 16/9 and
|
||||||
|
[ 40, 50 ]. The second argument doesn't care where the extra width and height
|
||||||
|
are within the content view--only that they exist. Just sum any extra width and
|
||||||
|
height areas you have within the overall content view.
|
||||||
|
|
||||||
__Note__: This API is only implemented on OS X.
|
__Note__: This API is only implemented on OS X.
|
||||||
|
|
||||||
|
@ -595,7 +615,8 @@ Starts inspecting element at position (`x`, `y`).
|
||||||
|
|
||||||
### `win.inspectServiceWorker()`
|
### `win.inspectServiceWorker()`
|
||||||
|
|
||||||
Opens the developer tools for the service worker context present in the web contents.
|
Opens the developer tools for the service worker context present in the web
|
||||||
|
contents.
|
||||||
|
|
||||||
### `win.focusOnWebView()`
|
### `win.focusOnWebView()`
|
||||||
|
|
||||||
|
@ -669,7 +690,8 @@ cleared
|
||||||
* `description` String - a description that will be provided to Accessibility
|
* `description` String - a description that will be provided to Accessibility
|
||||||
screen readers
|
screen readers
|
||||||
|
|
||||||
Sets a 16px overlay onto the current taskbar icon, usually used to convey some sort of application status or to passively notify the user.
|
Sets a 16px overlay onto the current taskbar icon, usually used to convey some
|
||||||
|
sort of application status or to passively notify the user.
|
||||||
|
|
||||||
__Note:__ This API is only available on Windows (Windows 7 and above)
|
__Note:__ This API is only available on Windows (Windows 7 and above)
|
||||||
|
|
||||||
|
|
|
@ -1,6 +1,8 @@
|
||||||
# session
|
# session
|
||||||
|
|
||||||
The `session` object is a property of [`webContents`](web-contents.md) which is a property of [`BrowserWindow`](browser-window.md). You can access it through an instance of `BrowserWindow`. For example:
|
The `session` object is a property of [`webContents`](web-contents.md) which is
|
||||||
|
a property of [`BrowserWindow`](browser-window.md). You can access it through an
|
||||||
|
instance of `BrowserWindow`. For example:
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
var BrowserWindow = require('browser-window');
|
var BrowserWindow = require('browser-window');
|
||||||
|
@ -58,7 +60,8 @@ win.webContents.on('did-finish-load', function() {
|
||||||
* `url` String - Retrieves cookies which are associated with `url`.
|
* `url` String - Retrieves cookies which are associated with `url`.
|
||||||
Empty implies retrieving cookies of all urls.
|
Empty implies retrieving cookies of all urls.
|
||||||
* `name` String - Filters cookies by name
|
* `name` String - Filters cookies by name
|
||||||
* `domain` String - Retrieves cookies whose domains match or are subdomains of `domains`
|
* `domain` String - Retrieves cookies whose domains match or are subdomains of
|
||||||
|
`domains`
|
||||||
* `path` String - Retrieves cookies whose path matches `path`
|
* `path` String - Retrieves cookies whose path matches `path`
|
||||||
* `secure` Boolean - Filters cookies by their Secure property
|
* `secure` Boolean - Filters cookies by their Secure property
|
||||||
* `session` Boolean - Filters out session or persistent cookies.
|
* `session` Boolean - Filters out session or persistent cookies.
|
||||||
|
@ -75,7 +78,8 @@ win.webContents.on('did-finish-load', function() {
|
||||||
* `session` Boolean - Whether the cookie is a session cookie or a persistent
|
* `session` Boolean - Whether the cookie is a session cookie or a persistent
|
||||||
cookie with an expiration date.
|
cookie with an expiration date.
|
||||||
* `expirationDate` Double - (Option) The expiration date of the cookie as
|
* `expirationDate` Double - (Option) The expiration date of the cookie as
|
||||||
the number of seconds since the UNIX epoch. Not provided for session cookies.
|
the number of seconds since the UNIX epoch. Not provided for session
|
||||||
|
cookies.
|
||||||
|
|
||||||
### `session.cookies.set(details, callback)`
|
### `session.cookies.set(details, callback)`
|
||||||
|
|
||||||
|
@ -86,8 +90,10 @@ win.webContents.on('did-finish-load', function() {
|
||||||
* `value` String - The value of the cookie. Empty by default if omitted.
|
* `value` String - The value of the cookie. Empty by default if omitted.
|
||||||
* `domain` String - The domain of the cookie. Empty by default if omitted.
|
* `domain` String - The domain of the cookie. Empty by default if omitted.
|
||||||
* `path` String - The path of the cookie. Empty by default if omitted.
|
* `path` String - The path of the cookie. Empty by default if omitted.
|
||||||
* `secure` Boolean - Whether the cookie should be marked as Secure. Defaults to false.
|
* `secure` Boolean - Whether the cookie should be marked as Secure. Defaults to
|
||||||
* `session` Boolean - Whether the cookie should be marked as HttpOnly. Defaults to false.
|
false.
|
||||||
|
* `session` Boolean - Whether the cookie should be marked as HttpOnly. Defaults
|
||||||
|
to false.
|
||||||
* `expirationDate` Double - The expiration date of the cookie as the number of
|
* `expirationDate` Double - The expiration date of the cookie as the number of
|
||||||
seconds since the UNIX epoch. If omitted, the cookie becomes a session cookie.
|
seconds since the UNIX epoch. If omitted, the cookie becomes a session cookie.
|
||||||
|
|
||||||
|
|
|
@ -3,7 +3,9 @@
|
||||||
`webContents` is an
|
`webContents` is an
|
||||||
[EventEmitter](http://nodejs.org/api/events.html#events_class_events_eventemitter).
|
[EventEmitter](http://nodejs.org/api/events.html#events_class_events_eventemitter).
|
||||||
|
|
||||||
It is responsible for rendering and controlling a web page and is a property of the [`BrowserWindow`](browser-window.md) object. An example of accessing the `webContents` object:
|
It is responsible for rendering and controlling a web page and is a property of
|
||||||
|
the [`BrowserWindow`](browser-window.md) object. An example of accessing the
|
||||||
|
`webContents` object:
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
var BrowserWindow = require('browser-window');
|
var BrowserWindow = require('browser-window');
|
||||||
|
@ -123,8 +125,8 @@ Returns:
|
||||||
Emitted when user or the page wants to start a navigation, it can happen when
|
Emitted when user or the page wants to start a navigation, it can happen when
|
||||||
`window.location` object is changed or user clicks a link in the page.
|
`window.location` object is changed or user clicks a link in the page.
|
||||||
|
|
||||||
This event will not emit when the navigation is started programmatically with APIs
|
This event will not emit when the navigation is started programmatically with
|
||||||
like `webContents.loadUrl` and `webContents.back`.
|
APIs like `webContents.loadUrl` and `webContents.back`.
|
||||||
|
|
||||||
Calling `event.preventDefault()` can prevent the navigation.
|
Calling `event.preventDefault()` can prevent the navigation.
|
||||||
|
|
||||||
|
@ -189,8 +191,8 @@ Returns whether web page is still loading resources.
|
||||||
|
|
||||||
### `webContents.isWaitingForResponse()`
|
### `webContents.isWaitingForResponse()`
|
||||||
|
|
||||||
Returns whether the web page is waiting for a first-response for the main resource
|
Returns whether the web page is waiting for a first-response for the main
|
||||||
of the page.
|
resource of the page.
|
||||||
|
|
||||||
### `webContents.stop()`
|
### `webContents.stop()`
|
||||||
|
|
||||||
|
@ -269,7 +271,9 @@ Injects CSS into the current web page.
|
||||||
|
|
||||||
Evaluates `code` in page.
|
Evaluates `code` in page.
|
||||||
|
|
||||||
In the browser window some HTML APIs like `requestFullScreen` can only be invoked by a gesture from the user. Setting `userGesture` to `true` will remove this limitation.
|
In the browser window some HTML APIs like `requestFullScreen` can only be
|
||||||
|
invoked by a gesture from the user. Setting `userGesture` to `true` will remove
|
||||||
|
this limitation.
|
||||||
|
|
||||||
### `webContents.setAudioMuted(muted)`
|
### `webContents.setAudioMuted(muted)`
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue