Skip to content

Commit 797aef6

Browse files
committed
📝 Update Korean docs as upstream
[ci skip]
1 parent 56e6796 commit 797aef6

File tree

5 files changed

+123
-31
lines changed

5 files changed

+123
-31
lines changed

docs-translations/ko-KR/api/app.md

Lines changed: 61 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -264,6 +264,19 @@ app.on('login', (event, webContents, request, authInfo, callback) => {
264264

265265
GPU가 작동하던 중 크래시가 일어났을 때 발생하는 이벤트입니다.
266266

267+
### Event: 'accessibility-support-changed' _macOS_ _Windows_
268+
269+
Returns:
270+
271+
* `event` Event
272+
* `accessibilitySupportEnabled` Boolean - Chrome의 접근성 지원이 활성화되어있으면
273+
`true`를 반환하고 아니라면 `false`를 반환합니다.
274+
275+
Chrome의 접근성 지원이 변경될 때 발생하는 이벤트입니다. 이 이벤트는 스크린 리더와 같은
276+
접근성 기술이 활성화되거나 비활성화될 때 발생합니다.
277+
자세한 내용은 https://www.chromium.org/developers/design-documents/accessibility
278+
참고하세요.
279+
267280
## Methods
268281

269282
`app` 객체는 다음과 같은 메서드를 가지고 있습니다:
@@ -579,6 +592,33 @@ pkcs12 형식으로된 인증서를 플랫폼 인증서 저장소로 가져옵
579592

580593
이 메서드는 `app``ready` 이벤트가 발생하기 전에만 호출할 수 있습니다.
581594

595+
### `app.setBadgeCount(count)` _Linux_ _macOS_
596+
597+
* `count` Integer
598+
599+
현재 앱에 대해 카운터 뱃지를 설정합니다. count를 `0`으로 설정하면 뱃지를 숨깁니다.
600+
호출이 성공적으로 끝나면 `true`를 반환하고 아닌 경우 `false`를 반환합니다.
601+
602+
macOS에선 독 아이콘에 표시됩니다. Linux에선 Unity 런처에서만 작동합니다.
603+
604+
**참고:** Unity 런처는 이 기능을 작동하기 위해 `.desktop` 파일을 필요로 합니다.
605+
이에 대한 자세한 내용은 [데스크톱 환경 통합][unity-requiremnt]을 참고하세요.
606+
607+
### `app.getBadgeCount()` _Linux_ _macOS_
608+
609+
현재 카운터 뱃지에 표시중인 값을 반환합니다.
610+
611+
### `app.isUnityRunning()` _Linux_
612+
613+
현재 데스크톱 환경이 Unity인지 여부를 반환합니다.
614+
615+
### `app.isAccessibilitySupportEnabled()` _macOS_ _Windows_
616+
617+
`Boolean` 값을 반환하며 Chrome의 접근성 지원이 활성화되어있으면 `true`를 그렇지
618+
않다면 `false`를 반환합니다. 이 API는 사용할 수 있는 스크린 리더와 같은 접근성 기술이
619+
감지되었을 때 `true`를 반환합니다. 자세한 내용은
620+
https://www.chromium.org/developers/design-documents/accessibility 를 참고하세요.
621+
582622
### `app.commandLine.appendSwitch(switch[, value])`
583623

584624
Chrominum의 명령줄에 스위치를 추가합니다. `value`는 추가적인 값을 뜻하며 옵션입니다.
@@ -647,32 +687,31 @@ dock 아이콘을 표시합니다.
647687

648688
dock 아이콘의 `image`를 설정합니다.
649689

650-
### `app.launcher.setBadgeCount(count)` _Linux_
651-
* `count` Integer
652-
653-
Unity 런처에서 앱 아이콘 옆에 표시될 숫자를 설정합니다. `0`으로 설정하면 뱃지를
654-
숨깁니다.
655-
656-
**참고:** 이 기능은 현재 Ubuntu Unity에서만 사용할 수 있습니다. 다른 환경에서 이
657-
함수를 호출하는 것은 아무런 효과가 없습니다.
658-
659-
**참고:** 이 기능을 사용하려면 `package.json``desktopName` 필드에 `.desktop` 파일 이름을 설정해야 합니다. 기본적으로 패키징된 애플리케이션의 `app.getName().desktop`을 사용합니다.
660-
661-
### `app.launcher.getBadgeCount()` _Linux_
662-
663-
런처 아이콘 옆 배지의 카운터에 표시된 현재 값을 반환합니다.
690+
### `app.getLoginItemSettings()` _macOS_
664691

665-
**참고:** `setBadgeCount`가 Ubuntu Unity에서만 지원하기 때문에, 애플리케이션이 다른
666-
플랫폼에서 돌아가고 있다면 이 메서드는 `0`을 반환합니다.
692+
앱의 로그인 항목 설정을 객체로 반환합니다.
667693

668-
### `app.launcher.isUnityRunning()` _Linux_
694+
* `openAtLogin` Boolean - 앱이 로그인시 열리도록 설정되어있는 경우 `true`를 반환.
695+
* `openAsHidden` Boolean - 앱이 로구인시 숨겨진 채로 열리도록 설정되어있는 경우
696+
`true`를 반환.
697+
* `wasOpenedAtLogin` Boolean - 자동으로 로그인할 때 애플리케이션이 열려있었는지 여부.
698+
* `wasOpenedAsHidden` Boolean - 앱이 숨겨진 로그인 항목처럼 열려있었는지 여부.
699+
이는 앱이 시작시 어떤 윈도우도 열지 않을 것을 표시합니다.
700+
* `restoreState` Boolean - 앱이 이전 세션에서 상태를 복원하여 로그인 항목처럼
701+
열려있었는지 여부. 이는 앱이 마지막으로 종료되었던 때에 열려있었던 윈도우를 복원하는
702+
것을 표시합니다.
669703

670-
현재 데스크톱 환경이 Unity인지 여부를 반환합니다. Unity가 맞다면 `true`를 반환합니다.
704+
### `app.setLoginItemSettings(settings)` _macOS_
671705

672-
### `app.launcher.isCounterBadgeAvailable()` _Linux_
706+
* `settings` Object
707+
* `openAtLogin` Boolean - `true`로 지정하면 로그인시 애플리케이션을 열도록 하며
708+
`false`로 지정시 로그인 항목에서 삭제합니다.
709+
* `openAsHidden` Boolean - `true`로 지정하면 애플리케이션을 숨겨진 채로 열도록
710+
합니다. 기본값은 `false`입니다. 사용자가 시스템 설정에서 이 설정을 변경할 수
711+
있으며 앱이 열렸을 때 현재 값을 확인하려면
712+
`app.getLoginItemStatus().wasOpenedAsHidden`를 확인해야 합니다.
673713

674-
현재 데스크톱 환경이 애플리케이션 아이콘 카운터 뱃지를 사용할 수 있는지 여부를
675-
반환합니다. 사용할 수 있다면 `true`를 반환합니다.
714+
앱의 로그인 항목 설정을 지정합니다.
676715

677716
[dock-menu]:https://developer.apple.com/library/mac/documentation/Carbon/Conceptual/customizing_docktile/concepts/dockconcepts.html#//apple_ref/doc/uid/TP30000986-CH2-TPXREF103
678717
[tasks]:http://msdn.microsoft.com/en-us/library/windows/desktop/dd378460(v=vs.85).aspx#tasks
@@ -681,3 +720,4 @@ Unity 런처에서 앱 아이콘 옆에 표시될 숫자를 설정합니다. `0`
681720
[LSCopyDefaultHandlerForURLScheme]: https://developer.apple.com/library/mac/documentation/Carbon/Reference/LaunchServicesReference/#//apple_ref/c/func/LSCopyDefaultHandlerForURLScheme
682721
[handoff]: https://developer.apple.com/library/ios/documentation/UserExperience/Conceptual/Handoff/HandoffFundamentals/HandoffFundamentals.html
683722
[activity-type]: https://developer.apple.com/library/ios/documentation/Foundation/Reference/NSUserActivity_Class/index.html#//apple_ref/occ/instp/NSUserActivity/activityType
723+
[unity-requiremnt]: ../tutorial/desktop-environment-integration.md#unity-launcher-shortcuts-linux

docs-translations/ko-KR/api/browser-window.md

Lines changed: 4 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -182,6 +182,9 @@ On Windows it is
182182
기본 값은 `true`입니다.
183183
* `titleBarStyle` String, macOS - 윈도우 타이틀 바 스타일을 지정합니다. 자세한 사항은
184184
아래를 참고하세요.
185+
* `thickFrame` Boolean - Windows에서 테두리 없는 윈도우를 위해 표준 윈도우 프레임을
186+
추가하는 `WS_THICKFRAME` 스타일을 사용합니다. `false`로 지정하면 윈도우의 그림자와
187+
애니메이션을 삭제합니다. 기본값은 `true`입니다.
185188
* `webPreferences` Object - 웹 페이지 기능을 설정합니다. 사용할 수 있는 속성은
186189
아래를 참고하세요.
187190

@@ -884,16 +887,7 @@ Windows 메시지 훅을 등록합니다. `callback`은 WndProc에서 메시지
884887

885888
### `win.capturePage([rect, ]callback)`
886889

887-
* `rect` Object (optional) - 캡쳐할 페이지의 영역
888-
* `x` Integer
889-
* `y` Integer
890-
* `width` Integer
891-
* `height` Integer
892-
* `callback` Function
893-
894-
페이지의 스크린샷을 `rect`에 설정한 만큼 캡처합니다. 캡처가 완료되면 `callback`
895-
`callback(image)` 형식으로 호출됩니다. `image`[NativeImage](native-image.md)
896-
인스턴스이며 스크린샷 데이터를 담고있습니다. `rect`를 생략하면 페이지 전체를 캡처합니다.
890+
`webContents.capturePage([rect, ]callback)`와 같습니다.
897891

898892
### `win.loadURL(url[, options])`
899893

docs-translations/ko-KR/api/web-contents.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -648,6 +648,19 @@ webContents.on('found-in-page', (event, result) => {
648648
const requestId = webContents.findInPage('api');
649649
```
650650

651+
### `webContents.capturePage([rect, ]callback)`
652+
653+
* `rect` Object (optional) - 캡쳐할 페이지의 영역
654+
* `x` Integer
655+
* `y` Integer
656+
* `width` Integer
657+
* `height` Integer
658+
* `callback` Function
659+
660+
페이지의 스크린샷을 `rect`에 설정한 만큼 캡처합니다. 캡처가 완료되면 `callback`
661+
`callback(image)` 형식으로 호출됩니다. `image`[NativeImage](native-image.md)
662+
인스턴스이며 스크린샷 데이터를 담고있습니다. `rect`를 생략하면 페이지 전체를 캡처합니다.
663+
651664
### `webContents.hasServiceWorker(callback)`
652665

653666
* `callback` Function
@@ -925,6 +938,16 @@ Input `event`를 웹 페이지로 전송합니다.
925938

926939
프레임 프레젠테이션 이벤트들에 대한 구독을 중지합니다.
927940

941+
### `webContents.startDrag(item)`
942+
943+
* `item` object
944+
* `file` String
945+
* `icon` [NativeImage](native-image.md)
946+
947+
현재 진행중인 드래그-드롭에 `item`을 드래그 중인 아이템으로 설정합니다. `file`
948+
드래그될 파일의 절대 경로입니다. 그리고 `icon`은 드래그 도중 커서 밑에 표시될
949+
이미지입니다.
950+
928951
### `webContents.savePage(fullPath, saveType, callback)`
929952

930953
* `fullPath` String - 전체 파일 경로.

docs-translations/ko-KR/api/web-view-tag.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -458,6 +458,11 @@ Service worker에 대한 개발자 도구를 엽니다.
458458
`webview` 페이지를 PDF 형식으로 인쇄합니다.
459459
`webContents.printToPDF(options, callback)` 메서드와 같습니다.
460460

461+
### `<webview>.capturePage([rect, ]callback)`
462+
463+
`webview`의 페이지의 스냅샷을 캡쳐합니다.
464+
`webContents.printToPDF(options, callback)` 메서드와 같습니다.
465+
461466
### `<webview>.send(channel[, arg1][, arg2][, ...])`
462467

463468
* `channel` String

docs-translations/ko-KR/tutorial/desktop-environment-integration.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -310,6 +310,36 @@ win.setRepresentedFilename('/etc/passwd');
310310
win.setDocumentEdited(true);
311311
```
312312

313+
## 파일을 윈도우 밖으로 드래그할 수 있도록 만들기
314+
315+
파일을 조작하는 특정 종류의 애플리케이션들에서 파일을 Electron에서 다른 애플리케이션으로
316+
드래그할 수 있는 기능은 중요합니다. 이 기능을 구현하려면 애플리케이션에서
317+
`ondragstart` 이벤트가 발생했을 때 `webContents.startDrag(item)` API를 호출해야
318+
합니다:
319+
320+
웹 페이지에서:
321+
322+
```html
323+
<a href="#" id="drag">item</a>
324+
<script type="text/javascript" charset="utf-8">
325+
document.getElementById('drag').ondragstart = (event) => {
326+
event.preventDefault()
327+
ipcRenderer.send('ondragstart', '/path/to/item')
328+
}
329+
</script>
330+
```
331+
332+
메인 프로세스에서:
333+
334+
```javascript
335+
ipcMain.on('ondragstart', (event, filePath) => {
336+
event.sender.startDrag({
337+
file: filePath,
338+
icon: '/path/to/icon.png'
339+
})
340+
})
341+
```
342+
313343
[addrecentdocument]: ../api/app.md#appaddrecentdocumentpath-os-x-windows
314344
[clearrecentdocuments]: ../api/app.md#appclearrecentdocuments-os-x-windows
315345
[setusertaskstasks]: ../api/app.md#appsetusertaskstasks-windows

0 commit comments

Comments
 (0)