electron/docs/api/web-frame.md

110 lines
2.6 KiB
Markdown
Raw Normal View History

2015-08-29 06:20:49 +00:00
# webFrame
2014-06-16 06:56:24 +00:00
2016-04-21 22:39:12 +00:00
> Customize the rendering of the current web page.
2014-06-16 06:56:24 +00:00
An example of zooming current page to 200%.
```javascript
const {webFrame} = require('electron');
2015-08-29 06:20:49 +00:00
2014-10-24 10:24:12 +00:00
webFrame.setZoomFactor(2);
2014-06-16 06:56:24 +00:00
```
2015-08-29 06:20:49 +00:00
## Methods
2016-04-26 17:28:04 +00:00
The `webFrame` module has the following methods:
2015-08-29 06:20:49 +00:00
### `webFrame.setZoomFactor(factor)`
2014-06-16 06:56:24 +00:00
2015-08-29 06:20:49 +00:00
* `factor` Number - Zoom factor.
2014-06-16 06:56:24 +00:00
2015-09-02 16:57:29 +00:00
Changes the zoom factor to the specified factor. Zoom factor is
zoom percent divided by 100, so 300% = 3.0.
2014-06-16 06:56:24 +00:00
2015-08-29 06:20:49 +00:00
### `webFrame.getZoomFactor()`
2014-06-16 06:56:24 +00:00
Returns the current zoom factor.
2015-08-29 06:20:49 +00:00
### `webFrame.setZoomLevel(level)`
2014-06-16 06:56:24 +00:00
* `level` Number - Zoom level
2015-09-01 03:05:57 +00:00
Changes the zoom level to the specified level. The original size is 0 and each
2014-06-16 06:56:24 +00:00
increment above or below represents zooming 20% larger or smaller to default
limits of 300% and 50% of original size, respectively.
2015-08-29 06:20:49 +00:00
### `webFrame.getZoomLevel()`
2014-06-16 06:56:24 +00:00
Returns the current zoom level.
2014-12-20 06:34:34 +00:00
2015-08-29 06:20:49 +00:00
### `webFrame.setZoomLevelLimits(minimumLevel, maximumLevel)`
2015-08-27 14:08:25 +00:00
* `minimumLevel` Number
* `maximumLevel` Number
Sets the maximum and minimum zoom level.
2015-08-29 06:20:49 +00:00
### `webFrame.setSpellCheckProvider(language, autoCorrectWord, provider)`
2014-12-20 06:34:34 +00:00
* `language` String
* `autoCorrectWord` Boolean
* `provider` Object
Sets a provider for spell checking in input fields and text areas.
The `provider` must be an object that has a `spellCheck` method that returns
whether the word passed is correctly spelled.
An example of using [node-spellchecker][spellchecker] as provider:
```javascript
webFrame.setSpellCheckProvider('en-US', true, {
spellCheck(text) {
2014-12-20 06:34:34 +00:00
return !(require('spellchecker').isMisspelled(text));
}
});
```
2015-11-13 08:03:40 +00:00
### `webFrame.registerURLSchemeAsSecure(scheme)`
* `scheme` String
Registers the `scheme` as secure scheme.
Secure schemes do not trigger mixed content warnings. For example, `https` and
`data` are secure schemes because they cannot be corrupted by active network
attackers.
2015-11-13 08:03:40 +00:00
### `webFrame.registerURLSchemeAsBypassingCSP(scheme)`
* `scheme` String
2015-08-29 06:20:49 +00:00
Resources will be loaded from this `scheme` regardless of the current page's
Content Security Policy.
2015-11-13 08:03:40 +00:00
### `webFrame.registerURLSchemeAsPrivileged(scheme)`
* `scheme` String
Registers the `scheme` as secure, bypasses content security policy for resources,
allows registering ServiceWorker and supports fetch API.
2016-01-13 03:21:16 +00:00
### `webFrame.insertText(text)`
* `text` String
2016-01-13 03:55:49 +00:00
Inserts `text` to the focused element.
2016-01-13 03:21:16 +00:00
2016-01-13 04:20:49 +00:00
### `webFrame.executeJavaScript(code[, userGesture])`
* `code` String
* `userGesture` Boolean (optional) - Default is `false`.
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.
2014-12-20 06:34:34 +00:00
[spellchecker]: https://github.com/atom/node-spellchecker