Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Popover/tooltip selector option needs documentation #4215

jakepetroules opened this issue Jul 29, 2012 · 11 comments

Popover/tooltip selector option needs documentation #4215

jakepetroules opened this issue Jul 29, 2012 · 11 comments


Copy link

The documentation for the selector option for popovers and tooltips currently states "if a selector is provided, tooltip objects will be delegated to the specified targets". This description is not very helpful and appears to confuse a good number of people, including myself until I figured out what it actually does (also see #2091).

Explanation: 'selector' is used internally in conjunction with jQuery.on in order to allow markup dynamically inserted in the DOM, to trigger tooltips and popovers. I've created an interactive jsFiddle illustrating its usage:

tl;dr: selector = jQuery.on support

I therefore propose that the documentation be improved, making note that 'selector' makes the plugins use jQuery.on and a short explanation of what that does, for those who may not be familiar with the function, along with the following sample code:

    selector: '[rel="tooltip"]'

    selector: '[rel="popover"]'

I'll leave exactly how it might be worded to @mdo / @fat.

Copy link

I had some trouble with this too, thanks!

Copy link

I agree on this, it's confusing.

Copy link

Got confused by the documentation as well. Thought data-selector was a way to point to another element in the page so its contents are displayed inside the popover, instead of the data-content attribute contents.

Copy link

dbwinger commented Nov 1, 2012

Thanks for the explanation @jakepetroules !

Copy link

mdo commented Dec 2, 2012

Please submit a pull request with the suggested edits and we can ge them in there. Until then, closing out. Thanks!

@mdo mdo closed this as completed Dec 2, 2012
Copy link

pykler commented Feb 26, 2013

Same issue here using 2.3.0 ... bootstrap is ignoring the data-trigger (atleast) when using the selector as mentioned in this bug report.

Copy link

Pull request on the docs meaning forking the javascript.html file and editing? Doing that. Is that really the preferred way? Seems like each section should live in a mustache/other template and the whole docs should be dynamically assembled.

Copy link

@jakepetroules Thanks for clearing it up.

Copy link

Read somewhere that jquery now suggests attaching ".on" to the document. (instead of the body as in this thread)

So you might try...
$(document).popover({selector:'.popover-source-dynamic[data-trigger="hover"]', trigger:'hover'});

It seems to work for me. (although admittedly didn't spend a lot of time on this)

Copy link

the documentation is still cryptic for tooltips

Copy link

cipster commented Nov 22, 2014

Thank you. It really helped me out

@twbs twbs locked and limited conversation to collaborators Jan 4, 2015
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
None yet

No branches or pull requests