docs.js 19 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455
  1. $(function () {
  2. 'use strict';
  3. function initTables() {
  4. var cardView = false;
  5. if ($(window).width() < 640) {
  6. cardView = true;
  7. }
  8. $('#table, #column, #event, #method, #localization').bootstrapTable('destroy');
  9. $('#table').bootstrapTable({
  10. cardView: cardView,
  11. columns: [
  12. {field: 'name', title: 'Name', align: 'center', width: 60, sortable: true},
  13. {field: 'type', title: 'Type', align: 'center', width: 60},
  14. {field: 'description', title: 'Description', width: 400},
  15. {field: 'default', title: 'Default', align: '', width: 180}
  16. ],
  17. data: [
  18. {
  19. name: 'bootstrapVersion',
  20. type: 'Number',
  21. description: 'Bootstrap version.',
  22. 'default': '3'
  23. },
  24. {
  25. name: 'classes',
  26. type: 'String',
  27. description: 'The class name of table.',
  28. 'default': 'table table-hover'
  29. },
  30. {
  31. name: 'height',
  32. type: 'Number',
  33. description: 'The height of table.',
  34. 'default': 'undefined'
  35. },
  36. {
  37. name: 'undefinedText',
  38. type: 'String',
  39. description: 'Defines the default undefined text.',
  40. 'default': '-'
  41. },
  42. {
  43. name: 'striped',
  44. type: 'Boolean',
  45. description: 'True to stripe the rows.',
  46. 'default': 'false'
  47. },
  48. {
  49. name: 'sortName',
  50. type: 'String',
  51. description: 'Defines which column can be sorted.',
  52. 'default': 'undefined'
  53. },
  54. {
  55. name: 'sortOrder',
  56. type: 'String',
  57. description: 'Defines the column sort order, can only be "asc" or "desc".',
  58. 'default': 'asc'
  59. },
  60. {
  61. name: 'columns',
  62. type: 'Array',
  63. description: 'The table columns config object, see column properties for more details.',
  64. 'default': '[]'
  65. },
  66. {
  67. name: 'data',
  68. type: 'Array',
  69. description: 'The data to be loaded.',
  70. 'default': '[]'
  71. },
  72. {
  73. name: 'method',
  74. type: 'String',
  75. description: 'The method type to request remote data.',
  76. 'default': 'get'
  77. },
  78. {
  79. name: 'url',
  80. type: 'String',
  81. description: 'A URL to request data from remote site.',
  82. 'default': 'undefined'
  83. },
  84. {
  85. name: 'contentType',
  86. type: 'String',
  87. description: 'The contentType of request remote data.',
  88. 'default': 'application/json'
  89. },
  90. {
  91. name: 'queryParams',
  92. type: 'Function',
  93. description: 'When request remote data, sending additional parameters by format the queryParams, the parameters object contains: <br>pageSize, pageNumber, searchText, sortName, sortOrder.',
  94. 'default': 'function(params) {<br>return {};<br>}'
  95. },
  96. {
  97. name: 'pagination',
  98. type: 'Boolean',
  99. description: 'True to show a pagination toolbar on datagrid bottom.',
  100. 'default': 'false'
  101. },
  102. {
  103. name: 'sidePagination',
  104. type: 'String',
  105. description: 'Defines the side pagination of table, can only be "client" or "server".',
  106. 'default': 'client'
  107. },
  108. {
  109. name: 'totalRows',
  110. type: 'Number',
  111. description: 'Defines the total rows of table, you need to set this option when the sidePagination option is set to "server".',
  112. 'default': 0
  113. },
  114. {
  115. name: 'pageNumber',
  116. type: 'Number',
  117. description: 'When set pagination property, initialize the page number.',
  118. 'default': 1
  119. },
  120. {
  121. name: 'pageSize',
  122. type: 'Number',
  123. description: 'When set pagination property, initialize the page size.',
  124. 'default': 10
  125. },
  126. {
  127. name: 'pageList',
  128. type: 'Array',
  129. description: 'When set pagination property, initialize the page size selecting list.',
  130. 'default': '[10, 25, 50, 100]'
  131. },
  132. {
  133. name: 'search',
  134. type: 'Boolean',
  135. description: 'Enable the search input.',
  136. 'default': 'false'
  137. },
  138. {
  139. name: 'selectItemName',
  140. type: 'String',
  141. description: 'The name of radio or checkbox input.',
  142. 'default': 'btSelectItem'
  143. },
  144. {
  145. name: 'showHeader',
  146. type: 'Boolean',
  147. description: 'False to hide the table header.',
  148. 'default': 'true'
  149. },
  150. {
  151. name: 'showColumns',
  152. type: 'Boolean',
  153. description: 'True to show the columns drop down list.',
  154. 'default': 'false'
  155. },
  156. {
  157. name: 'idField',
  158. type: 'String',
  159. description: 'Indicate which field is an identity field.',
  160. 'default': 'undefined'
  161. },
  162. {
  163. name: 'cardView',
  164. type: 'Boolean',
  165. description: 'True to show card view table, for example mobile view.',
  166. 'default': 'false'
  167. },
  168. {
  169. name: 'clickToSelect',
  170. type: 'Boolean',
  171. description: 'True to select checkbox or radiobox when click rows.',
  172. 'default': 'false'
  173. },
  174. {
  175. name: 'singleSelect',
  176. type: 'Boolean',
  177. description: 'True to allow checkbox selecting only one row.',
  178. 'default': 'false'
  179. },
  180. {
  181. name: 'toolbar',
  182. type: 'String',
  183. description: 'A jQuery selector that indicate the toolbar, for example: <br>#toolbar, .toolbar.',
  184. 'default': 'undefined'
  185. },
  186. {
  187. name: 'rowStyle',
  188. type: 'Function',
  189. description: 'The row formatter function, take two parameters: <br>row: the row record data.<br>index: the row index.<br>Support classes or css, code example:<br>{<br>classes: "red", <br>css: {background: "red", color: "white"}<br>}',
  190. 'default': '{}'
  191. }
  192. ]
  193. });
  194. $('#column').bootstrapTable({
  195. cardView: cardView,
  196. columns: [
  197. {field: 'name', title: 'Name', align: 'center', valign: 'middle', width: 60, sortable: true},
  198. {field: 'type', title: 'Type', align: 'center', valign: 'middle', width: 60},
  199. {field: 'description', title: 'Description', width: 400},
  200. {field: 'default', title: 'Default', align: 'right', valign: 'middle', width: 180}
  201. ],
  202. data: [
  203. {
  204. name: 'radio',
  205. type: 'Boolean',
  206. description: 'True to show a radio. The radio column has fixed width.',
  207. 'default': 'false'
  208. },
  209. {
  210. name: 'checkbox',
  211. type: 'Boolean',
  212. description: 'True to show a checkbox. The checkbox column has fixed width.',
  213. 'default': 'false'
  214. },
  215. {
  216. name: 'field',
  217. type: 'String',
  218. description: 'The column field name.',
  219. 'default': 'undefined'
  220. },
  221. {
  222. name: 'title',
  223. type: 'String',
  224. description: 'The column title text.',
  225. 'default': 'undefined'
  226. },
  227. {
  228. name: 'align',
  229. type: 'String',
  230. description: 'Indicate how to align the column data. "left", "right", "center" can be used.',
  231. 'default': 'undefined'},
  232. {
  233. name: 'valign',
  234. type: 'String',
  235. description: 'Indicate how to align the cell data. "top", "middle", "bottom" can be used.',
  236. 'default': 'undefined'
  237. },
  238. {
  239. name: 'width',
  240. type: 'Number',
  241. description: 'The width of column. If not defined, the width will auto expand to fit its contents.',
  242. 'default': 'undefined'},
  243. {
  244. name: 'sortable',
  245. type: 'Boolean',
  246. description: 'True to allow the column can be sorted.',
  247. 'default': 'false'
  248. },
  249. {
  250. name: 'order',
  251. type: 'String',
  252. description: 'The default sort order, can only be "asc" or "desc".',
  253. 'default': 'asc'
  254. },
  255. {
  256. name: 'visible',
  257. type: 'Boolean',
  258. description: 'True to visible the columns item.',
  259. 'default': 'true'
  260. },
  261. {
  262. name: 'formatter',
  263. type: 'Function',
  264. description: 'The cell formatter function, take two parameters: <br />value: the field value. <br />row: the row record data.<br />index: the row index.',
  265. 'default': 'undefined'
  266. },
  267. {
  268. name: 'sorter',
  269. type: 'Function',
  270. description: 'The custom field sort function that used to do local sorting, take two parameters: <br />a: the first field value.<br /> b: the second field value.',
  271. 'default': 'undefined'
  272. }
  273. ]
  274. });
  275. $('#event').bootstrapTable({
  276. cardView: cardView,
  277. columns: [
  278. {field: 'name', title: 'Name', align: 'center', valign: 'middle', width: 100, sortable: true},
  279. {field: 'parameter', title: 'Parameter', align: 'center', valign: 'middle', width: 100, sortable: true},
  280. {field: 'description', title: 'Description', width: 400, sortable: true}
  281. ],
  282. data: [
  283. {
  284. name: 'onClickRow',
  285. parameter: 'row',
  286. description: 'Fires when user click a row, the parameters contains: <br />row: the record corresponding to the clicked row.'},
  287. {
  288. name: 'onSort',
  289. parameter: 'name, order',
  290. description: 'Fires when user sort a column, the parameters contains: <br />name: the sort column field name<br />order: the sort column order.'
  291. },
  292. {
  293. name: 'onCheck',
  294. parameter: 'row',
  295. description: 'Fires when user check a row, the parameters contains: <br />row: the record corresponding to the clicked row.'
  296. },
  297. {
  298. name: 'onUncheck',
  299. parameter: 'row',
  300. description: 'Fires when user uncheck a row, the parameters contains: <br />row: the record corresponding to the clicked row.'
  301. },
  302. {
  303. name: 'onCheckAll',
  304. parameter: 'none',
  305. description: 'Fires when user check all rows.'
  306. },
  307. {
  308. name: 'onUncheckAll',
  309. parameter: 'none',
  310. description: 'Fires when user uncheck all rows.'
  311. },
  312. {
  313. name: 'onLoadSuccess',
  314. parameter: 'data',
  315. description: 'Fires when remote data is loaded successfully.'
  316. },
  317. {
  318. name: 'onLoadError',
  319. parameter: 'status',
  320. description: 'Fires when some errors occur to load remote data.'
  321. },
  322. {
  323. name: 'onBeforeLoad',
  324. parameter: 'res',
  325. description: 'Fires before a request is made to load data.'
  326. }
  327. ],
  328. onClickRow: function (row) {
  329. console.log('onClickRow', row);
  330. },
  331. onSort: function (name, order) {
  332. console.log('onSort', name, order);
  333. },
  334. onCheck: function(row) {
  335. console.log('onCheck', row);
  336. },
  337. onUncheck: function(row) {
  338. console.log('onUncheck', row);
  339. },
  340. onCheckAll: function() {
  341. console.log('onCheckAll');
  342. },
  343. onUncheckAll: function() {
  344. console.log('onUncheckAll');
  345. }
  346. });
  347. $('#method').bootstrapTable({
  348. cardView: cardView,
  349. columns: [
  350. {field: 'name', title: 'Name', align: 'center', valign: 'middle', width: 100},
  351. {field: 'parameter', title: 'Parameter', align: 'center', valign: 'middle', width: 100},
  352. {field: 'description', title: 'Description', width: 400}
  353. ]
  354. }).bootstrapTable('load', [
  355. {name: 'getSelections', parameter: 'none', description: 'Return all selected rows, when no record selected, am empty array will return.'},
  356. {name: 'load', parameter: 'data', description: 'Load the data to table.'}
  357. ]).bootstrapTable('append', [
  358. {name: 'append', parameter: 'data', description: 'Append the data to table.'},
  359. {name: 'mergeCells', parameter: 'options', description: 'Merge some cells to one cell, the options contains following properties:'},
  360. {name: 'mergeCells', parameter: 'options', description: 'index: the row index.'},
  361. {name: 'mergeCells', parameter: 'options', description: 'field: the field name.'},
  362. {name: 'mergeCells', parameter: 'options', description: 'rowspan: the rowspan count to be merged.'},
  363. {name: 'mergeCells', parameter: 'options', description: 'colspan: the colspan count to be merged.'},
  364. {name: 'refresh', parameter: 'none', description: 'Refresh the remote server data.'},
  365. {name: 'showLoading', parameter: 'none', description: 'Show loading status.'},
  366. {name: 'hideLoading', parameter: 'none', description: 'Hide loading status.'},
  367. {name: 'checkAll', parameter: 'none', description: 'Check all current page rows.'},
  368. {name: 'uncheckAll', parameter: 'none', description: 'Uncheck all current page rows.'},
  369. {name: 'resetView', parameter: 'none', description: 'Reset the bootstrap table view, like display error when init the table with display: none.'},
  370. {name: 'destroy', parameter: 'none', description: 'Destroy the bootstrap table.'}
  371. ]).bootstrapTable('mergeCells', {
  372. index: 3,
  373. field: 'name',
  374. rowspan: 5
  375. }).bootstrapTable('mergeCells', {
  376. index: 3,
  377. field: 'parameter',
  378. rowspan: 5
  379. });
  380. $('#localization').bootstrapTable({
  381. cardView: cardView,
  382. columns: [
  383. {field: 'name', title: 'Name', align: 'center', valign: 'middle', width: 100},
  384. {field: 'parameter', title: 'Parameter', align: 'center', valign: 'middle', width: 100},
  385. {field: 'default', title: 'Default', align: 'center', valign: 'middle', width: 200}
  386. ],
  387. data: [{
  388. name: 'formatLoadingMessage',
  389. parameter: '-',
  390. 'default': 'Loading, please wait…'
  391. }, {
  392. name: 'formatRecordsPerPage',
  393. parameter: 'pageNumber',
  394. 'default': '%s records per page'
  395. }, {
  396. name: 'formatShowingRows',
  397. parameter: 'pageFrom, pageTo, totalRows',
  398. 'default': 'Showing %s to %s of %s rows'
  399. }, {
  400. name: 'formatSearch',
  401. parameter: '-',
  402. 'default': 'Search'
  403. }, {
  404. name: 'formatNoMatches',
  405. parameter: '-',
  406. 'default': 'No matching records found'
  407. }]
  408. });
  409. }
  410. var $window = $(window);
  411. var $body = $(document.body);
  412. var navHeight = $('.navbar').outerHeight(true) + 10;
  413. $body.scrollspy({
  414. target: '.bs-sidebar',
  415. offset: navHeight
  416. });
  417. $window.on('load', function () {
  418. $body.scrollspy('refresh')
  419. });
  420. $window.on('resize', function() {
  421. initTables();
  422. });
  423. // affix
  424. setTimeout(function () {
  425. var $sideBar = $('.bs-sidebar');
  426. $sideBar.affix({
  427. offset: {
  428. top: function () {
  429. var offsetTop = $sideBar.offset().top;
  430. var sideBarMargin = parseInt($sideBar.children(0).css('margin-top'), 10);
  431. var navOuterHeight = $('.bs-docs-nav').height();
  432. return (this.top = offsetTop - navOuterHeight - sideBarMargin);
  433. },
  434. bottom: function () {
  435. return (this.bottom = $('.bs-footer').outerHeight(true));
  436. }
  437. }
  438. });
  439. }, 100);
  440. initTables();
  441. });