└── bootstrap.min.js.map
```
-We provide compiled CSS and JS (`bootstrap.*`), as well as compiled and minified CSS and JS (`bootstrap.min.*`). [source maps](https://developers.google.com/web/tools/chrome-devtools/debug/readability/source-maps) (`bootstrap.*.map`) are available for use with certain browsers' developer tools. Bundled JS files (`bootstrap.bundle.js` and minified `bootstrap.bundle.min.js`) include [Popper](https://popper.js.org/) and [HammerJS](https://hammerjs.github.io/), but not [jQuery](https://jquery.com/).
+We provide compiled CSS and JS (`bootstrap.*`), as well as compiled and minified CSS and JS (`bootstrap.min.*`). [source maps](https://developers.google.com/web/tools/chrome-devtools/debug/readability/source-maps) (`bootstrap.*.map`) are available for use with certain browsers' developer tools. Bundled JS files (`bootstrap.bundle.js` and minified `bootstrap.bundle.min.js`) include [Popper](https://popper.js.org/), but not [jQuery](https://jquery.com/).
## Bugs and feature requests
jquery_hash: "sha384-q8i/X+965DzO0rT7abK41JStQIAqVgRVzpbzo5smXKp4YfRvH+8abtTE1Pi6jizo"
popper: "https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.4/umd/popper.min.js"
popper_hash: "sha384-GM0Y80ecpwKxF1D5XCrGanKusGDy9WW0O2sSM84neB4iFhvKp3fwnoIRnPsQcN1R"
- hammer: "https://cdnjs.cloudflare.com/ajax/libs/hammer.js/2.0.8/hammer.min.js"
- hammer_hash: "sha384-Cs3dgUx6+jDxxuqHvVH8Onpyj2LF1gKZurLDlhqzuJmUqVYMJ0THTWpxK5Z086Zm"
toc:
min_level: 2
* Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE)
*/
-const path = require('path')
-const rollup = require('rollup')
-const babel = require('rollup-plugin-babel')
-const banner = require('./banner.js')
+const path = require('path')
+const rollup = require('rollup')
+const babel = require('rollup-plugin-babel')
+const banner = require('./banner.js')
const TEST = process.env.NODE_ENV === 'test'
const plugins = [
function build(plugin) {
console.log(`Building ${plugin} plugin...`)
- const external = ['hammerjs', 'jquery', 'popper.js']
+ const external = ['jquery', 'popper.js']
const globals = {
- hammerjs: 'Hammer',
jquery: 'jQuery', // Ensure we use jQuery which is always available even in noConflict mode
'popper.js': 'Popper'
}
{
file: 'node_modules/popper.js/dist/umd/popper.min.js',
configPropertyName: 'popper_hash'
- },
- {
- file: 'node_modules/hammerjs/hammer.min.js',
- configPropertyName: 'hammer_hash'
}
]
-const path = require('path')
-const babel = require('rollup-plugin-babel')
-const resolve = require('rollup-plugin-node-resolve')
-const commonjs = require('rollup-plugin-commonjs')
-const banner = require('./banner.js')
+const path = require('path')
+const babel = require('rollup-plugin-babel')
+const resolve = require('rollup-plugin-node-resolve')
+const banner = require('./banner.js')
const BUNDLE = process.env.BUNDLE === 'true'
-let fileDest = 'bootstrap.js'
-const external = ['jquery', 'hammerjs', 'popper.js']
+let fileDest = 'bootstrap.js'
+const external = ['jquery', 'popper.js']
const plugins = [
babel({
exclude: 'node_modules/**', // Only transpile our source code
]
const globals = {
jquery: 'jQuery', // Ensure we use jQuery which is always available even in noConflict mode
- hammerjs: 'Hammer',
'popper.js': 'Popper'
}
if (BUNDLE) {
fileDest = 'bootstrap.bundle.js'
- // We just keep jQuery as external
- external.length = 1
+ // Remove last entry in external array to bundle Popper
+ external.pop()
delete globals['popper.js']
- delete globals.hammerjs
- plugins.push(
- commonjs({
- include: 'node_modules/**'
- }),
- resolve()
- )
+ plugins.push(resolve())
}
module.exports = {
-import $ from 'jquery'
-import Hammer from 'hammerjs'
-import Util from './util'
-
/**
* --------------------------------------------------------------------------
* Bootstrap (v4.1.3): carousel.js
* --------------------------------------------------------------------------
*/
+import $ from 'jquery'
+import Util from './util'
+
/**
* ------------------------------------------------------------------------
* Constants
const ARROW_LEFT_KEYCODE = 37 // KeyboardEvent.which value for left arrow key
const ARROW_RIGHT_KEYCODE = 39 // KeyboardEvent.which value for right arrow key
const TOUCHEVENT_COMPAT_WAIT = 500 // Time for mouse compat events to fire after touch
-const HAMMER_ENABLED = typeof Hammer !== 'undefined'
+const SWIPE_THRESHOLD = 40
const Default = {
interval : 5000,
MOUSEENTER : `mouseenter${EVENT_KEY}`,
MOUSELEAVE : `mouseleave${EVENT_KEY}`,
TOUCHEND : `touchend${EVENT_KEY}`,
+ TOUCHSTART : `touchstart${EVENT_KEY}`,
+ TOUCHMOVE : `touchmove${EVENT_KEY}`,
LOAD_DATA_API : `load${EVENT_KEY}${DATA_API_KEY}`,
- CLICK_DATA_API : `click${EVENT_KEY}${DATA_API_KEY}`,
- SWIPELEFT : 'swipeleft',
- SWIPERIGHT : 'swiperight'
+ CLICK_DATA_API : `click${EVENT_KEY}${DATA_API_KEY}`
}
const ClassName = {
this._isPaused = false
this._isSliding = false
this.touchTimeout = null
- this.hammer = null
+ this.touchStartX = 0
+ this.touchDeltaX = 0
this._config = this._getConfig(config)
this._element = element
this._indicatorsElement = this._element.querySelector(Selector.INDICATORS)
- this._touchSupported = 'ontouchstart' in document.documentElement || navigator.maxTouchPoints > 0
-
- if (HAMMER_ENABLED && this._touchSupported && this._config.touch) {
- this.hammer = new Hammer(this._element, {
- recognizers: [[
- Hammer.Swipe, {
- direction: Hammer.DIRECTION_HORIZONTAL
- }
- ]]
- })
- }
+ this._touchSupported = 'ontouchstart' in document.documentElement
this._addEventListeners()
}
return config
}
+ _handleSwipe() {
+ const absDeltax = Math.abs(this.touchDeltaX)
+
+ if (absDeltax <= SWIPE_THRESHOLD) {
+ return
+ }
+
+ const direction = absDeltax / this.touchDeltaX
+
+ // swipe left
+ if (direction > 0) {
+ this.prev()
+ }
+
+ // swipe right
+ if (direction < 0) {
+ this.next()
+ }
+ }
+
_addEventListeners() {
if (this._config.keyboard) {
$(this._element)
.on(Event.KEYDOWN, (event) => this._keydown(event))
}
- if (this.hammer) {
- this.hammer.on(Event.SWIPELEFT, () => this.next())
- this.hammer.on(Event.SWIPERIGHT, () => this.prev())
- }
-
if (this._config.pause === 'hover') {
$(this._element)
.on(Event.MOUSEENTER, (event) => this.pause(event))
.on(Event.MOUSELEAVE, (event) => this.cycle(event))
- if (this._touchSupported) {
+ }
+
+ this._addTouchEventListeners()
+ }
+
+ _addTouchEventListeners() {
+ if (!this._touchSupported) {
+ return
+ }
+
+ $(this._element).on(Event.TOUCHSTART, (event) => {
+ this.touchStartX = event.originalEvent.touches[0].pageX
+ })
+
+ $(this._element).on(Event.TOUCHMOVE, (event) => {
+ event.preventDefault()
+
+ // ensure swiping with one touch and not pinching
+ if (event.originalEvent.touches.length > 1) {
+ return
+ }
+
+ this.touchDeltaX = event.originalEvent.touches[0].pageX - this.touchStartX
+ })
+
+ $(this._element).on(Event.TOUCHEND, () => {
+ this._handleSwipe()
+
+ if (this._config.pause === 'hover') {
// If it's a touch-enabled device, mouseenter/leave are fired as
// part of the mouse compatibility events on first tap - the carousel
// would stop cycling until user tapped out of it;
// (as if it's the second time we tap on it, mouseenter compat event
// is NOT fired) and after a timeout (to allow for mouse compatibility
// events to fire) we explicitly restart cycling
- $(this._element).on(Event.TOUCHEND, () => {
- this.pause()
- if (this.touchTimeout) {
- clearTimeout(this.touchTimeout)
- }
- this.touchTimeout = setTimeout((event) => this.cycle(event), TOUCHEVENT_COMPAT_WAIT + this._config.interval)
- })
+
+ this.pause()
+ if (this.touchTimeout) {
+ clearTimeout(this.touchTimeout)
+ }
+ this.touchTimeout = setTimeout((event) => this.cycle(event), TOUCHEVENT_COMPAT_WAIT + this._config.interval)
}
- }
+ })
}
_keydown(event) {
}())
</script>
<script src="../../node_modules/popper.js/dist/umd/popper.min.js"></script>
- <script src="../../node_modules/hammerjs/hammer.min.js"></script>
<!-- QUnit -->
<link rel="stylesheet" href="../../node_modules/qunit/qunit/qunit.css" media="screen">
const bundle = process.env.BUNDLE === 'true'
const browserStack = process.env.BROWSER === 'true'
-const plugins = [
- 'karma-qunit',
- 'karma-sinon'
-]
-
const frameworks = [
'qunit',
'sinon'
]
+const plugins = [
+ 'karma-qunit',
+ 'karma-sinon'
+]
+
const reporters = ['dots']
const detectBrowsers = {
let files = [
'node_modules/popper.js/dist/umd/popper.min.js',
- 'node_modules/hammerjs/hammer.min.js',
'node_modules/hammer-simulator/index.js'
]
window.Carousel = typeof bootstrap !== 'undefined' ? bootstrap.Carousel : Carousel
- var touchSupported = 'ontouchstart' in document.documentElement || navigator.maxTouchPoints > 0
-
QUnit.module('carousel plugin')
QUnit.test('should be defined on jQuery object', function (assert) {
})
QUnit.test('should allow swiperight and call prev', function (assert) {
- if (!touchSupported) {
- assert.expect(0)
-
- return
- }
-
- assert.expect(2)
+ Simulator.setType('touch')
+ assert.expect(3)
var done = assert.async()
document.documentElement.ontouchstart = $.noop
$carousel.appendTo('#qunit-fixture')
var $item = $('#item')
$carousel.bootstrapCarousel()
+ var carousel = $carousel.data('bs.carousel')
+ var spy = sinon.spy(carousel, 'prev')
$carousel.one('slid.bs.carousel', function () {
assert.ok(true, 'slid event fired')
assert.ok($item.hasClass('active'))
+ assert.ok(spy.called)
delete document.documentElement.ontouchstart
done()
})
})
})
- QUnit.test('should not use HammerJS when touch option is false', function (assert) {
- assert.expect(1)
-
- var $carousel = $('<div></div>').appendTo('#qunit-fixture')
- $carousel.bootstrapCarousel({
- touch: false
- })
-
- var carousel = $carousel.data('bs.carousel')
-
- assert.strictEqual(carousel.hammer, null)
- })
-
- QUnit.test('should use HammerJS when touch option is true', function (assert) {
- assert.expect(1)
-
- document.documentElement.ontouchstart = $.noop
-
- var $carousel = $('<div></div>').appendTo('#qunit-fixture')
- $carousel.bootstrapCarousel()
-
- var carousel = $carousel.data('bs.carousel')
-
- assert.ok(carousel.hammer !== null)
- })
-
QUnit.test('should allow swipeleft and call next', function (assert) {
- if (!touchSupported) {
- assert.expect(0)
-
- return
- }
+ assert.expect(3)
+ Simulator.setType('touch')
- assert.expect(2)
var done = assert.async()
document.documentElement.ontouchstart = $.noop
$carousel.appendTo('#qunit-fixture')
var $item = $('#item')
$carousel.bootstrapCarousel()
+ var carousel = $carousel.data('bs.carousel')
+ var spy = sinon.spy(carousel, 'next')
$carousel.one('slid.bs.carousel', function () {
assert.ok(true, 'slid event fired')
assert.ok(!$item.hasClass('active'))
- delete document.documentElement.ontouchstart
+ assert.ok(spy.called)
done()
})
deltaY: 0
})
})
+
+ QUnit.test('should not allow pinch', function (assert) {
+ assert.expect(0)
+ Simulator.setType('touch')
+ var done = assert.async()
+ document.documentElement.ontouchstart = $.noop
+
+ var carouselHTML = '<div class="carousel" data-interval="false"></div>'
+ var $carousel = $(carouselHTML)
+ $carousel.appendTo('#qunit-fixture')
+ $carousel.bootstrapCarousel()
+
+ Simulator.gestures.swipe($carousel[0], {
+ pos: [300, 10],
+ deltaX: -300,
+ deltaY: 0,
+ touches: 2
+ }, function () {
+ done()
+ })
+ })
})
</div>
<script src="../../../site/docs/4.1/assets/js/vendor/jquery-slim.min.js"></script>
- <script src="../../../node_modules/hammerjs/hammer.min.js"></script>
<script src="../../dist/util.js"></script>
<script src="../../dist/carousel.js"></script>
<script>
"integrity": "sha1-7tO85CtDMgF1o/T4NP4gjl+iSho=",
"dev": true
},
- "hammerjs": {
- "version": "2.0.8",
- "resolved": "https://registry.npmjs.org/hammerjs/-/hammerjs-2.0.8.tgz",
- "integrity": "sha1-BO93hiz/K7edMPdpIJWTAiK/YPE=",
- "dev": true
- },
"handlebars": {
"version": "4.0.12",
"resolved": "https://registry.npmjs.org/handlebars/-/handlebars-4.0.12.tgz",
"yallist": "^2.1.2"
}
},
- "magic-string": {
- "version": "0.22.5",
- "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.22.5.tgz",
- "integrity": "sha512-oreip9rJZkzvA8Qzk9HFs8fZGF/u7H/gtrE8EN6RjKJ9kh2HlC+yQ2QezifqTZfGyiuAV0dRv5a+y/8gBb1m9w==",
- "dev": true,
- "requires": {
- "vlq": "^0.2.2"
- }
- },
"make-dir": {
"version": "1.3.0",
"resolved": "https://registry.npmjs.org/make-dir/-/make-dir-1.3.0.tgz",
"rollup-pluginutils": "^2.3.0"
}
},
- "rollup-plugin-commonjs": {
- "version": "9.1.6",
- "resolved": "https://registry.npmjs.org/rollup-plugin-commonjs/-/rollup-plugin-commonjs-9.1.6.tgz",
- "integrity": "sha512-J7GOJm9uzEeLqkVxYSgjyoieh34hATWpa9G2M1ilGzWOLYGfQx5IDQ9ewG8QUj/Z2dzgV+d0/AyloAzElkABAA==",
- "dev": true,
- "requires": {
- "estree-walker": "^0.5.1",
- "magic-string": "^0.22.4",
- "resolve": "^1.5.0",
- "rollup-pluginutils": "^2.0.1"
- }
- },
"rollup-plugin-node-resolve": {
"version": "3.4.0",
"resolved": "https://registry.npmjs.org/rollup-plugin-node-resolve/-/rollup-plugin-node-resolve-3.4.0.tgz",
"unist-util-stringify-position": "^1.1.1"
}
},
- "vlq": {
- "version": "0.2.3",
- "resolved": "https://registry.npmjs.org/vlq/-/vlq-0.2.3.tgz",
- "integrity": "sha512-DRibZL6DsNhIgYQ+wNdWDL2SL3bKPlVrRiBqV5yuMm++op8W4kGFtaQfCs4KEJn0wBZcHVHJ3eoywX8983k1ow==",
- "dev": true
- },
"vnu-jar": {
"version": "18.8.29",
"resolved": "https://registry.npmjs.org/vnu-jar/-/vnu-jar-18.8.29.tgz",
"license": "MIT",
"dependencies": {},
"peerDependencies": {
- "hammerjs": "^2.0.8",
"jquery": "1.9.1 - 3",
"popper.js": "^1.14.4"
},
"find-unused-sass-variables": "^0.2.1",
"glob": "^7.1.3",
"hammer-simulator": "0.0.1",
- "hammerjs": "^2.0.8",
"htmllint-cli": "^0.0.7",
"http-server": "^0.11.1",
"ip": "^1.1.5",
"qunit": "^2.7.0",
"rollup": "^0.66.6",
"rollup-plugin-babel": "^4.0.3",
- "rollup-plugin-commonjs": "^9.1.6",
"rollup-plugin-node-resolve": "^3.4.0",
"shelljs": "^0.8.2",
"shx": "^0.3.2",
},
{
"path": "./dist/js/bootstrap.bundle.js",
- "maxSize": "61 kB"
+ "maxSize": "45 kB"
},
{
"path": "./dist/js/bootstrap.bundle.min.js",
- "maxSize": "28 kB"
+ "maxSize": "25 kB"
},
{
"path": "./dist/js/bootstrap.js",
<script src="{{ site.cdn.jquery }}" integrity="{{ site.cdn.jquery_hash }}" crossorigin="anonymous"></script>
<script>window.jQuery || document.write('<script src="{{ site.baseurl }}/assets/js/vendor/jquery-slim.min.js"><\/script>')</script>
-<script src="{{ site.cdn.hammer }}"{% if site.github %} integrity="{{ site.cdn.hammer_hash }}" crossorigin="anonymous"{% endif %}></script>
{%- if jekyll.environment == "production" -%}
<script src="{{ site.baseurl }}/docs/{{ site.docs_version }}/dist/js/bootstrap.bundle.min.js" integrity="{{ site.cdn.js_bundle_hash }}" crossorigin="anonymous"></script>
In browsers where the [Page Visibility API](https://www.w3.org/TR/page-visibility/) is supported, the carousel will avoid sliding when the webpage is not visible to the user (such as when the browser tab is inactive, the browser window is minimized, etc.).
-The carousel supports swipe gestures (left and right) using [HammerJS]({{ site.cdn.hammer }}). For this to function correctly you need to include HammerJS before Bootstrap or use `bootstrap.bundle.min.js` / `bootstrap.bundle.js` which contains HammerJS.
-
Please be aware that nested carousels are not supported, and carousels are generally not compliant with accessibility standards.
Lastly, if you're building our JavaScript from source, it [requires `util.js`]({{ site.baseurl }}/docs/{{ site.docs_version }}/getting-started/javascript/#util).
<td>touch</td>
<td>boolean</td>
<td>true</td>
- <td>Whether the carousel should handle touch event and allow swipe left/right.</td>
+ <td>Whether the carousel should support left/right swipe interactions on touchscreen devices.</td>
</tr>
</tbody>
</table>
└── bootstrap.min.js.map
{% endhighlight %}
-This is the most basic form of Bootstrap: precompiled files for quick drop-in usage in nearly any web project. We provide compiled CSS and JS (`bootstrap.*`), as well as compiled and minified CSS and JS (`bootstrap.min.*`). [source maps](https://developers.google.com/web/tools/chrome-devtools/javascript/source-maps) (`bootstrap.*.map`) are available for use with certain browsers' developer tools. Bundled JS files (`bootstrap.bundle.js` and minified `bootstrap.bundle.min.js`) include [Popper](https://popper.js.org/) and [HammerJS](https://hammerjs.github.io/), but not [jQuery](https://jquery.com/).
+This is the most basic form of Bootstrap: precompiled files for quick drop-in usage in nearly any web project. We provide compiled CSS and JS (`bootstrap.*`), as well as compiled and minified CSS and JS (`bootstrap.min.*`). [source maps](https://developers.google.com/web/tools/chrome-devtools/javascript/source-maps) (`bootstrap.*.map`) are available for use with certain browsers' developer tools. Bundled JS files (`bootstrap.bundle.js` and minified `bootstrap.bundle.min.js`) include [Popper](https://popper.js.org/), but not [jQuery](https://jquery.com/).
## CSS files
Curious which components explicitly require jQuery, our JS, and Popper.js? Click the show components link below. If you're at all unsure about the general page structure, keep reading for an example page template.
-Our `bootstrap.bundle.js` and `bootstrap.bundle.min.js` include [Popper](https://popper.js.org/) and [HammerJS](https://hammerjs.github.io/), but not [jQuery](https://jquery.com/). For more information about what's included in Bootstrap, please see our [contents]({{ site.baseurl }}/docs/{{ site.docs_version }}/getting-started/contents/#precompiled-bootstrap) section.
+Our `bootstrap.bundle.js` and `bootstrap.bundle.min.js` include [Popper](https://popper.js.org/), but not [jQuery](https://jquery.com/). For more information about what's included in Bootstrap, please see our [contents]({{ site.baseurl }}/docs/{{ site.docs_version }}/getting-started/contents/#precompiled-bootstrap) section.
<details>
<summary class="text-primary mb-3">Show components requiring JavaScript</summary>
projects / thirdparty / bootstrap.git / commitdiff
