mozilla
Your Search Results

    findbar

    In Gecko 1.9, the findbar widget moved into toolkit, so it's available to any XUL application, as well as extensions.

    For example, the standard findbar in Firefox 3.5 looks like this on the Mac:

    findbar.png

    You may attach a findbar to a particular browser element by either setting the findbar's browserid attribute to the ID of the browser element before the findbar element is bound, or by setting the findbar's browser property to the browser element itself.

    Attributes
    browserid, findnextaccesskey, findpreviousaccesskey, highlightaccesskey, matchcaseaccesskey
    Properties
    browser, findMode
    Methods
    close, onFindAgainCommand, open, startFind, toggleHighlight

    Example

    <browser type="content-primary" flex="1" id="content" src="about:blank"/>
    <findbar id="FindToolbar" browserid="content"/>
    

    Attributes

    browserid
    Type: string
    The ID of the browser element to which the findbar is attached.  This attribute is only used when the findbar is constructed.  You should use the browser property to get and set this value from a script.
    findnextaccesskey
    Type: string
    The access key for the "Find Next" toolbar button in the findbar.
    findpreviousaccesskey
    Type: string
    The access key for the "Find Previous" toolbar button in the findbar.
    highlightaccesskey
    Type: string
    The access key for the "Highlight" toolbar button in the findbar.
    matchcaseaccesskey
    Type: string
    The access key for the "Match case" checkbox in the findbar.

    Properties

    Inherited Properties
    align, attributes, allowEvents, baseURI, boxObject, builder, childElementCount, childNodes, children, className, clientHeight, clientLeft, clientTop, clientWidth, collapsed, contextMenu, controllers, database, datasources, dir, firstChild, firstElementChild, flex, height, hidden, id, lastChild, lastElementChild, left, localName, maxHeight, maxWidth, menu, minHeight, minWidth, namespaceURI, nextElementSibling, nextSibling, nodeName, nodeType, nodeValue, observes, ordinal, orient, ownerDocument, pack, parentNode, persist, prefix, previousElementSibling, previousSibling, ref, resource, scrollHeight, scrollLeft, scrollTop, scrollWidth, statusText, style, tagName,textContent, tooltip, tooltipText, top, width

    browser
    Type: browser element
    Lets you set and get the browser in which the findbar is located.
    findMode
    Type: integer
    Read only.  The find mode in use.  Possible values are:
    • FIND_NORMAL (0): Normal find
    • FIND_TYPEAHEAD (1): Typeahead find
    • FIND_LINKS (2): Link find

    Methods

    Inherited Methods
    addEventListener(), appendChild(), blur, click, cloneNode(), compareDocumentPosition, dispatchEvent(), doCommand, focus, getAttribute(), getAttributeNode(), getAttributeNodeNS(), getAttributeNS(), getBoundingClientRect(), getClientRects(), getElementsByAttribute, getElementsByAttributeNS, getElementsByClassName(), getElementsByTagName(), getElementsByTagNameNS(), getFeature, getUserData, hasAttribute(), hasAttributeNS(), hasAttributes(), hasChildNodes(), insertBefore(), isDefaultNamespace(), isEqualNode, isSameNode, isSupported(), lookupNamespaceURI, lookupPrefix, normalize(), querySelector(), querySelectorAll(), removeAttribute(), removeAttributeNode(), removeAttributeNS(), removeChild(), removeEventListener(), replaceChild(), setAttribute(), setAttributeNode(), setAttributeNodeNS(), setAttributeNS(), setUserData

    close()
    Return type: no return value
    Closes the notification or findbar and removes it from its enclosing notificationbox or findbar.
    open( mode )
    Return type: no return value
    Opens the findbar using the specified mode, which should be one of FIND_NORMAL, FIND_TYPEAHEAD, or FIND_LINKS.  If you don't pass a mode, the last-used mode for the same findbar is used.  If the findbar hasn't been used before, FIND_NORMAL is the default.
    onFindAgainCommand( findPrevious )
    Return type: no return value
    Call this method to handle your application's "find next" and "find previous" commands.  You should specify true as the input parameter to perform a "find previous" operation, or false to perform a "find next."
    startFind( mode )
    Return type: no return value
    Call this method to handle your application's "find" command.  This opens the findbar, focuses the edit field for the search term, and selects its contents.  The first time this is called for a given findbar, the findbar will flash to draw attention to itself.  The mode should be one of FIND_NORMAL, FIND_TYPEAHEAD, or FIND_LINKS.  If you don't pass a mode, the last-used mode for the same findbar is used.  If the findbar hasn't been used before, FIND_NORMAL is the default.
    toggleHighlight( highlight )
    Return type: no return value
    Turns highlighting of text matching the search term on and off; specify false to disable highlighting or true to enable it.

    Document Tags and Contributors

    Contributors to this page: Sheppy, Wladimir_Palant, Standard8, Jürgen Jeka
    Last updated by: Sheppy,