SelfNavigate - Develop Apps | Community Toolbar

Conduit API

Case Study

HTML Apps -> SelfNavigate

This function navigates an HTML component or gadget to a specified URL. Optionally, the width of the component can also be changed.

- Syntax

SelfNavigate(url, newWidth)

- Parameters

Parameter	Description	Range	Type
url	The URL for the HTML component or gadget window.	not null or empty	string
newWidth	The new width (in pixels) for the HTML component or for the gadget window. This parameter is optional.	>0	int

- Return Value

null

- Remarks

This function can be used both with the HTML component and with the gadget window.
*Notice: API methods must be invoked after the web page has triggered the "onload" event.

- Code Example

HTML | Gadget

This example contains an icon SelfNavigate

that when clicked, will navigate you to the URL of the main frame.

<html>
<head>
<style type= "text/css">
BODY
{
margin-left:0;
margin-right:0;
margin-top:0;
margin-bottom:0;
width:100%;
height:100%;
overflow:hidden;
background-color:threedface;
}
</style>
<!-- Conduit API script declaration -->
<script type="text/javascript" language="javascript" src="http://api.conduit.com/BrowserCompApi.js"></script>
<script language="javascript" type="text/javascript">
 
    function NavigateToMainURL() {
        var strMainFrameUrl = GetMainFrameUrl();
        SelfNavigate(strMainFrameUrl, 250);
    }
</script>
</head>
<body>
<img alt="SelfNavigation" style="vertical-align:bottom" src="http://www.conduit.com/developers/api/Images/Toolbars/HTML/GetMainFrameUrl.gif" onclick="NavigateToMainURL()" />
</body>
</html>

<html>
<head>
<style type= "text/css">
BODY
{
margin-left:0;
margin-right:0;
margin-top:0;
margin-bottom:0;
width:100%;
height:100%;
overflow:hidden;
background-color:threedface;
}
</style>
<!-- Conduit API script declaration -->
<script type="text/javascript" language="javascript" src="http://api.conduit.com/BrowserCompApi.js"></script>
<script language="javascript" type="text/javascript">
     function Navigate() {
        var width = document.getElementById('txtWidth').value;
        var strUrl = document.getElementById('txtUrl').value;
        SelfNavigate(strUrl, width);
    }
</script>
</head>
<body>
<div>Width:<input type="text" id="txtWidth" /></div>
<div>URL:<input type="text" id="txtUrl" /></div>
<div><input type="button" onclick="Navigate()" value="Self Nav" /></div>
</body>
</html>

- Code Usage

See code usage for HTML component
See code usage for gadget