documenting /src/foundation/display_callout.js

[agent marmorkuchen]

hoi...

what does /src/foundation/display_callout.js do? it doesn't seem to be
used, but references are probably constructed and evaled
dynamically? an unincorporated component makes a reference to 'popper',
the function display_callout is just a stub and has a comment which says
'the future' on top of it.

and i am somewhat baffled by the pmenu stuff which is due to me not
being a pro at javascript. what does this statement do?

(function() { ... })();

it calls an anonymous function which is defined within the curly braces?
but within the curly braces there are variables and functions (in 3
different syntax formats) defined. so it is actually a sort of class
definition which instantiates an anonymous (function) object? but what
part is executed when the 'function' is called?

bye,
marmorkuchen
--
_ ascii ribbon campaign .oOo. GCSd-s:+aC++ULB+++W++M+PS+++Y+
( )
X Agenda 23 - Soziale Zwietracht, Schrumpfen und Tradition
/ \

[Joe Edelman]

display_callout is currently unused, but is about to be folded into
livehtml [reveal] and changed around a bit. What it does is manage
"callouts/poppers" which are popover windows that have a "nose", which
is a little triangle which points to the original content. There is one
of these in Matthew's assignment editor mockup. When you click on the
shiny buttons on the right side of the assignment editor stanzas, a
popover window appears with a big black "nose" that points to the stanza
in question and offers you more options with regard to that stanza.
These noses are used in several places in the old UI and will be in the
new UI too. A "pmenu" is a callout with a nose that is also a menu with
several possibly hierarchical menus. There are upnoses and downnoses,
leftnoses and rightnoses, and a lot of dynamic display logic that makes
the popover window appear on the correct side of the thing and probably
fit on the screen and scroll with the map if it's attach to a mapwindow
and so on.

I will probably change these terms and certainly simplify the HTML
necessary when I fold it back in. Which will be in the next few days.

--Joe

--
J.E. -- http://nxhx.org -- 413.250.8007