Unclear how to get a Document

Question

Unclear how to get a Document

Closed this issue 6 years ago · 7 comments

BebeSparkelSparkel commented 6 years ago

there seems no way to get the root document

BebeSparkelSparkel commented 6 years ago

Thanks

Answer 1 · 2020-02-12T13:39:56.000Z

It's part of the HTML API rather than the more general DOM API: https://pursuit.purescript.org/packages/purescript-web-html/2.3.0/docs/Web.HTML.Window#v:document

Answer 2 · 2020-02-12T13:44:47.000Z

That seems to be a pretty far leap especially since web-dom uses the type Document and web-html uses type HTMLDocument

Answer 3 · 2020-02-12T13:46:11.000Z

And there is no documentation in Web.DOM.Document stating that

Answer 4 · 2020-02-12T13:48:00.000Z

Blame the W3C 😄

Document is only part of the interface that the window.document gives you, HTMLDocument is the rest.

Documenting it in Web.DOM.Document would be a bit like documenting RSS in an XML library: it's talking about specifics for something that is more general.

Answer 5 · 2020-02-12T13:52:54.000Z

I would say if the "XML" library had a common use case that a large proportion of the libraries user base was using for "RSS" then it would be worth noting in the docs to save a bit of frustration.

Answer 6 · 2020-02-12T20:13:50.000Z

Yeah you're right, that is kinda a silly argument. I think the only other use cases for Document in the browser are for XML (and SVG by extension), but almost everybody is using it in the HTML context.