mirror of
https://github.com/d3/d3.git
synced 2025-12-08 19:46:24 +00:00
583ff0e676
* an example of using an explicit namespace * Update docs/d3-selection/namespaces.md * space --------- Co-authored-by: Mike Bostock <mbostock@gmail.com>
41 lines
1.6 KiB
Markdown
41 lines
1.6 KiB
Markdown
# Namespaces
|
|
|
|
XML namespaces are fun! Right? 🤪 Fortunately you can mostly ignore them.
|
|
|
|
A case where you need to specify them is when appending an element to a parent that belongs to a different namespace; typically, to create a [div](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/div) inside a SVG [foreignObject](https://developer.mozilla.org/en-US/docs/Web/SVG/Element/ForeignObject) element:
|
|
|
|
```js
|
|
d3.create("svg")
|
|
.append("foreignObject")
|
|
.attr("width", 300)
|
|
.attr("height", 100)
|
|
.append("xhtml:div")
|
|
.text("Hello, HTML!");
|
|
```
|
|
|
|
## namespace(*name*) {#namespace}
|
|
|
|
[Source](https://github.com/d3/d3-selection/blob/main/src/namespace.js) · Qualifies the specified *name*, which may or may not have a namespace prefix.
|
|
|
|
```js
|
|
d3.namespace("svg:text") // {space: "http://www.w3.org/2000/svg", local: "text"}
|
|
```
|
|
|
|
If the name contains a colon (`:`), the substring before the colon is interpreted as the namespace prefix, which must be registered in [d3.namespaces](#namespaces). Returns an object `space` and `local` attributes describing the full namespace URL and the local name. If the name does not contain a colon, this function merely returns the input name.
|
|
|
|
## namespaces
|
|
|
|
[Source](https://github.com/d3/d3-selection/blob/main/src/namespaces.js) · The map of registered namespace prefixes. The initial value is:
|
|
|
|
```js
|
|
{
|
|
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.
|