Fix descriptions to make docs parser happy

This commit is contained in:
Cheng Zhao 2018-02-26 15:05:46 +09:00
parent 88b887fe47
commit 25f04d5b03

View file

@ -6,7 +6,7 @@ Process: [Renderer](../glossary.md#renderer-process)
`webFrame` export of the electron module is an instance of the `WebFrame` `webFrame` export of the electron module is an instance of the `WebFrame`
class representing the top frame of the current `BrowserWindow`. Sub-frames can class representing the top frame of the current `BrowserWindow`. Sub-frames can
be retrieved by certain properties and methods (e.g. `webFrame.firstChild`) be retrieved by certain properties and methods (e.g. `webFrame.firstChild`).
An example of zooming current page to 200%. An example of zooming current page to 200%.
@ -221,46 +221,46 @@ and intend to stay there).
### `webFrame.getFrameForSelector(selector)` ### `webFrame.getFrameForSelector(selector)`
* Returns `WebFrame` for the frame element in `webFrame's` document selected by * `selector` String - CSS selector for a frame element.
`selector`
* Returns `null` if `selector` does not select a frame or if the frame is not in
the current renderer process.
* `selector` String - CSS selector for a frame element
Returns `WebFrame` - The frame element in `webFrame's` document selected by
`selector`, `null` would be returned if `selector` does not select a frame or
if the frame is not in the current renderer process.
### `webFrame.findFrameByName(name)` ### `webFrame.findFrameByName(name)`
* Returns `WebFrame` - a child of `webFrame` with the supplied `name` * `name` String
* Returns `null` if there's no such frame or if the frame is not in the current
renderer process. Returns `WebFrame` - A child of `webFrame` with the supplied `name`, `null`
would be returned if there's no such frame or if the frame is not in the current
renderer process.
## Properties ## Properties
### `webFrame.top` ### `webFrame.top`
* Returns `WebFrame` - top frame in frame hierarchy to which `webFrame` belongs A `WebFrame` representing top frame in frame hierarchy to which `webFrame`
* Returns `null` if top frame is not in the current renderer process. belongs, the property would be `null` if top frame is not in the current
renderer process.
### `webFrame.opener` ### `webFrame.opener`
* Returns `WebFrame` - frame which opened `webFrame` A `WebFrame` representing the frame which opened `webFrame`, the property would
* Returns `null` if there's no opener or opener is not in the current renderer be `null` if there's no opener or opener is not in the current renderer process.
process.
### `webFrame.parent` ### `webFrame.parent`
* Returns `WebFrame` - parent frame of `webFrame` A `WebFrame` representing parent frame of `webFrame`, the property would be
* Returns `null` if `webFrame` is top or parent is not in the current renderer `null` if `webFrame` is top or parent is not in the current renderer process.
process.
### `webFrame.firstChild` ### `webFrame.firstChild`
* Returns `WebFrame` - first child frame of `webFrame` A `WebFrame` representing the first child frame of `webFrame`, the property
* Returns `null` if `webFrame` has no children or if first child is not in the would be `null` if `webFrame` has no children or if first child is not in the
current renderer process. current renderer process.
### `webFrame.nextSibling` ### `webFrame.nextSibling`
* Returns `WebFrame` - next sibling frame A `WebFrame` representing next sibling frame, the property would be `null` if
* Returns `null` if `webFrame` is the last frame its parent or if the next `webFrame` is the last frame its parent or if the next sibling is not in the
sibling is not in the current renderer process. current renderer process.