Multi Theft Auto: Wiki - User contributions [en]

OnClientBrowserLoadingStart

2018-09-19T20:30:07Z

Lars-Marcel:

__NOTOC__
{{Client event}}
{{New feature/item|3.0150|1.5||
The event is triggered when a [[Browser|webbrowser]] starts loading a page.
}}

==Parameters==
<syntaxhighlight lang="lua">
string URL, boolean isMain
</syntaxhighlight>
*'''URL:''' [[string]] containing the URL that will be loaded.
* {{New feature/item|3.0160|1.6|7888|'''isMainFrame:''' a [[boolean]] representing whether the entire page (main frame) was loaded or an ''<iframe>'' inside the page was loaded.
** '''true''': If the URL is loaded in the main frame.
** '''false''': If the URL is loaded in a ''<iframe>''.}}

==Source==
The [[Browser|webbrowser]] element.

==Example==
<syntaxhighlight lang="lua">
local browser = guiCreateBrowser(0, 0, 800, 600, false, false, false)
local theBrowser = guiGetBrowser(browser)
showCursor(true)

addEventHandler("onClientBrowserLoadingStart", theBrowser, function(url, isMainFrame)
if (isMainFrame) then
outputChatBox("Loading "..url.." in the main frame...")
else
outputChatBox("Loading "..url.." in a iframe...")
end
end)

addEventHandler("onClientBrowserCreated", theBrowser, function()
loadBrowserURL(source, "https://www.w3schools.com/html/html_iframe.asp")
end)
</syntaxhighlight>

==See Also==
{{CEF_events}}

OnClientBrowserLoadingStart

2018-09-19T20:28:09Z

Lars-Marcel:

__NOTOC__
{{Client event}}
{{New feature/item|3.0150|1.5||
The event is triggered when a [[Browser|webbrowser]] starts loading a page.
}}

==Parameters==
<syntaxhighlight lang="lua">
string URL, boolean isMain
</syntaxhighlight>
*'''URL:''' [[string]] containing the URL that will be loaded.
* {{New feature/item|3.0160|1.6|7888|'''isMainFrame:''' a [[boolean]] representing whether the entire page (main frame) was loaded or an ''<iframe>'' inside the page was loaded.
** '''true''': If the URL is loaded in the main frame.
** '''false''': If the URL is loaded in a ''<iframe>''.
}}

==Source==
The [[Browser|webbrowser]] element.

==Example==
<syntaxhighlight lang="lua">
local browser = guiCreateBrowser(0, 0, 800, 600, false, false, false)
local theBrowser = guiGetBrowser(browser)
showCursor(true)

addEventHandler("onClientBrowserLoadingStart", theBrowser, function(url, isMainFrame)
if (isMainFrame) then
outputChatBox("Loading "..url.." in the main frame...")
else
outputChatBox("Loading "..url.." in a iframe...")
end
end)

addEventHandler("onClientBrowserCreated", theBrowser, function()
loadBrowserURL(source, "https://www.w3schools.com/html/html_iframe.asp")
end)
</syntaxhighlight>

==See Also==
{{CEF_events}}

OnClientBrowserResourceBlocked

2018-09-19T20:25:00Z

Lars-Marcel: added example

__NOTOC__
{{Client_event}}
{{New feature/item|3.0150|1.5||
This event is executed when a resource (images, sounds etc.) has been blocked.
}}

==Parameters==
<syntaxhighlight lang="lua">
string url, string domain, int reason
</syntaxhighlight>
*'''url''': the blocked URL.
*'''domain''': the blocked domain (part of the URL).
*'''reason''': the reason why the resource was blocked. Possibles values:
** '''0''': not allowed yet
** '''1''': blacklisted
** '''2''': blocked protocol scheme

==Source==
The [[Element/Browser|browser]] element.

==Example==
This example asks the user to accept a blocked resource and reloads the browser if accepted.
<syntaxhighlight lang="lua">
local browser = guiCreateBrowser(0, 0, 800, 600, false, false, false)
local theBrowser = guiGetBrowser(browser)
showCursor(true)

addEventHandler("onClientBrowserCreated", theBrowser, function()
loadBrowserURL(source, "https://www.mta-sa.org/")
end)

local lastBrowser = nil
addEventHandler("onClientBrowserResourceBlocked", theBrowser, function(url, domain, reason)
if (reason == 0) then

lastBrowser = source
requestBrowserDomains({domain}, false, function(accepted, newDomains)
if (accepted == true) then
reloadBrowserPage(lastBrowser)
end
lastBrowser = nil
end)

end
end)
</syntaxhighlight>

[[pl:onClientBrowserResourceBlocked]]

==See Also==
{{CEF_events}}

OnClientBrowserLoadingStart

2018-09-19T20:16:25Z

Lars-Marcel:

__NOTOC__
{{Client event}}
{{New feature/item|3.0150|1.5||
The event is triggered when a [[Browser|webbrowser]] starts loading a page.
}}

==Parameters==
<syntaxhighlight lang="lua">
string URL, boolean isMain
</syntaxhighlight>
*'''URL:''' [[string]] containing the URL that will be loaded.
*'''isMain:''' [[boolean]]
** '''true''': If the URL is loaded in the main frame.
** '''false''': If the URL is loaded in a sub-frame, e.g. in an iFrame.

==Source==
The [[Browser|webbrowser]] element.

==Example==
<syntaxhighlight lang="lua">
local browser = guiCreateBrowser(0, 0, 800, 600, false, false, false)
local theBrowser = guiGetBrowser(browser)
showCursor(true)

addEventHandler("onClientBrowserLoadingStart", theBrowser, function(url, isMain)
if (isMain) then
outputChatBox("Loading "..url.." in the main frame...")
else
outputChatBox("Loading "..url.." in a sub main frame...")
end
end)

addEventHandler("onClientBrowserCreated", theBrowser, function()
loadBrowserURL(source, "https://www.w3schools.com/html/html_iframe.asp")
end)
</syntaxhighlight>

==See Also==
{{CEF_events}}

OnClientBrowserLoadingStart

2018-09-19T20:13:44Z

Lars-Marcel: Created page with "__NOTOC__ {{Client event}} {{New feature/item|3.0150|1.5|| The event is triggered when a webbrowser starts loading a page. }} ==Parameters== <syntaxhighlight lan..."

__NOTOC__
{{Client event}}
{{New feature/item|3.0150|1.5||
The event is triggered when a [[Browser|webbrowser]] starts loading a page.
}}

==Parameters==
<syntaxhighlight lang="lua">
string URL, boolean isMain
</syntaxhighlight>
*'''URL:''' [[string]] containing the URL that will be loaded.
*'''isMain:''' [[boolean]] true if the URL is loaded in the main frame. false if the URL is loaded in a sub-frame, e.g. in an iFrame.

==Source==
The [[Browser|webbrowser]] element.

==Example==
<syntaxhighlight lang="lua">
local browser = guiCreateBrowser(0, 0, 800, 600, false, false, false)
local theBrowser = guiGetBrowser(browser)
showCursor(true)

addEventHandler("onClientBrowserLoadingStart", theBrowser, function(url, isMain)
if (isMain) then
outputChatBox("Loading "..url.." in the main frame...")
else
outputChatBox("Loading "..url.." in a sub main frame...")
end
end)

addEventHandler("onClientBrowserCreated", theBrowser, function()
loadBrowserURL(source, "https://www.w3schools.com/html/html_iframe.asp")
end)
</syntaxhighlight>

==See Also==
{{CEF_events}}

OnClientBrowserTooltip

2018-09-19T19:55:20Z

Lars-Marcel:

__NOTOC__
{{Client event}}
{{New feature/item|3.0150|1.5||
The event is triggered when the user hovers a tooltip.
}}

==Parameters==
<syntaxhighlight lang="lua">
string text
</syntaxhighlight>
*'''text:''' [[string]] containing the tooltip text. Empty string if user is not longer hovering.

==Source==
The [[Browser|webbrowser]] element.

==Example==
If the user hovers the Google search input field 'Tooltip-Text: Search' will be printed in the chatbox.
<syntaxhighlight lang="lua">
local browser = guiCreateBrowser(0, 0, 800, 600, false, false, false)
local theBrowser = guiGetBrowser(browser)
showCursor(true)

addEventHandler( "onClientBrowserCreated", theBrowser, function()
loadBrowserURL(source, "https://www.google.com/?ncr&hl=en")
end)

addEventHandler("onClientBrowserTooltip", root, function(text)
if (text ~= "") then
outputChatBox("Tooltip-Text: "..text)
else
outputChatBox("You are not longer hovering a tooltip")
end
end)
</syntaxhighlight>

==See Also==
{{CEF_events}}

OnClientBrowserTooltip

2018-09-19T19:55:03Z

Lars-Marcel: Created page with "__NOTOC__ {{Client event}} {{New feature/item|3.0150|1.5|| The event is triggered when the user hovers a tooltip. }} ==Parameters== <syntaxhighlight lang="lua"> string text..."

OnClientBrowserWhitelistChange

2018-09-19T19:24:49Z

Lars-Marcel:

__NOTOC__
{{Client event}}
{{New feature/item|3.0150|1.5||
The event is triggered when the whitelist has changed. Note that this event is only triggered if the request window was confirmed by accepting.
}}
{{Note|Attaching the event to a webbrowser won't work. Attach it to the root element instead.}}

==Parameters==
<syntaxhighlight lang="lua">
table changedDomains
</syntaxhighlight>
*'''changedDomains:''' a [[table]] of changed domains.

==Source==
The [[Element_tree#Tree_elements|root]] element.

==Example==
<syntaxhighlight lang="lua">
requestBrowserDomains({ "mtasa.com" }) -- request browser domain
showCursor(true) -- show cursor
addEventHandler("onClientBrowserWhitelistChange", root,
function(newDomains)
if newDomains[1] == "mtasa.com" then
local browser = createBrowser(1280, 720, false, false) -- create browser
loadBrowserURL(browser, "http://mtasa.com/") -- load browser url
end
end
)
</syntaxhighlight>

[[pl:onClientBrowserWhitelistChange]]

==See Also==
{{CEF_events}}