HistoryNav

HistoryNav makes a selection list containing recently visited sites and goes to them when selected. After being instantiated, the selection list tracks all Web pages visited by the user and lists them as options in the list. Choosing a selection transfers the user back to that page in the history list.

Properties

name

DisplayName - Name
Description - (REQUIRED) Enter unique name of the control. Must exactly match the name of the corresponding JavaScript object on the page.
DefaultValue - HistoryNavComponent1

selectName

DisplayName - Name of HTML Select Object
Description - Enter the name of the HTML select object.
Type - String

domain

DisplayName - Domain
Description - The domain name being accessed (e.g. netobjects.com)

firstLabel

DisplayName - First Label
Description - Enter the label that you wish to have the first time the component opens

size

DisplayName - Size
Description - Enter the number of links that you wish to have a history of.


Methods

void addLink(void)
Function:addLink
Input:None
Return:None
Description:This function adds a url and corresponding optional label to the links and labels arrays. It then calls update() to update the HTML select list.


string getOpenerURL(void)

Function:getOpenerURL
Input:None
Return:String - URL of the opener window or "" otherwise
Description:This function compares the url parameter to all links and labels stored. It returns true or false to indicate whether or not url is a duplicate of a link already stored.


boolean isDuplicateURL( string )

Function:isDuplicateURL
Input:String - url
Return:Boolean - true if the url is duplicate
Description:This function compares the url parameter to all links and labels stored. It returns true or false to indicate whether or not url is a duplicate of a link already stored.


void refreshLinks(void)

Function:refreshLinks
Input:None
Return:None
Description:This function refreshes the links and labels arrays by removing the oldest (first) link and label in each array, then moving the other links over one position. This method is used to keep the list from exceeding this.maxItems.


void render(void)

Function:render
Input:None
Return:None
Description:This function writes out all necessary HTML to render the initial select list on the page. You should not call this function more than once per object.


void update(void)

Function:update
Input:None
Return:None
Description: This function uses the links and labels arrays to update the HTML select list on the form.


void validateLocation(void)

Function:validateLocation
Input:None
Return:None
Description:This function validates any locations discovered when the opener window's location changes. If the location is valid, the link and label are added to the lists of links.


void historyListener(void)

Function:historyListener
Input:None
Return:None
Description:This function will start a setTimeOut function running that will track all of URL's for this objects.


Events

None

Other Information

Environment: Client