diff --git a/README-ko.md b/README-ko.md index 2bd24dfe58..a2db99929c 100644 --- a/README-ko.md +++ b/README-ko.md @@ -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) 프로젝트에 커뮤니티가 운영중인 유용한 예제 어플리케이션과 도구, 리소스가 있으니 한번 참고해 보시기 diff --git a/docs-translations/ko-KR/api/app.md b/docs-translations/ko-KR/api/app.md index fea011a1cd..503864d042 100644 --- a/docs-translations/ko-KR/api/app.md +++ b/docs-translations/ko-KR/api/app.md @@ -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에서도 이 메서드를 통해 확실히 중복 실행을 방지하는 것이 좋습니다. diff --git a/docs-translations/ko-KR/api/chrome-command-line-switches.md b/docs-translations/ko-KR/api/chrome-command-line-switches.md index 443a8f2187..f13f37920a 100644 --- a/docs-translations/ko-KR/api/chrome-command-line-switches.md +++ b/docs-translations/ko-KR/api/chrome-command-line-switches.md @@ -57,7 +57,7 @@ Electron이 세미콜론으로 구분된 호스트 리스트에서 지정한 프 예시: ```javascript -app.commandLine.appendSwitch('proxy-bypass-list', ';*.google.com;*foo.com;1.2.3.4:5678')` +app.commandLine.appendSwitch('proxy-bypass-list', ';*.google.com;*foo.com;1.2.3.4:5678'); ``` 위 예시는 로컬 주소(`localhost`, `127.0.0.1`, 등)와 `google.com`의 서브도메인, diff --git a/docs-translations/ko-KR/api/web-contents.md b/docs-translations/ko-KR/api/web-contents.md index dc4ec67940..e6dec1bfc9 100644 --- a/docs-translations/ko-KR/api/web-contents.md +++ b/docs-translations/ko-KR/api/web-contents.md @@ -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 + +``` + ## 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 diff --git a/docs-translations/ko-KR/api/web-view-tag.md b/docs-translations/ko-KR/api/web-view-tag.md index 935976b6bd..8a4fd439bb 100644 --- a/docs-translations/ko-KR/api/web-view-tag.md +++ b/docs-translations/ko-KR/api/web-view-tag.md @@ -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 - [`.findInPage`](web-view-tag.md#webviewtagfindinpage) + 요청이 종료되었을 때 일어날 수 있는 작업을 지정합니다. + * `clearSelection` - 선택을 일반 선택으로 변경합니다. + * `keepSelection` - 선택을 취소합니다. + * `activateSelection` - 포커스한 후 선택된 노드를 클릭합니다. + +제공된 `action`에 대한 `webContents`의 모든 `findInPage` 요청을 중지합니다. + ### `.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 + +```