[FEATURE] Allow tip hiding on its outside click

[afoeder]

This adds an option hideOnTipOutsideClick which will
hide the Tip if the document is clicked somewhere outside
the ToolTip resp. its initial trigger element.

Apparently this only makes sense if no contradicting
hideOn option is set, as it would be the case in most
mouseleave cases because there would be no opportunity
to click outside if the Tip is just hiding anyways.

See #21

[lorenzos]

Let's discuss about if it's better to provide a new option (like you did), or allow a special value for the existent hideOn option (let's say 'clickOutside'). For me the second is a better choice, for the reason you can't make the "contradictions" you told about.

[afoeder]

I began to use a special value but soonish stumbled upon the fact that the showOn and hideOn exclusively affect the "trigger" of the tip and not the tip itself. When introducing pseudo-options, it should made clear what they affect. clickOutside as you suggested would be insufficient (or, not clear enough) because mouseleave for example means leaving the trigger element, while clickOutside means clicking outside the Tip.

While coding, I had a solution like hideOn: 'outsideTipClick' but that contradicted the current implementation at all, because whatever is written down there is considered as immediate event.
This maybe needs some refactoring anyways ;)

I will say, if we add and support a outsideTipClick option, we have to circumvent this case in the place where the events are added (evs[s.options.showOn]... you know), and we don't have a way to distinct between "special" values and "immediately usable" values...

Hope you know what I mean... What do you think?

[lorenzos]

I think you thought about it much more than I did. Jokes apart, yes, your arguments are surely valid. I'm merging.

Thank you again, excellent work.

[afoeder]

hihi yeah; I was also full of euphoria but when writing around in the code I realized every way has some drawbacks ;)
In favor of making slight enhancements I didn't refactor a big chunk but only this "additive" feature; as soon as I find some love and mind I'll give it another approach :)

Thanks for being so active!