index.html 27 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745
  1. <!doctype html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="utf-8">
  5. <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
  6. <meta name="description" content="Table Cookie extension of Bootstrap Table.">
  7. <meta name="author" content="Zhixin Wen, and Bootstrap Table contributors">
  8. <meta name="generator" content="Jekyll v3.8.7">
  9. <meta name="keywords" content="bootstrap,table,pagination,checkbox,radio,datatables,css,css-framework,semantic,semantic-ui,bulma,material,material-design,materialize,foundation">
  10. <meta name="docsearch:language" content="en">
  11. <title>Table Cookie · Bootstrap Table</title>
  12. <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.6.2/dist/css/bootstrap.min.css"><!-- Documentation extras -->
  13. <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css">
  14. <link rel="stylesheet" href="/assets/css/docs.min.css">
  15. <link rel="stylesheet" href="/assets/css/style.css?m=9">
  16. <!-- Favicons -->
  17. <link rel="icon" href="/favicon.png">
  18. <script type="text/javascript">
  19. if (window !== top) // 判断当前的 window 对象是否是 top 对象
  20. top.location.href = window.location.href // 如果不是,将 top 对象的网址自动导向被嵌入网页的网址
  21. </script>
  22. </head>
  23. <body>
  24. <a class="skippy sr-only sr-only-focusable" href="#content">
  25. <span class="skippy-text">Skip to main content</span>
  26. </a>
  27. <header class="navbar navbar-expand navbar-dark flex-column flex-md-row bd-navbar">
  28. <a class="navbar-brand mr-0 mr-md-2" href="/" aria-label="Bootstrap">
  29. <img src="/favicon.png" width="36" height="36">
  30. </a>
  31. <div class="navbar-nav-scroll">
  32. <ul class="navbar-nav bd-navbar-nav flex-row">
  33. <li class="nav-item">
  34. <a class="nav-link "
  35. href="/">Home</a>
  36. </li>
  37. <li class="nav-item">
  38. <a class="nav-link active"
  39. href="/docs/getting-started/introduction/">
  40. Documentation
  41. </a>
  42. </li>
  43. <li class="nav-item ">
  44. <a class="nav-link" href="/themes">
  45. Themes
  46. </a>
  47. </li>
  48. <li class="nav-item">
  49. <a class="nav-link "
  50. href="https://examples.bootstrap-table.com">
  51. Examples
  52. </a>
  53. </li>
  54. <li class="nav-item">
  55. <a class="nav-link"
  56. href="https://live.bootstrap-table.com"
  57. target="_blank">
  58. Online Editor
  59. </a>
  60. </li>
  61. <li class="nav-item ">
  62. <a class="nav-link" href="/news">
  63. News
  64. </a>
  65. </li>
  66. <li class="nav-item">
  67. <a class="nav-link"
  68. href="https://blog.bootstrap-table.com"
  69. target="_blank">
  70. Blog
  71. </a>
  72. </li>
  73. </ul>
  74. </div>
  75. <ul class="navbar-nav flex-row ml-md-auto d-none d-md-flex">
  76. <li class="nav-item dropdown">
  77. <a class="nav-item nav-link dropdown-toggle mr-md-2" href="#" id="bd-versions" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
  78. v1.23.5
  79. </a>
  80. <div class="dropdown-menu dropdown-menu-md-right" aria-labelledby="bd-versions">
  81. <a class="dropdown-item active" href="/">Latest (1.23.5)</a>
  82. <a class="dropdown-item" href="http://bootstrap-table.com/versions/1.21.4/" target="_blank">v1.21.4</a>
  83. <a class="dropdown-item" href="http://bootstrap-table.com/versions/1.20.2/" target="_blank">v1.20.2</a>
  84. <a class="dropdown-item" href="http://bootstrap-table.com/versions/1.19.1/" target="_blank">v1.19.1</a>
  85. <a class="dropdown-item" href="http://bootstrap-table.com/versions/1.18.3/" target="_blank">v1.18.3</a>
  86. <a class="dropdown-item" href="http://bootstrap-table.com/versions/1.17.1/" target="_blank">v1.17.1</a>
  87. <a class="dropdown-item" href="http://bootstrap-table.com/versions/1.16.0/" target="_blank">v1.16.0</a>
  88. <a class="dropdown-item" href="http://bootstrap-table.com/versions/1.15.5/" target="_blank">v1.15.5</a>
  89. </div>
  90. </li>
  91. <li class="nav-item">
  92. <a class="nav-link p-2" href="https://github.com/wenzhixin/bootstrap-table" target="_blank" rel="noopener" aria-label="GitHub"><svg class="navbar-nav-svg" xmlns="http://www.w3.org/2000/svg" viewbox="0 0 512 499.36" focusable="false" role="img"><path 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" fill="currentColor" fill-rule="evenodd"/></svg>
  93. </a>
  94. </li>
  95. <li class="nav-item">
  96. <a class="nav-link p-2" href="https://twitter.com/wenzhixin2010" target="_blank" rel="noopener" aria-label="Twitter"><svg class="navbar-nav-svg" xmlns="http://www.w3.org/2000/svg" viewbox="0 0 512 416.32" focusable="false" role="img"><path 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" fill="currentColor"/></svg>
  97. </a>
  98. </li>
  99. <li class="nav-item">
  100. <a class="nav-link p-2" href="https://opencollective.com/bootstrap-table" target="_blank" rel="noopener" aria-label="Open Collective"><svg class="navbar-nav-svg" xmlns="http://www.w3.org/2000/svg" viewbox="0 0 40 41" focusable="false" role="img" fill="currentColor" fill-rule="evenodd"><title>Open Collective</title><path 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" fill-opacity=".4"/><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>
  101. </a>
  102. </li>
  103. </ul>
  104. <a class="btn btn-bd-download d-none d-lg-inline-block mb-3 mb-md-0 ml-md-3"
  105. href="/docs/getting-started/download/">Download</a>
  106. </header>
  107. <div class="container-fluid">
  108. <div class="row flex-xl-nowrap">
  109. <div class="col-12 col-md-3 col-xl-2 bd-sidebar">
  110. <form class="bd-search d-flex align-items-center">
  111. <input type="search" class="form-control"
  112. id="search-input" placeholder="Search..."
  113. aria-label="Search for..." autocomplete="off">
  114. <button class="btn btn-link bd-search-docs-toggle d-md-none p-0 ml-3"
  115. type="button" data-toggle="collapse" data-target="#bd-docs-nav"
  116. aria-controls="bd-docs-nav" aria-expanded="false"
  117. aria-label="Toggle docs navigation"><svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 30 30" width="30" height="30" focusable="false" role="img"><title>Menu</title><path stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-miterlimit="10" d="M4 7h22M4 15h22M4 23h22"/></svg>
  118. </button>
  119. </form>
  120. <nav class="collapse bd-links" id="bd-docs-nav"><div class="bd-toc-item">
  121. <a class="bd-toc-link" href="/docs/getting-started/introduction/">
  122. Getting started
  123. </a>
  124. <ul class="nav bd-sidenav"><li>
  125. <a href="/docs/getting-started/introduction/">
  126. Introduction
  127. </a>
  128. </li><li>
  129. <a href="/docs/getting-started/download/">
  130. Download
  131. </a>
  132. </li><li>
  133. <a href="/docs/getting-started/contents/">
  134. Contents
  135. </a>
  136. </li><li>
  137. <a href="/docs/getting-started/usage/">
  138. Usage
  139. </a>
  140. </li><li>
  141. <a href="/docs/getting-started/browsers-devices/">
  142. Browsers & devices
  143. </a>
  144. </li><li>
  145. <a href="/docs/getting-started/build-tools/">
  146. Build tools
  147. </a>
  148. </li></ul>
  149. </div><div class="bd-toc-item">
  150. <a class="bd-toc-link" href="/docs/api/table-options/">
  151. API
  152. </a>
  153. <ul class="nav bd-sidenav"><li>
  154. <a href="/docs/api/table-options/">
  155. Table Options
  156. </a>
  157. </li><li>
  158. <a href="/docs/api/column-options/">
  159. Column Options
  160. </a>
  161. </li><li>
  162. <a href="/docs/api/events/">
  163. Events
  164. </a>
  165. </li><li>
  166. <a href="/docs/api/methods/">
  167. Methods
  168. </a>
  169. </li><li>
  170. <a href="/docs/api/localizations/">
  171. Localizations
  172. </a>
  173. </li></ul>
  174. </div><div class="bd-toc-item active">
  175. <a class="bd-toc-link" href="/docs/extensions/addrbar/">
  176. Extensions
  177. </a>
  178. <ul class="nav bd-sidenav"><li>
  179. <a href="/docs/extensions/addrbar/">
  180. Addrbar
  181. </a>
  182. </li><li>
  183. <a href="/docs/extensions/auto-refresh/">
  184. Auto Refresh
  185. </a>
  186. </li><li class="active bd-sidenav-active">
  187. <a href="/docs/extensions/cookie/">
  188. Cookie
  189. </a>
  190. </li><li>
  191. <a href="/docs/extensions/copy-rows/">
  192. Copy Rows
  193. </a>
  194. </li><li>
  195. <a href="/docs/extensions/custom-view/">
  196. Custom View
  197. </a>
  198. </li><li>
  199. <a href="/docs/extensions/defer-url/">
  200. Defer URL
  201. </a>
  202. </li><li>
  203. <a href="/docs/extensions/editable/">
  204. Editable
  205. </a>
  206. </li><li>
  207. <a href="/docs/extensions/export/">
  208. Export
  209. </a>
  210. </li><li>
  211. <a href="/docs/extensions/filter-control/">
  212. Filter Control
  213. </a>
  214. </li><li>
  215. <a href="/docs/extensions/fixed-columns/">
  216. Fixed Columns
  217. </a>
  218. </li><li>
  219. <a href="/docs/extensions/group-by-v2/">
  220. Group By v2
  221. </a>
  222. </li><li>
  223. <a href="/docs/extensions/i18n-enhance/">
  224. i18n Enhance
  225. </a>
  226. </li><li>
  227. <a href="/docs/extensions/key-events/">
  228. Key Events
  229. </a>
  230. </li><li>
  231. <a href="/docs/extensions/mobile/">
  232. Mobile
  233. </a>
  234. </li><li>
  235. <a href="/docs/extensions/multiple-sort/">
  236. Multiple Sort
  237. </a>
  238. </li><li>
  239. <a href="/docs/extensions/page-jump-to/">
  240. Page Jump To
  241. </a>
  242. </li><li>
  243. <a href="/docs/extensions/pipeline/">
  244. Pipeline
  245. </a>
  246. </li><li>
  247. <a href="/docs/extensions/print/">
  248. Print
  249. </a>
  250. </li><li>
  251. <a href="/docs/extensions/reorder-columns/">
  252. Reorder Columns
  253. </a>
  254. </li><li>
  255. <a href="/docs/extensions/reorder-rows/">
  256. Reorder Rows
  257. </a>
  258. </li><li>
  259. <a href="/docs/extensions/resizable/">
  260. Resizable
  261. </a>
  262. </li><li>
  263. <a href="/docs/extensions/sticky-header/">
  264. Sticky Header
  265. </a>
  266. </li><li>
  267. <a href="/docs/extensions/toolbar/">
  268. Toolbar
  269. </a>
  270. </li><li>
  271. <a href="/docs/extensions/treegrid/">
  272. Treegrid
  273. </a>
  274. </li></ul>
  275. </div><div class="bd-toc-item">
  276. <a class="bd-toc-link" href="/docs/vuejs/introduction/">
  277. VueJS
  278. </a>
  279. <ul class="nav bd-sidenav"><li>
  280. <a href="/docs/vuejs/introduction/">
  281. Introduction
  282. </a>
  283. </li><li>
  284. <a href="/docs/vuejs/browser/">
  285. Browser
  286. </a>
  287. </li><li>
  288. <a href="/docs/vuejs/webpack/">
  289. Webpack
  290. </a>
  291. </li><li>
  292. <a href="/docs/vuejs/component/">
  293. Component
  294. </a>
  295. </li></ul>
  296. </div><div class="bd-toc-item">
  297. <a class="bd-toc-link" href="/docs/online-editor/">
  298. Online Editor
  299. </a>
  300. <ul class="nav bd-sidenav"></ul>
  301. </div><div class="bd-toc-item">
  302. <a class="bd-toc-link" href="/docs/faq/">
  303. FAQ
  304. </a>
  305. <ul class="nav bd-sidenav"></ul>
  306. </div><div class="bd-toc-item">
  307. <a class="bd-toc-link" href="/docs/about/overview/">
  308. About
  309. </a>
  310. <ul class="nav bd-sidenav"><li>
  311. <a href="/docs/about/overview/">
  312. Overview
  313. </a>
  314. </li><li>
  315. <a href="/docs/about/team/">
  316. Team
  317. </a>
  318. </li><li>
  319. <a href="/docs/about/license/">
  320. License
  321. </a>
  322. </li><li>
  323. <a href="/docs/about/translations/">
  324. Translations
  325. </a>
  326. </li></ul>
  327. </div></nav>
  328. </div>
  329. <div class="d-none d-xl-block col-xl-2 bd-toc">
  330. <ul class="section-nav">
  331. <li class="toc-entry toc-h2"><a href="#usage">Usage</a></li>
  332. <li class="toc-entry toc-h2"><a href="#example">Example</a></li>
  333. <li class="toc-entry toc-h2"><a href="#options">Options</a>
  334. <ul>
  335. <li class="toc-entry toc-h3"><a href="#cookie">cookie</a></li>
  336. <li class="toc-entry toc-h3"><a href="#cookiecustomstoragedelete">cookieCustomStorageDelete</a></li>
  337. <li class="toc-entry toc-h3"><a href="#cookiecustomstorageget">cookieCustomStorageGet</a></li>
  338. <li class="toc-entry toc-h3"><a href="#cookiecustomstorageset">cookieCustomStorageSet</a></li>
  339. <li class="toc-entry toc-h3"><a href="#cookiedomain">cookieDomain</a></li>
  340. <li class="toc-entry toc-h3"><a href="#cookieexpire">cookieExpire</a></li>
  341. <li class="toc-entry toc-h3"><a href="#cookieidtable">cookieIdTable</a></li>
  342. <li class="toc-entry toc-h3"><a href="#cookiepath">cookiePath</a></li>
  343. <li class="toc-entry toc-h3"><a href="#cookiesecure">cookieSecure</a></li>
  344. <li class="toc-entry toc-h3"><a href="#cookiesamesite">cookieSameSite</a></li>
  345. <li class="toc-entry toc-h3"><a href="#cookiestorage">cookieStorage</a></li>
  346. <li class="toc-entry toc-h3"><a href="#cookiesenabled">cookiesEnabled</a></li>
  347. </ul>
  348. </li>
  349. <li class="toc-entry toc-h2"><a href="#methods">Methods</a>
  350. <ul>
  351. <li class="toc-entry toc-h3"><a href="#deletecookie">deleteCookie</a></li>
  352. <li class="toc-entry toc-h3"><a href="#getcookies">getCookies</a></li>
  353. </ul>
  354. </li>
  355. <li class="toc-entry toc-h2"><a href="#this-plugin-saves">This plugin saves</a></li>
  356. </ul>
  357. </div>
  358. <main class="col-12 col-md-9 col-xl-8 py-md-3 pl-md-5 bd-content extensions" role="main">
  359. <div class="d-md-flex flex-md-row-reverse align-items-center justify-content-between">
  360. <a class="btn btn-sm btn-bd-light mb-2 mb-md-0"
  361. href="https://github.com/wenzhixin/bootstrap-table/blob/develop/site/docs/extensions/cookie.md"
  362. title="View and edit this file on GitHub" target="_blank" rel="noopener">
  363. View on GitHub
  364. </a>
  365. <h1 class="bd-title" id="content">
  366. Table Cookie
  367. </h1>
  368. </div>
  369. <p class="bd-lead">Table Cookie extension of Bootstrap Table.</p>
  370. <div id="gg"></div>
  371. <h2 id="usage">Usage</h2>
  372. <figure class="highlight"><pre><code class="language-html" data-lang="html"><span class="nt">&lt;script </span><span class="na">src=</span><span class="s">"extensions/cookie/bootstrap-table-cookie.js"</span><span class="nt">&gt;&lt;/script&gt;</span></code></pre></figure>
  373. <h2 id="example">Example</h2>
  374. <p><a href="https://examples.bootstrap-table.com/#extensions/cookie.html">Cookie</a></p>
  375. <h2 id="options">Options</h2>
  376. <h3 id="cookie">cookie</h3>
  377. <ul>
  378. <li>
  379. <p><strong>Attribute:</strong> <code class="highlighter-rouge">data-cookie</code></p>
  380. </li>
  381. <li>
  382. <p><strong>type:</strong> <code class="highlighter-rouge">Boolean</code></p>
  383. </li>
  384. <li>
  385. <p><strong>Detail:</strong></p>
  386. <p>Set <code class="highlighter-rouge">true</code> to save the state of a table (its paging position, ordering state, and records per page).</p>
  387. </li>
  388. <li>
  389. <p><strong>Default:</strong> <code class="highlighter-rouge">false</code></p>
  390. </li>
  391. </ul>
  392. <h3 id="cookiecustomstoragedelete">cookieCustomStorageDelete</h3>
  393. <ul>
  394. <li>
  395. <p><strong>Attribute:</strong> <code class="highlighter-rouge">data-cookie-custom-storage-delete</code></p>
  396. </li>
  397. <li>
  398. <p><strong>type:</strong> <code class="highlighter-rouge">function</code></p>
  399. </li>
  400. <li>
  401. <p><strong>parameter</strong></p>
  402. <ul>
  403. <li><code class="highlighter-rouge">cookieName</code> - The name of the value e.g. the search</li>
  404. </ul>
  405. </li>
  406. <li>
  407. <p><strong>Detail:</strong></p>
  408. <p>This option allows deleting values with your custom function.
  409. This option is only required if you use <code class="highlighter-rouge">customStorage</code> on the <code class="highlighter-rouge">cookieStorage</code> option!</p>
  410. </li>
  411. <li>
  412. <p><strong>Default:</strong> <code class="highlighter-rouge">undefined</code></p>
  413. </li>
  414. </ul>
  415. <h3 id="cookiecustomstorageget">cookieCustomStorageGet</h3>
  416. <ul>
  417. <li>
  418. <p><strong>Attribute:</strong> <code class="highlighter-rouge">data-cookie-custom-storage-get</code></p>
  419. </li>
  420. <li>
  421. <p><strong>type:</strong> <code class="highlighter-rouge">function</code></p>
  422. </li>
  423. <li>
  424. <p><strong>parameter</strong></p>
  425. <ul>
  426. <li><code class="highlighter-rouge">cookieName</code> - The name of the value e.g. the search</li>
  427. </ul>
  428. </li>
  429. <li>
  430. <p><strong>Detail:</strong></p>
  431. <p>This option allows getting the saved value from your custom function.
  432. This option is only required if you use <code class="highlighter-rouge">customStorage</code> on the <code class="highlighter-rouge">cookieStorage</code> option!</p>
  433. </li>
  434. <li>
  435. <p><strong>Default:</strong> <code class="highlighter-rouge">undefined</code></p>
  436. </li>
  437. </ul>
  438. <h3 id="cookiecustomstorageset">cookieCustomStorageSet</h3>
  439. <ul>
  440. <li>
  441. <p><strong>Attribute:</strong> <code class="highlighter-rouge">data-cookie-custom-storage-set</code></p>
  442. </li>
  443. <li>
  444. <p><strong>type:</strong> <code class="highlighter-rouge">function</code></p>
  445. </li>
  446. <li>
  447. <p><strong>parameter</strong></p>
  448. <ul>
  449. <li><code class="highlighter-rouge">cookieName</code> - The name of the value e.g. the search</li>
  450. <li><code class="highlighter-rouge">value</code> - The value that will be saved</li>
  451. </ul>
  452. </li>
  453. <li>
  454. <p><strong>Detail:</strong></p>
  455. <p>This option allows saving values with your custom function.
  456. This option is only required if you use <code class="highlighter-rouge">customStorage</code> on the <code class="highlighter-rouge">cookieStorage</code> option!</p>
  457. </li>
  458. <li>
  459. <p><strong>Default:</strong> <code class="highlighter-rouge">undefined</code></p>
  460. </li>
  461. </ul>
  462. <h3 id="cookiedomain">cookieDomain</h3>
  463. <ul>
  464. <li>
  465. <p><strong>Attribute:</strong> <code class="highlighter-rouge">data-cookie-domain</code></p>
  466. </li>
  467. <li>
  468. <p><strong>type:</strong> <code class="highlighter-rouge">String</code></p>
  469. </li>
  470. <li>
  471. <p><strong>Detail:</strong></p>
  472. <p>This is the website domain, with the www. prefix removed.</p>
  473. </li>
  474. <li>
  475. <p><strong>Default:</strong> <code class="highlighter-rouge">null</code></p>
  476. </li>
  477. </ul>
  478. <h3 id="cookieexpire">cookieExpire</h3>
  479. <ul>
  480. <li>
  481. <p><strong>Attribute:</strong> <code class="highlighter-rouge">data-cookie-expire</code></p>
  482. </li>
  483. <li>
  484. <p><strong>type:</strong> <code class="highlighter-rouge">String</code></p>
  485. </li>
  486. <li>
  487. <p><strong>Detail:</strong></p>
  488. <p>You must set this property if the cookie option is enabled to know when will expire the cookie. Must use this format: <code class="highlighter-rouge">'number{letter}'</code> like <code class="highlighter-rouge">'2h'</code>, in the letter position you can use: <code class="highlighter-rouge">'s'</code>, <code class="highlighter-rouge">'mi'</code>, <code class="highlighter-rouge">'h'</code>, <code class="highlighter-rouge">'d'</code>, <code class="highlighter-rouge">'m'</code>, <code class="highlighter-rouge">'y'</code>, these means: <code class="highlighter-rouge">'seconds'</code>, <code class="highlighter-rouge">'minutes'</code>, <code class="highlighter-rouge">'hours'</code>, <code class="highlighter-rouge">'days'</code>, <code class="highlighter-rouge">'months'</code>, <code class="highlighter-rouge">'years'</code>.</p>
  489. </li>
  490. <li>
  491. <p><strong>Default:</strong> <code class="highlighter-rouge">2h</code></p>
  492. </li>
  493. </ul>
  494. <h3 id="cookieidtable">cookieIdTable</h3>
  495. <ul>
  496. <li>
  497. <p><strong>Attribute:</strong> <code class="highlighter-rouge">data-cookie-id-table</code></p>
  498. </li>
  499. <li>
  500. <p><strong>type:</strong> <code class="highlighter-rouge">String</code></p>
  501. </li>
  502. <li>
  503. <p><strong>Detail:</strong></p>
  504. <p>You must set this property if the cookie property is enabled to set a unique cookie with an identifier for each table in your page or project. You must set this property because we need to create cookies with an identifier.</p>
  505. </li>
  506. <li>
  507. <p><strong>Default:</strong> <code class="highlighter-rouge">''</code></p>
  508. </li>
  509. </ul>
  510. <h3 id="cookiepath">cookiePath</h3>
  511. <ul>
  512. <li>
  513. <p><strong>Attribute:</strong> <code class="highlighter-rouge">data-cookie-path</code></p>
  514. </li>
  515. <li>
  516. <p><strong>type:</strong> <code class="highlighter-rouge">String</code></p>
  517. </li>
  518. <li>
  519. <p><strong>Detail:</strong></p>
  520. <p>you can tell the browser what path the cookie belongs to. By default, the cookie belongs to the current page.</p>
  521. </li>
  522. <li>
  523. <p><strong>Default:</strong> <code class="highlighter-rouge">null</code></p>
  524. </li>
  525. </ul>
  526. <h3 id="cookiesecure">cookieSecure</h3>
  527. <ul>
  528. <li>
  529. <p><strong>Attribute:</strong> <code class="highlighter-rouge">data-cookie-secure</code></p>
  530. </li>
  531. <li>
  532. <p><strong>type:</strong> <code class="highlighter-rouge">Boolean</code></p>
  533. </li>
  534. <li>
  535. <p><strong>Detail:</strong></p>
  536. <p>This property keeps cookie communication limited to encrypted transmission, directing browsers to use cookies only via secure/encrypted connections.</p>
  537. </li>
  538. <li>
  539. <p><strong>Default:</strong> <code class="highlighter-rouge">null</code></p>
  540. </li>
  541. </ul>
  542. <h3 id="cookiesamesite">cookieSameSite</h3>
  543. <ul>
  544. <li>
  545. <p><strong>Attribute:</strong> <code class="highlighter-rouge">data-cookie-same-site</code></p>
  546. </li>
  547. <li>
  548. <p><strong>type:</strong> <code class="highlighter-rouge">string</code></p>
  549. </li>
  550. <li>
  551. <p><strong>Detail:</strong></p>
  552. <p>This property defines the value of the <code class="highlighter-rouge">SameSite</code> cookie attribute, for more information please check the <a href="https://developer.mozilla.org/de/docs/Web/HTTP/Headers/Set-Cookie/SameSite">SameSite Documentation</a>.</p>
  553. </li>
  554. <li>
  555. <p><strong>Default:</strong> <code class="highlighter-rouge">Lax</code></p>
  556. </li>
  557. </ul>
  558. <h3 id="cookiestorage">cookieStorage</h3>
  559. <ul>
  560. <li>
  561. <p><strong>Attribute:</strong> <code class="highlighter-rouge">data-cookie-storage</code></p>
  562. </li>
  563. <li>
  564. <p><strong>type:</strong> <code class="highlighter-rouge">String</code></p>
  565. </li>
  566. <li>
  567. <p><strong>Detail:</strong></p>
  568. <p>Set the storage that this extension will use. Use <code class="highlighter-rouge">cookieStorage</code>, <code class="highlighter-rouge">localStorage</code>, <code class="highlighter-rouge">sessionStorage</code>, or <code class="highlighter-rouge">customStorage</code>.</p>
  569. <p>Info for <code class="highlighter-rouge">customStorage</code>:
  570. You have use <code class="highlighter-rouge">cookieCustomStorageGet</code>, <code class="highlighter-rouge">cookieCustomStorageSet</code> and <code class="highlighter-rouge">cookieCustomStorageDelete</code>.</p>
  571. </li>
  572. <li>
  573. <p><strong>Default:</strong> <code class="highlighter-rouge">cookieStorage</code></p>
  574. </li>
  575. </ul>
  576. <h3 id="cookiesenabled">cookiesEnabled</h3>
  577. <ul>
  578. <li>
  579. <p><strong>Attribute:</strong> <code class="highlighter-rouge">data-cookies-enabled</code></p>
  580. </li>
  581. <li>
  582. <p><strong>type:</strong> <code class="highlighter-rouge">Array</code></p>
  583. </li>
  584. <li>
  585. <p><strong>Detail:</strong></p>
  586. <p>Set this array with the table properties (<code class="highlighter-rouge">sortOrder</code>, <code class="highlighter-rouge">sortName</code>, <code class="highlighter-rouge">sortPriority</code>, <code class="highlighter-rouge">pageNumber</code>, <code class="highlighter-rouge">pageList</code>, <code class="highlighter-rouge">hiddenColumns</code>, <code class="highlighter-rouge">searchText</code>, <code class="highlighter-rouge">filterControl</code>) that you want to save</p>
  587. </li>
  588. <li>
  589. <p><strong>Default:</strong> <code class="highlighter-rouge">['bs.table.sortOrder', 'bs.table.sortName', 'bs.table.sortPriority', 'bs.table.pageNumber', 'bs.table.pageList', 'bs.table.hiddenColumns', 'bs.table.searchText', 'bs.table.filterControl', 'bs.table.cardView', 'bs.table.customView']</code></p>
  590. </li>
  591. </ul>
  592. <h2 id="methods">Methods</h2>
  593. <h3 id="deletecookie">deleteCookie</h3>
  594. <ul>
  595. <li>
  596. <p><strong>parameters:</strong> <code class="highlighter-rouge">cookieName</code></p>
  597. </li>
  598. <li>
  599. <p><strong>Detail:</strong></p>
  600. <p>Delete the saved cookie by cookie name.</p>
  601. </li>
  602. </ul>
  603. <h3 id="getcookies">getCookies</h3>
  604. <ul>
  605. <li>
  606. <p><strong>parameters:</strong> <code class="highlighter-rouge">undefined</code></p>
  607. </li>
  608. <li>
  609. <p><strong>Detail:</strong></p>
  610. <p>Return the saved cookies.</p>
  611. </li>
  612. </ul>
  613. <h2 id="this-plugin-saves">This plugin saves</h2>
  614. <ul>
  615. <li>Page number</li>
  616. <li>Page size (Rows per page)</li>
  617. <li>Search text</li>
  618. <li>Search filter control</li>
  619. <li>Sort order</li>
  620. <li>Sort name</li>
  621. <li>Multiple Sort order</li>
  622. <li>Hidden columns</li>
  623. <li>Card view state</li>
  624. </ul>
  625. </main>
  626. </div>
  627. </div>
  628. <script src="https://cdn.jsdelivr.net/npm/jquery/dist/jquery.min.js"></script>
  629. <script src="https://cdn.jsdelivr.net/npm/popper.js@1.16.1/dist/umd/popper.min.js"></script>
  630. <script src="https://cdn.jsdelivr.net/npm/bootstrap@4.6.2/dist/js/bootstrap.min.js"></script>
  631. <script async defer src="https://buttons.github.io/buttons.js"></script><script src="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.js"></script>
  632. <script>
  633. $(function () {
  634. $('.bd-content.api a').attr('target', '_blank')
  635. })
  636. </script><script src="https://gg.wenzhixin.net.cn/bootstrap-table/gg.js"></script>
  637. <script src="/assets/js/docs.min.js?m=1"></script>
  638. <!-- Global site tag (gtag.js) - Google Analytics -->
  639. <script async src="https://www.googletagmanager.com/gtag/js?id=UA-132747866-1"></script>
  640. <script>
  641. window.dataLayer = window.dataLayer || []
  642. function gtag() {window.dataLayer.push(arguments)}
  643. gtag('js', new Date())
  644. gtag('config', 'UA-132747866-1')
  645. </script>
  646. </body>
  647. </html>