Why is D3 so Verbose?

(theheasman.com)

51 points | by TheHeasman 7 hours ago ago

39 comments

  • text0404 2 hours ago ago

    Note: the example is a misconception and not what's meant by "binding to data." In D3, binding to data refers to using the `.data()` method to supply an object (typically an array) which you can then use in a function callback in the accessors, so like `.attr('x1', d => /* access individual array item here */)`. This allows you to easily bind a dataset to a graphical representation and use its attributes to inform the properties of the visualization.

    I'd also argue that D3 is no more verbose than vanilla JS (at least for this example). What's the alternative for creating a line in SVG?

        const line = document.createElementNS('http://www.w3.org/2000/svg', 'line')
        line.setAttribute('x1', ...)
        line.setAttribute('y1', ...)
        line.setAttribute('x2', ...)
        line.setAttribute('y2', ...)
        // etc
        document.querySelector('svg').appendChild(line)
    • TheHeasman 2 hours ago ago

      This is very fair: I went for a metaphorical explanation, rather than a literal one. (For instance, I'd actually have had to write down the code for an SVG, and I was quickly writing this on my lunch break).

      The `.selectAll().data().join()` data binding method (or `.enter()` on older versions) is very intuitive once you understand it, but for the layman coming in, it's inaccessible AF. I fudged a little in my explanation to make it more accessible. But hey. That's learning.

      • text0404 2 hours ago ago

        For sure, data joining (and enter/exit) is arguably the learning curve wrt D3. TBH since I've started using FE frameworks which handle the DOM, d3-selection (and having to think about data binding) has almost completely fallen off my radar. Now it's mostly using functions from d3-scale, d3-geo, d3-shape, etc then mapping over that output to manually render DOM nodes.

    • bapak an hour ago ago

      > I'd also argue that D3 is no more verbose than vanilla JS

      Right? So why load a bunch of JS to do the same thing? One step further, why load any JS at all since you're just generating an SVG? People have forgotten that HTML and SVG are meant to be DATA containers, you don't have to use JSON + JS.

      D3 is cool for the advanced visualizations and the interactivity. If you're sticking to static graphs, for the love of god just have the server serve a static SVG.

  • trjordan 2 hours ago ago

    Man, my first startup in 2010 used protovis, the charting library Mike Bostock built before deciding d3 was the better approach. It was rough to have an 8 month old startup with a core piece of tech that suddenly stopped improving.

    My main takeaway from so much of this is that "just a chart" is one of the biggest sources of hidden complexity in displaying useful information to people. It's right up there with "a simple web form" and "a web page with some simple interactivity."

    Everybody has a wildly different idea of what good looks like. Defaults will never be right. Personal and global taste changes annually. We clown react (rightly) for constantly reinventing the same 4 wheels, but customers gleefully use new stuff all the time.

    It's kind of amazing that d3 has been so durable in the frontend world. It really is a wrapper over a pretty solid approach. And yeah, that approach is complex, but that's the reality of visualization. It's hard to imagine another one that's that good.

  • tmcw 3 hours ago ago

    All right, I got nerdsniped into writing a "yes and" sort of thing even though I agree with the gist of this article :) https://macwright.com/2025/08/21/why-d3-is-so-verbose-anothe...

    • TheHeasman 2 hours ago ago

      Ahhhhh. Thanks man. And totally nerding out here because YES. ANIMATIONS. Animations is why I fell in love with wanting to learn D3 in 2019. You can do things as you transition between data steps, that honestly, has been such a pain in the behind to try with anything else. I'm not a web developer. I'm a data guy.

      • fwip 32 minutes ago ago

        Speaking of animations, I used D3 to build my first web video game, a little match-3 game: https://fwip.github.io/colormatch/ The whole game board is a single SVG.

        It clearly has some bugs (like the score sometimes being NaN - no idea how I messed that up), but I haven't touched the code in over a decade, so it's a little time capsule.

  • time4tea 32 minutes ago ago
  • lenerdenator 3 hours ago ago

    More granular control, more verbosity.

    I am still proud of the D3 gadget I made about 8 years back as a green web dev. Couldn't have made it any other way, not sure if I could with any other library today. Wouldn't want to do it again, though, unless I was a dedicated front-end guy.

  • dleeftink 12 minutes ago ago

    Verbosity is readability. I'd wager some of the terser libraries take more effort picking up again after leaving them for a while.

    Whereas once th3 D3 training wheels come off, its muscle memory is hard to shed.

    • sitzkrieg 2 minutes ago ago

      came to post this. verbose good (to an extent)

  • biowaffeln 2 hours ago ago

    recently i've been having a lot of success with working with d3 + solid.js. I use d3 as the data processing layer, and solid for actually rendering svgs from the data. the combination is lovely, you get all the power of d3, while the parts that usually end up verbose are written succinctly in jsx. and it's a lot less pain than doing it in react, because the mental models of solid/d3 feel much more aligned

    • TheHeasman 2 hours ago ago

      I'll check that out. At the moment I'm just building up a bunch of template code which I'll re-use. But might check out solid.js.

  • jwilber 4 minutes ago ago

    Love all D3 content, but I'd add that the data binding just to create svg is not the real reason - after all, you can do this declaratively using most modern frameworks by directly iterating over the data and returning a positioned element (fwiw this is how I prefer to use it today). The reason is because of the complexity within d3 selection, namely the enter/update/exit + transition capabilities: https://www.d3indepth.com/enterexit/

    Another thing worth mentioning that newcomers seem to take for granted - the margin boilerplate required for correct positioning (see https://observablehq.com/@d3/margin-convention).

  • esafak 3 hours ago ago

    I feel like D3 ought to be the for-computer substrate for libraries that are actually for humans.

    I suppose it matters less now in the LLM age.

    • lionkor 3 hours ago ago

      If your LLM is the only one that can reasonably maintain your software, you essentially created a new kind of lock-in, similar to what we already solved with open source a long, long time ago.

      Once your LLM gets too expensive, goes out of business, and the competitors just don't quite do it the way your favorite LLM does it, you have a problem.

      • esafak 3 hours ago ago

        Speaking for myself, when it comes to D3 the problem is being locked out :)

  • moron4hire 3 hours ago ago

    This is why I've always found it weird that people consider D3 to be a charting tool. Yes, people have used it to build a lot of charts, but it's really just a streaming data processing tool. It doesn't provide anything specific to charting[0]. All of that part, you're still left to figure out on your own.

    [0] At least in the core, I'm not too familiar with the full ecosystem and what is considered official in terms of plugins. Everytime I've tried to use it, I've not found the documentation leading me to using anything more specifically oriented towards charting.

    • joshcartme an hour ago ago

      At least these days I think Plot, https://observablehq.com/plot/getting-started, which uses D3 under the hood and is from the makers of D3, is probably the closest thing to an official charting tool built on top of D3.

    • digitalWestie 2 hours ago ago

      This is the answer. People need to consider D3 more as a graphics/dom manipulation library than a charting library.

      • gedy an hour ago ago

        Yeah I used to pull my hair when a team would start down the D3 path for some non-interactive graphic, and then push back when I'd explain you can just use SVG for this simple case.

    • TheHeasman 2 hours ago ago

      Yaaasss. I think of it as being able to use a pencil to draw charts (and do creative stuff like Florence Nightingale's original polar area graph), instead of having a stencil that can draw things for you. It's a way to visually manipulate the DOM in a way if you're comfortable with data.

      You can simply just use Tableau or Power BI and take screenshots otherwise.

  • z3ratul163071 2 hours ago ago

    the author was inspired by early directx apis

  • ramesh31 2 hours ago ago

    Because the alternative is big config files or a declarative DSL. Builder pattern works really well here to keep things simple.

  • thrown-0825 2 hours ago ago

    I love D3, but its a library not a language.

    • moron4hire 19 minutes ago ago

      D3 is a good example of inventing a language without inventing a syntax for that language. It very much is a DSL implemented in JavaScript.

      • thrown-0825 16 minutes ago ago

        ok, I'll buy that, definitely feels like it

    • TheHeasman 2 hours ago ago

      Agreed. I fudged quite a lot in my post to make it accessible to the layman. Triee to explain to a UX designer I know that "D3 is a library for JavaScript that..." And I saw their brain switch off live in front of me.

      Semantics matter more than literals sometimes.

      *EDIT: Grammar. I was typing on my phone. Soz.

  • yieldcrv 2 hours ago ago

    D3 is painful, we don't have to appeal to authority to admit that.

    Mike Bostock is an interesting person, and a case study in why we don't design languages from a single person's genius.

  • balamatom 3 hours ago ago

    I'd say because JavaScript is insufficiently expressive. No macros, no arrow (pipe) operator, and the premier way of writing it is 4x as verbose than what I'd consider reasonable. D3 is a great library though.

    • TheHeasman 2 hours ago ago

      Uh, there are arrow operators in JS. D3.JS in Action Third Edition exclusively uses arrow operators.

      (Trust me. I don't know jack about JavaScript, I had to get through the MDN docs to understand what they were, and once I did, made a whole lot more sense).

      • tomku an hour ago ago

        The feature the person you're replying to is talking about is not arrow functions (`=>`), but what are called "threading macros" in other languages. In Clojure[1], the main one is named `->` and used as a way to thread a value through a series of functions that take it as a first argument, using the return value from the first function as the first argument to the second, and so on. It allows you to compose a series of plain functions to transform a value instead of (stateful) method chaining or nesting functions.

        JS does not have a straightforward equivalent. The old and deprecated `with` keyword might seem similar but it's only a surface resemblance as it does not perform the return-value threading that makes the above pattern useful, it was meant for methods that mutate object state. There's a TC39 proposal[2] to add a pipe operator that would accomplish a similar thing to threading macros via an infix operator but it's still a draft.

        [1]: https://clojure.org/guides/threading_macros

        [2]: https://github.com/tc39/proposal-pipeline-operator

      • balamatom an hour ago ago

        And I know more about JavaScript than I'd like to, so don't trust me.

    • DanielHB 3 hours ago ago

      what do you mean by "arrow operator"?

      • amiga386 2 hours ago ago

        Probably a reference to Clojure's arrow operator:

        https://blog.frankel.ch/learning-clojure/2/

        Something like a(b(c(d(e(7)))))) in Javascript could be written (-> 7 e d c b a) in Clojure?

      • lionkor 3 hours ago ago

        Maybe overloadable operators like in C++, where -> usually demotes some kind of deeper access into the object or abstraction? Or, the opposite, and abstracted access.

        • DanielHB an hour ago ago

          That is what I thought, but that doesn't make sense for a language without pointers

          According to the other comment it seems he meant the |> pipe operator that is under proposal in js