WebView QML Type

웹 콘텐츠를 표시하기 위한 컴포넌트입니다. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• canGoBack : bool
• canGoForward : bool
• httpUserAgent : url (since QtWebView 1.14)
• loadProgress : int
• loading : bool
• settings : WebViewSettings (since QtWebView 6.5)
• title : string
• url : url

신호

• cookieAdded(string domain, string name)
• cookieRemoved(string domain, string name)
• httpUserAgentChanged(string userAgent)
• loadProgressChanged(int loadProgress)
• loadingChanged(WebViewLoadRequest loadRequest)
• titleChanged(string title)
• urlChanged(url url)

방법

• void deleteAllCookies() (since QtWebView 6.3)
• void deleteCookie(string domain, string name) (since QtWebView 6.3)
• void goBack()
• void goForward()
• void loadHtml(string html, url baseUrl)
• void reload()
• void runJavaScript(string script, variant callback)
• void setCookie(string domain, string name, string value) (since QtWebView 6.3)
• void stop()

상세 설명

WebView는 웹 콘텐츠를 표시하기 위한 컴포넌트로, 해당 기능이 지원되는 플랫폼에서는 네이티브 API를 사용하여 구현되므로, 애플리케이션의 일부로 전체 웹 브라우저 스택을 포함할 필요가 없습니다.

Qt WebView 모듈이 모든 플랫폼에서 올바르게 작동하도록 하려면, QGuiApplication 인스턴스를 생성한 직후에 QtWebView::initialize()을 호출해야 합니다.

속성 문서

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()`를 사용하여 파싱해야 합니다.

신호 문서

cookieAdded(string domain, string name)

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

매개변수에는 추가된 쿠키의 domain 및 name 에 대한 정보가 포함됩니다.

cookieRemoved(string domain, string name)

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

매개변수에는 삭제된 쿠키의 domain 및 name 에 대한 정보가 포함됩니다.

httpUserAgentChanged(string userAgent)

이 신호는 뷰의 userAgent 가 변경될 때마다 발생합니다.

httpUserAgent도 참조하십시오 .

loadProgressChanged(int loadProgress)

이 신호는 웹 페이지가 로딩되는 동안 지속적으로 전송됩니다. ` loadProgress ` 매개변수는 0에서 100 사이의 값으로, 웹 페이지의 로딩 진행률을 백분율로 나타냅니다. 이 신호의 용도는 사용자에게 진행률 표시줄을 표시하는 것입니다.

loadingChanged도 참조하십시오 .

loadingChanged(WebViewLoadRequest loadRequest)

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

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

WebViewLoadRequest도 참조하십시오 .

titleChanged(string title)

이 신호는 뷰의 title 가 변경될 때마다 발생합니다.

title도 참조하십시오 .

urlChanged(url url)

이 신호는 뷰의 url 가 변경될 때마다 발생합니다.

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 에 있어야 합니다.

url도 참조하십시오 .

void reload()

현재의 url 을 다시 불러옵니다.

void runJavaScript(string script, variant callback)

지정된 자바스크립트를 실행합니다. ` 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 의 로딩을 중지합니다.