![\"Istanbul](\"https://codeclimate.com/github/FezVrasta/popper.js/badges/coverage.svg\")
\n ![\"Get](\"https://img.shields.io/badge/chat-on_spectrum-6833F9.svg?logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyBpZD0iTGl2ZWxsb18xIiBkYXRhLW5hbWU9IkxpdmVsbG8gMSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIiB2aWV3Qm94PSIwIDAgMTAgOCI%2BPGRlZnM%2BPHN0eWxlPi5jbHMtMXtmaWxsOiNmZmY7fTwvc3R5bGU%2BPC9kZWZzPjx0aXRsZT5zcGVjdHJ1bTwvdGl0bGU%2BPHBhdGggY2xhc3M9ImNscy0xIiBkPSJNNSwwQy40MiwwLDAsLjYzLDAsMy4zNGMwLDEuODQuMTksMi43MiwxLjc0LDMuMWgwVjcuNThhLjQ0LjQ0LDAsMCwwLC42OC4zNUw0LjM1LDYuNjlINWM0LjU4LDAsNS0uNjMsNS0zLjM1UzkuNTgsMCw1LDBaTTIuODMsNC4xOGEuNjMuNjMsMCwxLDEsLjY1LS42M0EuNjQuNjQsMCwwLDEsMi44Myw0LjE4Wk01LDQuMThhLjYzLjYzLDAsMSwxLC42NS0uNjNBLjY0LjY0LDAsMCwxLDUsNC4xOFptMi4xNywwYS42My42MywwLDEsMSwuNjUtLjYzQS42NC42NCwwLDAsMSw3LjE3LDQuMThaIi8%2BPC9zdmc%2B\"){kind=icon}
\n \n
![\"Build](\"https://travis-ci.org/FezVrasta/popper.js.svg?branch=master\")
\n \n A library used to position poppers in web applications.\n
\n\n\n \n
\n
\n \n
\n
\n \n \n
![](\"https://raw.githubusercontent.com/FezVrasta/popper.js/master/popperjs.png\")
\n\n\n\n## Wut? Poppers?\n\nA popper is an element on the screen which \"pops out\" from the natural flow of your application. \nCommon examples of poppers are tooltips, popovers and drop-downs.\n\n\n## So, yet another tooltip library?\n\nWell, basically, **no**. \nPopper.js is a **positioning engine**, its purpose is to calculate the position of an element\nto make it possible to position it near a given reference element. \n\nThe engine is completely modular and most of its features are implemented as **modifiers**\n(similar to middlewares or plugins). \nThe whole code base is written in ES2015 and its features are automatically tested on real browsers thanks to [SauceLabs](https://saucelabs.com/) and [TravisCI](https://travis-ci.org/).\n\nPopper.js has zero dependencies. No jQuery, no LoDash, nothing. \nIt's used by big companies like [Twitter in Bootstrap v4](https://getbootstrap.com/), [Microsoft in WebClipper](https://github.com/OneNoteDev/WebClipper) and [Atlassian in AtlasKit](https://aui-cdn.atlassian.com/atlaskit/registry/).\n\n### Popper.js\n\nThis is the engine, the library that computes and, optionally, applies the styles to\nthe poppers.\n\nSome of the key points are:\n\n- Position elements keeping them in their original DOM context (doesn't mess with your DOM!);\n- Allows to export the computed informations to integrate with React and other view libraries;\n- Supports Shadow DOM elements;\n- Completely customizable thanks to the modifiers based structure;\n\nVisit our [project page](https://fezvrasta.github.io/popper.js) to see a lot of examples of what you can do with Popper.js!\n\nFind [the documentation here](/docs/_includes/popper-documentation.md).\n\n\n### Tooltip.js\n\nSince lots of users just need a simple way to integrate powerful tooltips in their projects,\nwe created **Tooltip.js**. \nIt's a small library that makes it easy to automatically create tooltips using as engine Popper.js. \nIts API is almost identical to the famous tooltip system of Bootstrap, in this way it will be\neasy to integrate it in your projects. \nThe tooltips generated by Tooltip.js are accessible thanks to the `aria` tags.\n\nFind [the documentation here](/docs/_includes/tooltip-documentation.md).\n\n\n## Installation\nPopper.js is available on the following package managers and CDNs:\n\n| Source | |\n|:-------|:---------------------------------------------------------------------------------|\n| npm | `npm install popper.js --save` |\n| yarn | `yarn add popper.js` |\n| NuGet | `PM> Install-Package popper.js` |\n| Bower | `bower install popper.js --save` |\n| unpkg | [`https://unpkg.com/popper.js`](https://unpkg.com/popper.js) |\n| cdnjs | [`https://cdnjs.com/libraries/popper.js`](https://cdnjs.com/libraries/popper.js) |\n\nTooltip.js as well:\n\n| Source | |\n|:-------|:---------------------------------------------------------------------------------|\n| npm | `npm install tooltip.js --save` |\n| yarn | `yarn add tooltip.js` |\n| Bower* | `bower install tooltip.js=https://unpkg.com/tooltip.js --save` |\n| unpkg | [`https://unpkg.com/tooltip.js`](https://unpkg.com/tooltip.js) |\n| cdnjs | [`https://cdnjs.com/libraries/popper.js`](https://cdnjs.com/libraries/popper.js) |\n\n\\*: Bower isn't officially supported, it can be used to install Tooltip.js only trough the unpkg.com CDN. This method has the limitation of not being able to define a specific version of the library. Bower and Popper.js suggests to use npm or Yarn for your projects. \nFor more info, [read the related issue](https://github.com/FezVrasta/popper.js/issues/390).\n\n### Dist targets\n\nPopper.js is currently shipped with 3 targets in mind: UMD, ESM and ESNext.\n\n- UMD - Universal Module Definition: AMD, RequireJS and globals;\n- ESM - ES Modules: For webpack/Rollup or browser supporting the spec;\n- ESNext: Available in `dist/`, can be used with webpack and `babel-preset-env`;\n\nMake sure to use the right one for your needs. If you want to import it with a `