Platforms to show: All Mac Windows Linux Cross-Platform

Back to DesktopWKWebViewControlMBS control.

DesktopWKWebViewControlMBS.addScriptMessageHandler(Name as String)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method WebKit2 MBS Mac64bit Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Adds a script message handler.
Example
// register once
browser.addScriptMessageHandler "test"
// later use in javascript:
browser.EvaluateJavaScript("window.webkit.messageHandlers.test.postMessage('Hello');")

Name: The name of the message handler.

Adding a script message handler with name name causes the JavaScript function window.webkit.messageHandlers.name.postMessage(messageBody) to be defined in all frames in all web views that use the user content controller.

DesktopWKWebViewControlMBS.addUserScript(userScript as WKUserScriptMBS)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method WebKit2 MBS Mac64bit Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Adds an user script.

DesktopWKWebViewControlMBS.EvaluateJavaScript(JavaScript as String, byref Error as NSErrorMBS) as Variant

Type Topic Plugin Version macOS Windows Linux iOS Targets
method WebKit2 MBS Mac64bit Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Evaluates JavaScript.
Example
Dim e As NSErrorMBS

// returns array of variants with doubles
Dim v As Variant = DesktopWKWebViewControlMBS1.EvaluateJavaScript("o = [1,2,3];", e)
Dim vd() As Variant = v

// returns array of variants with strings
Dim vv As Variant = DesktopWKWebViewControlMBS1.EvaluateJavaScript("o = [""a"",""b"",""d""];", e)
Dim vs() As Variant = vv

// returns dictionary
Dim v3 As Variant = DesktopWKWebViewControlMBS1.EvaluateJavaScript("o = {a:1}", e)
Dim dd As Dictionary = v3

Break

Synchronous version which waits for JavaScript to return the value.
Error is set in case of errors.

Result is converted from JavaScript data types to Xojo datatypes, usually variants, dictionaries or array of variants.

See also:

DesktopWKWebViewControlMBS.EvaluateJavaScript(JavaScript as String, Tag as String = "")

Type Topic Plugin Version macOS Windows Linux iOS Targets
method WebKit2 MBS Mac64bit Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Evaluates JavaScript.

Calls later JavaScriptEvaluated event with result and passed tag value.

Result is converted from JavaScript data types to Xojo datatypes, usually variants, dictionaries or array of variants.

See also:

DesktopWKWebViewControlMBS.goBack

Type Topic Plugin Version macOS Windows Linux iOS Targets
method WebKit2 MBS Mac64bit Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Navigates to the back item in the back-forward list.

Sets Navigation property.

DesktopWKWebViewControlMBS.goForward

Type Topic Plugin Version macOS Windows Linux iOS Targets
method WebKit2 MBS Mac64bit Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Navigates to the forward item in the back-forward list.

Sets Navigation property.

DesktopWKWebViewControlMBS.goToBackForwardListItem(Item as WKBackForwardListItemMBS)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method WebKit2 MBS Mac64bit Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Navigates to an item from the back-forward list and sets it as the current item.

item: The item to which to navigate. Must be one of the items in the web view's back-forward list.

Sets Navigation property.

DesktopWKWebViewControlMBS.LoadData(Data as MemoryBlock, MIMEType as String, textEncodingName as String, baseURL as string = "")

Type Topic Plugin Version macOS Windows Linux iOS Targets
method WebKit2 MBS Mac64bit Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Sets the webpage contents and base URL.
Example
Dim browser As DesktopWKWebViewControlMBS // your instance

browser.LoadData "<p>Hello World</p>", "text/html", "UTF-8", ""

data: The data to use as the contents of the webpage.
MIMEType: The MIME type of the data.
characterEncodingName: The data's character encoding name.
baseURL: A URL used to resolve relative URLs within the document.

Sets Navigation property.

DesktopWKWebViewControlMBS.LoadFileURL(File as FolderItem, readAccessItem as FolderItem)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method WebKit2 MBS Mac64bit Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Navigates to a requested file.
Example
Dim w as DesktopWKWebViewControlMBS // your web viewer
Dim HTMLFile as folderItem = getfolderItem("test.html")

// pass folderitem parent to allow read to other files in same folder
w.LoadFileURL HTMLFile, HTMLFile.parent

Navigates to the requested file URL on the filesystem.
file: The file URL to which to navigate.
readAccessItem: The file or folder to allow read access to.
If readAccessItem references a single file, only that file may be loaded by WebKit.
If readAccessItem references a directory, files inside that file may be loaded by WebKit.

Sets Navigation property.

DesktopWKWebViewControlMBS.LoadHTML(htmlText as String, baseURL as string = "")

Type Topic Plugin Version macOS Windows Linux iOS Targets
method WebKit2 MBS Mac64bit Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Sets the webpage contents and base URL.
Example
Dim browser As DesktopWKWebViewControlMBS // your instance

browser.LoadHTML "<p>Hello World</p>"

htmlText: The string to use as the contents of the webpage.
baseURL: A URL used to resolve relative URLs within the document.

Sets Navigation property.

DesktopWKWebViewControlMBS.LoadURL(URL as string)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method WebKit2 MBS Mac64bit Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Navigates to a requested URL.
Example

Dim browser As DesktopWKWebViewControlMBS // your instance

call browser.LoadURL "https://www.mbsplugins.de/xojo"

Sets Navigation property.
Sets Navigation property.

DesktopWKWebViewControlMBS.LoadURLRequest(Request as NSURLRequestMBS)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method WebKit2 MBS Mac64bit Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Navigates to a requested URL.

Sets Navigation property.

DesktopWKWebViewControlMBS.printOperation(printInfo as NSPrintInfoMBS) as NSPrintOperationMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method WebKit2 MBS Mac64bit Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Creates a print operation for the current web viewer.
Example
dim browser as DesktopWKWebViewControlMBS // your web viewer
Dim pi As NSPrintInfoMBS = NSPrintInfoMBS.sharedPrintInfo
Dim po As NSPrintOperationMBS = browser.printOperation(pi)

po.showsPrintPanel = True
po.showsProgressPanel = True

po.runOperationModalForWindow(Self)

Works for WebKit 1.x and 2.x.

For WebKit 2.x may run into endless loop for some websites due to bugs in Apple's WebKit framework.

DesktopWKWebViewControlMBS.reload

Type Topic Plugin Version macOS Windows Linux iOS Targets
method WebKit2 MBS Mac64bit Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Reloads the current page.
Example
Public Sub Reload(browser as DesktopWKWebViewControlMBS, force as Boolean)
If force Then
Call browser.reloadFromOrigin
Else
Call browser.reload
End If
End Sub

Sets Navigation property.

DesktopWKWebViewControlMBS.reloadFromOrigin

Type Topic Plugin Version macOS Windows Linux iOS Targets
method WebKit2 MBS Mac64bit Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Reloads the current page, performing end-to-end revalidation using cache-validating conditionals if possible.
Example
Public Sub Reload(browser as DesktopWKWebViewControlMBS, force as Boolean)
If force Then
call browser.reloadFromOrigin
Else
call browser.reload
End If
End Sub

Sets Navigation property.

DesktopWKWebViewControlMBS.removeAllUserScripts

Type Topic Plugin Version macOS Windows Linux iOS Targets
method WebKit2 MBS Mac64bit Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Removes all associated user scripts.
Example
Dim browser As DesktopWKWebViewControlMBS // your instance

browser.removeAllUserScripts

DesktopWKWebViewControlMBS.removeScriptMessageHandler(Name as String)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method WebKit2 MBS Mac64bit Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Removes a script message handler.

name: The name of the message handler to remove.

DesktopWKWebViewControlMBS.runOpenPanelWithParametersCompleted(URLs() as NSURLMBS)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method WebKit2 MBS Mac64bit Plugin 22.0 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Pass result for a runOpenPanelWithParameters event here.

Pass nil to indicate cancel was pressed.

DesktopWKWebViewControlMBS.setMagnification(magnification as double, pointX as double, pointY as double)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method WebKit2 MBS Mac64bit Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Scales the page content by a specified factor and centers the result on a specified point.
Example
Dim browser As DesktopWKWebViewControlMBS // your instance

// zoom to 200% on 100/100
browser.setMagnification(2, 100, 100)

magnification: The factor by which to scale the content.
x/y: The point (in view space) to center magnification on. As usual with Cocoa, bottom is y = 0.

For MacOS 64-bit only.

DesktopWKWebViewControlMBS.stopLoading

Type Topic Plugin Version macOS Windows Linux iOS Targets
method WebKit2 MBS Mac64bit Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Stops loading all resources on the current page.
Example
Dim browser As DesktopWKWebViewControlMBS // your instance

browser.stopLoading

DesktopWKWebViewControlMBS.takeSnapshot(byref error as NSErrorMBS) as NSImageMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method WebKit2 MBS Mac64bit Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Requests a snapshot.

This is synchronous version which waits for image to be finished.
In case of error the result is nil and error may be set.

See also:

DesktopWKWebViewControlMBS.takeSnapshot(tag as string = "")

Type Topic Plugin Version macOS Windows Linux iOS Targets
method WebKit2 MBS Mac64bit Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Requests a snapshot.

Calls later takeSnapshotCompleted event.
Tag is passed to event to distinguish various snapshot requests.

See also:

DesktopWKWebViewControlMBS.userScripts as WKUserScriptMBS()

Type Topic Plugin Version macOS Windows Linux iOS Targets
method WebKit2 MBS Mac64bit Plugin 21.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
The user scripts associated with the user content controller.

The items on this page are in the following plugins: MBS Mac64bit Plugin.


The biggest plugin in space...