0
0
mirror of https://github.com/twbs/bootstrap.git synced 2025-02-26 23:54:23 +01:00

swipe left/right without hammerjs

This commit is contained in:
Johann-S 2018-10-14 13:59:51 +02:00 committed by XhmikosR
parent caefd70463
commit c08652cfe8
16 changed files with 122 additions and 158 deletions

View File

@ -99,7 +99,7 @@ bootstrap/
└── bootstrap.min.js.map └── 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 ## Bugs and feature requests

View File

@ -58,8 +58,6 @@ cdn:
jquery_hash: "sha384-q8i/X+965DzO0rT7abK41JStQIAqVgRVzpbzo5smXKp4YfRvH+8abtTE1Pi6jizo" jquery_hash: "sha384-q8i/X+965DzO0rT7abK41JStQIAqVgRVzpbzo5smXKp4YfRvH+8abtTE1Pi6jizo"
popper: "https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.4/umd/popper.min.js" popper: "https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.4/umd/popper.min.js"
popper_hash: "sha384-GM0Y80ecpwKxF1D5XCrGanKusGDy9WW0O2sSM84neB4iFhvKp3fwnoIRnPsQcN1R" 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: toc:
min_level: 2 min_level: 2

View File

@ -5,10 +5,10 @@
* Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE) * Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE)
*/ */
const path = require('path') const path = require('path')
const rollup = require('rollup') const rollup = require('rollup')
const babel = require('rollup-plugin-babel') const babel = require('rollup-plugin-babel')
const banner = require('./banner.js') const banner = require('./banner.js')
const TEST = process.env.NODE_ENV === 'test' const TEST = process.env.NODE_ENV === 'test'
const plugins = [ const plugins = [
@ -41,9 +41,8 @@ const rootPath = TEST ? '../js/coverage/dist/' : '../js/dist/'
function build(plugin) { function build(plugin) {
console.log(`Building ${plugin} plugin...`) console.log(`Building ${plugin} plugin...`)
const external = ['hammerjs', 'jquery', 'popper.js'] const external = ['jquery', 'popper.js']
const globals = { const globals = {
hammerjs: 'Hammer',
jquery: 'jQuery', // Ensure we use jQuery which is always available even in noConflict mode jquery: 'jQuery', // Ensure we use jQuery which is always available even in noConflict mode
'popper.js': 'Popper' 'popper.js': 'Popper'
} }

View File

@ -42,10 +42,6 @@ const files = [
{ {
file: 'node_modules/popper.js/dist/umd/popper.min.js', file: 'node_modules/popper.js/dist/umd/popper.min.js',
configPropertyName: 'popper_hash' configPropertyName: 'popper_hash'
},
{
file: 'node_modules/hammerjs/hammer.min.js',
configPropertyName: 'hammer_hash'
} }
] ]

View File

@ -1,13 +1,12 @@
const path = require('path') const path = require('path')
const babel = require('rollup-plugin-babel') const babel = require('rollup-plugin-babel')
const resolve = require('rollup-plugin-node-resolve') const resolve = require('rollup-plugin-node-resolve')
const commonjs = require('rollup-plugin-commonjs') const banner = require('./banner.js')
const banner = require('./banner.js')
const BUNDLE = process.env.BUNDLE === 'true' const BUNDLE = process.env.BUNDLE === 'true'
let fileDest = 'bootstrap.js' let fileDest = 'bootstrap.js'
const external = ['jquery', 'hammerjs', 'popper.js'] const external = ['jquery', 'popper.js']
const plugins = [ const plugins = [
babel({ babel({
exclude: 'node_modules/**', // Only transpile our source code exclude: 'node_modules/**', // Only transpile our source code
@ -22,22 +21,15 @@ const plugins = [
] ]
const globals = { const globals = {
jquery: 'jQuery', // Ensure we use jQuery which is always available even in noConflict mode jquery: 'jQuery', // Ensure we use jQuery which is always available even in noConflict mode
hammerjs: 'Hammer',
'popper.js': 'Popper' 'popper.js': 'Popper'
} }
if (BUNDLE) { if (BUNDLE) {
fileDest = 'bootstrap.bundle.js' fileDest = 'bootstrap.bundle.js'
// We just keep jQuery as external // Remove last entry in external array to bundle Popper
external.length = 1 external.pop()
delete globals['popper.js'] delete globals['popper.js']
delete globals.hammerjs plugins.push(resolve())
plugins.push(
commonjs({
include: 'node_modules/**'
}),
resolve()
)
} }
module.exports = { module.exports = {

View File

@ -1,7 +1,3 @@
import $ from 'jquery'
import Hammer from 'hammerjs'
import Util from './util'
/** /**
* -------------------------------------------------------------------------- * --------------------------------------------------------------------------
* Bootstrap (v4.1.3): carousel.js * Bootstrap (v4.1.3): carousel.js
@ -9,6 +5,9 @@ import Util from './util'
* -------------------------------------------------------------------------- * --------------------------------------------------------------------------
*/ */
import $ from 'jquery'
import Util from './util'
/** /**
* ------------------------------------------------------------------------ * ------------------------------------------------------------------------
* Constants * Constants
@ -24,7 +23,7 @@ const JQUERY_NO_CONFLICT = $.fn[NAME]
const ARROW_LEFT_KEYCODE = 37 // KeyboardEvent.which value for left arrow key 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 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 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 = { const Default = {
interval : 5000, interval : 5000,
@ -58,10 +57,10 @@ const Event = {
MOUSEENTER : `mouseenter${EVENT_KEY}`, MOUSEENTER : `mouseenter${EVENT_KEY}`,
MOUSELEAVE : `mouseleave${EVENT_KEY}`, MOUSELEAVE : `mouseleave${EVENT_KEY}`,
TOUCHEND : `touchend${EVENT_KEY}`, TOUCHEND : `touchend${EVENT_KEY}`,
TOUCHSTART : `touchstart${EVENT_KEY}`,
TOUCHMOVE : `touchmove${EVENT_KEY}`,
LOAD_DATA_API : `load${EVENT_KEY}${DATA_API_KEY}`, LOAD_DATA_API : `load${EVENT_KEY}${DATA_API_KEY}`,
CLICK_DATA_API : `click${EVENT_KEY}${DATA_API_KEY}`, CLICK_DATA_API : `click${EVENT_KEY}${DATA_API_KEY}`
SWIPELEFT : 'swipeleft',
SWIPERIGHT : 'swiperight'
} }
const ClassName = { const ClassName = {
@ -98,22 +97,13 @@ class Carousel {
this._isPaused = false this._isPaused = false
this._isSliding = false this._isSliding = false
this.touchTimeout = null this.touchTimeout = null
this.hammer = null this.touchStartX = 0
this.touchDeltaX = 0
this._config = this._getConfig(config) this._config = this._getConfig(config)
this._element = element this._element = element
this._indicatorsElement = this._element.querySelector(Selector.INDICATORS) this._indicatorsElement = this._element.querySelector(Selector.INDICATORS)
this._touchSupported = 'ontouchstart' in document.documentElement || navigator.maxTouchPoints > 0 this._touchSupported = 'ontouchstart' in document.documentElement
if (HAMMER_ENABLED && this._touchSupported && this._config.touch) {
this.hammer = new Hammer(this._element, {
recognizers: [[
Hammer.Swipe, {
direction: Hammer.DIRECTION_HORIZONTAL
}
]]
})
}
this._addEventListeners() this._addEventListeners()
} }
@ -235,22 +225,65 @@ class Carousel {
return config 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() { _addEventListeners() {
if (this._config.keyboard) { if (this._config.keyboard) {
$(this._element) $(this._element)
.on(Event.KEYDOWN, (event) => this._keydown(event)) .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') { if (this._config.pause === 'hover') {
$(this._element) $(this._element)
.on(Event.MOUSEENTER, (event) => this.pause(event)) .on(Event.MOUSEENTER, (event) => this.pause(event))
.on(Event.MOUSELEAVE, (event) => this.cycle(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 // If it's a touch-enabled device, mouseenter/leave are fired as
// part of the mouse compatibility events on first tap - the carousel // part of the mouse compatibility events on first tap - the carousel
// would stop cycling until user tapped out of it; // would stop cycling until user tapped out of it;
@ -258,15 +291,14 @@ class Carousel {
// (as if it's the second time we tap on it, mouseenter compat event // (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 // is NOT fired) and after a timeout (to allow for mouse compatibility
// events to fire) we explicitly restart cycling // events to fire) we explicitly restart cycling
$(this._element).on(Event.TOUCHEND, () => {
this.pause() this.pause()
if (this.touchTimeout) { if (this.touchTimeout) {
clearTimeout(this.touchTimeout) clearTimeout(this.touchTimeout)
} }
this.touchTimeout = setTimeout((event) => this.cycle(event), TOUCHEVENT_COMPAT_WAIT + this._config.interval) this.touchTimeout = setTimeout((event) => this.cycle(event), TOUCHEVENT_COMPAT_WAIT + this._config.interval)
})
} }
} })
} }
_keydown(event) { _keydown(event) {

View File

@ -20,7 +20,6 @@
}()) }())
</script> </script>
<script src="../../node_modules/popper.js/dist/umd/popper.min.js"></script> <script src="../../node_modules/popper.js/dist/umd/popper.min.js"></script>
<script src="../../node_modules/hammerjs/hammer.min.js"></script>
<!-- QUnit --> <!-- QUnit -->
<link rel="stylesheet" href="../../node_modules/qunit/qunit/qunit.css" media="screen"> <link rel="stylesheet" href="../../node_modules/qunit/qunit/qunit.css" media="screen">

View File

@ -12,16 +12,16 @@ const jqueryFile = process.env.USE_OLD_JQUERY ? 'https://code.jquery.com/jquery-
const bundle = process.env.BUNDLE === 'true' const bundle = process.env.BUNDLE === 'true'
const browserStack = process.env.BROWSER === 'true' const browserStack = process.env.BROWSER === 'true'
const plugins = [
'karma-qunit',
'karma-sinon'
]
const frameworks = [ const frameworks = [
'qunit', 'qunit',
'sinon' 'sinon'
] ]
const plugins = [
'karma-qunit',
'karma-sinon'
]
const reporters = ['dots'] const reporters = ['dots']
const detectBrowsers = { const detectBrowsers = {
@ -48,7 +48,6 @@ const customLaunchers = {
let files = [ let files = [
'node_modules/popper.js/dist/umd/popper.min.js', 'node_modules/popper.js/dist/umd/popper.min.js',
'node_modules/hammerjs/hammer.min.js',
'node_modules/hammer-simulator/index.js' 'node_modules/hammer-simulator/index.js'
] ]

View File

@ -3,8 +3,6 @@ $(function () {
window.Carousel = typeof bootstrap !== 'undefined' ? bootstrap.Carousel : Carousel window.Carousel = typeof bootstrap !== 'undefined' ? bootstrap.Carousel : Carousel
var touchSupported = 'ontouchstart' in document.documentElement || navigator.maxTouchPoints > 0
QUnit.module('carousel plugin') QUnit.module('carousel plugin')
QUnit.test('should be defined on jQuery object', function (assert) { QUnit.test('should be defined on jQuery object', function (assert) {
@ -1009,13 +1007,8 @@ $(function () {
}) })
QUnit.test('should allow swiperight and call prev', function (assert) { QUnit.test('should allow swiperight and call prev', function (assert) {
if (!touchSupported) { Simulator.setType('touch')
assert.expect(0) assert.expect(3)
return
}
assert.expect(2)
var done = assert.async() var done = assert.async()
document.documentElement.ontouchstart = $.noop document.documentElement.ontouchstart = $.noop
@ -1035,10 +1028,13 @@ $(function () {
$carousel.appendTo('#qunit-fixture') $carousel.appendTo('#qunit-fixture')
var $item = $('#item') var $item = $('#item')
$carousel.bootstrapCarousel() $carousel.bootstrapCarousel()
var carousel = $carousel.data('bs.carousel')
var spy = sinon.spy(carousel, 'prev')
$carousel.one('slid.bs.carousel', function () { $carousel.one('slid.bs.carousel', function () {
assert.ok(true, 'slid event fired') assert.ok(true, 'slid event fired')
assert.ok($item.hasClass('active')) assert.ok($item.hasClass('active'))
assert.ok(spy.called)
delete document.documentElement.ontouchstart delete document.documentElement.ontouchstart
done() done()
}) })
@ -1049,40 +1045,10 @@ $(function () {
}) })
}) })
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) { QUnit.test('should allow swipeleft and call next', function (assert) {
if (!touchSupported) { assert.expect(3)
assert.expect(0) Simulator.setType('touch')
return
}
assert.expect(2)
var done = assert.async() var done = assert.async()
document.documentElement.ontouchstart = $.noop document.documentElement.ontouchstart = $.noop
@ -1102,11 +1068,13 @@ $(function () {
$carousel.appendTo('#qunit-fixture') $carousel.appendTo('#qunit-fixture')
var $item = $('#item') var $item = $('#item')
$carousel.bootstrapCarousel() $carousel.bootstrapCarousel()
var carousel = $carousel.data('bs.carousel')
var spy = sinon.spy(carousel, 'next')
$carousel.one('slid.bs.carousel', function () { $carousel.one('slid.bs.carousel', function () {
assert.ok(true, 'slid event fired') assert.ok(true, 'slid event fired')
assert.ok(!$item.hasClass('active')) assert.ok(!$item.hasClass('active'))
delete document.documentElement.ontouchstart assert.ok(spy.called)
done() done()
}) })
@ -1116,4 +1084,25 @@ $(function () {
deltaY: 0 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()
})
})
}) })

View File

@ -46,7 +46,6 @@
</div> </div>
<script src="../../../site/docs/4.1/assets/js/vendor/jquery-slim.min.js"></script> <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/util.js"></script>
<script src="../../dist/carousel.js"></script> <script src="../../dist/carousel.js"></script>
<script> <script>

33
package-lock.json generated
View File

@ -4818,12 +4818,6 @@
"integrity": "sha1-7tO85CtDMgF1o/T4NP4gjl+iSho=", "integrity": "sha1-7tO85CtDMgF1o/T4NP4gjl+iSho=",
"dev": true "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": { "handlebars": {
"version": "4.0.12", "version": "4.0.12",
"resolved": "https://registry.npmjs.org/handlebars/-/handlebars-4.0.12.tgz", "resolved": "https://registry.npmjs.org/handlebars/-/handlebars-4.0.12.tgz",
@ -6455,15 +6449,6 @@
"yallist": "^2.1.2" "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": { "make-dir": {
"version": "1.3.0", "version": "1.3.0",
"resolved": "https://registry.npmjs.org/make-dir/-/make-dir-1.3.0.tgz", "resolved": "https://registry.npmjs.org/make-dir/-/make-dir-1.3.0.tgz",
@ -9016,18 +9001,6 @@
"rollup-pluginutils": "^2.3.0" "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": { "rollup-plugin-node-resolve": {
"version": "3.4.0", "version": "3.4.0",
"resolved": "https://registry.npmjs.org/rollup-plugin-node-resolve/-/rollup-plugin-node-resolve-3.4.0.tgz", "resolved": "https://registry.npmjs.org/rollup-plugin-node-resolve/-/rollup-plugin-node-resolve-3.4.0.tgz",
@ -11498,12 +11471,6 @@
"unist-util-stringify-position": "^1.1.1" "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": { "vnu-jar": {
"version": "18.8.29", "version": "18.8.29",
"resolved": "https://registry.npmjs.org/vnu-jar/-/vnu-jar-18.8.29.tgz", "resolved": "https://registry.npmjs.org/vnu-jar/-/vnu-jar-18.8.29.tgz",

View File

@ -95,7 +95,6 @@
"license": "MIT", "license": "MIT",
"dependencies": {}, "dependencies": {},
"peerDependencies": { "peerDependencies": {
"hammerjs": "^2.0.8",
"jquery": "1.9.1 - 3", "jquery": "1.9.1 - 3",
"popper.js": "^1.14.4" "popper.js": "^1.14.4"
}, },
@ -116,7 +115,6 @@
"find-unused-sass-variables": "^0.2.1", "find-unused-sass-variables": "^0.2.1",
"glob": "^7.1.3", "glob": "^7.1.3",
"hammer-simulator": "0.0.1", "hammer-simulator": "0.0.1",
"hammerjs": "^2.0.8",
"htmllint-cli": "^0.0.7", "htmllint-cli": "^0.0.7",
"http-server": "^0.11.1", "http-server": "^0.11.1",
"ip": "^1.1.5", "ip": "^1.1.5",
@ -136,7 +134,6 @@
"qunit": "^2.7.0", "qunit": "^2.7.0",
"rollup": "^0.66.6", "rollup": "^0.66.6",
"rollup-plugin-babel": "^4.0.3", "rollup-plugin-babel": "^4.0.3",
"rollup-plugin-commonjs": "^9.1.6",
"rollup-plugin-node-resolve": "^3.4.0", "rollup-plugin-node-resolve": "^3.4.0",
"shelljs": "^0.8.2", "shelljs": "^0.8.2",
"shx": "^0.3.2", "shx": "^0.3.2",
@ -185,11 +182,11 @@
}, },
{ {
"path": "./dist/js/bootstrap.bundle.js", "path": "./dist/js/bootstrap.bundle.js",
"maxSize": "61 kB" "maxSize": "45 kB"
}, },
{ {
"path": "./dist/js/bootstrap.bundle.min.js", "path": "./dist/js/bootstrap.bundle.min.js",
"maxSize": "28 kB" "maxSize": "25 kB"
}, },
{ {
"path": "./dist/js/bootstrap.js", "path": "./dist/js/bootstrap.js",

View File

@ -1,6 +1,5 @@
<script src="{{ site.cdn.jquery }}" integrity="{{ site.cdn.jquery_hash }}" crossorigin="anonymous"></script> <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>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" -%} {%- 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> <script src="{{ site.baseurl }}/docs/{{ site.docs_version }}/dist/js/bootstrap.bundle.min.js" integrity="{{ site.cdn.js_bundle_hash }}" crossorigin="anonymous"></script>

View File

@ -12,8 +12,6 @@ The carousel is a slideshow for cycling through a series of content, built with
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.). 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. 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). Lastly, if you're building our JavaScript from source, it [requires `util.js`]({{ site.baseurl }}/docs/{{ site.docs_version }}/getting-started/javascript/#util).
@ -287,7 +285,7 @@ Options can be passed via data attributes or JavaScript. For data attributes, ap
<td>touch</td> <td>touch</td>
<td>boolean</td> <td>boolean</td>
<td>true</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> </tr>
</tbody> </tbody>
</table> </table>

View File

@ -38,7 +38,7 @@ bootstrap/
└── bootstrap.min.js.map └── bootstrap.min.js.map
{% endhighlight %} {% 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 ## CSS files

View File

@ -37,7 +37,7 @@ We use [jQuery's slim build](https://blog.jquery.com/2016/06/09/jquery-3-0-final
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. 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> <details>
<summary class="text-primary mb-3">Show components requiring JavaScript</summary> <summary class="text-primary mb-3">Show components requiring JavaScript</summary>