Translated API docs, added power-save-blocker API to README

This commit is contained in:
Plusb Preco 2015-07-01 14:36:27 +09:00
parent 783e4bc591
commit dcd10d1e4b
19 changed files with 138 additions and 170 deletions

View file

@ -18,7 +18,7 @@
* [개요](api/synopsis-ko.md)
* [프로세스 객체](api/process-ko.md)
* [크롬 Command-Line 스위치에 대한 지원](api/chrome-command-line-switches-ko.md)
* [크롬 Command-Line 스위치 지원](api/chrome-command-line-switches-ko.md)
커스텀 DOM Element:
@ -38,6 +38,7 @@
* [menu](api/menu-ko.md)
* [menu-item](api/menu-item-ko.md)
* [power-monitor](api/power-monitor-ko.md)
* [power-save-blocker](api/power-save-blocker-ko.md)
* [protocol](api/protocol-ko.md)
* [tray](api/tray-ko.md)

View file

@ -38,6 +38,7 @@ Modules for the main process:
* [menu](api/menu.md)
* [menu-item](api/menu-item.md)
* [power-monitor](api/power-monitor.md)
* [power-save-blocker](api/power-save-blocker.md)
* [protocol](api/protocol.md)
* [tray](api/tray.md)

View file

@ -92,21 +92,21 @@ click on the application's dock icon.
* `event` Event
* `window` BrowserWindow
Emitted when a [browserWindow](browser-window.md) gets blurred.
Emitted when a [browserWindow](browser-window-ko.md) gets blurred.
## Event: browser-window-focus
* `event` Event
* `window` BrowserWindow
Emitted when a [browserWindow](browser-window.md) gets focused.
Emitted when a [browserWindow](browser-window-ko.md) gets focused.
### Event: 'select-certificate'
Emitted when client certificate is requested.
* `event` Event
* `webContents` [WebContents](browser-window.md#class-webcontents)
* `webContents` [WebContents](browser-window-ko.md#class-webcontents)
* `url` String
* `certificateList` [Objects]
* `data` PEM encoded data

View file

@ -16,7 +16,7 @@ win.show();
```
You can also create a window without chrome by using
[Frameless Window](frameless-window.md) API.
[Frameless Window](frameless-window-ko.md) API.
## Class: BrowserWindow
@ -48,11 +48,11 @@ You can also create a window without chrome by using
zoom percent / 100, so `3.0` represents `300%`
* `kiosk` Boolean - The kiosk mode
* `title` String - Default window title
* `icon` [NativeImage](native-image.md) - The window icon, when omitted on
* `icon` [NativeImage](native-image-ko.md) - The window icon, when omitted on
Windows the executable's icon would be used as window icon
* `show` Boolean - Whether window should be shown when created
* `frame` Boolean - Specify `false` to create a
[Frameless Window](frameless-window.md)
[Frameless Window](frameless-window-ko.md)
* `node-integration` Boolean - Whether node integration is enabled, default
is `true`
* `accept-first-mouse` Boolean - Whether the web view accepts a single
@ -68,7 +68,7 @@ You can also create a window without chrome by using
scripts run in the window. This script will always have access to node APIs
no matter whether node integration is turned on for the window, and the path
of `preload` script has to be absolute path.
* `transparent` Boolean - Makes the window [transparent](frameless-window.md)
* `transparent` Boolean - Makes the window [transparent](frameless-window-ko.md)
* `type` String - Specifies the type of the window, possible types are
`desktop`, `dock`, `toolbar`, `splash`, `notification`. This only works on
Linux.
@ -566,11 +566,11 @@ Opens the developer tools for the service worker context present in the web cont
Captures the snapshot of page within `rect`, upon completion `callback` would be
called with `callback(image)`, the `image` is an instance of
[NativeImage](native-image.md) that stores data of the snapshot. Omitting the
[NativeImage](native-image-ko.md) that stores data of the snapshot. Omitting the
`rect` would capture the whole visible page.
**Note:** Be sure to read documents on remote buffer in
[remote](remote.md) if you are going to use this API in renderer
[remote](remote-ko.md) if you are going to use this API in renderer
process.
### BrowserWindow.print([options])
@ -613,7 +613,7 @@ it will assume `app.getName().desktop`.
### BrowserWindow.setOverlayIcon(overlay, description)
* `overlay` [NativeImage](native-image.md) - the icon to display on the bottom
* `overlay` [NativeImage](native-image-ko.md) - the icon to display on the bottom
right corner of the taskbar icon. If this parameter is `null`, the overlay is
cleared
* `description` String - a description that will be provided to Accessibility

View file

@ -1,4 +1,4 @@
# Supported Chrome command line switches
# 크롬 Command-Line 스위치 지원
The following command lines switches in Chrome browser are also supported in
Electron, you can use [app.commandLine.appendSwitch][append-switch] to append
@ -63,9 +63,9 @@ connection, and the endpoint host in a `SOCKS` proxy connection).
Like `--host-rules` but these `rules` only apply to the host resolver.
[app]: app.md
[append-switch]: app.md#appcommandlineappendswitchswitch-value
[ready]: app.md#event-ready
[app]: app-ko.md
[append-switch]: app-ko.md#appcommandlineappendswitchswitch-value
[ready]: app-ko.md#event-ready
## --ignore-certificate-errors

View file

@ -45,11 +45,11 @@ console.log(clipboard.readText('selection'));
* `type` String
클립보드로부터 [NativeImage](native-image.md)로 이미지를 읽어들입니다.
클립보드로부터 [NativeImage](native-image-ko.md)로 이미지를 읽어들입니다.
## clipboard.writeImage(image[, type])
* `image` [NativeImage](native-image.md)
* `image` [NativeImage](native-image-ko.md)
* `type` String
클립보드에 `image`를 씁니다.

View file

@ -75,7 +75,7 @@ will be passed via `callback(filename)`
* `title` String - Title of the message box, some platforms will not show it
* `message` String - Content of the message box
* `detail` String - Extra information of the message
* `icon` [NativeImage](native-image.md)
* `icon` [NativeImage](native-image-ko.md)
* `callback` Function
Shows a message box, it will block until the message box is closed. It returns

View file

@ -5,7 +5,7 @@ A frameless window is a window that has no chrome.
## Create a frameless window
To create a frameless window, you only need to specify `frame` to `false` in
[BrowserWindow](browser-window.md)'s `options`:
[BrowserWindow](browser-window-ko.md)'s `options`:
```javascript

View file

@ -1,49 +1,47 @@
# global-shortcut
The `global-shortcut` module can register/unregister a global keyboard shortcut
in operating system, so that you can customize the operations for various shortcuts.
Note that the shortcut is global, even if the app does not get focused, it will still work.
`global-shortcut` 모듈은 사용자가 다양한 단축키 작업을 정의 할 수 있도록 운영체제의 전역 키보드 단축키를 설정 등록/해제 하는 방법을 제공합니다.
참고로 설정된 단축키는 어플리케이션이 백그라운드로 작동(창이 포커스 되지 않음) 할 때도 여전히 계속 작동합니다.
```javascript
var globalShortcut = require('global-shortcut');
// Register a 'ctrl+x' shortcut listener.
// 'ctrl+x' 단축키를 리스너에 등록합니다.
var ret = globalShortcut.register('ctrl+x', function() { console.log('ctrl+x is pressed'); })
if (!ret) {
console.log('registration failed');
}
// Check whether a shortcut is registered.
// 단축키가 등록되었는지 확인합니다.
console.log(globalShortcut.isRegistered('ctrl+x'));
// Unregister a shortcut.
// 단축키의 등록을 해제합니다.
globalShortcut.unregister('ctrl+x');
// Unregister all shortcuts.
// 모든 단축키의 등록을 해제합니다.
globalShortcut.unregisterAll();
```
## globalShortcut.register(accelerator, callback)
* `accelerator` [Accelerator](accelerator.md)
* `accelerator` [Accelerator](accelerator-ko.md)
* `callback` Function
Registers a global shortcut of `accelerator`, the `callback` would be called when
the registered shortcut is pressed by user.
`accelerator`로 표현된 전역 단축키를 등록합니다. 유저로부터 등록된 단축키가 눌렸을 경우 `callback` 함수가 호출됩니다.
## globalShortcut.isRegistered(accelerator)
* `accelerator` [Accelerator](accelerator.md)
* `accelerator` [Accelerator](accelerator-ko.md)
Returns `true` or `false` depending on if the shortcut `accelerator` is registered.
지정된 `accelerator` 단축키가 등록되었는지 여부를 확인합니다. 반환값은 boolean(true, false) 입니다.
## globalShortcut.unregister(accelerator)
* `accelerator` [Accelerator](accelerator.md)
* `accelerator` [Accelerator](accelerator-ko.md)
Unregisters the global shortcut of `keycode`.
`키코드`에 해당하는 전역 단축키를 등록 해제합니다.
## globalShortcut.unregisterAll()
Unregisters all the global shortcuts.
모든 전역 단축키 등록을 해제합니다.

View file

@ -1,20 +1,17 @@
# ipc (main process)
Handles asynchronous and synchronous message sent from a renderer process (web
page).
랜더러 프로세스(웹 페이지)로 부터 동기 또는 비동기로 메시지를 받아 처리합니다.
The messages sent from a renderer would be emitted to this module, the event name
is the `channel` when sending message. To reply a synchronous message, you need
to set `event.returnValue`, to send an asynchronous back to the sender, you can
use `event.sender.send(...)`.
랜더러로부터 발신된 메시지들은 모두 이 모듈에서 `channel` 이라는 특정 이벤트 이름을 통해 수신할 수 있습니다.
동기 메시지는 `event.returnValue`를 이용하여 반환값(답장)을 설정할 수 있습니다. 비동기 메시지라면 `event.sender.send(...)`를 사용하면 됩니다.
It's also possible to send messages from main process to the renderer process,
see [WebContents.send](browser-window.md#webcontentssendchannel-args) for more.
또한 메인 프로세스에서 랜더러 프로세스로 메시지를 보내는 것도 가능합니다.
자세한 내용은 [WebContents.send](browser-window-ko.md#webcontentssendchannel-args)를 참고 하세요.
An example of sending and handling messages:
보내진 메시지들을 처리하는 예제입니다:
```javascript
// In main process.
// 메인 프로세스에서 처리.
var ipc = require('ipc');
ipc.on('asynchronous-message', function(event, arg) {
console.log(arg); // prints "ping"
@ -28,7 +25,7 @@ ipc.on('synchronous-message', function(event, arg) {
```
```javascript
// In renderer process (web page).
// 랜더러 프로세스에서의 처리 (web page).
var ipc = require('ipc');
console.log(ipc.sendSync('synchronous-message', 'ping')); // prints "pong"
@ -42,8 +39,8 @@ ipc.send('asynchronous-message', 'ping');
### Event.returnValue
Assign to this to return an value to synchronous messages.
동기 메시지를 설정합니다.
### Event.sender
The `WebContents` that sent the message.
메시지를 보내온 sender `WebContents` 객체입니다.

View file

@ -1,29 +1,25 @@
# ipc (renderer)
The `ipc` module provides a few methods so you can send synchronous and
asynchronous messages to the main process, and also receive messages sent from
main process. If you want to make use of modules of main process from renderer
process, you might consider using the [remote](remote.md) module.
`ipc` 모듈은 메인 프로세스로 메시지를 동기 또는 비동기로 보내고 받을 수 있는 몇 가지 방법을 제공합니다.
만약 랜더러 프로세스에서 메인 프로세스의 모듈을 직접적으로 사용하고 싶다면 [remote](remote-ko.md) 모듈을 사용하는 것을 고려해보는 것이 좋습니다.
See [ipc (main process)](ipc-main-process.md) for examples.
[ipc (main process)](ipc-main-process-ko.md)에서 예제를 볼 수 있습니다.
## ipc.send(channel[, args...])
Send `args..` to the renderer via `channel` in asynchronous message, the main
process can handle it by listening to the `channel` event of `ipc` module.
지정한 `channel`을 통해 `args..`를 비동기로 메시지를 보냅니다. 메인 프로세스는 `ipc` 모듈의 `channel` 이벤트를 통해 메시지를 받을 수 있습니다.
## ipc.sendSync(channel[, args...])
Send `args..` to the renderer via `channel` in synchronous message, and returns
the result sent from main process. The main process can handle it by listening to
the `channel` event of `ipc` module, and returns by setting `event.returnValue`.
지정한 `channel`을 통해 `args..`를 동기로 메시지를 보냅니다. 그리고 메인 프로세스에서 보낸 결과를 반환합니다.
메인 프로세스는 `ipc` 모듈의 `channel` 이벤트를 통해 메시지를 받을 수 있습니다. 그리고 `event.returnValue`를 통해 반환값을 설정할 수 있습니다.
**Note:** Usually developers should never use this API, since sending
synchronous message would block the whole renderer process.
역자 주: `channel`은 이벤트 이름입니다.
**알림:** 보통 개발자들은 해당 API를 사용하려 하지 않습니다. 동기 ipc 작업은 랜더러 프로세스의 모든 작업을 중단시킵니다.
## ipc.sendToHost(channel[, args...])
Like `ipc.send` but the message will be sent to the host page instead of the
main process.
`ipc.send`와 비슷하지만 메시지를 메인 프로세스 대신 호스트 페이지로 보냅니다.
This is mainly used by the page in `<webview>` to communicate with host page.
이 메소드는 보통 `<webview>`와 호스트 페이지 간의 통신에 사용됩니다.

View file

@ -10,8 +10,8 @@
* `type` String - `MenuItem`의 타입 `normal`, `separator`, `submenu`, `checkbox` 또는 `radio` 사용가능
* `label` String
* `sublabel` String
* `accelerator` [Accelerator](accelerator.md)
* `icon` [NativeImage](native-image.md)
* `accelerator` [Accelerator](accelerator-ko.md)
* `icon` [NativeImage](native-image-ko.md)
* `enabled` Boolean
* `visible` Boolean
* `checked` Boolean

View file

@ -5,7 +5,7 @@ application menus and context menus. Each menu consists of multiple menu
items, and each menu item can have a submenu.
Below is an example of creating a menu dynamically in a web page by using
the [remote](remote.md) module, and showing it when the user right clicks
the [remote](remote-ko.md) module, and showing it when the user right clicks
the page:
```html
@ -191,7 +191,7 @@ emulating default Cocoa menu behaviors, usually you would just use the
* `template` Array
Generally, the `template` is just an array of `options` for constructing
[MenuItem](menu-item.md), the usage can be referenced above.
[MenuItem](menu-item-ko.md), the usage can be referenced above.
You can also attach other fields to element of the `template`, and they will
become properties of the constructed menu items.

View file

@ -1,9 +1,8 @@
# power-save-blocker
The `power-save-blocker` module is used to block the system from entering
low-power(sleep) mode, allowing app to keep system and screen active.
`power-save-blocker` 모듈은 시스템이 저전력 모드(슬립)로 진입하는 것을 막고 앱 및 화면이 항상 활성화되어 있는 상태를 만들 수 있도록 해줍니다.
An example is:
예제:
```javascript
var powerSaveBlocker = require('power-save-blocker');
@ -16,33 +15,29 @@ powerSaveBlocker.stop(id);
## powerSaveBlocker.start(type)
* `type` String - Power save blocker type
* `prevent-app-suspension` - Prevent the application from being suspended.
Keeps system active, but allows screen to be turned off. Example use cases:
downloading a file, playing audio.
* `prevent-display-sleep`- Prevent the display from going to sleep. Keeps system
and screen active. Example use case: playing video.
* `type` String - Power save blocker 종류
* `prevent-app-suspension` - 저전력 모드 등으로 인한 어플리케이션 작동 중단을 방지합니다.
시스템을 항시 활성화 상태로 만듭니다, 하지만 화면은 자동으로 꺼질 수 있습니다. 사용 예시: 파일 다운로드, 음악 재생 등.
* `prevent-display-sleep`- 슬립 모드 등으로 인한 어플리케이션의 작동 중단을 방지합니다.
시스템을 항시 활성화 상태로 만들고 슬립 모드(화면 꺼짐)를 방지합니다. 사용 예시: 비디오 재생 등.
Starts the power save blocker preventing the system entering lower-power mode.
Returns an integer identified the power save blocker.
Power save blocker를 시작하고 시스템이 저전력 모드(슬립)로 진입하는 것을 막습니다. 정수로 된 식별 ID를 반환합니다.
**Note:**
`prevent-display-sleep` has higher precedence level than `prevent-app-suspension`.
Only the highest precedence type takes effect. In other words, `prevent-display-sleep`
always take precedence over `prevent-app-suspension`.
**알림:**
`prevent-display-sleep` 모드는 `prevent-app-suspension` 보다 우선순위가 높습니다.
가장 높은 우선순위의 모드만 작동합니다. 다시 말해 `prevent-display-sleep` 모드는 언제나 `prevent-app-suspension` 모드의 효과를 덮어씌웁니다.
For example, an API calling A requests for `prevent-app-suspension`, and
another calling B requests for `prevent-display-sleep`. `prevent-display-sleep`
will be used until B stops its request. After that, `prevent-app-suspension` is used.
예를 들어 A-요청이 `prevent-app-suspension` 모드를 사용하고 B-요청이 `prevent-display-sleep`를 사용하는 API 호출이 있었다 치면
`prevent-display-sleep` 모드를 사용하는 B의 작동이 중단(stop)되기 전까지 작동하다 B가 중단되면 `prevent-app-suspension` 모드를 사용하는 A가 작동하기 시작합니다.
## powerSaveBlocker.stop(id)
* `id` Integer - The power save blocker id returned by `powerSaveBlocker.start`.
* `id` Integer - `powerSaveBlocker.start`로 부터 반환되는 power save blocker 식별 ID.
Stops the specified power save blocker.
설정한 power save blocker를 중지합니다.
## powerSaveBlocker.isStarted(id)
* `id` Integer - The power save blocker id returned by `powerSaveBlocker.start`.
* `id` Integer - `powerSaveBlocker.start`로 부터 반환되는 power save blocker 식별 ID.
Returns whether the corresponding `powerSaveBlocker` starts.
해당하는 id의 `powerSaveBlocker`가 실행중인지 확인합니다.

View file

@ -1,10 +1,8 @@
# protocol
The `protocol` module can register a new protocol or intercept an existing
protocol, so you can customize the response to the requests for various protocols.
`protocol` 모듈은 여러 프로토콜의 요청과 응답을 커스터마이즈 할 수 있도록 이미 있는 프로토콜을 변경하거나 새로운 프로토콜을 만드는 방법을 제공합니다.
An example of implementing a protocol that has the same effect with the
`file://` protocol:
다음 예제는 `file://` 프로토콜과 같은 일을 하는 커스텀 프로토콜을 설정합니다:
```javascript
var app = require('app');
@ -19,67 +17,63 @@ app.on('ready', function() {
});
```
**Note:** This module can only be used after the `ready` event
was emitted.
**알림:** 이 모듈은 app의 `ready` 이벤트가 발생한 이후에만 사용할 수 있습니다.
## protocol.registerProtocol(scheme, handler)
* `scheme` String
* `handler` Function
Registers a custom protocol of `scheme`, the `handler` would be called with
`handler(request)` when the a request with registered `scheme` is made.
지정한 `scheme`을 기반으로 커스텀 프로토콜을 등록합니다. 등록한 `scheme` 프로토콜에 요청이 들어올 경우 `request` 인자와 함께 `handler` 함수가 호출됩니다.
You need to return a request job in the `handler` to specify which type of
response you would like to send.
호출된 `handler` 함수에선 요청에 대한 해당 프로토콜의 작업 결과를 응답(반환) 해야 할 필요가 있습니다.
## protocol.unregisterProtocol(scheme)
* `scheme` String
Unregisters the custom protocol of `scheme`.
지정한 `scheme` 프로토콜을 등록 해제합니다.
## protocol.registerStandardSchemes(value)
* `value` Array
`value` is an array of custom schemes to be registered to the standard.
지정한 `value` 배열을 사용하여 미리 지정된 스킴으로 등록합니다.
## protocol.isHandledProtocol(scheme)
* `scheme` String
Returns whether the `scheme` can be handled already.
해당 `scheme`에 처리자(handler)가 등록되었는지 확인합니다.
## protocol.interceptProtocol(scheme, handler)
* `scheme` String
* `handler` Function
Intercepts an existing protocol with `scheme`, returning `null` or `undefined`
in `handler` would use the original protocol handler to handle the request.
지정한 `scheme`의 작업을 `handler`로 변경합니다.
`handler`에서 `null` 또는 `undefined`를 반환 할 경우 해당 프로토콜의 기본 동작(응답)으로 대체 됩니다.
## protocol.uninterceptProtocol(scheme)
* `scheme` String
Unintercepts a protocol.
변경된 프로토콜의 작업을 해제합니다.
## Class: protocol.RequestFileJob(path)
* `path` String
Create a request job which would query a file of `path` and set corresponding
mime types.
`path` 경로를 기반으로 파일을 반환하는 request 작업을 생성합니다. 그리고 해당 파일에 상응하는 mime type을 지정합니다.
## Class: protocol.RequestStringJob(options)
* `options` Object
* `mimeType` String - Default is `text/plain`
* `charset` String - Default is `UTF-8`
* `mimeType` String - `text/plain`이 기본
* `charset` String - `UTF-8`이 기본
* `data` String
Create a request job which sends a string as response.
문자열을 반환하는 request 작업을 생성합니다.
## Class: protocol.RequestBufferJob(options)
@ -88,7 +82,7 @@ Create a request job which sends a string as response.
* `encoding` String - Default is `UTF-8`
* `data` Buffer
Create a request job which sends a buffer as response.
버퍼를 반환하는 request 작업을 생성합니다.
## Class: protocol.RequestHttpJob(options)
@ -97,17 +91,16 @@ Create a request job which sends a buffer as response.
* `method` String - Default is `GET`
* `referrer` String
Send a request to `url` and pipe the response back.
`url`의 요청 결과를 그대로 반환하는 request 작업을 생성합니다.
## Class: protocol.RequestErrorJob(code)
* `code` Integer
Create a request job which sets appropriate network error message to console.
Default message is `net::ERR_NOT_IMPLEMENTED`. Code should be in the following
range.
콘솔에 특정한 네트워크 에러 메시지를 설정하는 request 작업을 생성합니다.
기본 메시지는 `net::ERR_NOT_IMPLEMENTED`입니다. 사용할 수 있는 코드의 범위는 다음과 같습니다.
* Ranges:
* 범위:
* 0- 99 System related errors
* 100-199 Connection related errors
* 200-299 Certificate errors
@ -118,4 +111,4 @@ range.
* 700-799 Certificate manager errors
* 800-899 DNS resolver errors
Check the [network error list](https://code.google.com/p/chromium/codesearch#chromium/src/net/base/net_error_list.h) for code and message relations.
에러 코드와 메시지에 대해 자세하게 알아보려면 [네트워크 에러 리스트](https://code.google.com/p/chromium/codesearch#chromium/src/net/base/net_error_list.h)를 참고하기 바랍니다.

View file

@ -20,7 +20,7 @@ var win = new BrowserWindow({ width: 800, height: 600 });
win.loadUrl('https://github.com');
```
Note: for the reverse (access renderer process from main process), you can use [webContents.executeJavascript](https://github.com/atom/electron/blob/master/docs/api/browser-window.md#browserwindowwebcontents).
Note: for the reverse (access renderer process from main process), you can use [webContents.executeJavascript](https://github.com/atom/electron/blob/master/docs/api/browser-window-ko.md#browserwindowwebcontents).
## Remote objects
@ -139,7 +139,7 @@ Returns the object returned by `require(module)` in the main process.
## remote.getCurrentWindow()
Returns the [BrowserWindow](browser-window.md) object which this web page
Returns the [BrowserWindow](browser-window-ko.md) object which this web page
belongs to.
## remote.getCurrentWebContent()

View file

@ -1,18 +1,14 @@
# Synopsis
# 개요
All of [node.js's built-in modules](http://nodejs.org/api/) are available in
Electron, and third-party node modules are fully supported too (including the
[native modules](../tutorial/using-native-node-modules.md)).
Electron은 모든 [node.js's built-in 모듈](http://nodejs.org/api/)과 third-party node 모듈을 완벽하게 지원합니다. ([네이티브 모듈](../tutorial/using-native-node-modules-ko.md)을 포함해서)
Electron also provides some extra built-in modules for developing native
desktop applications. Some modules are only available on the main process, some
are only available on the renderer process, and some can be used on both processes.
The basic rule is: if a module is GUI or low-level system related, then it should
be only available on the main process. You need to be familiar with the concept of
[main process vs. renderer process](../tutorial/quick-start.md#the-main-process)
scripts to be able to use those modules.
Electron은 네이티브 데스크톱 어플리케이션을 개발 할 수 있도록 추가적인 built-in 모듈을 제공합니다.
몇몇 모듈은 메인 프로세스에서만 사용할 수 있고 어떤 모듈은 랜더러 프로세스에서만 사용할 수 있습니다. 또한 두 프로세스 모두 사용할 수 있는 모듈도 있습니다.
기본적인 규칙은 다음과 같습니다: GUI와 저 수준 시스템에 관련된 모듈은 오직 메인 프로세스에서만 사용할 수 있습니다.
[메인 프로세스 vs. 랜더러 프로세스](../tutorial/quick-start-ko.md#메인 프로세스) 컨셉에 익숙해야 이 모듈들을 사용하기 쉬우므로 해당 문서를 정독하는 것을 권장합니다.
The main process script is just like a normal `node.js` script:
메인 프로세스 스크립트는 일반 `node.js` 스크립트와 같습니다:
```javascript
var app = require('app');
@ -26,8 +22,7 @@ app.on('ready', function() {
});
```
The web page is no different than a normal web page, except for the extra
ability to use node modules:
웹 페이지 역시 예외적인 node module을 사용할 수 있다는 점을 제외하면 일반 웹 페이지와 다를게 없습니다:
```html
<!DOCTYPE html>
@ -41,4 +36,4 @@ ability to use node modules:
</html>
```
To run your app, read [Run your app](../tutorial/quick-start.md#run-your-app).
어플리케이션을 실행하려면 [앱 실행하기](../tutorial/quick-start-ko.md#앱 실행하기) 문서를 참고하기 바랍니다.

View file

@ -1,8 +1,8 @@
# web-frame
# web-frame
The `web-frame` module can custom the rendering of current web page.
`web-frame` 모듈은 현재 웹 페이지의 랜더링 상태를 커스터마이즈 할 수 있도록 해줍니다.
An example of zooming current page to 200%.
다음 예제는 현재 페이지를 200% 줌 합니다.
```javascript
var webFrame = require('web-frame');
@ -11,26 +11,24 @@ webFrame.setZoomFactor(2);
## webFrame.setZoomFactor(factor)
* `factor` Number - Zoom factor
* `factor` Number - Zoom
Changes the zoom factor to the specified factor, zoom factor is
zoom percent / 100, so 300% = 3.0.
지정한 값으로 페이지를 줌 합니다. 줌 값은 퍼센트 / 100입니다. (예시: 300% = 3.0)
## webFrame.getZoomFactor()
Returns the current zoom factor.
현재 줌 값을 반환합니다.
## webFrame.setZoomLevel(level)
* `level` Number - Zoom level
Changes the zoom level to the specified level, 0 is "original size", and each
increment above or below represents zooming 20% larger or smaller to default
limits of 300% and 50% of original size, respectively.
지정한 레벨로 줌 레벨을 변경합니다. 0은 "기본 크기" 입니다.
그리고 각각 레벨 값을 올리거나 내릴 때마다 20%씩 커지거나 작아지고 기본 크기의 50%부터 300%까지 조절 제한이 있습니다.
## webFrame.getZoomLevel()
Returns the current zoom level.
현재 줌 레벨을 반환합니다.
## webFrame.setSpellCheckProvider(language, autoCorrectWord, provider)
@ -38,12 +36,11 @@ Returns the current zoom level.
* `autoCorrectWord` Boolean
* `provider` Object
Sets a provider for spell checking in input fields and text areas.
Input field나 text area에 철자 검사(spell checking) 제공자를 설정합니다.
The `provider` must be an object that has a `spellCheck` method that returns
whether the word passed is correctly spelled.
`provider`는 반드시 전달된 단어의 철자가 맞았는지 검사하는 `spellCheck` 메소드를 가지고 있어야 합니다.
An example of using [node-spellchecker][spellchecker] as provider:
[node-spellchecker][spellchecker]를 철자 검사 제공자로 사용하는 예제입니다:
```javascript
require('web-frame').setSpellCheckProvider("en-US", true, {
@ -57,10 +54,8 @@ require('web-frame').setSpellCheckProvider("en-US", true, {
* `scheme` String
Sets the `scheme` as secure scheme.
지정한 `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.
보안 스킴은 혼합된 컨텐츠 경고를 발생시키지 않습니다. 예를 들어 `https``data`는 네트워크 공격자로부터 손상될 가능성이 없기 때문에 보안 스킴입니다.
[spellchecker]: https://github.com/atom/node-spellchecker

View file

@ -1,12 +1,10 @@
# `window.open` function
# `window.open` 함수
When `window.open` is called to create a new window in web page, a new instance
of `BrowserWindow` will be created for the `url`, and a proxy will be returned
to `window.open` to let the page to have limited control over it.
`window.open` 함수가 호출되면 새 창에서 새로운 페이지를 불러옵니다.
이 창은 `url`로 부터 만들어진 `BrowserWindow`의 새 인스턴스이며 본 객체 대신 페이지의 컨트롤이 제한된 프록시 객체를 반환합니다.
The proxy only has some limited standard functionality implemented to be
compatible with traditional web pages, for full control of the created window
you should create a `BrowserWindow` directly.
프록시 객체는 기존의 웹 페이지와 호환될 수 있도록 일부 제한된 표준 기능만 가지고 있습니다.
창의 모든 컨트롤을 가지려면 `BrowserWindow`를 직접 생성하여 작업해야 합니다.
## window.open(url, [frameName[, features]])
@ -14,47 +12,46 @@ you should create a `BrowserWindow` directly.
* `frameName` String
* `features` String
Creates a new window and returns an instance of `BrowserWindowProxy` class.
`BrowserWindowProxy` 클래스의 객체를 반환하는 새로운 윈도우를 생성합니다.
## window.opener.postMessage(message, targetOrigin)
* `message` String
* `targetOrigin` String
Sends a message to the parent window with the specified origin or `*` for no
origin preference.
부모 윈도우에 메시지를 보냅니다. 특정한 origin을 지정할 수도 있으며 `*`를 지정하면 따로 origin 설정을 사용하지 않습니다.
## Class: BrowserWindowProxy
### BrowserWindowProxy.blur()
Removes focus from the child window.
자식 윈도우의 포커스를 해제합니다.
### BrowserWindowProxy.close()
자식 윈도우를 강제로 닫습니다. unload 이벤트가 발생하지 않습니다.
Forcefully closes the child window without calling its unload event.
### BrowserWindowProxy.closed
Set to true after the child window gets closed.
자식 윈도우가 닫히면 true로 설정됩니다.
### BrowserWindowProxy.eval(code)
* `code` String
Evaluates the code in the child window.
자식 윈도우에서 특정 스크립트를 실행합니다.
### BrowserWindowProxy.focus()
Focuses the child window (brings the window to front).
자식 윈도우에 포커스를 맞춥니다. (창을 맨 앞으로 가져옵니다)
### BrowserWindowProxy.postMessage(message, targetOrigin)
* `message` String
* `targetOrigin` String
Sends a message to the child window with the specified origin or `*` for no
origin preference.
자식 윈도우에 메시지를 보냅니다. 특정한 origin을 지정할 수도 있으며 `*`를 지정하면 따로 origin 설정을 사용하지 않습니다.
In addition to these methods, the child window implements `window.opener` object
with no properties and a single method:
참고로 자식 윈도우의 `window.opener` 객체에는 다른 속성 없이 이 함수 하나만 구현되어 있습니다.