In order to access this site you need to enable JavaScript!

You are here: Reference > JavaScript > client-side > xml handling > properties > prefix (attribute, Element)

prefix property (attribute, Element)

Browser support:

Sets or returns the namespace prefix of the current node.

To set or return the namespace URI of a node, use the namespaceURI property. If you need the name of a node, use the localName and baseName properties in XML documents and the nodeName and tagName properties in HTML documents.

Syntax:

object.prefix;

You can find the related objects in the Supported by objects section below.

This property is read/write.

Possible values:

String that specifies or retrieves the namespace prefix.

Default: this property has no default value.

Example HTML code 1:

This example illustrates the use of the prefix property:

Code

ajax.js

ns.xml

<head>
    <script type="text/javascript" src="ajax.js"></script>
    
    <script type="text/javascript">
        var httpRequest = null;
        
        function SendRequest () {
            if (!httpRequest) {
                httpRequest = CreateHTTPRequestObject ();   // defined in ajax.js
            }
            if (httpRequest) {          
                    // The requested file must be in the same domain that the page is served from.
                var url = "ns.xml";
                httpRequest.open ("GET", url, true);    // async
                httpRequest.onreadystatechange = OnStateChange;
                httpRequest.send (null);
            }
        }

        function OnStateChange () {
            if (httpRequest.readyState == 0 || httpRequest.readyState == 4) {
                if (IsRequestSuccessful (httpRequest)) {    // defined in ajax.js
                    GetTagInfo ();
                }
                else {
                    alert ("Operation failed.");
                }
            }
        }

        function GetTagInfo () {
            var xmlDoc = ParseHTTPResponse (httpRequest);   // defined in ajax.js
            if (!xmlDoc)
                return;

            if (xmlDoc.getElementsByTagNameNS) {    // Firefox, Opera, Google Chrome and Safari
                var titleTags = xmlDoc.getElementsByTagNameNS ("http://help.dottoro.com/NS", "title");
                if (titleTags.length > 0) {
                    var message = "The localName of the first title tag: " + titleTags[0].localName + "\n" +
                                   "The namespaceURI of the first title tag: " + titleTags[0].namespaceURI + "\n" +
                                   "The prefix of the first title tag: " + titleTags[0].prefix;
                    alert (message);
                }
                else {
                    alert ("There is no title tag!");
                }
            }
            else {      // Internet Explorer
                var titleTags = xmlDoc.getElementsByTagName ("dotto:title");
                if (titleTags.length > 0) {
                    var message = "The localName of the first title tag: " + titleTags[0].baseName + "\n" +
                                   "The namespaceURI of the first title tag: " + titleTags[0].namespaceURI + "\n" +
                                   "The prefix of the first title tag: " + titleTags[0].prefix;
                    alert (message);
                }
                else {
                    alert ("There is no title tag!");
                }
            }
        }

    </script>
</head>
<body>
    <button onclick="SendRequest ()">Get localName, namespaceURI and prefix</button>
</body>


function CreateHTTPRequestObject () {
        // although IE supports the XMLHttpRequest object, but it does not work on local files.
    var forceActiveX = (window.ActiveXObject && location.protocol === "file:");
    if (window.XMLHttpRequest && !forceActiveX) {
        return new XMLHttpRequest();
    }
    else {
        try {
            return new ActiveXObject("Microsoft.XMLHTTP");
        } catch(e) {}
    }
    alert ("Your browser doesn't support XML handling!");
    return null;
}

function CreateMSXMLDocumentObject () {
    if (typeof (ActiveXObject) != "undefined") {
        var progIDs = [
                        "Msxml2.DOMDocument.6.0", 
                        "Msxml2.DOMDocument.5.0", 
                        "Msxml2.DOMDocument.4.0", 
                        "Msxml2.DOMDocument.3.0", 
                        "MSXML2.DOMDocument", 
                        "MSXML.DOMDocument"
                      ];
        for (var i = 0; i < progIDs.length; i++) {
            try { 
                return new ActiveXObject(progIDs[i]); 
            } catch(e) {};
        }
    }
    return null;
}

function CreateXMLDocumentObject (rootName) {
    if (!rootName) {
        rootName = "";
    }
    var xmlDoc = CreateMSXMLDocumentObject ();
    if (xmlDoc) {
        if (rootName) {
            var rootNode = xmlDoc.createElement (rootName);
            xmlDoc.appendChild (rootNode);
        }
    }
    else {
        if (document.implementation.createDocument) {
            xmlDoc = document.implementation.createDocument ("", rootName, null);
        }
    }
    
    return xmlDoc;
}

function ParseHTTPResponse (httpRequest) {
    var xmlDoc = httpRequest.responseXML;

            // if responseXML is not valid, try to create the XML document from the responseText property
    if (!xmlDoc || !xmlDoc.documentElement) {
        if (window.DOMParser) {
            var parser = new DOMParser();
            try {
                xmlDoc = parser.parseFromString (httpRequest.responseText, "text/xml");
            } catch (e) {
                alert ("XML parsing error");
                return null;
            };
        }
        else {
            xmlDoc = CreateMSXMLDocumentObject ();
            if (!xmlDoc) {
                return null;
            }
            xmlDoc.loadXML (httpRequest.responseText);

        }
    }

            // if there was an error while parsing the XML document
    var errorMsg = null;
    if (xmlDoc.parseError && xmlDoc.parseError.errorCode != 0) {
        errorMsg = "XML Parsing Error: " + xmlDoc.parseError.reason
                  + " at line " + xmlDoc.parseError.line
                  + " at position " + xmlDoc.parseError.linepos;
    }
    else {
        if (xmlDoc.documentElement) {
            if (xmlDoc.documentElement.nodeName == "parsererror") {
                errorMsg = xmlDoc.documentElement.childNodes[0].nodeValue;
            }
        }
    }
    if (errorMsg) {
        alert (errorMsg);
        return null;
    }

        // ok, the XML document is valid
    return xmlDoc;
}

    // returns whether the HTTP request was successful
function IsRequestSuccessful (httpRequest) {
        // IE: sometimes 1223 instead of 204
    var success = (httpRequest.status == 0 || 
        (httpRequest.status >= 200 && httpRequest.status < 300) || 
        httpRequest.status == 304 || httpRequest.status == 1223);
    
    return success;
}

<?xml version="1.0" encoding="utf-8"?>
<ns xmlns="http://help.dottoro.com/defaultNS" xmlns:dotto="http://help.dottoro.com/NS">
    <item dotto:color="red">
        <dotto:title>Namespace example</dotto:title>
        <dotto:description>Describes how to use namespaces with tags and attributes.</dotto:description>
        <dotto:pubDate>Wed, 17 Aug 2009 13:58:41 +0200</dotto:pubDate>
        <dotto:link>http://help.dottoro.com</dotto:link>
    </item>
    <order>
        <dotto:param name="sortBy" value="title" />
        <dotto:param name="sortDir" value="ascending" />
    </order>
</ns>