1
1
# BrowserWindow
2
2
3
- ` BrowserWindow ` 클래스는 브라우저 창(윈도우 창 )을 만드는 역할을 담당합니다.
3
+ ` BrowserWindow ` 클래스는 브라우저 창(윈도우)을 만드는 역할을 담당합니다.
4
4
5
- 다음 예제는 윈도우 창을 생성합니다:
5
+ 다음 예제는 윈도우를 생성합니다:
6
6
7
7
``` javascript
8
8
// 메인 프로세스에서
@@ -28,37 +28,45 @@ win.show();
28
28
` BrowserWindow ` 는 [ EventEmitter] ( http://nodejs.org/api/events.html#events_class_events_eventemitter ) 를
29
29
상속받은 클래스 입니다.
30
30
31
- ` BrowserWindow ` 는 ` options ` 를 통해 네이티브 속성을 포함한 새로운 윈도우 창을
32
- 생성합니다.
31
+ ` BrowserWindow ` 는 ` options ` 를 통해 네이티브 속성을 포함한 새로운 윈도우를 생성합니다.
33
32
34
33
### ` new BrowserWindow([options]) `
35
34
36
35
` options ` 객체 (optional), 사용할 수 있는 속성들:
37
36
38
- * ` width ` Integer - 윈도우 창의 가로 너비. 기본값은 ` 800 ` 입니다.
39
- * ` height ` Integer - 윈도우 창의 세로 높이. 기본값은 ` 600 ` 입니다.
37
+ * ` width ` Integer - 윈도우의 가로 너비. 기본값은 ` 800 ` 입니다.
38
+ * ` height ` Integer - 윈도우의 세로 높이. 기본값은 ` 600 ` 입니다.
40
39
* ` x ` Integer - 화면을 기준으로 창 좌측을 오프셋 한 위치. 기본값은 ` 화면중앙 ` 입니다.
41
40
* ` y ` Integer - 화면을 기준으로 창 상단을 오프셋 한 위치. 기본값은 ` 화면중앙 ` 입니다.
42
41
* ` useContentSize ` Boolean - ` width ` 와 ` height ` 를 웹 페이지의 크기로 사용합니다.
43
42
이 속성을 사용하면 웹 페이지의 크기에 윈도우 프레임 크기가 추가되므로 실제 창은 조금
44
43
더 커질 수 있습니다. 기본값은 ` false ` 입니다.
45
- * ` center ` Boolean - 윈도우 창을 화면 정 중앙에 위치시킵니다.
46
- * ` minWidth ` Integer - 윈도우 창의 최소 가로 너비. 기본값은 ` 0 ` 입니다.
47
- * ` minHeight ` Integer - 윈도우 창의 최소 세로 높이. 기본값은 ` 0 ` 입니다.
48
- * ` maxWidth ` Integer - 윈도우 창의 최대 가로 너비. 기본값은 ` 제한없음 ` 입니다.
49
- * ` maxHeight ` Integer - 윈도우 창의 최대 세로 높이. 기본값은 ` 제한없음 ` 입니다.
50
- * ` resizable ` Boolean - 윈도우 창의 크기를 재조정 할 수 있는지 여부. 기본값은 ` true `
44
+ * ` center ` Boolean - 윈도우를 화면 정 중앙에 위치시킵니다.
45
+ * ` minWidth ` Integer - 윈도우의 최소 가로 너비. 기본값은 ` 0 ` 입니다.
46
+ * ` minHeight ` Integer - 윈도우의 최소 세로 높이. 기본값은 ` 0 ` 입니다.
47
+ * ` maxWidth ` Integer - 윈도우의 최대 가로 너비. 기본값은 ` 제한없음 ` 입니다.
48
+ * ` maxHeight ` Integer - 윈도우의 최대 세로 높이. 기본값은 ` 제한없음 ` 입니다.
49
+ * ` resizable ` Boolean - 윈도우의 크기를 재조정 할 수 있는지 여부. 기본값은 ` true `
51
50
입니다.
52
- * ` movable ` Boolean - 윈도우를 이동시킬 수 있는지 여부. 이 기능은 현재 OSX에만
53
- 구현되어 있습니다. 기본값은 ` true `
54
- * ` alwaysOnTop ` Boolean - 윈도우 창이 언제나 다른 창들 위에 유지되는지 여부.
51
+ * ` movable ` Boolean - 윈도우를 이동시킬 수 있는지 여부. Linux에선 구현되어있지
52
+ 않습니다. 기본값은 ` true ` 입니다.
53
+ * ` minimizable ` Boolean - 윈도우를 최소화시킬 수 있는지 여부. Linux에선 구현되어있지
54
+ 않습니다. 기본값은 ` true ` 입니다.
55
+ * ` maximizable ` Boolean - 윈도우를 최대화시킬 수 있는지 여부. Linux에선 구현되어있지
56
+ 않습니다. 기본값은 ` true ` 입니다.
57
+ * ` closable ` Boolean - 윈도우를 닫을 수 있는지 여부. Linux에선 구현되어있지 않습니다.
58
+ 기본값은 ` true ` 입니다.
59
+ * ` alwaysOnTop ` Boolean - 윈도우이 언제나 다른 창들 위에 유지되는지 여부.
55
60
기본값은 ` false ` 입니다.
56
- * ` fullscreen ` Boolean - 윈도우 창의 전체화면 활성화 여부. 기본값은 ` false ` 입니다.
57
- ` false ` 로 지정했을 경우 OS X에선 전체화면 버튼이 숨겨지거나 비활성화됩니다.
61
+ * ` fullscreen ` Boolean - 윈도우의 전체화면 활성화 여부. 이 속성을 명시적으로
62
+ ` false ` 로 지정했을 경우, OS X에선 전체화면 버튼이 숨겨지거나 비활성화되고,
63
+ Windows에선 최대화 버튼이 비활성화됩니다. 기본값은 ` false ` 입니다.
64
+ * ` fullscreenable ` Boolean - OS X의 최대화/줌 버튼이 전체화면 모드 또는 윈도우
65
+ 최대화를 토글할 수 있게 할지 여부입니다. 기본값은 ` true ` 입니다.
58
66
* ` skipTaskbar ` Boolean - 작업표시줄 어플리케이션 아이콘 표시 스킵 여부. 기본값은
59
67
` false ` 입니다.
60
68
* ` kiosk ` Boolean - Kiosk(키오스크) 모드. 기본값은 ` false ` 입니다.
61
- * ` title ` String - 기본 윈도우 창 제목. 기본값은 ` "Electron" ` 입니다.
69
+ * ` title ` String - 기본 윈도우 제목. 기본값은 ` "Electron" ` 입니다.
62
70
* ` icon ` [ NativeImage] ( native-image.md ) - 윈도우 아이콘, 생략하면 실행 파일의
63
71
아이콘이 대신 사용됩니다.
64
72
* ` show ` Boolean - 윈도우가 생성되면 보여줄지 여부. 기본값은 ` true ` 입니다.
@@ -70,16 +78,18 @@ win.show();
70
78
` false ` 입니다.
71
79
* ` autoHideMenuBar ` Boolean - ` Alt ` 를 누르지 않는 한 어플리케이션 메뉴바를 숨길지
72
80
여부. 기본값은 ` false ` 입니다.
73
- * ` enableLargerThanScreen ` Boolean - 윈도우 창 크기가 화면 크기보다 크게 재조정 될
81
+ * ` enableLargerThanScreen ` Boolean - 윈도우 크기가 화면 크기보다 크게 재조정 될
74
82
수 있는지 여부. 기본값은 ` false ` 입니다.
75
- * ` backgroundColor ` String - 16진수로 표현된 윈도우의 배경 색. ` #66CD00 ` 또는
76
- ` #FFF ` 가 사용될 수 있습니다. 이 속성은 Linux와 Windows에만 구현되어 있습니다.
77
- 기본값은 ` #000 ` (검정)입니다.
83
+ * ` backgroundColor ` String - ` #66CD00 ` 와 ` #FFF ` 같이 16진수로 표현된 윈도우의
84
+ 배경 색. 기본값은 Linux와 Windows에선 ` #000 ` (검정)이며, Mac에선 ` #FFF ` (또는,
85
+ 만약 transparent(투명)일 경우 clear(색 없음)로 설정)
86
+ * ` hasShadow ` Boolean - 윈도우가 그림자를 가질지 여부를 지정합니다. 이 속성은
87
+ OS X에서만 구현되어 있습니다. 기본값은 ` true ` 입니다.
78
88
* ` darkTheme ` Boolean - 설정에 상관 없이 무조건 어두운 윈도우 테마를 사용합니다.
79
89
몇몇 GTK+3 데스크톱 환경에서만 작동합니다. 기본값은 ` false ` 입니다.
80
- * ` transparent ` Boolean - 윈도우 창을 [ 투명화] ( frameless-window.md ) 합니다. 기본값은
90
+ * ` transparent ` Boolean - 윈도우를 [ 투명화] ( frameless-window.md ) 합니다. 기본값은
81
91
` false ` 입니다.
82
- * ` type ` String - 특정 플랫폼에만 적용되는 윈도우 창의 종류를 지정합니다. 기본값은
92
+ * ` type ` String - 특정 플랫폼에만 적용되는 윈도우의 종류를 지정합니다. 기본값은
83
93
일반 윈도우 입니다. 사용할 수 있는 창의 종류는 아래를 참고하세요.
84
94
* ` standardWindow ` Boolean - OS X의 표준 윈도우를 텍스쳐 윈도우 대신 사용합니다.
85
95
기본 값은 ` true ` 입니다.
@@ -155,6 +165,15 @@ win.show();
155
165
* ` blinkFeatures ` String - ` CSSVariables,KeyboardEventKey ` 같은 ` , ` 로 구분된
156
166
기능 문자열들의 리스트입니다. 지원하는 전체 기능 문자열들은
157
167
[ setFeatureEnabledFromString] [ blink-feature-string ] 함수에서 찾을 수 있습니다.
168
+ * ` defaultFontFamily ` Object - font-family의 기본 폰트를 지정합니다.
169
+ * ` standard ` String - 기본값 ` Times New Roman ` .
170
+ * ` serif ` String - 기본값 ` Times New Roman ` .
171
+ * ` sansSerif ` String - 기본값 ` Arial ` .
172
+ * ` monospace ` String - 기본값 ` Courier New ` .
173
+ * ` defaultFontSize ` Integer - 기본값 ` 16 ` .
174
+ * ` defaultMonospaceFontSize ` Integer - 기본값 ` 13 ` .
175
+ * ` minimumFontSize ` Integer - 기본값 ` 0 ` .
176
+ * ` defaultEncoding ` String - 기본값 ` ISO-8859-1 ` .
158
177
159
178
## Events
160
179
@@ -203,7 +222,7 @@ window.onbeforeunload = function(e) {
203
222
### Event: 'closed'
204
223
205
224
윈도우 종료가 완료된 경우 발생하는 이벤트입니다. 이 이벤트가 발생했을 경우 반드시
206
- 윈도우 창의 레퍼런스가 더 이상 사용되지 않도록 제거해야 합니다.
225
+ 윈도우의 레퍼런스가 더 이상 사용되지 않도록 제거해야 합니다.
207
226
208
227
### Event: 'unresponsive'
209
228
@@ -507,11 +526,71 @@ var win = new BrowserWindow({ width: 800, height: 600 });
507
526
508
527
* ` resizable ` Boolean
509
528
510
- 윈도우의 크기가 사용자에 의해 재조정될 수 있는지를 지정합니다.
529
+ 사용자에 의해 윈도우의 크기가 재조정될 수 있는지를 지정합니다.
511
530
512
531
### ` win.isResizable() `
513
532
514
- 윈도우의 크기가 사용자에 의해 재조정될 수 있는지 여부를 반환합니다.
533
+ 사용자에 의해 윈도우의 크기가 재조정될 수 있는지 여부를 반환합니다.
534
+
535
+ ### ` win.setMovable(movable) ` _ OS X_ _ Windows_
536
+
537
+ * ` movable ` Boolean
538
+
539
+ 사용자에 의해 윈도우를 이동시킬 수 있는지 여부를 지정합니다. Linux에선 아무 일도
540
+ 일어나지 않습니다.
541
+
542
+ ### ` win.isMovable() ` _ OS X_ _ Windows_
543
+
544
+ 사용자에 의해 윈도우를 이동시킬 수 있는지 여부를 반환합니다. Linux에선 항상 ` true ` 를
545
+ 반환합니다.
546
+
547
+ ### ` win.setMinimizable(minimizable) ` _ OS X_ _ Windows_
548
+
549
+ * ` minimizable ` Boolean
550
+
551
+ 사용자에 의해 윈도우를 최소화시킬 수 있는지 여부를 지정합니다. Linux에선 아무 일도
552
+ 일어나지 않습니다.
553
+
554
+ ### ` win.isMinimizable() ` _ OS X_ _ Windows_
555
+
556
+ 사용자에 의해 윈도우를 최소화시킬 수 있는지 여부를 반환합니다. Linux에선 항상 ` true ` 를
557
+ 반환합니다.
558
+
559
+ ### ` win.setMaximizable(maximizable) ` _ OS X_ _ Windows_
560
+
561
+ * ` maximizable ` Boolean
562
+
563
+ 사용자에 의해 윈도우를 최대화시킬 수 있는지 여부를 지정합니다. Linux에선 아무 일도
564
+ 일어나지 않습니다.
565
+
566
+ ### ` win.isMaximizable() ` _ OS X_ _ Windows_
567
+
568
+ 사용자에 의해 윈도우를 최대화시킬 수 있는지 여부를 반환합니다. Linux에선 항상 ` true ` 를
569
+ 반환합니다.
570
+
571
+ ### ` win.setFullscreenable(fullscreenable) ` _ OS X_
572
+
573
+ * ` fullscreenable ` Boolean
574
+
575
+ 최대화/줌 버튼이 전체화면 모드 또는 윈도우 최대화를 토글할 수 있게 할지 여부를
576
+ 지정합니다. Windows와 Linux에선 아무 일도 일어나지 않습니다.
577
+
578
+ ### ` win.isFullscreenable() ` _ OS X_
579
+
580
+ 최대화/줌 버튼이 전체화면 모드 또는 윈도우 최대화를 토글할 수 있게 할지 여부를
581
+ 반환합니다. Windows와 Linux에선 항상 ` true ` 를 반환합니다.
582
+
583
+ ### ` win.setClosable(closable) ` _ OS X_ _ Windows_
584
+
585
+ * ` closable ` Boolean
586
+
587
+ 사용자에 의해 윈도우가 수동적으로 닫힐 수 있는지 여부를 지정합니다. Linux에선 아무 일도
588
+ 일어나지 않습니다.
589
+
590
+ ### ` win.isClosable() ` _ OS X_ _ Windows_
591
+
592
+ 사용자에 의해 윈도우가 수동적으로 닫힐 수 있는지 여부를 반환합니다. Linux에선 항상
593
+ ` true ` 를 반환합니다.
515
594
516
595
### ` win.setAlwaysOnTop(flag) `
517
596
@@ -689,9 +768,21 @@ Linux 플랫폼에선 Unity 데스크톱 환경만 지원합니다. 그리고
689
768
현재 작업표시줄 아이콘에 16px 크기의 오버레이를 지정합니다. 보통 이 기능은
690
769
어플리케이션의 여러 상태를 사용자에게 소극적으로 알리기 위한 방법으로 사용됩니다.
691
770
771
+ ### ` win.setHasShadow(hasShadow) ` _ OS X_
772
+
773
+ * ` hasShadow ` (Boolean)
774
+
775
+ 윈도우가 그림자를 가질지 여부를 지정합니다. Windows와 Linux에선 아무 일도 일어나지
776
+ 않습니다.
777
+
778
+ ### ` win.hasShadow() ` _ OS X_
779
+
780
+ 윈도우가 그림자를 가지고 있는지 여부를 반환합니다. Windows와 Linux에선 항상 ` true ` 를
781
+ 반환합니다.
782
+
692
783
### ` win.setThumbarButtons(buttons) ` _ Windows 7+_
693
784
694
- ` buttons ` - ` button ` 객체의 배열:
785
+ ` buttons ` - ` button ` 객체의 배열
695
786
696
787
` button ` 객체는 다음과 같은 속성을 가지고 있습니다:
697
788
0 commit comments