Skip to content
This repository has been archived by the owner on Dec 8, 2017. It is now read-only.

Decide on terminology for map loading states #5

Closed
lucaswoj opened this issue Dec 16, 2015 · 4 comments
Closed

Decide on terminology for map loading states #5

lucaswoj opened this issue Dec 16, 2015 · 4 comments

Comments

@lucaswoj
Copy link

In mapbox/mapbox-gl-native#3318 and mapbox/mapbox-gl-js#1715 we're trying to come up with the right terminology to describe map loading states. So far, we have identified at least 2 states that need unique descriptive names (but I think there are some more interesting ones)

  • everything has loaded for the initial map viewport (presently captured by the load event)
  • everything has loaded for the current map viewport (presently unnamed)

(NOTE: "everything" = styles, tilejson, tiles, geojson, glyphs, sprites)

@brunoabinader
Copy link
Member

I vote for ready instead of loaded because loading a resource does not necessarily indicate that a resource is ready for usage e.g. we can say that a style is ready after all its sources in which at least one visible layer are loaded, which means not all of its sources needs to be loaded.

@jfirebaugh
Copy link
Contributor

  • everything has loaded for the initial map viewport (presently captured by the load event)

Let's leave this event named load, for backward compatibility and window.onload precedent.

  • everything has loaded for the current map viewport

I vote for naming the event quiesce, and the accessor isQuiescent(). It's an uncommon enough word that we can attach our own domain-specific meaning to it.

qui·es·cent

adjective: in a state or period of inactivity.
"After an animation finishes and all tiles have been loaded, the map becomes quiescent and the frame rate drops to zero."

@tmcw
Copy link

tmcw commented Dec 18, 2015

-1 for quiesce, on account of spelling difficulty

@lucaswoj
Copy link
Author

+1 for quiesce, on account of semantic differentiation from load and it being and uncommon enough word that we can attach our own domain-specific meaning to it.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

No branches or pull requests

4 participants