mirror of
https://github.com/twbs/bootstrap.git
synced 2025-01-23 15:52:21 +01:00
684 lines
45 KiB
HTML
684 lines
45 KiB
HTML
<!doctype html>
|
||
<html lang="en">
|
||
<head>
|
||
<meta charset="utf-8">
|
||
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
|
||
<meta name="description" content="Bring Bootstrap to life with our optional JavaScript plugins built on jQuery. Learn about each plugin, our data and programmatic API options, and more.">
|
||
<meta name="author" content="Mark Otto, Jacob Thornton, and Bootstrap contributors">
|
||
<meta name="generator" content="Jekyll v4.1.1">
|
||
|
||
<meta name="docsearch:language" content="en">
|
||
<meta name="docsearch:version" content="4.5">
|
||
|
||
<title>JavaScript · Bootstrap v4.5</title>
|
||
|
||
<link rel="canonical" href="https://getbootstrap.com/docs/4.5/getting-started/javascript/">
|
||
|
||
<!-- Bootstrap core CSS -->
|
||
<link href="/docs/4.5/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-JcKb8q3iqJ61gNV9KGb8thSsNjpSL0n8PARn9HuZOnIxN0hoP+VmmDGMN5t9UJ0Z" crossorigin="anonymous">
|
||
<!-- Documentation extras -->
|
||
|
||
<link href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css" rel="stylesheet">
|
||
|
||
|
||
<link href="/docs/4.5/assets/css/docs.min.css" rel="stylesheet">
|
||
|
||
<!-- Favicons -->
|
||
<link rel="apple-touch-icon" href="/docs/4.5/assets/img/favicons/apple-touch-icon.png" sizes="180x180">
|
||
<link rel="icon" href="/docs/4.5/assets/img/favicons/favicon-32x32.png" sizes="32x32" type="image/png">
|
||
<link rel="icon" href="/docs/4.5/assets/img/favicons/favicon-16x16.png" sizes="16x16" type="image/png">
|
||
<link rel="manifest" href="/docs/4.5/assets/img/favicons/manifest.json">
|
||
<link rel="mask-icon" href="/docs/4.5/assets/img/favicons/safari-pinned-tab.svg" color="#563d7c">
|
||
<link rel="icon" href="/docs/4.5/assets/img/favicons/favicon.ico">
|
||
<meta name="msapplication-config" content="/docs/4.5/assets/img/favicons/browserconfig.xml">
|
||
<meta name="theme-color" content="#563d7c">
|
||
|
||
<!-- Twitter -->
|
||
<meta name="twitter:card" content="summary">
|
||
<meta name="twitter:site" content="@getbootstrap">
|
||
<meta name="twitter:creator" content="@getbootstrap">
|
||
<meta name="twitter:title" content="JavaScript">
|
||
<meta name="twitter:description" content="Bring Bootstrap to life with our optional JavaScript plugins built on jQuery. Learn about each plugin, our data and programmatic API options, and more.">
|
||
<meta name="twitter:image" content="https://getbootstrap.com/docs/4.5/assets/brand/bootstrap-social-logo.png">
|
||
|
||
<!-- Facebook -->
|
||
<meta property="og:url" content="https://getbootstrap.com/docs/4.5/getting-started/javascript/">
|
||
<meta property="og:title" content="JavaScript">
|
||
<meta property="og:description" content="Bring Bootstrap to life with our optional JavaScript plugins built on jQuery. Learn about each plugin, our data and programmatic API options, and more.">
|
||
<meta property="og:type" content="website">
|
||
<meta property="og:image" content="https://getbootstrap.com/docs/4.5/assets/brand/bootstrap-social.png">
|
||
<meta property="og:image:type" content="image/png">
|
||
<meta property="og:image:width" content="1200">
|
||
<meta property="og:image:height" content="630">
|
||
|
||
<script>
|
||
window.ga=window.ga||function(){(ga.q=ga.q||[]).push(arguments)};ga.l=+new Date;
|
||
ga('create', 'UA-146052-10', 'getbootstrap.com');
|
||
ga('set', 'anonymizeIp', true);
|
||
ga('send', 'pageview');
|
||
</script>
|
||
<script async src="https://www.google-analytics.com/analytics.js"></script>
|
||
|
||
|
||
</head>
|
||
<body>
|
||
<div class="skippy overflow-hidden">
|
||
<div class="container-xl">
|
||
<a class="sr-only sr-only-focusable d-inline-flex p-2 m-1" href="#content">Skip to main content</a><a class="sr-only sr-only-focusable d-none d-md-inline-flex p-2 m-1" href="#bd-docs-nav">Skip to docs navigation</a></div>
|
||
</div>
|
||
|
||
|
||
<header class="navbar navbar-expand navbar-dark flex-column flex-md-row bd-navbar">
|
||
<a class="navbar-brand mr-0 mr-md-2" href="/" aria-label="Bootstrap"><svg xmlns="http://www.w3.org/2000/svg" width="36" height="36" class="d-block" viewBox="0 0 612 612" role="img" focusable="false"><title>Bootstrap</title><path fill="currentColor" d="M510 8a94.3 94.3 0 0 1 94 94v408a94.3 94.3 0 0 1-94 94H102a94.3 94.3 0 0 1-94-94V102a94.3 94.3 0 0 1 94-94h408m0-8H102C45.9 0 0 45.9 0 102v408c0 56.1 45.9 102 102 102h408c56.1 0 102-45.9 102-102V102C612 45.9 566.1 0 510 0z"/><path fill="currentColor" d="M196.77 471.5V154.43h124.15c54.27 0 91 31.64 91 79.1 0 33-24.17 63.72-54.71 69.21v1.76c43.07 5.49 70.75 35.82 70.75 78 0 55.81-40 89-107.45 89zm39.55-180.4h63.28c46.8 0 72.29-18.68 72.29-53 0-31.42-21.53-48.78-60-48.78h-75.57zm78.22 145.46c47.68 0 72.73-19.34 72.73-56s-25.93-55.37-76.46-55.37h-74.49v111.4z"/></svg></a>
|
||
|
||
<div class="navbar-nav-scroll">
|
||
<ul class="navbar-nav bd-navbar-nav flex-row">
|
||
<li class="nav-item">
|
||
<a class="nav-link " href="/" onclick="ga('send', 'event', 'Navbar', 'Community links', 'Bootstrap');">Home</a>
|
||
</li>
|
||
<li class="nav-item">
|
||
<a class="nav-link active" href="/docs/4.5/getting-started/introduction/" onclick="ga('send', 'event', 'Navbar', 'Community links', 'Docs');">Documentation</a>
|
||
</li>
|
||
<li class="nav-item">
|
||
<a class="nav-link " href="/docs/4.5/examples/" onclick="ga('send', 'event', 'Navbar', 'Community links', 'Examples');">Examples</a>
|
||
</li>
|
||
<li class="nav-item">
|
||
<a class="nav-link" href="https://icons.getbootstrap.com/" onclick="ga('send', 'event', 'Navbar', 'Community links', 'Icons');" target="_blank" rel="noopener">Icons</a>
|
||
</li>
|
||
<li class="nav-item">
|
||
<a class="nav-link" href="https://themes.getbootstrap.com/" onclick="ga('send', 'event', 'Navbar', 'Community links', 'Themes');" target="_blank" rel="noopener">Themes</a>
|
||
</li>
|
||
<li class="nav-item">
|
||
<a class="nav-link" href="https://expo.getbootstrap.com/" onclick="ga('send', 'event', 'Navbar', 'Community links', 'Expo');" target="_blank" rel="noopener">Expo</a>
|
||
</li>
|
||
<li class="nav-item">
|
||
<a class="nav-link" href="https://blog.getbootstrap.com/" onclick="ga('send', 'event', 'Navbar', 'Community links', 'Blog');" target="_blank" rel="noopener">Blog</a>
|
||
</li>
|
||
</ul>
|
||
</div>
|
||
|
||
<ul class="navbar-nav ml-md-auto">
|
||
<li class="nav-item dropdown">
|
||
<a class="nav-item nav-link dropdown-toggle mr-md-2" href="#" id="bd-versions" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
|
||
v4.5
|
||
</a>
|
||
<div class="dropdown-menu dropdown-menu-md-right" aria-labelledby="bd-versions">
|
||
<a class="dropdown-item active" href="/docs/4.5/">Latest (4.5.x)</a>
|
||
<div class="dropdown-divider"></div>
|
||
<a class="dropdown-item" href="https://getbootstrap.com/docs/3.4/">v3.4.1</a>
|
||
<a class="dropdown-item" href="https://getbootstrap.com/2.3.2/">v2.3.2</a>
|
||
<div class="dropdown-divider"></div>
|
||
<a class="dropdown-item" href="/docs/versions/">All versions</a>
|
||
</div>
|
||
</li>
|
||
|
||
<li class="nav-item">
|
||
<a class="nav-link pl-2 pr-1 mx-1 py-3 my-n2" href="https://github.com/twbs" target="_blank" rel="noopener" aria-label="GitHub"><svg xmlns="http://www.w3.org/2000/svg" class="navbar-nav-svg" viewBox="0 0 512 499.36" role="img" focusable="false"><title>GitHub</title><path fill="currentColor" fill-rule="evenodd" d="M256 0C114.64 0 0 114.61 0 256c0 113.09 73.34 209 175.08 242.9 12.8 2.35 17.47-5.56 17.47-12.34 0-6.08-.22-22.18-.35-43.54-71.2 15.49-86.2-34.34-86.2-34.34-11.64-29.57-28.42-37.45-28.42-37.45-23.27-15.84 1.73-15.55 1.73-15.55 25.69 1.81 39.21 26.38 39.21 26.38 22.84 39.12 59.92 27.82 74.5 21.27 2.33-16.54 8.94-27.82 16.25-34.22-56.84-6.43-116.6-28.43-116.6-126.49 0-27.95 10-50.8 26.35-68.69-2.63-6.48-11.42-32.5 2.51-67.75 0 0 21.49-6.88 70.4 26.24a242.65 242.65 0 0 1 128.18 0c48.87-33.13 70.33-26.24 70.33-26.24 14 35.25 5.18 61.27 2.55 67.75 16.41 17.9 26.31 40.75 26.31 68.69 0 98.35-59.85 120-116.88 126.32 9.19 7.9 17.38 23.53 17.38 47.41 0 34.22-.31 61.83-.31 70.23 0 6.85 4.61 14.81 17.6 12.31C438.72 464.97 512 369.08 512 256.02 512 114.62 397.37 0 256 0z"/></svg></a>
|
||
</li>
|
||
<li class="nav-item">
|
||
<a class="nav-link px-1 mx-1 py-3 my-n2" href="https://twitter.com/getbootstrap" target="_blank" rel="noopener" aria-label="Twitter"><svg xmlns="http://www.w3.org/2000/svg" class="navbar-nav-svg" viewBox="0 0 512 416.32" role="img" focusable="false"><title>Twitter</title><path fill="currentColor" d="M160.83 416.32c193.2 0 298.92-160.22 298.92-298.92 0-4.51 0-9-.2-13.52A214 214 0 0 0 512 49.38a212.93 212.93 0 0 1-60.44 16.6 105.7 105.7 0 0 0 46.3-58.19 209 209 0 0 1-66.79 25.37 105.09 105.09 0 0 0-181.73 71.91 116.12 116.12 0 0 0 2.66 24c-87.28-4.3-164.73-46.3-216.56-109.82A105.48 105.48 0 0 0 68 159.6a106.27 106.27 0 0 1-47.53-13.11v1.43a105.28 105.28 0 0 0 84.21 103.06 105.67 105.67 0 0 1-47.33 1.84 105.06 105.06 0 0 0 98.14 72.94A210.72 210.72 0 0 1 25 370.84a202.17 202.17 0 0 1-25-1.43 298.85 298.85 0 0 0 160.83 46.92"/></svg></a>
|
||
</li>
|
||
<li class="nav-item">
|
||
<a class="nav-link px-1 mx-1 py-3 my-n2" href="https://bootstrap-slack.herokuapp.com/" target="_blank" rel="noopener" aria-label="Slack"><svg xmlns="http://www.w3.org/2000/svg" class="navbar-nav-svg" viewBox="0 0 512 512" role="img" focusable="false"><title>Slack</title><path fill="currentColor" d="M210.787 234.832l68.31-22.883 22.1 65.977-68.309 22.882z"/><path fill="currentColor" d="M490.54 185.6C437.7 9.59 361.6-31.34 185.6 21.46S-31.3 150.4 21.46 326.4 150.4 543.3 326.4 490.54 543.34 361.6 490.54 185.6zM401.7 299.8l-33.15 11.05 11.46 34.38c4.5 13.92-2.87 29.06-16.78 33.56-2.87.82-6.14 1.64-9 1.23a27.32 27.32 0 0 1-24.56-18l-11.46-34.38-68.36 22.92 11.46 34.38c4.5 13.92-2.87 29.06-16.78 33.56-2.87.82-6.14 1.64-9 1.23a27.32 27.32 0 0 1-24.56-18l-11.46-34.43-33.15 11.05c-2.87.82-6.14 1.64-9 1.23a27.32 27.32 0 0 1-24.56-18c-4.5-13.92 2.87-29.06 16.78-33.56l33.12-11.03-22.1-65.9-33.15 11.05c-2.87.82-6.14 1.64-9 1.23a27.32 27.32 0 0 1-24.56-18c-4.48-13.93 2.89-29.07 16.81-33.58l33.15-11.05-11.46-34.38c-4.5-13.92 2.87-29.06 16.78-33.56s29.06 2.87 33.56 16.78l11.46 34.38 68.36-22.92-11.46-34.38c-4.5-13.92 2.87-29.06 16.78-33.56s29.06 2.87 33.56 16.78l11.47 34.42 33.15-11.05c13.92-4.5 29.06 2.87 33.56 16.78s-2.87 29.06-16.78 33.56L329.7 194.6l22.1 65.9 33.15-11.05c13.92-4.5 29.06 2.87 33.56 16.78s-2.88 29.07-16.81 33.57z"/></svg></a>
|
||
</li>
|
||
<li class="nav-item">
|
||
<a class="nav-link px-1 mx-1 py-3 my-n2" href="https://opencollective.com/bootstrap/" target="_blank" rel="noopener" aria-label="Open Collective"><svg xmlns="http://www.w3.org/2000/svg" fill="currentColor" fill-rule="evenodd" class="navbar-nav-svg" viewBox="0 0 40 41" role="img" focusable="false"><title>Open Collective</title><path fill-opacity=".4" d="M32.8 21c0 2.4-.8 4.9-2 6.9l5.1 5.1c2.5-3.4 4.1-7.6 4.1-12 0-4.6-1.6-8.8-4-12.2L30.7 14c1.2 2 2 4.3 2 7z"/><path d="M20 33.7a12.8 12.8 0 0 1 0-25.6c2.6 0 5 .7 7 2.1L32 5a20 20 0 1 0 .1 31.9l-5-5.2a13 13 0 0 1-7 2z"/></svg></a>
|
||
</li>
|
||
</ul>
|
||
|
||
<a class="btn btn-bd-download d-none d-lg-inline-block mb-3 mb-md-0 ml-md-3" href="/docs/4.5/getting-started/download/">Download</a>
|
||
</header>
|
||
|
||
|
||
<div class="container-fluid">
|
||
<div class="row flex-xl-nowrap">
|
||
<div class="col-md-3 col-xl-2 bd-sidebar">
|
||
<form role="search" class="bd-search d-flex align-items-center">
|
||
<input type="search" class="form-control" id="search-input" placeholder="Search..." aria-label="Search for..." autocomplete="off" data-docs-version="4.5">
|
||
<button class="btn bd-search-docs-toggle d-md-none p-0 ml-3" type="button" data-toggle="collapse" data-target="#bd-docs-nav" aria-controls="bd-docs-nav" aria-expanded="false" aria-label="Toggle docs navigation"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"/></svg></button>
|
||
</form>
|
||
|
||
<nav class="collapse bd-links" id="bd-docs-nav" aria-label="Main navigation"><div class="bd-toc-item active">
|
||
<a class="bd-toc-link" href="/docs/4.5/getting-started/introduction/">
|
||
Getting started
|
||
</a>
|
||
|
||
<ul class="nav bd-sidenav"><li>
|
||
<a href="/docs/4.5/getting-started/introduction/">
|
||
Introduction
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/getting-started/download/">
|
||
Download
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/getting-started/contents/">
|
||
Contents
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/getting-started/browsers-devices/">
|
||
Browsers & devices
|
||
</a>
|
||
</li><li class="active bd-sidenav-active">
|
||
<a href="/docs/4.5/getting-started/javascript/">
|
||
JavaScript
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/getting-started/theming/">
|
||
Theming
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/getting-started/build-tools/">
|
||
Build tools
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/getting-started/webpack/">
|
||
Webpack
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/getting-started/accessibility/">
|
||
Accessibility
|
||
</a>
|
||
</li></ul>
|
||
</div><div class="bd-toc-item">
|
||
<a class="bd-toc-link" href="/docs/4.5/layout/overview/">
|
||
Layout
|
||
</a>
|
||
|
||
<ul class="nav bd-sidenav"><li>
|
||
<a href="/docs/4.5/layout/overview/">
|
||
Overview
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/layout/grid/">
|
||
Grid
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/layout/utilities-for-layout/">
|
||
Utilities for layout
|
||
</a>
|
||
</li></ul>
|
||
</div><div class="bd-toc-item">
|
||
<a class="bd-toc-link" href="/docs/4.5/content/reboot/">
|
||
Content
|
||
</a>
|
||
|
||
<ul class="nav bd-sidenav"><li>
|
||
<a href="/docs/4.5/content/reboot/">
|
||
Reboot
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/content/typography/">
|
||
Typography
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/content/code/">
|
||
Code
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/content/images/">
|
||
Images
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/content/tables/">
|
||
Tables
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/content/figures/">
|
||
Figures
|
||
</a>
|
||
</li></ul>
|
||
</div><div class="bd-toc-item">
|
||
<a class="bd-toc-link" href="/docs/4.5/components/alerts/">
|
||
Components
|
||
</a>
|
||
|
||
<ul class="nav bd-sidenav"><li>
|
||
<a href="/docs/4.5/components/alerts/">
|
||
Alerts
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/components/badge/">
|
||
Badge
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/components/breadcrumb/">
|
||
Breadcrumb
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/components/buttons/">
|
||
Buttons
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/components/button-group/">
|
||
Button group
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/components/card/">
|
||
Card
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/components/carousel/">
|
||
Carousel
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/components/collapse/">
|
||
Collapse
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/components/dropdowns/">
|
||
Dropdowns
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/components/forms/">
|
||
Forms
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/components/input-group/">
|
||
Input group
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/components/jumbotron/">
|
||
Jumbotron
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/components/list-group/">
|
||
List group
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/components/media-object/">
|
||
Media object
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/components/modal/">
|
||
Modal
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/components/navs/">
|
||
Navs
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/components/navbar/">
|
||
Navbar
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/components/pagination/">
|
||
Pagination
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/components/popovers/">
|
||
Popovers
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/components/progress/">
|
||
Progress
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/components/scrollspy/">
|
||
Scrollspy
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/components/spinners/">
|
||
Spinners
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/components/toasts/">
|
||
Toasts
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/components/tooltips/">
|
||
Tooltips
|
||
</a>
|
||
</li></ul>
|
||
</div><div class="bd-toc-item">
|
||
<a class="bd-toc-link" href="/docs/4.5/utilities/borders/">
|
||
Utilities
|
||
</a>
|
||
|
||
<ul class="nav bd-sidenav"><li>
|
||
<a href="/docs/4.5/utilities/borders/">
|
||
Borders
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/utilities/clearfix/">
|
||
Clearfix
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/utilities/close-icon/">
|
||
Close icon
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/utilities/colors/">
|
||
Colors
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/utilities/display/">
|
||
Display
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/utilities/embed/">
|
||
Embed
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/utilities/flex/">
|
||
Flex
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/utilities/float/">
|
||
Float
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/utilities/image-replacement/">
|
||
Image replacement
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/utilities/interactions/">
|
||
Interactions
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/utilities/overflow/">
|
||
Overflow
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/utilities/position/">
|
||
Position
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/utilities/screen-readers/">
|
||
Screen readers
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/utilities/shadows/">
|
||
Shadows
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/utilities/sizing/">
|
||
Sizing
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/utilities/spacing/">
|
||
Spacing
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/utilities/stretched-link/">
|
||
Stretched link
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/utilities/text/">
|
||
Text
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/utilities/vertical-align/">
|
||
Vertical align
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/utilities/visibility/">
|
||
Visibility
|
||
</a>
|
||
</li></ul>
|
||
</div><div class="bd-toc-item">
|
||
<a class="bd-toc-link" href="/docs/4.5/extend/approach/">
|
||
Extend
|
||
</a>
|
||
|
||
<ul class="nav bd-sidenav"><li>
|
||
<a href="/docs/4.5/extend/approach/">
|
||
Approach
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/extend/icons/">
|
||
Icons
|
||
</a>
|
||
</li></ul>
|
||
</div><div class="bd-toc-item">
|
||
<a class="bd-toc-link" href="/docs/4.5/migration/">
|
||
Migration
|
||
</a>
|
||
|
||
<ul class="nav bd-sidenav"></ul>
|
||
</div><div class="bd-toc-item">
|
||
<a class="bd-toc-link" href="/docs/4.5/about/overview/">
|
||
About
|
||
</a>
|
||
|
||
<ul class="nav bd-sidenav"><li>
|
||
<a href="/docs/4.5/about/overview/">
|
||
Overview
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/about/team/">
|
||
Team
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/about/brand/">
|
||
Brand
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/about/license/">
|
||
License
|
||
</a>
|
||
</li><li>
|
||
<a href="/docs/4.5/about/translations/">
|
||
Translations
|
||
</a>
|
||
</li></ul>
|
||
</div></nav>
|
||
|
||
</div>
|
||
|
||
|
||
<nav class="d-none d-xl-block col-xl-2 bd-toc" aria-label="Secondary navigation">
|
||
<ul class="section-nav">
|
||
<li class="toc-entry toc-h2"><a href="#individual-or-compiled">Individual or compiled</a></li>
|
||
<li class="toc-entry toc-h2"><a href="#dependencies">Dependencies</a></li>
|
||
<li class="toc-entry toc-h2"><a href="#data-attributes">Data attributes</a></li>
|
||
<li class="toc-entry toc-h2"><a href="#events">Events</a></li>
|
||
<li class="toc-entry toc-h2"><a href="#programmatic-api">Programmatic API</a>
|
||
<ul>
|
||
<li class="toc-entry toc-h3"><a href="#asynchronous-functions-and-transitions">Asynchronous functions and transitions</a></li>
|
||
<li class="toc-entry toc-h3"><a href="#default-settings">Default settings</a></li>
|
||
</ul>
|
||
</li>
|
||
<li class="toc-entry toc-h2"><a href="#no-conflict">No conflict</a></li>
|
||
<li class="toc-entry toc-h2"><a href="#version-numbers">Version numbers</a></li>
|
||
<li class="toc-entry toc-h2"><a href="#no-special-fallbacks-when-javascript-is-disabled">No special fallbacks when JavaScript is disabled</a></li>
|
||
<li class="toc-entry toc-h2"><a href="#util">Util</a></li>
|
||
<li class="toc-entry toc-h2"><a href="#sanitizer">Sanitizer</a></li>
|
||
</ul>
|
||
</nav>
|
||
|
||
|
||
<main class="col-md-9 col-xl-8 py-md-3 pl-md-5 bd-content" role="main">
|
||
<div class="d-md-flex flex-md-row-reverse align-items-center justify-content-between">
|
||
<a class="btn btn-sm btn-bd-light my-2 my-md-0" href="https://github.com/twbs/bootstrap/tree/v4-dev/site/docs/4.5/getting-started/javascript.md" title="View and edit this file on GitHub" target="_blank" rel="noopener">View on GitHub</a>
|
||
<h1 class="bd-title" id="content">JavaScript</h1>
|
||
</div>
|
||
<p class="bd-lead">Bring Bootstrap to life with our optional JavaScript plugins built on jQuery. Learn about each plugin, our data and programmatic API options, and more.</p>
|
||
<script async src="https://cdn.carbonads.com/carbon.js?serve=CKYIKKJL&placement=getbootstrapcom" id="_carbonads_js"></script>
|
||
|
||
<h2 id="individual-or-compiled">Individual or compiled</h2>
|
||
|
||
<p>Plugins can be included individually (using Bootstrap’s individual <code class="language-plaintext highlighter-rouge">js/dist/*.js</code>), or all at once using <code class="language-plaintext highlighter-rouge">bootstrap.js</code> or the minified <code class="language-plaintext highlighter-rouge">bootstrap.min.js</code> (don’t include both).</p>
|
||
|
||
<p>If you use a bundler (Webpack, Rollup…), you can use <code class="language-plaintext highlighter-rouge">/js/dist/*.js</code> files which are UMD ready.</p>
|
||
|
||
<h2 id="dependencies">Dependencies</h2>
|
||
|
||
<p>Some plugins and CSS components depend on other plugins. If you include plugins individually, make sure to check for these dependencies in the docs. Also note that <strong>all plugins depend on jQuery</strong> (this means jQuery must be included <strong>before</strong> the plugin files). <a href="https://github.com/twbs/bootstrap/blob/v4.5.2/package.json">Consult our <code class="language-plaintext highlighter-rouge">package.json</code></a> to see which versions of jQuery are supported.</p>
|
||
|
||
<p>Our dropdowns, popovers and tooltips also depend on <a href="https://popper.js.org/">Popper.js</a>.</p>
|
||
|
||
<h2 id="data-attributes">Data attributes</h2>
|
||
|
||
<p>Nearly all Bootstrap plugins can be enabled and configured through HTML alone with data attributes (our preferred way of using JavaScript functionality). Be sure to <strong>only use one set of data attributes on a single element</strong> (e.g., you cannot trigger a tooltip and modal from the same button.)</p>
|
||
|
||
<p>However, in some situations it may be desirable to disable this functionality. To disable the data attribute API, unbind all events on the document namespaced with <code class="language-plaintext highlighter-rouge">data-api</code> like so:</p>
|
||
|
||
<figure class="highlight"><pre><code class="language-js" data-lang="js"><span class="nx">$</span><span class="p">(</span><span class="nb">document</span><span class="p">).</span><span class="nx">off</span><span class="p">(</span><span class="dl">'</span><span class="s1">.data-api</span><span class="dl">'</span><span class="p">)</span></code></pre></figure>
|
||
|
||
<p>Alternatively, to target a specific plugin, just include the plugin’s name as a namespace along with the data-api namespace like this:</p>
|
||
|
||
<figure class="highlight"><pre><code class="language-js" data-lang="js"><span class="nx">$</span><span class="p">(</span><span class="nb">document</span><span class="p">).</span><span class="nx">off</span><span class="p">(</span><span class="dl">'</span><span class="s1">.alert.data-api</span><span class="dl">'</span><span class="p">)</span></code></pre></figure>
|
||
|
||
<div class="bd-callout bd-callout-warning">
|
||
<h2 id="selectors">Selectors</h2>
|
||
|
||
<p>Currently to query DOM elements we use the native methods <code class="language-plaintext highlighter-rouge">querySelector</code> and <code class="language-plaintext highlighter-rouge">querySelectorAll</code> for performance reasons, so you have to use <a href="https://www.w3.org/TR/CSS21/syndata.html#value-def-identifier">valid selectors</a>.
|
||
If you use special selectors, for example: <code class="language-plaintext highlighter-rouge">collapse:Example</code> be sure to escape them.</p>
|
||
</div>
|
||
|
||
<h2 id="events">Events</h2>
|
||
|
||
<p>Bootstrap provides custom events for most plugins’ unique actions. Generally, these come in an infinitive and past participle form - where the infinitive (ex. <code class="language-plaintext highlighter-rouge">show</code>) is triggered at the start of an event, and its past participle form (ex. <code class="language-plaintext highlighter-rouge">shown</code>) is triggered on the completion of an action.</p>
|
||
|
||
<p>All infinitive events provide <a href="https://developer.mozilla.org/en-US/docs/Web/API/Event/preventDefault"><code class="language-plaintext highlighter-rouge">preventDefault()</code></a> functionality. This provides the ability to stop the execution of an action before it starts. Returning false from an event handler will also automatically call <code class="language-plaintext highlighter-rouge">preventDefault()</code>.</p>
|
||
|
||
<figure class="highlight"><pre><code class="language-js" data-lang="js"><span class="nx">$</span><span class="p">(</span><span class="dl">'</span><span class="s1">#myModal</span><span class="dl">'</span><span class="p">).</span><span class="nx">on</span><span class="p">(</span><span class="dl">'</span><span class="s1">show.bs.modal</span><span class="dl">'</span><span class="p">,</span> <span class="kd">function</span> <span class="p">(</span><span class="nx">e</span><span class="p">)</span> <span class="p">{</span>
|
||
<span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="nx">data</span><span class="p">)</span> <span class="p">{</span>
|
||
<span class="k">return</span> <span class="nx">e</span><span class="p">.</span><span class="nx">preventDefault</span><span class="p">()</span> <span class="c1">// stops modal from being shown</span>
|
||
<span class="p">}</span>
|
||
<span class="p">})</span></code></pre></figure>
|
||
|
||
<h2 id="programmatic-api">Programmatic API</h2>
|
||
|
||
<p>We also believe you should be able to use all Bootstrap plugins purely through the JavaScript API. All public APIs are single, chainable methods, and return the collection acted upon.</p>
|
||
|
||
<figure class="highlight"><pre><code class="language-js" data-lang="js"><span class="nx">$</span><span class="p">(</span><span class="dl">'</span><span class="s1">.btn.danger</span><span class="dl">'</span><span class="p">).</span><span class="nx">button</span><span class="p">(</span><span class="dl">'</span><span class="s1">toggle</span><span class="dl">'</span><span class="p">).</span><span class="nx">addClass</span><span class="p">(</span><span class="dl">'</span><span class="s1">fat</span><span class="dl">'</span><span class="p">)</span></code></pre></figure>
|
||
|
||
<p>All methods should accept an optional options object, a string which targets a particular method, or nothing (which initiates a plugin with default behavior):</p>
|
||
|
||
<figure class="highlight"><pre><code class="language-js" data-lang="js"><span class="nx">$</span><span class="p">(</span><span class="dl">'</span><span class="s1">#myModal</span><span class="dl">'</span><span class="p">).</span><span class="nx">modal</span><span class="p">()</span> <span class="c1">// initialized with defaults</span>
|
||
<span class="nx">$</span><span class="p">(</span><span class="dl">'</span><span class="s1">#myModal</span><span class="dl">'</span><span class="p">).</span><span class="nx">modal</span><span class="p">({</span> <span class="na">keyboard</span><span class="p">:</span> <span class="kc">false</span> <span class="p">})</span> <span class="c1">// initialized with no keyboard</span>
|
||
<span class="nx">$</span><span class="p">(</span><span class="dl">'</span><span class="s1">#myModal</span><span class="dl">'</span><span class="p">).</span><span class="nx">modal</span><span class="p">(</span><span class="dl">'</span><span class="s1">show</span><span class="dl">'</span><span class="p">)</span> <span class="c1">// initializes and invokes show immediately</span></code></pre></figure>
|
||
|
||
<p>Each plugin also exposes its raw constructor on a <code class="language-plaintext highlighter-rouge">Constructor</code> property: <code class="language-plaintext highlighter-rouge">$.fn.popover.Constructor</code>. If you’d like to get a particular plugin instance, retrieve it directly from an element: <code class="language-plaintext highlighter-rouge">$('[rel="popover"]').data('popover')</code>.</p>
|
||
|
||
<h3 id="asynchronous-functions-and-transitions">Asynchronous functions and transitions</h3>
|
||
|
||
<p>All programmatic API methods are <strong>asynchronous</strong> and return to the caller once the transition is started but <strong>before it ends</strong>.</p>
|
||
|
||
<p>In order to execute an action once the transition is complete, you can listen to the corresponding event.</p>
|
||
|
||
<figure class="highlight"><pre><code class="language-js" data-lang="js"><span class="nx">$</span><span class="p">(</span><span class="dl">'</span><span class="s1">#myCollapse</span><span class="dl">'</span><span class="p">).</span><span class="nx">on</span><span class="p">(</span><span class="dl">'</span><span class="s1">shown.bs.collapse</span><span class="dl">'</span><span class="p">,</span> <span class="kd">function</span> <span class="p">(</span><span class="nx">e</span><span class="p">)</span> <span class="p">{</span>
|
||
<span class="c1">// Action to execute once the collapsible area is expanded</span>
|
||
<span class="p">})</span></code></pre></figure>
|
||
|
||
<p>In addition a method call on a <strong>transitioning component will be ignored</strong>.</p>
|
||
|
||
<figure class="highlight"><pre><code class="language-js" data-lang="js"><span class="nx">$</span><span class="p">(</span><span class="dl">'</span><span class="s1">#myCarousel</span><span class="dl">'</span><span class="p">).</span><span class="nx">on</span><span class="p">(</span><span class="dl">'</span><span class="s1">slid.bs.carousel</span><span class="dl">'</span><span class="p">,</span> <span class="kd">function</span> <span class="p">(</span><span class="nx">e</span><span class="p">)</span> <span class="p">{</span>
|
||
<span class="nx">$</span><span class="p">(</span><span class="dl">'</span><span class="s1">#myCarousel</span><span class="dl">'</span><span class="p">).</span><span class="nx">carousel</span><span class="p">(</span><span class="dl">'</span><span class="s1">2</span><span class="dl">'</span><span class="p">)</span> <span class="c1">// Will slide to the slide 2 as soon as the transition to slide 1 is finished</span>
|
||
<span class="p">})</span>
|
||
|
||
<span class="nx">$</span><span class="p">(</span><span class="dl">'</span><span class="s1">#myCarousel</span><span class="dl">'</span><span class="p">).</span><span class="nx">carousel</span><span class="p">(</span><span class="dl">'</span><span class="s1">1</span><span class="dl">'</span><span class="p">)</span> <span class="c1">// Will start sliding to the slide 1 and returns to the caller</span>
|
||
<span class="nx">$</span><span class="p">(</span><span class="dl">'</span><span class="s1">#myCarousel</span><span class="dl">'</span><span class="p">).</span><span class="nx">carousel</span><span class="p">(</span><span class="dl">'</span><span class="s1">2</span><span class="dl">'</span><span class="p">)</span> <span class="c1">// !! Will be ignored, as the transition to the slide 1 is not finished !!</span></code></pre></figure>
|
||
|
||
<h3 id="default-settings">Default settings</h3>
|
||
|
||
<p>You can change the default settings for a plugin by modifying the plugin’s <code class="language-plaintext highlighter-rouge">Constructor.Default</code> object:</p>
|
||
|
||
<figure class="highlight"><pre><code class="language-js" data-lang="js"><span class="c1">// changes default for the modal plugin's `keyboard` option to false</span>
|
||
<span class="nx">$</span><span class="p">.</span><span class="nx">fn</span><span class="p">.</span><span class="nx">modal</span><span class="p">.</span><span class="nx">Constructor</span><span class="p">.</span><span class="nx">Default</span><span class="p">.</span><span class="nx">keyboard</span> <span class="o">=</span> <span class="kc">false</span></code></pre></figure>
|
||
|
||
<h2 id="no-conflict">No conflict</h2>
|
||
|
||
<p>Sometimes it is necessary to use Bootstrap plugins with other UI frameworks. In these circumstances, namespace collisions can occasionally occur. If this happens, you may call <code class="language-plaintext highlighter-rouge">.noConflict</code> on the plugin you wish to revert the value of.</p>
|
||
|
||
<figure class="highlight"><pre><code class="language-js" data-lang="js"><span class="kd">var</span> <span class="nx">bootstrapButton</span> <span class="o">=</span> <span class="nx">$</span><span class="p">.</span><span class="nx">fn</span><span class="p">.</span><span class="nx">button</span><span class="p">.</span><span class="nx">noConflict</span><span class="p">()</span> <span class="c1">// return $.fn.button to previously assigned value</span>
|
||
<span class="nx">$</span><span class="p">.</span><span class="nx">fn</span><span class="p">.</span><span class="nx">bootstrapBtn</span> <span class="o">=</span> <span class="nx">bootstrapButton</span> <span class="c1">// give $().bootstrapBtn the Bootstrap functionality</span></code></pre></figure>
|
||
|
||
<h2 id="version-numbers">Version numbers</h2>
|
||
|
||
<p>The version of each of Bootstrap’s jQuery plugins can be accessed via the <code class="language-plaintext highlighter-rouge">VERSION</code> property of the plugin’s constructor. For example, for the tooltip plugin:</p>
|
||
|
||
<figure class="highlight"><pre><code class="language-js" data-lang="js"><span class="nx">$</span><span class="p">.</span><span class="nx">fn</span><span class="p">.</span><span class="nx">tooltip</span><span class="p">.</span><span class="nx">Constructor</span><span class="p">.</span><span class="nx">VERSION</span> <span class="c1">// => "4.5.2"</span></code></pre></figure>
|
||
|
||
<h2 id="no-special-fallbacks-when-javascript-is-disabled">No special fallbacks when JavaScript is disabled</h2>
|
||
|
||
<p>Bootstrap’s plugins don’t fall back particularly gracefully when JavaScript is disabled. If you care about the user experience in this case, use <a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/noscript"><code class="language-plaintext highlighter-rouge"><noscript></code></a> to explain the situation (and how to re-enable JavaScript) to your users, and/or add your own custom fallbacks.</p>
|
||
|
||
<div class="bd-callout bd-callout-warning">
|
||
<h5 id="third-party-libraries">Third-party libraries</h5>
|
||
|
||
<p><strong>Bootstrap does not officially support third-party JavaScript libraries</strong> like Prototype or jQuery UI. Despite <code class="language-plaintext highlighter-rouge">.noConflict</code> and namespaced events, there may be compatibility problems that you need to fix on your own.</p>
|
||
</div>
|
||
|
||
<h2 id="util">Util</h2>
|
||
|
||
<p>All Bootstrap’s JavaScript files depend on <code class="language-plaintext highlighter-rouge">util.js</code> and it has to be included alongside the other JavaScript files. If you’re using the compiled (or minified) <code class="language-plaintext highlighter-rouge">bootstrap.js</code>, there is no need to include this—it’s already there.</p>
|
||
|
||
<p><code class="language-plaintext highlighter-rouge">util.js</code> includes utility functions and a basic helper for <code class="language-plaintext highlighter-rouge">transitionEnd</code> events as well as a CSS transition emulator. It’s used by the other plugins to check for CSS transition support and to catch hanging transitions.</p>
|
||
|
||
<h2 id="sanitizer">Sanitizer</h2>
|
||
|
||
<p>Tooltips and Popovers use our built-in sanitizer to sanitize options which accept HTML.</p>
|
||
|
||
<p>The default <code class="language-plaintext highlighter-rouge">whiteList</code> value is the following:</p>
|
||
|
||
<figure class="highlight"><pre><code class="language-js" data-lang="js"><span class="kd">var</span> <span class="nx">ARIA_ATTRIBUTE_PATTERN</span> <span class="o">=</span> <span class="sr">/^aria-</span><span class="se">[\w</span><span class="sr">-</span><span class="se">]</span><span class="sr">*$/i</span>
|
||
<span class="kd">var</span> <span class="nx">DefaultWhitelist</span> <span class="o">=</span> <span class="p">{</span>
|
||
<span class="c1">// Global attributes allowed on any supplied element below.</span>
|
||
<span class="dl">'</span><span class="s1">*</span><span class="dl">'</span><span class="p">:</span> <span class="p">[</span><span class="dl">'</span><span class="s1">class</span><span class="dl">'</span><span class="p">,</span> <span class="dl">'</span><span class="s1">dir</span><span class="dl">'</span><span class="p">,</span> <span class="dl">'</span><span class="s1">id</span><span class="dl">'</span><span class="p">,</span> <span class="dl">'</span><span class="s1">lang</span><span class="dl">'</span><span class="p">,</span> <span class="dl">'</span><span class="s1">role</span><span class="dl">'</span><span class="p">,</span> <span class="nx">ARIA_ATTRIBUTE_PATTERN</span><span class="p">],</span>
|
||
<span class="na">a</span><span class="p">:</span> <span class="p">[</span><span class="dl">'</span><span class="s1">target</span><span class="dl">'</span><span class="p">,</span> <span class="dl">'</span><span class="s1">href</span><span class="dl">'</span><span class="p">,</span> <span class="dl">'</span><span class="s1">title</span><span class="dl">'</span><span class="p">,</span> <span class="dl">'</span><span class="s1">rel</span><span class="dl">'</span><span class="p">],</span>
|
||
<span class="na">area</span><span class="p">:</span> <span class="p">[],</span>
|
||
<span class="na">b</span><span class="p">:</span> <span class="p">[],</span>
|
||
<span class="na">br</span><span class="p">:</span> <span class="p">[],</span>
|
||
<span class="na">col</span><span class="p">:</span> <span class="p">[],</span>
|
||
<span class="na">code</span><span class="p">:</span> <span class="p">[],</span>
|
||
<span class="na">div</span><span class="p">:</span> <span class="p">[],</span>
|
||
<span class="na">em</span><span class="p">:</span> <span class="p">[],</span>
|
||
<span class="na">hr</span><span class="p">:</span> <span class="p">[],</span>
|
||
<span class="na">h1</span><span class="p">:</span> <span class="p">[],</span>
|
||
<span class="na">h2</span><span class="p">:</span> <span class="p">[],</span>
|
||
<span class="na">h3</span><span class="p">:</span> <span class="p">[],</span>
|
||
<span class="na">h4</span><span class="p">:</span> <span class="p">[],</span>
|
||
<span class="na">h5</span><span class="p">:</span> <span class="p">[],</span>
|
||
<span class="na">h6</span><span class="p">:</span> <span class="p">[],</span>
|
||
<span class="na">i</span><span class="p">:</span> <span class="p">[],</span>
|
||
<span class="na">img</span><span class="p">:</span> <span class="p">[</span><span class="dl">'</span><span class="s1">src</span><span class="dl">'</span><span class="p">,</span> <span class="dl">'</span><span class="s1">srcset</span><span class="dl">'</span><span class="p">,</span> <span class="dl">'</span><span class="s1">alt</span><span class="dl">'</span><span class="p">,</span> <span class="dl">'</span><span class="s1">title</span><span class="dl">'</span><span class="p">,</span> <span class="dl">'</span><span class="s1">width</span><span class="dl">'</span><span class="p">,</span> <span class="dl">'</span><span class="s1">height</span><span class="dl">'</span><span class="p">],</span>
|
||
<span class="na">li</span><span class="p">:</span> <span class="p">[],</span>
|
||
<span class="na">ol</span><span class="p">:</span> <span class="p">[],</span>
|
||
<span class="na">p</span><span class="p">:</span> <span class="p">[],</span>
|
||
<span class="na">pre</span><span class="p">:</span> <span class="p">[],</span>
|
||
<span class="na">s</span><span class="p">:</span> <span class="p">[],</span>
|
||
<span class="na">small</span><span class="p">:</span> <span class="p">[],</span>
|
||
<span class="na">span</span><span class="p">:</span> <span class="p">[],</span>
|
||
<span class="na">sub</span><span class="p">:</span> <span class="p">[],</span>
|
||
<span class="na">sup</span><span class="p">:</span> <span class="p">[],</span>
|
||
<span class="na">strong</span><span class="p">:</span> <span class="p">[],</span>
|
||
<span class="na">u</span><span class="p">:</span> <span class="p">[],</span>
|
||
<span class="na">ul</span><span class="p">:</span> <span class="p">[]</span>
|
||
<span class="p">}</span></code></pre></figure>
|
||
|
||
<p>If you want to add new values to this default <code class="language-plaintext highlighter-rouge">whiteList</code> you can do the following:</p>
|
||
|
||
<figure class="highlight"><pre><code class="language-js" data-lang="js"><span class="kd">var</span> <span class="nx">myDefaultWhiteList</span> <span class="o">=</span> <span class="nx">$</span><span class="p">.</span><span class="nx">fn</span><span class="p">.</span><span class="nx">tooltip</span><span class="p">.</span><span class="nx">Constructor</span><span class="p">.</span><span class="nx">Default</span><span class="p">.</span><span class="nx">whiteList</span>
|
||
|
||
<span class="c1">// To allow table elements</span>
|
||
<span class="nx">myDefaultWhiteList</span><span class="p">.</span><span class="nx">table</span> <span class="o">=</span> <span class="p">[]</span>
|
||
|
||
<span class="c1">// To allow td elements and data-option attributes on td elements</span>
|
||
<span class="nx">myDefaultWhiteList</span><span class="p">.</span><span class="nx">td</span> <span class="o">=</span> <span class="p">[</span><span class="dl">'</span><span class="s1">data-option</span><span class="dl">'</span><span class="p">]</span>
|
||
|
||
<span class="c1">// You can push your custom regex to validate your attributes.</span>
|
||
<span class="c1">// Be careful about your regular expressions being too lax</span>
|
||
<span class="kd">var</span> <span class="nx">myCustomRegex</span> <span class="o">=</span> <span class="sr">/^data-my-app-</span><span class="se">[\w</span><span class="sr">-</span><span class="se">]</span><span class="sr">+/</span>
|
||
<span class="nx">myDefaultWhiteList</span><span class="p">[</span><span class="dl">'</span><span class="s1">*</span><span class="dl">'</span><span class="p">].</span><span class="nx">push</span><span class="p">(</span><span class="nx">myCustomRegex</span><span class="p">)</span></code></pre></figure>
|
||
|
||
<p>If you want to bypass our sanitizer because you prefer to use a dedicated library, for example <a href="https://www.npmjs.com/package/dompurify">DOMPurify</a>, you should do the following:</p>
|
||
|
||
<figure class="highlight"><pre><code class="language-js" data-lang="js"><span class="nx">$</span><span class="p">(</span><span class="dl">'</span><span class="s1">#yourTooltip</span><span class="dl">'</span><span class="p">).</span><span class="nx">tooltip</span><span class="p">({</span>
|
||
<span class="na">sanitizeFn</span><span class="p">:</span> <span class="kd">function</span> <span class="p">(</span><span class="nx">content</span><span class="p">)</span> <span class="p">{</span>
|
||
<span class="k">return</span> <span class="nx">DOMPurify</span><span class="p">.</span><span class="nx">sanitize</span><span class="p">(</span><span class="nx">content</span><span class="p">)</span>
|
||
<span class="p">}</span>
|
||
<span class="p">})</span></code></pre></figure>
|
||
|
||
|
||
</main>
|
||
</div>
|
||
</div>
|
||
|
||
<script src="https://code.jquery.com/jquery-3.5.1.slim.min.js" integrity="sha384-DfXdz2htPH0lsSSs5nCTpuj/zy4C+OGpamoFVy38MVBnE+IbbVYUew+OrCXaRkfj" crossorigin="anonymous"></script>
|
||
<script>window.jQuery || document.write('<script src="/docs/4.5/assets/js/vendor/jquery.slim.min.js"><\/script>')</script><script src="/docs/4.5/dist/js/bootstrap.bundle.min.js" integrity="sha384-LtrjvnR4Twt/qOuYxE721u19sVFLVSA4hf/rRt6PrZTmiPltdZcI7q7PXQBYTKyf" crossorigin="anonymous"></script><script src="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.js"></script><script src="/docs/4.5/assets/js/docs.min.js"></script>
|
||
</body>
|
||
</html>
|