WebCola
Options
All
  • Public
  • Public/Protected
  • All
Menu

A D3 Selection of elements.

The first generic "GElement" refers to the type of the selected element(s). The second generic "Datum" refers to the type of the datum of a selected element(s). The third generic "PElement" refers to the type of the parent element(s) in the D3 selection. The fourth generic "PDatum" refers to the type of the datum of the parent element(s).

Type parameters

Hierarchy

  • Selection

Index

Methods

append

  • append<ChildElement>(type: string): Selection<ChildElement, Datum, PElement, PDatum>
  • append<ChildElement>(type: ValueFn): Selection<ChildElement, Datum, PElement, PDatum>
  • Appends a new element of the specified type (tag name) as the last child of each selected element, or the next following sibling in the update selection if this is an enter selection. (The enter behavior allows you to insert elements into the DOM in an order consistent with bound data; however, the slower selection.order may still be required if updating elements change order.)

    This method returns a new selection containing the appended elements. Each new element inherits the data of the current elements, if any.

    The generic refers to the type of the child element to be appended.

    Type parameters

    Parameters

    • type: string

      A string representing the tag name. The specified name may have a namespace prefix, such as svg:text to specify a text attribute in the SVG namespace. If no namespace is specified, the namespace will be inherited from the parent element; or, if the name is one of the known prefixes, the corresponding namespace will be used (for example, svg implies svg:svg)

    Returns Selection<ChildElement, Datum, PElement, PDatum>

  • Appends a new element of the type provided by the element creator function as the last child of each selected element, or the next following sibling in the update selection if this is an enter selection. (The enter behavior allows you to insert elements into the DOM in an order consistent with bound data; however, the slower selection.order may still be required if updating elements change order.)

    This method returns a new selection containing the appended elements. Each new element inherits the data of the current elements, if any.

    The generic refers to the type of the child element to be appended.

    Type parameters

    Parameters

    • type: ValueFn

      A creator function which is evaluated for each selected element, in order, being passed the current datum (d), the current index (i), and the current group (nodes), with this as the current DOM element. This function should return an element to be appended. (The function typically creates a new element, but it may instead return an existing element.)

    Returns Selection<ChildElement, Datum, PElement, PDatum>

attr

  • attr(name: string): string
  • attr(name: string, value: null)
  • attr(name: string, value: string | number | boolean)
  • attr(name: string, value: ValueFn)
  • Return the current value of the specified attribute for the first (non-null) element in the selection. This is generally useful only if you know that the selection contains exactly one element.

    Parameters

    • name: string

      Name of the attribute

    Returns string

  • Clear the attribute with the specified name for the selected elements and returns this selection.

    Parameters

    • name: string

      Name of the attribute

    • value: null

      null,to clear the attribute

  • Sets the value of the attribute with the specified name for the selected elements and returns this selection. All elements are given the same attribute value.

    Parameters

    • name: string

      Name of the attribute

    • value: string | number | boolean

      Constant value for the attribute

  • Sets the value of the attribute with the specified name for the selected elements and returns this selection. The value for the individual selected elements is determined by the value function.

    Parameters

    • name: string

      Name of the attribute

    • value: ValueFn

      A value function which is evaluated for each selected element, in order, being passed the current datum (d), the current index (i), and the current group (nodes), with this as the current DOM element. A null value will clear the attribute.

call

  • call(func: function, ...args: any[])
  • Invoke the specified function exactly once, passing in this selection along with any optional arguments. Returns this selection.

    Parameters

    • func: function

      A function which is passed this selection as the first argument along with any optional arguments.

        • (selection: Selection<GElement, Datum, PElement, PDatum>, ...args: any[]): void
        • Parameters

          • selection: Selection<GElement, Datum, PElement, PDatum>
          • Rest ...args: any[]

          Returns void

    • Rest ...args: any[]

      List of optional arguments to be passed to the callback function.

classed

  • classed(names: string): boolean
  • classed(names: string, value: boolean)
  • classed(names: string, value: ValueFn)
  • Returns true if and only if the first (non-null) selected element has the specified classes. This is generally useful only if you know the selection contains exactly one element.

    Parameters

    • names: string

    Returns boolean

  • Assigns or unassigns the specified CSS class names on the selected elements by setting the class attribute or modifying the classList property and returns this selection. If the constant value is truthy, then all elements are assigned the specified classes; otherwise, the classes are unassigned.

    Parameters

    • names: string

      A string of space-separated class names.

    • value: boolean

      A boolean flag (true = assign / false = unassign)

  • Assigns or unassigns the specified CSS class names on the selected elements by setting the class attribute or modifying the classList property and returns this selection. The assign/unassign status for the individual selected elements is determined by the boolean return value of the value function.

    Parameters

    • names: string

      A string of space-separated class names.

    • value: ValueFn

      A value function which is evaluated for each selected element, in order, being passed the current datum (d), the current index (i), and the current group (nodes), with this as the current DOM element. The function’s return value is then used to assign or unassign classes on each element.

data

  • data(): Datum[]
  • data<NewDatum>(data: NewDatum[], key?: ValueFn): Selection<GElement, NewDatum, PElement, PDatum>
  • data<NewDatum>(data: ValueFn, key?: ValueFn): Selection<GElement, NewDatum, PElement, PDatum>
  • Returns the array of data for the selected elements.

    Returns Datum[]

  • Joins the specified array of data with the selected elements, returning a new selection that it represents the update selection: the elements successfully bound to data. Also defines the enter and exit selections on the returned selection, which can be used to add or remove elements to correspond to the new data.

    The data is specified for each group in the selection. If the selection has multiple groups (such as d3.selectAll followed by selection.selectAll), then data should typically be specified as a function.

    If a key function is not specified, then the first datum in data is assigned to the first selected element, the second datum to the second selected element, and so on. A key function may be specified to control which datum is assigned to which element, replacing the default join-by-index.

    The update and enter selections are returned in data order, while the exit selection preserves the selection order prior to the join. If a key function is specified, the order of elements in the selection may not match their order in the document; use selection.order or selection.sort as needed.

    This method cannot be used to clear bound data; use selection.datum instead.

    For details see:

    The generic refers to the type of the new datum to be used for the selected elements.

    Type parameters

    • NewDatum

    Parameters

    • data: NewDatum[]

      The specified data is an array of arbitrary values (e.g., numbers or objects).

    • Optional key: ValueFn

      An optional key function which is evaluated for each selected element, in order, being passed the current datum (d), the current index (i), and the current group (nodes), with this as the current DOM element. The key function is then also evaluated for each new datum in data, being passed the current datum (d), the current index (i), and the group’s new data, with this as the group’s parent DOM element. The datum for a given key is assigned to the element with the matching key. If multiple elements have the same key, the duplicate elements are put into the exit selection; if multiple data have the same key, the duplicate data are put into the enter selection.

    Returns Selection<GElement, NewDatum, PElement, PDatum>

  • Joins the data returned by the specified value function with the selected elements, returning a new selection that it represents the update selection: the elements successfully bound to data. Also defines the enter and exit selections on the returned selection, which can be used to add or remove elements to correspond to the new data.

    The data is specified for each group in the selection.

    If a key function is not specified, then the first datum in data is assigned to the first selected element, the second datum to the second selected element, and so on. A key function may be specified to control which datum is assigned to which element, replacing the default join-by-index.

    The update and enter selections are returned in data order, while the exit selection preserves the selection order prior to the join. If a key function is specified, the order of elements in the selection may not match their order in the document; use selection.order or selection.sort as needed.

    This method cannot be used to clear bound data; use selection.datum instead.

    For details see:

    The generic refers to the type of the new datum to be used for the selected elements.

    Type parameters

    • NewDatum

    Parameters

    • data: ValueFn

      A value function which will be evaluated for each group in order, being passed the group’s parent datum (d, which may be undefined), the group index (i), and the selection’s parent nodes (nodes), with this as the group’s parent element. The function returns an array of values for each group.

    • Optional key: ValueFn

      An optional key function which is evaluated for each selected element, in order, being passed the current datum (d), the current index (i), and the current group (nodes), with this as the current DOM element. The key function is then also evaluated for each new datum in data, being passed the current datum (d), the current index (i), and the group’s new data, with this as the group’s parent DOM element. The datum for a given key is assigned to the element with the matching key. If multiple elements have the same key, the duplicate elements are put into the exit selection; if multiple data have the same key, the duplicate data are put into the enter selection.

    Returns Selection<GElement, NewDatum, PElement, PDatum>

datum

  • datum(): Datum
  • datum(value: null): Selection<GElement, undefined, PElement, PDatum>
  • datum<NewDatum>(value: ValueFn): Selection<GElement, NewDatum, PElement, PDatum>
  • datum<NewDatum>(value: NewDatum): Selection<GElement, NewDatum, PElement, PDatum>
  • Returns the bound datum for the first (non-null) element in the selection. This is generally useful only if you know the selection contains exactly one element.

    Returns Datum

  • Delete the bound data for each element in the selection.

    Parameters

    • value: null

    Returns Selection<GElement, undefined, PElement, PDatum>

  • Sets the element’s bound data using the specified value function on all selected elements. Unlike selection.data, this method does not compute a join and does not affect indexes or the enter and exit selections.

    The generic refers to the type of the new datum to be used for the selected elements.

    Type parameters

    • NewDatum

    Parameters

    • value: ValueFn

      A value function which is evaluated for each selected element, in order, being passed the current datum (d), the current index (i), and the current group (nodes), with this as the current DOM element. The function is then used to set each element’s new data. A null value will delete the bound data.

    Returns Selection<GElement, NewDatum, PElement, PDatum>

  • Sets the element’s bound data to the specified value on all selected elements. Unlike selection.data, this method does not compute a join and does not affect indexes or the enter and exit selections.

    The generic refers to the type of the new datum to be used for the selected elements.

    Type parameters

    • NewDatum

    Parameters

    • value: NewDatum

      A value object to be used as the datum for each element.

    Returns Selection<GElement, NewDatum, PElement, PDatum>

dispatch

  • Dispatches a custom event of the specified type to each selected element, in order. An optional parameters map may be specified to set additional properties of the event.

    Parameters

    • type: string

      Name of event to dispatch

    • Optional parameters: CustomEventParameters

      An optional value map with custom event parameters

  • Dispatches a custom event of the specified type to each selected element, in order. An optional value function returning a parameters map for each element in the selection may be specified to set additional properties of the event.

    Parameters

    • type: string

      Name of event to dispatch

    • Optional parameters: ValueFn

      A value function which is evaluated for each selected element, in order, being passed the current datum (d), the current index (i), and the current group (nodes), with this as the current DOM element. It must return the parameters map for the current element.

each

  • Invoke the specified function for each selected element, passing in the current datum (d), the current index (i), and the current group (nodes), with this of the current DOM element. This method can be used to invoke arbitrary code for each selected element, and is useful for creating a context to access parent and child data simultaneously.

    Parameters

    • func: ValueFn

      A function which is invoked for each selected element, being passed the current datum (d), the current index (i), and the current group (nodes), with this of the current DOM element.

empty

  • empty(): boolean
  • Return true if this selection contains no (non-null) elements.

    Returns boolean

enter

  • Return the enter selection: placeholder nodes for each datum that had no corresponding DOM element in the selection. The enter selection is determined by selection.data, and is empty on a selection that is not joined to data.

    Returns Selection<EnterElement, Datum, PElement, PDatum>

exit

  • exit<OldDatum>(): Selection<GElement, OldDatum, PElement, PDatum>
  • Return the exit selection: existing DOM elements in the selection for which no new datum was found. The exit selection is determined by the previous selection.data, and is thus empty until the selection is joined to data. If the exit selection is retrieved more than once after a data join, subsequent calls return the empty selection.

    IMPORTANT: The generic refers to the type of the old datum associated with the exit selection elements. Ensure you set the generic to the correct type, if you need to access the data on the exit selection in follow-up steps, e.g. to set styles as part of an exit transition before removing them.

    Type parameters

    • OldDatum

    Returns Selection<GElement, OldDatum, PElement, PDatum>

filter

  • filter(selector: string): Selection<GElement, Datum, PElement, PDatum>
  • filter<FilteredElement>(selector: string): Selection<FilteredElement, Datum, PElement, PDatum>
  • filter(selector: ValueFn): Selection<GElement, Datum, PElement, PDatum>
  • filter<FilteredElement>(selector: ValueFn): Selection<FilteredElement, Datum, PElement, PDatum>
  • Filters the selection, returning a new selection that contains only the elements for which the specified filter is true.

    The returned filtered selection preserves the parents of this selection, but like array.filter, it does not preserve indexes as some elements may be removed; use selection.select to preserve the index, if needed.

    Parameters

    • selector: string

      A CSS selector string to match when filtering.

    Returns Selection<GElement, Datum, PElement, PDatum>

  • Filters the selection, returning a new selection that contains only the elements for which the specified filter is true.

    The returned filtered selection preserves the parents of this selection, but like array.filter, it does not preserve indexes as some elements may be removed; use selection.select to preserve the index, if needed.

    The generic refers to the type of element which will be selected after applying the filter, i.e. if the element types contained in a pre-filter selection are narrowed to a subset as part of the filtering.

    Type parameters

    Parameters

    • selector: string

      A CSS selector string to match when filtering.

    Returns Selection<FilteredElement, Datum, PElement, PDatum>

  • Filter the selection, returning a new selection that contains only the elements for which the specified filter is true.

    The returned filtered selection preserves the parents of this selection, but like array.filter, it does not preserve indexes as some elements may be removed; use selection.select to preserve the index, if needed.

    Parameters

    • selector: ValueFn

      A value function which is evaluated for each selected element, in order, being passed the current datum (d), the current index (i), and the current group (nodes), with this as the current DOM element. This function should return true for an element to be included, and false otherwise.

    Returns Selection<GElement, Datum, PElement, PDatum>

  • Filter the selection, returning a new selection that contains only the elements for which the specified filter is true.

    The returned filtered selection preserves the parents of this selection, but like array.filter, it does not preserve indexes as some elements may be removed; use selection.select to preserve the index, if needed.

    Type parameters

    Parameters

    • selector: ValueFn

      A value function which is evaluated for each selected element, in order, being passed the current datum (d), the current index (i), and the current group (nodes), with this as the current DOM element. This function should return true for an element to be included, and false otherwise.

    Returns Selection<FilteredElement, Datum, PElement, PDatum>

html

  • html(): string
  • html(value: null)
  • html(value: string)
  • html(value: ValueFn)
  • Returns a string representation of the inner HTML for the first (non-null) element in the selection. This is generally useful only if you know the selection contains exactly one element.

    Returns string

  • Clear the html content of the selected elements and return the selection.

    Parameters

    • value: null
  • Sets the inner HTML to the specified value on all selected elements, replacing any existing child elements. All elements are given the same inner HTML

    Parameters

    • value: string

      String representation of inner HTML.

  • Sets the inner HTML to the specified value on all selected elements, replacing any existing child elements. The inner HTML is determined for each individual element using a value function.

    Parameters

    • value: ValueFn

      A value function which is evaluated for each selected element, in order, being passed the current datum (d), the current index (i), and the current group (nodes), with this as the current DOM element. The function’s return value is then used to set each element’s inner HTML. A null value will clear the content.

insert

  • insert<ChildElement>(type: string | ValueFn, before?: string | ValueFn): Selection<ChildElement, Datum, PElement, PDatum>
  • Inserts a new element of the specified type (tag name) before the element matching the specified "before" selector string for each selected element.

    This method returns a new selection containing the appended elements. Each new element inherits the data of the current elements, if any.

    The generic refers to the type of the child element to be appended.

    Type parameters

    Parameters

    • type: string | ValueFn

      One of:

      • A string representing the tag name for the element type to be inserted. The specified name may have a namespace prefix, such as svg:text to specify a text attribute in the SVG namespace. If no namespace is specified, the namespace will be inherited from the parent element; or, if the name is one of the known prefixes, the corresponding namespace will be used (for example, svg implies svg:svg)
      • A creator function which is evaluated for each selected element, in order, being passed the current datum (d), the current index (i), and the current group (nodes), with this as the current DOM element. This function should return an element to be inserted. (The function typically creates a new element, but it may instead return an existing element.)
    • Optional before: string | ValueFn

      One of:

      • A CSS selector string for the element before which the insertion should occur.
      • A child selector function which is evaluated for each selected element, in order, being passed the current datum (d), the current index (i), and the current group (nodes), with this as the current DOM element. This function should return the child element before which the element should be inserted.

    Returns Selection<ChildElement, Datum, PElement, PDatum>

lower

  • lower()
  • Re-insert each selected element, in order, as the first child of its parent.

merge

  • merge(other: Selection<GElement, Datum, PElement, PDatum>): Selection<GElement, Datum, PElement, PDatum>
  • Returns a new selection merging this selection with the specified other selection. The returned selection has the same number of groups and the same parents as this selection. Any missing (null) elements in this selection are filled with the corresponding element, if present (not null), from the specified selection. (If the other selection has additional groups or parents, they are ignored.)

    This method is commonly used to merge the enter and update selections after a data-join. After modifying the entering and updating elements separately, you can merge the two selections and perform operations on both without duplicate code.

    This method is not intended for concatenating arbitrary selections, however: if both this selection and the specified other selection have (non-null) elements at the same index, this selection’s element is returned in the merge and the other selection’s element is ignored.

    Parameters

    • other: Selection<GElement, Datum, PElement, PDatum>

      Selection to be merged.

    Returns Selection<GElement, Datum, PElement, PDatum>

node

  • node(): GElement | null
  • Return the first (non-null) element in this selection. If the selection is empty, returns null.

    Returns GElement | null

nodes

  • nodes(): GElement[]
  • Return an array of all (non-null) elements in this selection.

    Returns GElement[]

on

  • on(typenames: string): ValueFn | undefined
  • on(typenames: string, listener: null)
  • on(typenames: string, listener: ValueFn, capture?: boolean)
  • Return the currently-assigned listener for the specified event typename on the first (non-null) selected element, if any, If multiple typenames are specified, the first matching listener is returned.

    Parameters

    • typenames: string

      The typenames is a string event type, such as click, mouseover, or submit; any DOM event type supported by your browser may be used. The type may be optionally followed by a period (.) and a name; the optional name allows multiple callbacks to be registered to receive events of the same type, such as click.foo and click.bar. To specify multiple typenames, separate typenames with spaces, such as "input change"" or "click.foo click.bar".

    Returns ValueFn | undefined

  • Remove a listener for the specified event type names. To remove all listeners for a given name, pass null as the listener and ".foo" as the typename, where foo is the name; to remove all listeners with no name, specify "." as the typename.

    Parameters

    • typenames: string

      The typenames is a string event type, such as click, mouseover, or submit; any DOM event type supported by your browser may be used. The type may be optionally followed by a period (.) and a name; the optional name allows multiple callbacks to be registered to receive events of the same type, such as click.foo and click.bar. To specify multiple typenames, separate typenames with spaces, such as "input change"" or "click.foo click.bar".

    • listener: null

      null to indicate removal of listener

  • Add an event listener for the specified event type names. If an event listener was previously registered for the same typename on a selected element, the old listener is removed before the new listener is added.

    When a specified event is dispatched on a selected node, the specified listener will be evaluated for each selected element.

    An optional capture flag may be specified which corresponds to the W3C useCapture flag: “After initiating capture, all events of the specified type will be dispatched to the registered EventListener before being dispatched to any EventTargets beneath them in the tree. Events which are bubbling upward through the tree will not trigger an EventListener designated to use capture.”

    Parameters

    • typenames: string

      The typenames is a string event type, such as click, mouseover, or submit; any DOM event type supported by your browser may be used. The type may be optionally followed by a period (.) and a name; the optional name allows multiple callbacks to be registered to receive events of the same type, such as click.foo and click.bar. To specify multiple typenames, separate typenames with spaces, such as "input change"" or "click.foo click.bar".

    • listener: ValueFn

      A listener function which will be evaluated for each selected element, being passed the current datum (d), the current index (i), and the current group (nodes), with this as the current DOM element. Listeners always see the latest datum for their element, but the index is a property of the selection and is fixed when the listener is assigned; to update the index, re-assign the listener. To access the current event within a listener, use d3.event.

    • Optional capture: boolean

      An optional capture flag which corresponds to the W3C useCapture flag.

order

  • order()
  • Re-insert elements into the document such that the document order of each group matches the selection order. This is equivalent to calling selection.sort if the data is already sorted, but much faster.

property

  • property(name: string): any
  • property<T>(name: Local<T>): T | undefined
  • property(name: string, value: ValueFn)
  • property(name: string, value: null)
  • property(name: string, value: any)
  • property<T>(name: Local<T>, value: ValueFn)
  • property<T>(name: Local<T>, value: T)
  • Return the current value of the specified property for the first (non-null) element in the selection. This is generally useful only if you know that the selection contains exactly one element.

    Parameters

    • name: string

      Name of the property

    Returns any

  • Look up a local variable on the first node of this selection. Note that this is not equivalent to local.get(selection.node()) in that it will not look up locals set on the parent node(s).

    Type parameters

    • T

    Parameters

    • name: Local<T>

      The d3.local variable to look up.

    Returns T | undefined

  • Sets the value of the property with the specified name for the selected elements and returns this selection. The value for the individual selected elements is determined by the value function.

    Some HTML elements have special properties that are not addressable using attributes or styles, such as a form field’s text value and a checkbox’s checked boolean. Use this method to get or set these properties.

    Parameters

    • name: string

      Name of the property

    • value: ValueFn

      A value function which is evaluated for each selected element, in order, being passed the current datum (d), the current index (i), and the current group (nodes), with this as the current DOM element. A null value will clear the property.

  • Clears the property with the specified name for the selected elements and returns this selection.

    Parameters

    • name: string

      Name of the property

    • value: null

      null,to clear the property

  • Sets the value of the property with the specified name for the selected elements and returns this selection. All elements are given the same property value.

    Parameters

    • name: string

      Name of the property

    • value: any

      Constant value for the property

  • Store a value in a d3.local variable. This is equivalent to selection.each(function (d, i, g) { name.set(this, value.call(this, d, i, g)); }) but more concise.

    Type parameters

    • T

    Parameters

    • name: Local<T>

      A d3.local variable

    • value: ValueFn

      A callback that returns the value to store

  • Store a value in a d3.local variable for each node in the selection. This is equivalent to selection.each(function () { name.set(this, value); }) but more concise.

    Type parameters

    • T

    Parameters

    • name: Local<T>

      A d3.local variable

    • value: T

      A callback that returns the value to store

raise

  • raise()
  • Re-insert each selected element, in order, as the last child of its parent.

remove

  • remove()
  • Removes the selected elements from the document. Returns this selection (the removed elements) which are now detached from the DOM.

select

  • select<DescElement>(selector: string): Selection<DescElement, Datum, PElement, PDatum>
  • select<DescElement>(selector: null): Selection<null, undefined, PElement, PDatum>
  • select<DescElement>(selector: ValueFn): Selection<DescElement, Datum, PElement, PDatum>
  • For each selected element, select the first descendant element that matches the specified selector string. If no element matches the specified selector for the current element, the element at the current index will be null in the returned selection. If multiple elements match the selector, only the first matching element in document order is selected. Selection.select does not affect grouping: it preserves the existing group structure and indexes, and propagates data (if any) to selected children.

    If the current element has associated data, this data is propagated to the corresponding selected element.

    The generic represents the type of the descendant element to be selected.

    Type parameters

    Parameters

    • selector: string

      CSS selector string

    Returns Selection<DescElement, Datum, PElement, PDatum>

  • Create an empty sub-selection. Selection.select does not affect grouping: it preserves the existing group structure and indexes.

    Type parameters

    Parameters

    • selector: null

    Returns Selection<null, undefined, PElement, PDatum>

  • For each selected element, select the descendant element returned by the selector function. If no element is returned by the selector function for the current element, the element at the current index will be null in the returned selection. Selection.select does not affect grouping: it preserves the existing group structure and indexes, and propagates data (if any) to selected children.

    If the current element has associated data, this data is propagated to the corresponding selected element.

    The generic represents the type of the descendant element to be selected.

    Type parameters

    Parameters

    • selector: ValueFn

      A selector function, which is evaluated for each selected element, in order, being passed the current datum (d), the current index (i), and the current group (nodes), with this as the current DOM element. It must return an element, or null if there is no matching element.

    Returns Selection<DescElement, Datum, PElement, PDatum>

selectAll

  • selectAll(): Selection<null, undefined, GElement, Datum>
  • selectAll(selector: null): Selection<null, undefined, GElement, Datum>
  • selectAll(selector: undefined): Selection<null, undefined, GElement, Datum>
  • selectAll<DescElement, OldDatum>(selector: string): Selection<DescElement, OldDatum, GElement, Datum>
  • selectAll<DescElement, OldDatum>(selector: ValueFn): Selection<DescElement, OldDatum, GElement, Datum>
  • Create an empty sub-selection. Selection.selectAll does affect grouping: The elements in the returned selection are grouped by their corresponding parent node in this selection, the group at the current index will be empty.

    Returns Selection<null, undefined, GElement, Datum>

  • Create an empty sub-selection. Selection.selectAll does affect grouping: The elements in the returned selection are grouped by their corresponding parent node in this selection, the group at the current index will be empty.

    Parameters

    • selector: null

    Returns Selection<null, undefined, GElement, Datum>

  • Create an empty sub-selection. Selection.selectAll does affect grouping: The elements in the returned selection are grouped by their corresponding parent node in this selection, the group at the current index will be empty.

    Parameters

    • selector: undefined

    Returns Selection<null, undefined, GElement, Datum>

  • For each selected element, selects the descendant elements that match the specified selector string. The elements in the returned selection are grouped by their corresponding parent node in this selection. If no element matches the specified selector for the current element, the group at the current index will be empty. Selection.selectAll does affect grouping: each selected descendant is grouped by the parent element in the originating selection.

    The selected elements do not inherit data from this selection; use selection.data to propagate data to children.

    The first generic "DescElement" refers to the type of descendant element to be selected. The second generic "OldDatum" refers to the type of the datum, of a selected element. This is useful when re-selecting elements with a previously set, know datum type.

    Type parameters

    Parameters

    • selector: string

      CSS selector string

    Returns Selection<DescElement, OldDatum, GElement, Datum>

  • For each selected element, selects the descendant elements returned by the selector function. The elements in the returned selection are grouped by their corresponding parent node in this selection. If no element matches the specified selector for the current element, the group at the current index will be empty. Selection.selectAll does affect grouping: each selected descendant is grouped by the parent element in the originating selection.

    The selected elements do not inherit data from this selection; use selection.data to propagate data to children.

    The first generic "DescElement" refers to the type of descendant element to be selected. The second generic "OldDatum" refers to the type of the datum, of a selected element. This is useful when re-selecting elements with a previously set, know datum type.

    Type parameters

    Parameters

    • selector: ValueFn

      A selector function which is evaluated for each selected element, in order, being passed the current datum (d), the current index (i), and the current group (nodes), with this as the current DOM element. It must return an array of elements (or a pseudo-array, such as a NodeList), or the empty array if there are no matching elements.

    Returns Selection<DescElement, OldDatum, GElement, Datum>

size

  • size(): number
  • Returns the total number of elements in this selection.

    Returns number

sort

  • sort(comparator?: function)
  • Return a new selection that contains a copy of each group in this selection sorted according to the compare function. After sorting, re-inserts elements to match the resulting order (per selection.order).

    Note that sorting is not guaranteed to be stable; however, it is guaranteed to have the same behavior as your browser’s built-in sort method on arrays.

    Parameters

    • Optional comparator: function

      An optional comparator function, which defaults to "ascending". The function is passed two elements’ data a and b to compare. It should return either a negative, positive, or zero value. If negative, then a should be before b; if positive, then a should be after b; otherwise, a and b are considered equal and the order is arbitrary.

        • (a: Datum, b: Datum): number
        • Parameters

          • a: Datum
          • b: Datum

          Returns number

style

  • style(name: string): string
  • style(name: string, value: null)
  • style(name: string, value: string | number | boolean, priority?: null | "important")
  • style(name: string, value: ValueFn, priority?: null | "important")
  • Returns the current computed value of the specified style for the first (non-null) element in the selection. This is generally useful only if you know that the selection contains exactly one element. The computed value may be different than the previously-set value, particularly if it was set using a shorthand property (such as the font style, which is shorthand for font-size, font-face, etc.).

    Parameters

    • name: string

      Name of the style

    Returns string

  • Clear the style with the specified name for the selected elements and returns this selection.

    Parameters

    • name: string

      Name of the style

    • value: null

      null,to clear the style

  • Sets the value of the style with the specified name for the selected elements and returns this selection. All elements are given the same style value.

    Parameters

    • name: string

      Name of the style

    • value: string | number | boolean

      Constant value for the style

    • Optional priority: null | "important"

      An optional priority flag, either null or the string important (without the exclamation point)

  • Sets the value of the style with the specified name for the selected elements and returns this selection. The value for the individual selected elements is determined by the value function.

    Parameters

    • name: string

      Name of the style

    • value: ValueFn

      A value function which is evaluated for each selected element, in order, being passed the current datum (d), the current index (i), and the current group (nodes), with this as the current DOM element. A null value will clear the style.

    • Optional priority: null | "important"

      An optional priority flag, either null or the string important (without the exclamation point)

text

  • text(): string
  • text(value: null)
  • text(value: string | number | boolean)
  • text(value: ValueFn)
  • Returns the text content for the first (non-null) element in the selection. This is generally useful only if you know the selection contains exactly one element.

    Returns string

  • Clear the text content of the selected elements and return the selection.

    Parameters

    • value: null
  • Sets the text content to the specified value on all selected elements, replacing any existing child elements. All elements are given the same text content.

    Parameters

    • value: string | number | boolean

      Text content value for the elements.

  • Sets the text content to the specified value on all selected elements, replacing any existing child elements. All elements are given the same text content.

    Parameters

    • value: ValueFn

      A value unction which is evaluated for each selected element, in order, being passed the current datum (d), the current index (i), and the current group (nodes), with this as the current DOM element. The function’s return value is then used to set each element’s text content. A null value will clear the content.

Legend

  • Module
  • Object literal
  • Variable
  • Function
  • Function with type parameter
  • Index signature
  • Type alias
  • Enumeration
  • Enumeration member
  • Property
  • Method
  • Interface
  • Interface with type parameter
  • Constructor
  • Property
  • Method
  • Index signature
  • Class
  • Class with type parameter
  • Constructor
  • Property
  • Method
  • Accessor
  • Index signature
  • Inherited constructor
  • Inherited property
  • Inherited method
  • Inherited accessor
  • Protected property
  • Protected method
  • Protected accessor
  • Private property
  • Private method
  • Private accessor
  • Static property
  • Static method

Generated using TypeDoc