📝 Update as upstream
[ci skip]
This commit is contained in:
Plusb Preco
Cheng Zhao
parent
26f9f83cfd
commit
2f99a1ac8e
5 changed files with 142 additions and 6 deletions
|
|
@ -49,12 +49,14 @@ API 레퍼런스가 있습니다. Electron을 빌드 하는 방법과 프로젝
|
|||
|
||||
## 참조 문서 (번역)
|
||||
|
||||
- [브라질 포르투칼어](https://github.com/atom/electron/tree/master/docs-translations/pt-BR)
|
||||
- [브라질 포르투갈어](https://github.com/atom/electron/tree/master/docs-translations/pt-BR)
|
||||
- [한국어](https://github.com/atom/electron/tree/master/docs-translations/ko-KR)
|
||||
- [일본어](https://github.com/atom/electron/tree/master/docs-translations/jp)
|
||||
- [스페인어](https://github.com/atom/electron/tree/master/docs-translations/es)
|
||||
- [중국어 간체](https://github.com/atom/electron/tree/master/docs-translations/zh-CN)
|
||||
- [중국어 번체](https://github.com/atom/electron/tree/master/docs-translations/zh-TW)
|
||||
- [우크라이나어](https://github.com/atom/electron/tree/master/docs-translations/uk-UA)
|
||||
- [러시아어](https://github.com/atom/electron/tree/master/docs-translations/ru-RU)
|
||||
|
||||
## 시작하기
|
||||
|
||||
|
|
@ -68,6 +70,7 @@ API 레퍼런스가 있습니다. Electron을 빌드 하는 방법과 프로젝
|
|||
- Atom 포럼의 [`electron`](http://discuss.atom.io/c/electron) 카테고리
|
||||
- Freenode 채팅의 `#atom-shell` 채널
|
||||
- Slack의 [`Atom`](http://atom-slack.herokuapp.com/) 채널
|
||||
- [`electron-br`](https://electron-br.slack.com) *(브라질 포르투갈어)*
|
||||
|
||||
[awesome-electron](https://github.com/sindresorhus/awesome-electron) 프로젝트에
|
||||
커뮤니티가 운영중인 유용한 예제 어플리케이션과 도구, 리소스가 있으니 한번 참고해 보시기
|
||||
|
|
|
|||
|
|
@ -135,7 +135,7 @@ Returns:
|
|||
|
||||
[browserWindow](browser-window.md)에 대한 포커스가 발생했을 때 발생하는 이벤트 입니다.
|
||||
|
||||
**역주:** _포커스_는 창을 클릭해서 활성화 시켰을 때를 말합니다.
|
||||
**역주:** _포커스_ 는 창을 클릭해서 활성화 시켰을 때를 말합니다.
|
||||
|
||||
### Event: 'browser-window-created'
|
||||
|
||||
|
|
@ -351,7 +351,7 @@ Windows에서 사용할 수 있는 JumpList의 [Tasks][tasks] 카테고리에 `t
|
|||
|
||||
`tasks`는 다음과 같은 구조를 가지는 `Task` 객체의 배열입니다:
|
||||
|
||||
`Task` Object
|
||||
`Task` Object:
|
||||
* `program` String - 실행할 프로그램의 경로.
|
||||
보통 현재 작동중인 어플리케이션의 경로인 `process.execPath`를 지정합니다.
|
||||
* `arguments` String - `program`이 실행될 때 사용될 명령줄 인자.
|
||||
|
|
@ -378,7 +378,7 @@ Windows에서 사용할 수 있는 JumpList의 [Tasks][tasks] 카테고리에 `t
|
|||
|
||||
* `callback` Function
|
||||
|
||||
현재 어플리케이션을 **Single Instance Application**으로 만들어줍니다.
|
||||
현재 어플리케이션을 **Single Instance Application** 으로 만들어줍니다.
|
||||
이 메서드는 어플리케이션이 여러 번 실행됐을 때 다중 인스턴스가 생성되는 대신 한 개의
|
||||
주 인스턴스만 유지되도록 만들 수 있습니다. 이때 중복 생성된 인스턴스는 주 인스턴스에
|
||||
신호를 보내고 종료됩니다.
|
||||
|
|
@ -397,7 +397,7 @@ Windows에서 사용할 수 있는 JumpList의 [Tasks][tasks] 카테고리에 `t
|
|||
중복 생성된 인스턴스는 즉시 종료시켜야 합니다.
|
||||
|
||||
OS X에선 사용자가 Finder에서 어플리케이션의 두 번째 인스턴스를 열려고 했을 때 자동으로
|
||||
**Single Instance**화 하고 `open-file`과 `open-url` 이벤트를 발생시킵니다. 그러나
|
||||
**Single Instance** 화 하고 `open-file`과 `open-url` 이벤트를 발생시킵니다. 그러나
|
||||
사용자가 어플리케이션을 CLI 터미널에서 실행하면 운영체제 시스템의 싱글 인스턴스
|
||||
메커니즘이 무시되며 그대로 중복 실행됩니다. 따라서 OS X에서도 이 메서드를 통해 확실히
|
||||
중복 실행을 방지하는 것이 좋습니다.
|
||||
|
|
|
|||
|
|
@ -57,7 +57,7 @@ Electron이 세미콜론으로 구분된 호스트 리스트에서 지정한 프
|
|||
예시:
|
||||
|
||||
```javascript
|
||||
app.commandLine.appendSwitch('proxy-bypass-list', '<local>;*.google.com;*foo.com;1.2.3.4:5678')`
|
||||
app.commandLine.appendSwitch('proxy-bypass-list', '<local>;*.google.com;*foo.com;1.2.3.4:5678');
|
||||
```
|
||||
|
||||
위 예시는 로컬 주소(`localhost`, `127.0.0.1`, 등)와 `google.com`의 서브도메인,
|
||||
|
|
|
|||
|
|
@ -219,6 +219,20 @@ Returns:
|
|||
|
||||
[`app`의 `login`이벤트](app.md#event-login)와 사용 방법은 같습니다.
|
||||
|
||||
### Event: 'found-in-page'
|
||||
|
||||
Returns:
|
||||
|
||||
* `event` Event
|
||||
* `result` Object
|
||||
* `requestId` Integer
|
||||
* `finalUpdate` Boolean - 더 많은 응답이 따르는 경우를 표시합니다.
|
||||
* `matches` Integer (Optional) - 일치하는 개수.
|
||||
* `selectionArea` Object (Optional) - 첫 일치 부위의 좌표.
|
||||
|
||||
[`webContents.findInPage`](web-contents.md#webcontentsfindinpage) 요청의 결과를
|
||||
사용할 수 있을 때 발생하는 이벤트입니다.
|
||||
|
||||
### Event: 'media-started-playing'
|
||||
|
||||
미디어가 재생되기 시작할 때 발생하는 이벤트입니다.
|
||||
|
|
@ -227,6 +241,15 @@ Returns:
|
|||
|
||||
미디어가 중지되거나 재생이 완료되었을 때 발생하는 이벤트입니다.
|
||||
|
||||
### Event: 'did-change-theme-color'
|
||||
|
||||
페이지의 테마 색이 변경될 때 발생하는 이벤트입니다. 이 이벤트는 보통 meta 태그에
|
||||
의해서 발생합니다:
|
||||
|
||||
```html
|
||||
<meta name='theme-color' content='#ff0000'>
|
||||
```
|
||||
|
||||
## Instance Methods
|
||||
|
||||
`webContents`객체는 다음과 같은 인스턴스 메서드들을 가지고 있습니다.
|
||||
|
|
@ -417,6 +440,46 @@ CSS 코드를 현재 웹 페이지에 삽입합니다.
|
|||
|
||||
웹 페이지에서 `replaceMisspelling` 편집 커맨드를 실행합니다.
|
||||
|
||||
### `webContents.findInPage(text[, options])`
|
||||
|
||||
* `text` String - 찾을 컨텐츠, 반드시 공백이 아니여야 합니다.
|
||||
* `options` Object (Optional)
|
||||
* `forward` Boolean - 앞에서부터 검색할지 뒤에서부터 검색할지 여부입니다. 기본값은
|
||||
`true`입니다.
|
||||
* `findNext` Boolean - 작업을 계속 처리할지 첫 요청만 처리할지 여부입니다. 기본값은
|
||||
`false`입니다.
|
||||
* `matchCase` Boolean - 검색이 대소문자를 구분할지 여부입니다. 기본값은
|
||||
`false`입니다.
|
||||
* `wordStart` Boolean - 단어의 시작 부분만 볼 지 여부입니다. 기본값은
|
||||
`false`입니다.
|
||||
* `medialCapitalAsWordStart` Boolean - `wordStart`와 합쳐질 때, 소문자 또는
|
||||
비문자가 따라붙은 대문자로 일치가 시작하는 경우 단어 중간의 일치를 허용합니다.
|
||||
여러가지 다른 단어 내의 일치를 허용합니다. 기본값은 `false`입니다.
|
||||
|
||||
웹 페이지에서 `text`에 일치하는 모든 대상을 찾는 요청을 시작하고 요청에 사용된 요청을
|
||||
표현하는 `정수(integer)`를 반환합니다. 요청의 결과는
|
||||
[`found-in-page`](web-contents.md#event-found-in-page) 이벤트를 통해 취득할 수
|
||||
있습니다.
|
||||
|
||||
### `webContents.stopFindInPage(action)`
|
||||
|
||||
* `action` String - [`webContents.findInPage`](web-contents.md#webcontentfindinpage)
|
||||
요청이 종료되었을 때 일어날 수 있는 작업을 지정합니다.
|
||||
* `clearSelection` - 선택을 일반 선택으로 변경합니다.
|
||||
* `keepSelection` - 선택을 취소합니다.
|
||||
* `activateSelection` - 포커스한 후 선택된 노드를 클릭합니다.
|
||||
|
||||
제공된 `action`에 대한 `webContents`의 모든 `findInPage` 요청을 중지합니다.
|
||||
|
||||
```javascript
|
||||
webContents.on('found-in-page', function(event, result) {
|
||||
if (result.finalUpdate)
|
||||
webContents.stopFindInPage("clearSelection");
|
||||
});
|
||||
|
||||
const requestId = webContents.findInPage("api");
|
||||
```
|
||||
|
||||
### `webContents.hasServiceWorker(callback)`
|
||||
|
||||
* `callback` Function
|
||||
|
|
|
|||
|
|
@ -336,6 +336,37 @@ Service worker에 대한 개발자 도구를 엽니다.
|
|||
|
||||
페이지에서 `replaceMisspelling` 커맨드를 실행합니다.
|
||||
|
||||
### `webContents.findInPage(text[, options])`
|
||||
|
||||
* `text` String - 찾을 컨텐츠, 반드시 공백이 아니여야 합니다.
|
||||
* `options` Object (Optional)
|
||||
* `forward` Boolean - 앞에서부터 검색할지 뒤에서부터 검색할지 여부입니다. 기본값은
|
||||
`true`입니다.
|
||||
* `findNext` Boolean - 작업을 계속 처리할지 첫 요청만 처리할지 여부입니다. 기본값은
|
||||
`false`입니다.
|
||||
* `matchCase` Boolean - 검색이 대소문자를 구분할지 여부입니다. 기본값은
|
||||
`false`입니다.
|
||||
* `wordStart` Boolean - 단어의 시작 부분만 볼 지 여부입니다. 기본값은
|
||||
`false`입니다.
|
||||
* `medialCapitalAsWordStart` Boolean - `wordStart`와 합쳐질 때, 소문자 또는
|
||||
비문자가 따라붙은 대문자로 일치가 시작하는 경우 단어 중간의 일치를 허용합니다.
|
||||
여러가지 다른 단어 내의 일치를 허용합니다. 기본값은 `false`입니다.
|
||||
|
||||
웹 페이지에서 `text`에 일치하는 모든 대상을 찾는 요청을 시작하고 요청에 사용된 요청을
|
||||
표현하는 `정수(integer)`를 반환합니다. 요청의 결과는
|
||||
[`found-in-page`](web-view-tag.md#event-found-in-page) 이벤트를 통해 취득할 수
|
||||
있습니다.
|
||||
|
||||
### `webContents.stopFindInPage(action)`
|
||||
|
||||
* `action` String - [`<webview>.findInPage`](web-view-tag.md#webviewtagfindinpage)
|
||||
요청이 종료되었을 때 일어날 수 있는 작업을 지정합니다.
|
||||
* `clearSelection` - 선택을 일반 선택으로 변경합니다.
|
||||
* `keepSelection` - 선택을 취소합니다.
|
||||
* `activateSelection` - 포커스한 후 선택된 노드를 클릭합니다.
|
||||
|
||||
제공된 `action`에 대한 `webContents`의 모든 `findInPage` 요청을 중지합니다.
|
||||
|
||||
### `<webview>.print([options])`
|
||||
|
||||
Webview 페이지를 인쇄합니다. `webContents.print([options])` 메서드와 같습니다.
|
||||
|
|
@ -488,6 +519,28 @@ webview.addEventListener('console-message', function(e) {
|
|||
});
|
||||
```
|
||||
|
||||
### Event: 'found-in-page'
|
||||
|
||||
Returns:
|
||||
|
||||
* `result` Object
|
||||
* `requestId` Integer
|
||||
* `finalUpdate` Boolean - 더 많은 응답이 따르는 경우를 표시합니다.
|
||||
* `matches` Integer (Optional) - 일치하는 개수.
|
||||
* `selectionArea` Object (Optional) - 첫 일치 부위의 좌표.
|
||||
|
||||
[`webContents.findInPage`](web-contents.md#webcontentsfindinpage) 요청의 결과를
|
||||
사용할 수 있을 때 발생하는 이벤트입니다.
|
||||
|
||||
```javascript
|
||||
webview.addEventListener('found-in-page', function(e) {
|
||||
if (e.result.finalUpdate)
|
||||
webview.stopFindInPage("keepSelection");
|
||||
});
|
||||
|
||||
const rquestId = webview.findInPage("test");
|
||||
```
|
||||
|
||||
### Event: 'new-window'
|
||||
|
||||
Returns:
|
||||
|
|
@ -570,3 +623,20 @@ Returns:
|
|||
### Event: 'destroyed'
|
||||
|
||||
WebContents가 파괴될 때 발생하는 이벤트입니다.
|
||||
|
||||
### Event: 'media-started-playing'
|
||||
|
||||
미디어가 재생되기 시작할 때 발생하는 이벤트입니다.
|
||||
|
||||
### Event: 'media-paused'
|
||||
|
||||
미디어가 중지되거나 재생이 완료되었을 때 발생하는 이벤트입니다.
|
||||
|
||||
### Event: 'did-change-theme-color'
|
||||
|
||||
페이지의 테마 색이 변경될 때 발생하는 이벤트입니다. 이 이벤트는 보통 meta 태그에
|
||||
의해서 발생합니다:
|
||||
|
||||
```html
|
||||
<meta name='theme-color' content='#ff0000'>
|
||||
```
|
||||
|
|
|
|||
Loading…
Reference in a new issue