Page MenuHomePhorge

Documentation: add article about Javelin DOM stuff
ClosedPublic

Authored by valerio.bozzolan on Sep 9 2024, 16:04.

Details

Summary

Finally we know something about:

  • how to get an element by id ($)
  • how to find some children by a parent (scry)
  • how to find an exact child by a parent (find)
  • how to find a parent by a child (findAbove)

Closes T15870

Test Plan

You read this article and you find something interesting and
probably also accurate.

Event Timeline

aklapper requested changes to this revision.Sep 10 2024, 11:33
aklapper subscribed.

I guess D25784 shouldn't be mashed up in here thus requesting changes.

I'd personally write a few sentences in a way more boring style as I dislike reading long texts when I just quickly want to find relevant info.

webroot/rsrc/externals/javelin/docs/javelin_intro.diviner
9–15

As you know, Phorge is the fork of Phabricator. Phabricator was designed with a particular Open Source JavaScript library called Javelin.

17–23

So, why I should master Javelin?

The Javelin APIs are un-documented, un-intuitive, and esoteric, and you may prefer X / Y / Z framework instead.

24–29

But hey: Javelin will not be abandoned anytime soon.

Give Javelin a try, so you can make Phorge even better.

40–43

Traversing the DOM using Javelin is simple... as long as
you know what a "sigil" is. In fact, Javelin is designed to avoid
finding something by CSS classes. Instead, Javelin introduced
"sigils" - that is, exactly like a CSS class but vegan (?).

This revision now requires changes to proceed.Sep 10 2024, 11:33

(I don't get the comment about D25784) thanks for feedback

Ah! yes - undo ConpherenceViewController

If Harbormaster is fine I better be fine too, dont want no problems with them for reals

This revision is now accepted and ready to land.Sep 10 2024, 21:51

I hope that something is better than nothing I think. Then we can move if we don't like it.

This revision was landed with ongoing or failed builds.Sep 14 2024, 13:40
This revision was automatically updated to reflect the committed changes.