electron/docs-translations/jp/api/frameless-window.md
2016-04-04 12:05:53 -07:00

5.3 KiB
Raw Blame History

Frameless Window

フレームの無いウィンドウは、ウェブページの一部ではなく、ツールバーのようなウィンドウのパーツで、chromeではないウィンドウです。 オプションとしてBrowserWindowクラスがあります。

フレームの無いウィンドウを作成する

フレームの無いウィンドウを作成するために、BrowserWindowoptionsで、framefalseに設定する必要があります。

const BrowserWindow = require('electron').BrowserWindow;
var win = new BrowserWindow({ width: 800, height: 600, frame: false });

OS Xでの別の方法

Mac OS X 10.10 Yosemite以降では、Chrome無しのウィンドウを指定する方法があります。framefalseに設定しタイトルバーとウィンドウコントロールの両方を無効にする代わりに、タイトルバーを隠しコンテンツをフルウィンドウサイズに広げたいけど、標準的なウィンドウ操作用にウィンドウコントロール("トラフィックライト")を維持したいかもしれません。新しいtitleBarStyleオプションを指定することで、そうできます。

var win = new BrowserWindow({ 'titleBarStyle': 'hidden' });

透明なウィンドウ

transparentオプションをtrueに設定すると、フレームの無い透明なウィンドウを作成できます。

var win = new BrowserWindow({ transparent: true, frame: false });

制限

  • 透明領域をクリックすることはできません。この問題を解決するためにウィンドウの輪郭を設定するAPIを導入しようとしています。詳細は、our issue を参照してください。
  • 透明なウィンドウはサイズ変更できません。いくつかのプラットフォーム上では、resizabletrue設定は、いくつかのプラットフォーム上で、動作を停止する透明ウィンドウを作成するかもしれません。
  • 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;
}

コンテキストメニュー

いくつかのプラットフォームでは、ドラッグ可能な領域は、クライアントフレーム無しとして扱われるので、その上で右クリックすると、システムメニューがポップアップします。コンテキストメニューをすべてのプラットフォームで正しく動作するようにするためには、ドラッグ可能領域でカスタムコンテキストメニューを使用しないでください。