Translate web-view-tag-tag-ko.md, improve grammer

This commit is contained in:
Plusb Preco 2015-07-30 09:56:27 +09:00
parent 11589a7bde
commit 05def654c3
4 changed files with 99 additions and 121 deletions

View file

@ -20,10 +20,7 @@ tracing.startRecording('*', tracing.DEFAULT_OPTIONS, function() {
* `callback` Function
카테고리 그룹 세트를 가져옵니다. 카테고리 그룹은 도달 대상이 되는 코드 경로를 변경할 수 있습니다.
Get a set of category groups. The category groups can change as new code paths
are reached.
카테고리 그룹 세트를 가져옵니다. 카테고리 그룹은 도달된 코드 경로를 변경할 수 있습니다.
Once all child processes have acked to the `getCategories` request, `callback`
is invoked with an array of category groups.

View file

@ -56,14 +56,14 @@ app.on('ready', function() {
* `event` Event
* `newDisplay` Object
새로운 디스플레이가 추가되면 발생니다.
새로운 디스플레이가 추가되면 발생하는 이벤트입니다.
## Event: display-removed
* `event` Event
* `oldDisplay` Object
기존의 디스플레이가 제거되면 발생니다.
기존의 디스플레이가 제거되면 발생하는 이벤트입니다.
## Event: display-metrics-changed
@ -71,7 +71,7 @@ app.on('ready', function() {
* `display` Object
* `changedMetrics` Array
`display`의 하나 또는 다수의 매트릭스가 변경될 경우 발생합니다.
`display`의 하나 또는 다수의 매트릭스가 변경될 때 발생하는 이벤트입니다.
`changedMetrics`는 변경에 대한 정보를 담은 문자열의 배열입니다.
`bounds`, `workArea`, `scaleFactor`, `rotation`등이 변경될 수 있습니다.

View file

@ -1,31 +1,24 @@
# `<webview>` 태그
Use the `webview` tag to embed 'guest' content (such as web pages) in your
Electron app. The guest content is contained within the `webview` container;
an embedder page within your app controls how the guest content is laid out and
rendered.
`guest` 컨텐츠(웹 페이지)를 Electron 앱 페이지에 삽입하기 위해 `webview` 태그를 사용할 수 있습니다.
게스트 컨텐츠는 `webview` 컨테이너에 담겨 대상 페이지에 삽입되고 해당 페이지에선 게스트 컨텐츠의 배치 및 렌더링 과정을 조작할 수 있습니다.
Different from the `iframe`, the `webview` runs in a separate process than your
app; it doesn't have the same permissions as your web page and all interactions
between your app and embedded content will be asynchronous. This keeps your app
safe from the embedded content.
`iframe``webview`의 차이는 어플리케이션과 프로세스가 분리되어 돌아간다는 점입니다.
그것은 모든 권한이 웹 페이지와 같지 않고 모든 앱과 임베디드(게스트) 컨텐츠간의 상호작용이 비동기로 작동한다는 것을 의미합니다.
이에 따라 임베디드 컨텐츠로부터 어플리케이션을 안전하게 유지할 수 있습니다.
## 예제
To embed a web page in your app, add the `webview` tag to your app's embedder
page (this is the app page that will display the guest content). In its simplest
form, the `webview` tag includes the `src` of the web page and css styles that
control the appearance of the `webview` container:
웹 페이지를 어플리케이션에 삽입하려면 `webview` 태그를 사용해 원하는 타겟 페이지에 추가하면 됩니다. (게스트 컨텐츠가 앱 페이지에 추가 됩니다)
간단한 예로 `webview` 태그의 `src` 속성에 페이지를 지정하고 css 스타일을 이용해서 컨테이너의 외관을 설정할 수 있습니다:
```html
<webview id="foo" src="https://www.github.com/" style="display:inline-block; width:640px; height:480px"></webview>
```
If you want to control the guest content in any way, you can write JavaScript
that listens for `webview` events and responds to those events using the
`webview` methods. Here's sample code with two event listeners: one that listens
for the web page to start loading, the other for the web page to stop loading,
and displays a "loading..." message during the load time:
게스트 컨텐츠를 조작하기 위해 자바스크립트로 `webview` 태그의 이벤트를 리스닝 하여 응답을 받을 수 있습니다.
다음 예제를 참고하세요: 첫번째 리스너는 페이지 로딩 시작시의 이벤트를 확인하고 두번째 리스너는 페이지의 로딩이 끝난시점을 확인합니다.
그리고 페이지를 로드하는 동안 "loading..." 메시지를 표시합니다.
```html
<script>
@ -53,13 +46,11 @@ and displays a "loading..." message during the load time:
<webview src="https://www.github.com/"></webview>
```
Returns the visible URL. Writing to this attribute initiates top-level
navigation.
지정한 URL을 페이지 소스로 사용합니다. 이 속성을 지정할 경우 `webview`의 최상위 페이지가 됩니다.
Assigning `src` its own value will reload the current page.
`src`에 같은 페이지를 지정하면 페이지를 새로고침합니다.
The `src` attribute can also accept data URLs, such as
`data:text/plain,Hello, world!`.
`src` 속성은 `data:text/plain,Hello, world!` 같은 data URL도 사용할 수 있습니다.
### autosize
@ -67,11 +58,9 @@ The `src` attribute can also accept data URLs, such as
<webview src="https://www.github.com/" autosize="on" minwidth="576" minheight="432"></webview>
```
If "on", the `webview` container will automatically resize within the
bounds specified by the attributes `minwidth`, `minheight`, `maxwidth`, and
`maxheight`. These contraints do not impact the `webview` UNLESS `autosize` is
enabled. When `autosize` is enabled, the `webview` container size cannot be less
than the minimum values or greater than the maximum.
"on" 으로 지정하면 `webview` 컨테이너는 `minwidth`, `minheight`, `maxwidth`, `maxheight`에 맞춰서 자동으로 크기를 조절합니다.
이 조건은 `autosize`가 활성화되어있지 않는 한 따로 영향을 주지 않습니다.
`autosize`가 활성화 되어있으면 `webview` 컨테이너의 크기는 각각의 지정한 최대, 최소값에 따라 조절됩니다.
### nodeintegration
@ -79,8 +68,8 @@ than the minimum values or greater than the maximum.
<webview src="http://www.google.com/" nodeintegration></webview>
```
If "on", the guest page in `webview` will have node integration and can use node
APIs like `require` and `process` to access low level system resources.
"on"으로 지정하면 `webview` 페이지 내에서 `require``process 객체`같은 node.js API를 사용할 수 있습니다.
이를 지정하면 내부에서 로우레벨 리소스에 접근할 수 있습니다.
### plugins
@ -88,7 +77,7 @@ APIs like `require` and `process` to access low level system resources.
<webview src="https://www.github.com/" plugins></webview>
```
If "on", the guest page in `webview` will be able to use browser plugins.
"on"으로 지정하면 `webview` 내부에서 브라우저 플러그인을 사용할 수 있습니다.
### preload
@ -96,13 +85,12 @@ If "on", the guest page in `webview` will be able to use browser plugins.
<webview src="https://www.github.com/" preload="./test.js"></webview>
```
Specifies a script that will be loaded before other scripts run in the guest
page. The protocol of script's URL must be either `file:` or `asar:`, because it
will be loaded by `require` in guest page under the hood.
게스트 페이지가 로드되기 전에 실행할 스크립트를 지정합니다.
스크립트 URL은 `file:` 또는 `asar:` 프로토콜 중 하나를 반드시 사용해야 합니다.
왜냐하면 `require`를 사용해 게스트 페이지 내에서 스크립트를 로드하기 때문입니다.
When the guest page doesn't have node integration this script will still have
access to all Node APIs, but global objects injected by Node will be deleted
after this script has done execution.
게스트 페이지가 nodeintegration을 활성화 하지 않았어도 지정된 스크립트는 정상적으로 돌아갑니다.
하지만 스크립트 내에서 사용할 수 있는 global 객체는 스크립트 작동이 끝나면 삭제됩니다.
### httpreferrer
@ -110,7 +98,7 @@ after this script has done execution.
<webview src="https://www.github.com/" httpreferrer="http://cheng.guru"></webview>
```
Sets the referrer URL for the guest page.
게스트 페이지의 referrer URL을 설정합니다.
### useragent
@ -118,7 +106,7 @@ Sets the referrer URL for the guest page.
<webview src="https://www.github.com/" useragent="Mozilla/5.0 (Windows NT 6.1; WOW64; Trident/7.0; AS; rv:11.0) like Gecko"></webview>
```
Sets the user agent for the guest page before the page is navigated to. Once the page is loaded, use the `setUserAgent` method to change the user agent.
게스트 페이지의 `User-Agent`를 설정합니다. 페이지가 로드된 후엔 `setUserAgent` 메소드를 사용해서 변경할 수 있습니다.
### disablewebsecurity
@ -126,12 +114,13 @@ Sets the user agent for the guest page before the page is navigated to. Once the
<webview src="https://www.github.com/" disablewebsecurity></webview>
```
If "on", the guest page will have web security disabled.
"on"으로 지정하면 게스트 페이지의 웹 보안을 해제합니다.
## API
The webview element must be loaded before using the methods.
**Example**
webview 메서드는 페이지 로드가 끝난 뒤에만 사용할 수 있습니다.
**예제**
```javascript
webview.addEventListener("dom-ready", function() {
webview.openDevTools();
@ -140,206 +129,202 @@ webview.addEventListener("dom-ready", function() {
### `<webview>`.getUrl()
Returns URL of guest page.
게스트 페이지의 URL을 반환합니다.
### `<webview>`.getTitle()
Returns the title of guest page.
게스트 페이지의 제목을 반환합니다.
### `<webview>`.isLoading()
Returns whether guest page is still loading resources.
페이지가 아직 리소스를 로딩하고 있는지 확인합니다.
### `<webview>`.isWaitingForResponse()
Returns whether guest page is waiting for a first-response for the main resource
of the page.
게스트 페이지가 메인 리소스의 첫 응답을 기다리고 있는지 확인합니다.
### `<webview>`.stop()
Stops any pending navigation.
모든 탐색을 취소합니다.
### `<webview>`.reload()
Reloads guest page.
페이지를 새로고침합니다.
### `<webview>`.reloadIgnoringCache()
Reloads guest page and ignores cache.
캐시를 무시하고 페이지를 새로고침합니다.
### `<webview>`.canGoBack()
Returns whether guest page can go back.
페이지 히스토리를 한 칸 뒤로 가기를 할 수 있는지 확인합니다.
### `<webview>`.canGoForward()
Returns whether guest page can go forward.
페이지 히스토리를 한 칸 앞으로 가기를 할 수 있는지 확인합니다.
### `<webview>`.canGoToOffset(offset)
* `offset` Integer
Returns whether guest page can go to `offset`.
페이지 히스토리를 `offset` 만큼 이동할 수 있는지 확인합니다.
### `<webview>`.clearHistory()
Clears the navigation history.
탐색 히스토리를 비웁니다.
### `<webview>`.goBack()
Makes guest page go back.
페이지 뒤로 가기를 실행합니다.
### `<webview>`.goForward()
Makes guest page go forward.
페이지 앞으로 가기를 실행합니다.
### `<webview>`.goToIndex(index)
* `index` Integer
Navigates to the specified absolute index.
페이지를 지정한 `index`로 이동합니다.
### `<webview>`.goToOffset(offset)
* `offset` Integer
Navigates to the specified offset from the "current entry".
현재 페이지로 부터 `offset` 만큼 이동합니다.
### `<webview>`.isCrashed()
Whether the renderer process has crashed.
랜더러 프로세스가 크래시 됬는지 확인합니다.
### `<webview>`.setUserAgent(userAgent)
* `userAgent` String
Overrides the user agent for guest page.
`User-Agent`를 지정합니다.
### `<webview>`.getUserAgent()
Returns a `String` represents the user agent for guest page.
현재 페이지의 `User-Agent` 문자열을 가져옵니다.
### `<webview>`.insertCSS(css)
* `css` String
Injects CSS into guest page.
게스트 페이지에 CSS를 삽입합니다.
### `<webview>`.executeJavaScript(code)
* `code` String
Evaluates `code` in guest page.
게스트 페이지에서 자바스크립트 `code`를 실행합니다.
### `<webview>`.openDevTools()
Opens a devtools window for guest page.
게스트 페이지에 대한 개발자 툴을 엽니다.
### `<webview>`.closeDevTools()
Closes the devtools window of guest page.
게스트 페이지에 대한 개발자 툴을 닫습니다.
### `<webview>`.isDevToolsOpened()
Returns whether guest page has a devtools window attached.
게스트 페이지에 대한 개발자 툴이 열려있는지 확인합니다.
### `<webview>`.inspectElement(x, y)
* `x` Integer
* `y` Integer
Starts inspecting element at position (`x`, `y`) of guest page.
(`x`, `y`) 위치에 있는 엘리먼트를 inspect합니다.
### `<webview>`.inspectServiceWorker()
Opens the devtools for the service worker context present in the guest page.
Service worker에 대한 개발자 툴을 엽니다.
### `<webview>`.undo()
Executes editing command `undo` in page.
페이지에서 실행 취소 커맨드를 실행합니다.
### `<webview>`.redo()
Executes editing command `redo` in page.
페이지에서 다시 실행 커맨드를 실행합니다.
### `<webview>`.cut()
Executes editing command `cut` in page.
페이지에서 잘라내기 커맨드를 실행합니다.
### `<webview>`.copy()
Executes editing command `copy` in page.
페이지에서 복사 커맨드를 실행합니다.
### `<webview>`.paste()
Executes editing command `paste` in page.
페이지에서 붙여넣기 커맨드를 실행합니다.
### `<webview>`.pasteAndMatchStyle()
Executes editing command `pasteAndMatchStyle` in page.
페이지에서 `pasteAndMatchStyle` 편집 커맨드를 실행합니다.
### `<webview>`.delete()
Executes editing command `delete` in page.
페이지에서 삭제 커맨드를 실행합니다.
### `<webview>`.selectAll()
Executes editing command `selectAll` in page.
페이지에서 전체 선택 커맨드를 실행합니다.
### `<webview>`.unselect()
Executes editing command `unselect` in page.
페이지에서 `unselect` 커맨드를 실행합니다.
### `<webview>`.replace(text)
* `text` String
Executes editing command `replace` in page.
페이지에서 `replace` 커맨드를 실행합니다.
### `<webview>`.replaceMisspelling(text)
* `text` String
Executes editing command `replaceMisspelling` in page.
페이지에서 `replaceMisspelling` 커맨드를 실행합니다.
### `<webview>`.send(channel[, args...])
* `channel` String
Send `args..` to guest page via `channel` in asynchronous message, the guest
page can handle it by listening to the `channel` event of `ipc` module.
`channel`을 통해 게스트 페이지에 `args...` 비동기 메시지를 보냅니다.
게스트 페이지에선 `ipc` 모듈의 `channel` 이벤트를 사용하면 이 메시지를 받을 수 있습니다.
See [WebContents.send](browser-window-ko.md#webcontentssendchannel-args) for
examples.
예제는 [WebContents.send](browser-window-ko.md#webcontentssendchannel-args)를 참고하세요.
## DOM 이벤트
### did-finish-load
Fired when the navigation is done, i.e. the spinner of the tab will stop
spinning, and the `onload` event was dispatched.
탐색이 끝나면 발생하는 이벤트입니다. 브라우저 탭의 스피너가 멈추고 `onload` 이벤트가 발생될 때를 생각하면 됩니다.
### did-fail-load
* `errorCode` Integer
* `errorDescription` String
This event is like `did-finish-load`, but fired when the load failed or was
cancelled, e.g. `window.stop()` is invoked.
`did-finish-load`와 비슷합니다. 하지만 이 이벤트는 `window.stop()`과 같은 무언가로 인해 로드에 실패했을 때 발생하는 이벤트입니다.
### did-frame-finish-load
* `isMainFrame` Boolean
Fired when a frame has done navigation.
프레임의 탐색이 끝나면 발생하는 이벤트입니다.
### did-start-loading
Corresponds to the points in time when the spinner of the tab starts spinning.
브라우저 탭의 스피너가 돌기 시작할 때 처럼 페이지의 로드가 시작될 때 발생하는 이벤트입니다.
### did-stop-loading
Corresponds to the points in time when the spinner of the tab stops spinning.
브라우저 탭의 스피너가 멈출 때 처럼 페이지의 로드가 끝나면 발생하는 이벤트입니다.
### did-get-response-details
@ -351,8 +336,8 @@ Corresponds to the points in time when the spinner of the tab stops spinning.
* `referrer` String
* `headers` Object
Fired when details regarding a requested resource is available.
`status` indicates socket connection to download the resource.
요청한 리소스에 관해 자세한 내용을 알 수 있을 때 발생하는 이벤트입니다.
`status`는 리소스를 다운로드할 소켓 커낵션을 나타냅니다.
### did-get-redirect-request
@ -360,33 +345,32 @@ Fired when details regarding a requested resource is available.
* `newUrl` String
* `isMainFrame` Boolean
Fired when a redirect was received while requesting a resource.
리소스를 요청하고 받는 도중에 리다이렉트가 생기면 발생하는 이벤트입니다.
### dom-ready
Fired when document in the given frame is loaded.
현재 프레임 문서의 로드가 끝나면 발생하는 이벤트입니다.
### page-title-set
* `title` String
* `explicitSet` Boolean
Fired when page title is set during navigation. `explicitSet` is false when title is synthesised from file
url.
탐색하는 동안에 페이지의 제목이 설정되면 발생하는 이벤트입니다. `explicitSet`는 파일 URL에서 종합(synthesised)된 제목인 경우 false로 표시됩니다.
### page-favicon-updated
* `favicons` Array - Array of Urls
Fired when page receives favicon urls.
페이지가 favicon URL을 받았을 때 발생하는 이벤트입니다.
### enter-html-full-screen
Fired when page enters fullscreen triggered by html api.
페이지가 HTML API에 의해 전체 화면 모드에 돌입했을 때 발생하는 이벤트입니다.
### leave-html-full-screen
Fired when page leaves fullscreen triggered by html api.
페이지의 전체 화면 모드가 해제됬을 때 발생하는 이벤트입니다.
### console-message
@ -395,10 +379,9 @@ Fired when page leaves fullscreen triggered by html api.
* `line` Integer
* `sourceId` String
Fired when the guest window logs a console message.
`console.log` API에 의해 로깅될 때 발생하는 이벤트입니다.
The following example code forwards all log messages to the embedder's console
without regard for log level or other properties.
다음 예제는 모든 로그 메시지를 로그 레벨이나 다른 속성에 관련 없이 호스트 페이지의 콘솔에 다시 로깅하는 예제입니다.
```javascript
webview.addEventListener('console-message', function(e) {
@ -413,9 +396,9 @@ webview.addEventListener('console-message', function(e) {
* `disposition` String - Can be `default`, `foreground-tab`, `background-tab`,
`new-window` and `other`
Fired when the guest page attempts to open a new browser window.
게스트 페이지가 새로운 브라우저 창을 생성할 때 발생하는 이벤트입니다.
The following example code opens the new url in system's default browser.
다음 예제 코드는 새 URL을 시스템의 기본 브라우저로 여는 코드입니다.
```javascript
webview.addEventListener('new-window', function(e) {
@ -425,10 +408,9 @@ webview.addEventListener('new-window', function(e) {
### close
Fired when the guest page attempts to close itself.
게스트 페이지가 자체적으로 닫힐 때 발생하는 이벤트입니다.
The following example code navigates the `webview` to `about:blank` when the
guest attempts to close itself.
다음 예제 코드는 게스트 페이지가 자체적으로 닫힐 때 `webview``about:blank` 페이지로 이동시키는 예제입니다.
```javascript
webview.addEventListener('close', function() {
@ -441,10 +423,9 @@ webview.addEventListener('close', function() {
* `channel` String
* `args` Array
Fired when the guest page has sent an asynchronous message to embedder page.
호스트 페이지에서 비동기 IPC 메시지를 보낼 때 발생하는 이벤트입니다.
With `sendToHost` method and `ipc-message` event you can easily communicate
between guest page and embedder page:
`sendToHost` 메소드와 `ipc-message` 이벤트로 호스트 페이지와 쉽게 통신을 할 수 있습니다:
```javascript
// In embedder page.
@ -465,19 +446,19 @@ ipc.on('ping', function() {
### crashed
Fired when the renderer process is crashed.
랜더러 프로세스가 크래시 되었을 때 발생하는 이벤트입니다.
### gpu-crashed
Fired when the gpu process is crashed.
GPU 프로세스가 크래시 되었을 때 발생하는 이벤트입니다.
### plugin-crashed
* `name` String
* `version` String
Fired when a plugin process is crashed.
플러그인 프로세스가 크래시 되었을 때 발생하는 이벤트입니다.
### destroyed
Fired when the WebContents is destroyed.
WebContents가 파괴될 때 발생하는 이벤트입니다.

View file

@ -93,7 +93,7 @@ Traceback (most recent call last):
subprocess.CalledProcessError: Command '['npm.cmd', 'install']' returned non-zero exit status 3
```
이 버그는 Cygwin python과 Win32 node를 같이 사용할 경우 발생합니다.
이 버그는 Cygwin python과 Win32 node를 같이 사용할 발생합니다.
부트스트랩 스크립트에서 Win32 python을 사용함으로써 이 문제를 해결할 수 있습니다 (`C:\Python27` 디렉터리에 python이 설치되었다는 것을 가정하면):
```bash