Using JQuery UI and Bootstrap togheter in the same web page

HTML input type number with (localized) decimal values using JQuery

In the past few months we’ve seen the Bootstrap framework became more and more popular among web developers. The reasons are fairly obvious, we’re talking  about a powerful CSS/JS enhancement library featuring a lot of useful stuff to build a responsive, mobile-friendly webpage fully compatible with every major browser/device. The most recent version of the framework (v3.3.1 by the time of this post) contains a lot of useful javascript plugin requiring JQuery v1.9.0 or higher in order to work: there’s no doubt that some of these websites are also running JQuery UI.

These 2 frameworks are indeed able to work togheter, but we need to pay attention to at least two naming conflicts between them which need to be fixed in order to avoid JS errors and, most importantly, get them to work properly. We’re talking about the tooltip and button plugins, which happen to exist in both of these libraries with the exact same name.

The Issue.

Let’s take the tooltip plugin as an example. Open the address http://jqueryui.com/tooltip/ and look at the sample code – by clicking on the “view source” link – to see how the JQuery UI tooltip plugin actually works:

The highlighted text shows a call to the tooltip function which, thanks to JQuery UI, is added at runtime to any JQuery object. Bootstrap does the exact same job, as shown in the official tutorial:

This nasty naming conflict prevents the plugins to work an might also generates some Javascript errors depending on the framework <script> references order inside the web page. For example, here’s what you’ll most likely get in your Javascript Console if Boostrap is inserted after JQuery UI and the latter’s tooltip plugin is being used:

Uncaught TypeError: Cannot read property ‘documentElement’ of null

We get this message because the tooltip plugin provided by JQueryUI has a completely different – and hardly compatible – interface than the Bootstrap plugin sharing its name.

 The Solution.

The best way to make the 2 libraries blend togheter and “constructively” fix the aforementioned naming conflicts is to use the not-so-well-known $.widget.bridge plugin, which allows us to re-define each previously assigned prototype function name. The plugin is already included inside the JQuery UI standard distribution package, so we won’t add any additional stuff to our website. The usage is quite simple:

These commands need to be executed after the JQueryUI and before the Bootstrap js file references. In the following example we can see a full implementation example in the <head> block of a common webpage:

After you do this, the tooltip and button prototype methods will be univocally routed to the Bootstrap ones: those provided by JQuery UI will also be usable as long as we call them by using the new alias we gave them: uitooltip and uibutton.

References:
http://stackoverflow.com/a/27745464/1233379 (my answer on StackOverflow which kinda inspired this post).

 

About Ryan

IT Project Manager, Web Interface Architect and Lead Developer for many high-traffic web sites & services hosted in Italy and Europe. Since 2010 it's also a lead designer for many App and games for Android, iOS and Windows Phone mobile devices for a number of italian companies. Microsoft MVP for Development Technologies since 2018.

View all posts by Ryan

12 Comments on “Using JQuery UI and Bootstrap togheter in the same web page”

  1. Just suffered from this. Since I use the BS tooltip I simply removed it from jQuery-ui. Luckily you can customize your download to include/exclude widgets.

  2. Dear Ryan,

    I cannot solve my issue. I created a navbar with some buttons. One of this button has bootstrap tooltip specs.

    However, the style and positioning inherited by the tooltip comes from a jquery.ui.css file stored into /pubic_html ; therefore I downloaded the proper bootstrap css and min.css and uploaded in the same directory. Then, I added to the frame_chat.inc.php (where my navbar is) all the references to bootstrap as per blow.

    The tricky part, I think based on what I noticed, is that wen I inspect the tooltip, what I find is this:

    Button

    While if I inspect an element on the bootstrap page, the tooltip is wrapped in the following div:

    Tooltip on top

    Any idea? Many thanks my friend.

    ***** Scripts in my file .php

    http://public_html/includes/jquery-1.10.2.min.js

    // Change JQueryUI plugin names to fix name collision with Bootstrap.
    $.widget.bridge(‘ui.tooltip’, $.ui.tooltip);
    $.widget.bridge(‘ui.button’, $.ui.button);

    http://public_html/includes/bootstrap.js

    < content etc. etc. >


    https://code.jquery.com/jquery-3.2.1.slim.min.js


    https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.3/umd/popper.min.js


    https://maxcdn.bootstrapcdn.com/bootstrap/4.0.0/js/bootstrap.min.js

    1. Hello there,

      from what you’re showing on your code, it definitely seems to me that you’re loading two different jquery versions: 1.10.2.min and 3.2.1.slim.

      You can’t do that: pick a single jQuery version and stick with it, otherwise you’ll mess up your jQuery classes and the $.widget.bridge won’t work as expected.

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.