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]

사용 중인 사용자 에이전트입니다.

참고: WinRT에서 이 속성은 애플리케이션의 모든 웹 뷰에 영향을 줍니다.

이 속성은 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 리소스 시스템을 통한 콘텐츠 로딩을 지원하지 않습니다.


신호 문서

cookieAdded(string domain, string name)

이 신호는 쿠키가 추가될 때 발생합니다.

파라미터는 추가된 쿠키의 domain 및 name 에 대한 정보를 제공합니다.

참고: Qt WebEngine 모듈이 백엔드로 사용되는 경우, 웹사이트가 추가한 쿠키를 포함하여 기본 QWebEngineCookieStore 에 추가된 모든 쿠키에 대해 cookieAdded 신호가 발생합니다. 다른 경우에는 setCookie()로 명시적으로 추가된 쿠키에 대해서만 cookieAdded 신호가 발생합니다.

참고: 해당 핸들러는 onCookieAdded 입니다.


cookieRemoved(string domain, string name)

이 신호는 쿠키가 삭제될 때 발생합니다.

매개 변수는 삭제된 쿠키의 domain 및 name 에 대한 정보를 제공합니다.

참고: 해당 핸들러는 onCookieRemoved 입니다.


loadingChanged(WebViewLoadRequest loadRequest)

이 신호는 웹 콘텐츠 로딩 상태가 변경될 때 발생합니다. 이 신호를 처리하면 예를 들어 페이지 로드 오류에 대응할 수 있습니다.

loadRequest 매개변수에는 요청의 URL과 상태, 그리고 실패한 요청에 대한 오류 메시지가 포함된 errorString이 포함됩니다.

참고: 해당 핸들러는 onLoadingChanged 입니다.

WebViewLoadRequest 를참조하세요 .


메서드 문서

[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 리소스 시스템을 통한 콘텐츠 로드를 지원하지 않습니다.

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 로드를 중지합니다.


© 2025 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.