Back to Qt.io
Contact Us Blog Download Qt
このページでは

WebView QML Type

ウェブコンテンツを表示するためのコンポーネント。もっと見る...

Import Statement: import QtWebView

プロパティ

信号

方法

詳細説明

WebViewはウェブコンテンツを表示するためのコンポーネントで、利用可能なプラットフォーム上ではネイティブAPIを使用して実装されるため、アプリケーションの一部として完全なウェブブラウザスタックを含める必要は必ずしもありません。

すべてのプラットフォームでQt WebView モジュールを正しく機能させるには、QGuiApplication インスタンスを作成した直後にQtWebView::initialize() を呼び出す必要があります。

注意： プラットフォームの制限により、WebViewと他のQMLコンポーネントのオーバーラップはサポートされていません。

プロパティの説明

canGoBack : bool [read-only]

true ウェブ履歴をさかのぼることが可能かどうかを保持する。

canGoForward : bool [read-only]

true ウェブ履歴を前方に移動できる場合に保持する。

httpUserAgent : url [since QtWebView 1.14]

使用中のユーザーエージェント。

このプロパティは QtWebView 1.14 で導入されました。

loadProgress : int [read-only]

ウェブコンテンツの現在のロード進捗。0から100までの整数で表される。

loading : bool [read-only]

WebView が現在新しいコンテンツの読み込み中であればtrue を、そうでなければfalse を保持する。

loadingChanged()も参照のこと 。

settings : WebViewSettings [read-only, since QtWebView 6.5]

WebView の設定オブジェクト。

このプロパティは QtWebView 6.5 で導入されました。

WebViewSettingsも参照してください 。

title : string [read-only]

現在ロードされているウェブページのタイトル。

url : url

現在ロードされているウェブページのURL。これを変更すると、新しいコンテンツがロードされます。

URLはそのまま使用される。ユーザー入力に由来する URL は、QUrl::fromUserInput() で解析する必要があります。

注意: WebView は、Qt Resource システムを通したコンテンツのロードをサポートしていません。

シグナルのドキュメント

cookieAdded(string domain, string name)

このシグナルはクッキーが追加されたときに発せられます。

パラメータは追加されたクッキーのdomain とname に関する情報を提供します。

注意: QtWebEngine モジュールがバックエンドとして使われるとき、cookieAdded シグナルは、ウェブサイトによって追加されたものも含めて、基礎となるQWebEngineCookieStore に 追加されたすべてのクッキーに対して発せられます。その他の場合、cookieAdded シグナルはsetCookie()で明示的に追加されたクッキーに対してのみ発せられます。

注意: 対応するハンドラはonCookieAdded です。

cookieRemoved(string domain, string name)

このシグナルはクッキーが削除されたときに発せられます。

パラメータは削除されたクッキーのdomain とname に関する情報を提供します。

注: 対応するハンドラはonCookieRemoved です。

httpUserAgentChanged(string userAgent)

このシグナルは、ビューのuserAgent が変更されるたびに発行される。

注意: 対応するハンドラはonHttpUserAgentChanged です。

httpUserAgentも参照してください 。

loadProgressChanged(int loadProgress)

このシグナルは、ウェブページがロードされている間、継続的に発せられます。loadProgress パラメータは 0 から 100 の間の値で、ウェブページの何パーセントが読み込まれたかを示します。このシグナルの使用目的は、ユーザーにプログレスバーを表示することです。

注意: バックエンドの中には、ロードの進行状況の小数の変更をサポートしていないものがあり、ロードの開始時と終了時にのみ、それぞれ 0 と 100 の値でこのシグナルを発します。

注意: 対応するハンドラはonLoadProgressChanged 。

loadingChangedも参照のこと 。

loadingChanged(WebViewLoadRequest loadRequest)

このシグナルは、ウェブコンテンツのロード状態が変化したときに発行されます。このシグナルを処理することで、たとえばページの読み込みエラーに対応することができます。

loadRequest パラメータには、リクエストのurlとステータス、失敗したリクエストのエラーメッセージを含むerrorStringが格納されます。

注意: 対応するハンドラはonLoadingChanged です。

WebViewLoadRequestも参照してください 。

titleChanged(string title)

このシグナルは、ビューのtitle が変更されるたびに発行される。

注意: 対応するハンドラはonTitleChanged です。

titleも参照してください 。

urlChanged(url url)

このシグナルは、ビューのurl が変更されるたびに発行される。

注意: 対応するハンドラはonUrlChanged です。

urlも参照してください 。

メソッドのドキュメント

[since QtWebView 6.3] void deleteAllCookies()

すべてのクッキーを削除します。

このメソッドはQtWebView 6.3で導入されました。

[since QtWebView 6.3] void deleteCookie(string domain, string name)

指定されたdomain とname を持つクッキーを削除します。

クッキーが削除されるとcookieRemoved シグナルが発せられます。

このメソッドは QtWebView 6.3 で導入されました。

void goBack()

ウェブ履歴を遡ります。

void goForward()

ウェブ履歴をナビゲートします。

void loadHtml(string html, url baseUrl)

指定されたhtml コンテンツをウェブ・ビューにロードする。

このメソッドは、URL 経由で HTML ページを参照するurl プロパティに代わる低レベルの方法を提供します。

HTML ドキュメントで参照されるスタイルシートや画像などの外部オブジェクトは、baseUrl からの相対位置に配置する必要があります。例えば、html がベースURLであるhttp://www.example.com/documents/overview.html から取得される場合、相対URLであるdiagram.png で参照される画像はhttp://www.example.com/documents/diagram.png にあるべきです。

注意: WebView は Qt Resource システムからのコンテンツの読み込みをサポートしていません。

urlも参照してください 。

void reload()

現在のurl をリロードする。

void runJavaScript(string script, variant callback)

指定されたJavaScriptを実行する。callback 関数が指定された場合は、script の実行終了後に呼び出されます。

runJavaScript("document.title", function(result) { console.log(result); });

[since QtWebView 6.3] void setCookie(string domain, string name, string value)

指定されたdomain 、name 、value でクッキーを追加します。

クッキーが追加されるとcookieAdded シグナルが発せられます。

このメソッドは QtWebView 6.3 で導入されました。

void stop()

現在のurl のロードを停止する。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.