Skip to content

Latest commit

 

History

History
31 lines (21 loc) · 1.49 KB

Namespaces.md

File metadata and controls

31 lines (21 loc) · 1.49 KB
Raw

API Reference ▸ Core ▸ Namespaces

The D3 4.0 API Reference has moved. This page describes the D3 3.x API.

SVG has a different namespace from HTML, so D3 provides a few tools to simplify dealing with namespaces.

# d3.ns.prefix

The map of registered namespace prefixes. The default value is:

{
  svg: "http://www.w3.org/2000/svg",
  xhtml: "http://www.w3.org/1999/xhtml",
  xlink: "http://www.w3.org/1999/xlink",
  xml: "http://www.w3.org/XML/1998/namespace",
  xmlns: "http://www.w3.org/2000/xmlns/"
}

Additional prefixes may be assigned as needed to create elements or attributes in other namespaces.

# d3.ns.qualify(name)

Qualifies the specified name, which may have a namespace prefix. If the name contains a colon (":"), the substring before the colon is interpreted as the namespace prefix, which must be registered in d3.ns.prefix; the return value is an object with space and local attributes containing the full namespace URL and the local name. For example, the result of qualify("svg:text") is:

{space: "http://www.w3.org/2000/svg", local: "text"}

If the name does not contain a colon, this function merely returns the input name. This function is used internally to decide whether to use a namespaced method (such as createElementNS) or a non-namespaced equivalent.