5.3 KiB
Frameless Window
フレームの無いウィンドウは、ウェブページの一部ではなく、ツールバーのようなウィンドウのパーツで、chromeではないウィンドウです。 オプションとしてBrowserWindow
クラスがあります。
フレームの無いウィンドウを作成する
フレームの無いウィンドウを作成するために、BrowserWindowの options
で、frame
を false
に設定する必要があります。
const BrowserWindow = require('electron').BrowserWindow
var win = new BrowserWindow({ width: 800, height: 600, frame: false })
macOSでの別の方法
macOS 10.10 Yosemite以降では、Chrome無しのウィンドウを指定する方法があります。frame
をfalse
に設定しタイトルバーとウィンドウコントロールの両方を無効にする代わりに、タイトルバーを隠しコンテンツをフルウィンドウサイズに広げたいけど、標準的なウィンドウ操作用にウィンドウコントロール("トラフィックライト")を維持したいかもしれません。新しいtitleBarStyle
オプションを指定することで、そうできます。
var win = new BrowserWindow({ 'titleBarStyle': 'hidden' })
透明なウィンドウ
transparent
オプションをtrue
に設定すると、フレームの無い透明なウィンドウを作成できます。
var win = new BrowserWindow({ transparent: true, frame: false })
制限
- 透明領域をクリックすることはできません。この問題を解決するためにウィンドウの輪郭を設定するAPIを導入しようとしています。詳細は、our issue を参照してください。
- 透明なウィンドウはサイズ変更できません。いくつかのプラットフォーム上では、
resizable
のtrue
設定は、いくつかのプラットフォーム上で、動作を停止する透明ウィンドウを作成するかもしれません。 blur
フィルターはウェブページのみに適用され、ウィンドウの下のコンテンツ(例えば、ユーザーのシステム上でほかのアプリケーションを開く)に、ぼやける効果を適用する方法はありません。- Windows オペレーティングシステム上では、DMMが無効のとき透明なウィンドウは動作しません。
- Linuxユーザーは、GPUを無効化するためにコマンドラインで
--enable-transparent-visuals --disable-gpu
を設定でき、透明ウィンドウを作成するためにARGBを許可でき、これは、 いくつかのNVidiaドライバー上でアルファチャンネルが動作しない という上流のバグ原因になります。 - Macでは、透明なウィンドウでネイティブのウィンドウシャドーを表示できません。
ドラッグ可能領域
既定では、フレーム無しウィンドウはドラッグできません。(OSの標準的なタイトルバーのような)ドラッグできる領域をElectronに指定するには、CSSで-webkit-app-region: drag
を指定する必要があり、アプリはドラッグできる領域からドラッグできない領域を除外するために、-webkit-app-region: no-drag
を使えます。現在のところ長方形領域のみサポートしています。
ウィンドウ全体をドラッグできるようにするには、body
のスタイルに-webkit-app-region: drag
を追加します。
<body style="-webkit-app-region: drag">
</body>
ウィンドウ全体度ドラッグできるようにするには、ボタンをドラッグできないように指定する必要があり、そうしなければユーザーがそれをクリックする可能性があります。
button {
-webkit-app-region: no-drag;
}
カスタムタイトルバーをドラッグできるように設定すると、タイトルバーのすべてのボタンをドラッグできないようにする必要があります。
テキスト選択
フレームの無いウィンドウでは、ドラッグを可能にする動作とテキスト選択がぶつかるかもしれません。例えば、タイトルバーをドラッグしたとき、うっかりタイトルバーのテキストを選択してしまうかもしれません。これを防ぐために、次の例のようにドラッグできる領域内のテキスト選択を無効にする必要があります。
.titlebar {
-webkit-user-select: none;
-webkit-app-region: drag;
}
コンテキストメニュー
いくつかのプラットフォームでは、ドラッグ可能な領域は、クライアントフレーム無しとして扱われるので、その上で右クリックすると、システムメニューがポップアップします。コンテキストメニューをすべてのプラットフォームで正しく動作するようにするためには、ドラッグ可能領域でカスタムコンテキストメニューを使用しないでください。