ui-soxo-bootstrap-core 2.4.24

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (429) hide show
  1. package/.babelrc +9 -0
  2. package/.github/workflows/npm-publish.yml +33 -0
  3. package/.husky/pre-commit +12 -0
  4. package/.prettierrc.json +11 -0
  5. package/babel.config.js +3 -0
  6. package/core/assets/images/vector.png +0 -0
  7. package/core/components/component-loader/component-loader.js +125 -0
  8. package/core/components/component-wrapper/component-wrapper.js +122 -0
  9. package/core/components/extra-info/extra-info-details.js +172 -0
  10. package/core/components/extra-info/extra-info-details.scss +27 -0
  11. package/core/components/extra-info/extra-info.js +134 -0
  12. package/core/components/index.js +18 -0
  13. package/core/components/landing-api/landing-api.js +492 -0
  14. package/core/components/landing-api/landing-api.scss +19 -0
  15. package/core/components/menu-template-api/menu-template-api.js +321 -0
  16. package/core/components/root-application-api/root-application-api.js +174 -0
  17. package/core/components/root-application-api/root-application.api.scss +0 -0
  18. package/core/index.js +14 -0
  19. package/core/lib/Store.js +363 -0
  20. package/core/lib/assets/Tick-icon.png +0 -0
  21. package/core/lib/assets/blue-slate-theme.png +0 -0
  22. package/core/lib/assets/dark-theme.png +0 -0
  23. package/core/lib/assets/deep-purple-theme.png +0 -0
  24. package/core/lib/assets/light-theme.png +0 -0
  25. package/core/lib/assets/nura-theme.png +0 -0
  26. package/core/lib/assets/plant.png +0 -0
  27. package/core/lib/assets/welcome-image.png +0 -0
  28. package/core/lib/assets/white-haze-theme.png +0 -0
  29. package/core/lib/components/application-bootstrap/application-bootstrap.js +115 -0
  30. package/core/lib/components/application-bootstrap/application-bootstrap.scss +0 -0
  31. package/core/lib/components/approval-form/approval-form.js +280 -0
  32. package/core/lib/components/approval-form/approval-form.scss +184 -0
  33. package/core/lib/components/approval-list/approval-list.js +143 -0
  34. package/core/lib/components/approval-list/approval-list.scss +3 -0
  35. package/core/lib/components/approval-list/components/request-card/request-card.js +43 -0
  36. package/core/lib/components/approval-list/components/request-card/request-card.scss +31 -0
  37. package/core/lib/components/camera/camera.js +231 -0
  38. package/core/lib/components/camera/camera.scss +86 -0
  39. package/core/lib/components/comment-block/comment-block.js +139 -0
  40. package/core/lib/components/comment-block/comment-block.scss +3 -0
  41. package/core/lib/components/confirm-modal/confirm-modal.js +82 -0
  42. package/core/lib/components/confirm-modal/confirm-modal.scss +3 -0
  43. package/core/lib/components/consent/consent.js +67 -0
  44. package/core/lib/components/consent/consent.scss +0 -0
  45. package/core/lib/components/consent/pdf-signature.js +299 -0
  46. package/core/lib/components/consent/signature-pad.js +90 -0
  47. package/core/lib/components/consent/signature-pad.scss +14 -0
  48. package/core/lib/components/file-upload/file-upload.js +133 -0
  49. package/core/lib/components/finger-print-reader/finger-print-reader.js +296 -0
  50. package/core/lib/components/finger-print-reader/finger-print-reader.scss +47 -0
  51. package/core/lib/components/finger-print-search/finger-print-search.js +200 -0
  52. package/core/lib/components/finger-print-search/finger-print-search.scss +47 -0
  53. package/core/lib/components/global-header/animations.js +18 -0
  54. package/core/lib/components/global-header/global-header.js +413 -0
  55. package/core/lib/components/global-header/global-header.scss +369 -0
  56. package/core/lib/components/header/generic-header.js +76 -0
  57. package/core/lib/components/header/generic-header.scss +99 -0
  58. package/core/lib/components/image-preview/image-preview.js +33 -0
  59. package/core/lib/components/image-wrapper/image-wrapper.js +108 -0
  60. package/core/lib/components/image-wrapper/image-wrapper.scss +13 -0
  61. package/core/lib/components/index.js +203 -0
  62. package/core/lib/components/landing/landing.js +404 -0
  63. package/core/lib/components/landing/landing.scss +0 -0
  64. package/core/lib/components/language-switcher/language-switcher.js +50 -0
  65. package/core/lib/components/menu-context/menu-context.js +70 -0
  66. package/core/lib/components/menu-template/menu-template.js +250 -0
  67. package/core/lib/components/menu-template/menu-template.scss +9 -0
  68. package/core/lib/components/modal-search/modal-search.js +153 -0
  69. package/core/lib/components/modal-search/modal-search.scss +79 -0
  70. package/core/lib/components/modal-wrapper/modal-manager.js +16 -0
  71. package/core/lib/components/modal-wrapper/modal-wrapper.js +108 -0
  72. package/core/lib/components/modal-wrapper/modal-wrapper.scss +14 -0
  73. package/core/lib/components/notice-board/notice-board.js +132 -0
  74. package/core/lib/components/notice-board/notice-board.scss +65 -0
  75. package/core/lib/components/page-container/page-container.js +55 -0
  76. package/core/lib/components/page-container/page-container.scss +8 -0
  77. package/core/lib/components/page-header/page-header.js +23 -0
  78. package/core/lib/components/page-header/page-header.scss +18 -0
  79. package/core/lib/components/pdf-viewer/pdf-viewer.js +56 -0
  80. package/core/lib/components/portlet-table/components/table-actions/table-actions.js +58 -0
  81. package/core/lib/components/portlet-table/components/table-actions/table-actions.scss +1 -0
  82. package/core/lib/components/portlet-table/components/table-data/table-data.js +107 -0
  83. package/core/lib/components/portlet-table/components/table-data/table-data.scss +0 -0
  84. package/core/lib/components/portlet-table/portlet-table.js +63 -0
  85. package/core/lib/components/portlet-table/portlet-table.scss +90 -0
  86. package/core/lib/components/progress-bar/progress-bar.js +58 -0
  87. package/core/lib/components/progress-bar/progress-bar.scss +15 -0
  88. package/core/lib/components/request-form/request-form.js +110 -0
  89. package/core/lib/components/request-form/request-form.scss +0 -0
  90. package/core/lib/components/root-application/root-application.js +70 -0
  91. package/core/lib/components/rupee/rupee.js +14 -0
  92. package/core/lib/components/script-input/script-input.js +169 -0
  93. package/core/lib/components/script-input/script-input.scss +8 -0
  94. package/core/lib/components/sidemenu/animations.js +52 -0
  95. package/core/lib/components/sidemenu/sidemenu.js +617 -0
  96. package/core/lib/components/sidemenu/sidemenu.scss +264 -0
  97. package/core/lib/components/spotlight-search/spotlight-search.component.js +636 -0
  98. package/core/lib/components/spotlight-search/spotlight-search.component.scss +78 -0
  99. package/core/lib/components/table-wrapper/table-wrapper.js +136 -0
  100. package/core/lib/components/table-wrapper/table-wrapper.scss +72 -0
  101. package/core/lib/components/ui_elements/Loader.js +13 -0
  102. package/core/lib/components/ui_elements/Notify.js +13 -0
  103. package/core/lib/components/ui_elements/PlaceHolder.js +34 -0
  104. package/core/lib/components/web-camera/web-camera.js +162 -0
  105. package/core/lib/components/web-camera/web-camera.scss +28 -0
  106. package/core/lib/core.md +9 -0
  107. package/core/lib/elements/Elements.md +3 -0
  108. package/core/lib/elements/basic/LoggedUserRedirect.js +21 -0
  109. package/core/lib/elements/basic/PrivateRoute.js +16 -0
  110. package/core/lib/elements/basic/button/Button.md +43 -0
  111. package/core/lib/elements/basic/button/button.js +170 -0
  112. package/core/lib/elements/basic/button/button.scss +0 -0
  113. package/core/lib/elements/basic/card/Card.md +15 -0
  114. package/core/lib/elements/basic/card/card.js +40 -0
  115. package/core/lib/elements/basic/card/card.scss +14 -0
  116. package/core/lib/elements/basic/checkbox/checkbox.js +23 -0
  117. package/core/lib/elements/basic/col/col.js +16 -0
  118. package/core/lib/elements/basic/copy-to-clipboard/Readme.md +40 -0
  119. package/core/lib/elements/basic/copy-to-clipboard/copy-to-clipboard.js +62 -0
  120. package/core/lib/elements/basic/country-phone-input/Readme.md +98 -0
  121. package/core/lib/elements/basic/country-phone-input/country-phone-input.js +107 -0
  122. package/core/lib/elements/basic/country-phone-input/phone-input.scss +62 -0
  123. package/core/lib/elements/basic/datepicker/datepicker.js +33 -0
  124. package/core/lib/elements/basic/dragabble-wrapper/draggable-wrapper.js +61 -0
  125. package/core/lib/elements/basic/empty/empty.js +15 -0
  126. package/core/lib/elements/basic/fingerprint-protrected/fingerprint-protected.js +118 -0
  127. package/core/lib/elements/basic/fingerprint-protrected/fingerprint-protected.scss +10 -0
  128. package/core/lib/elements/basic/form/Readme.md +0 -0
  129. package/core/lib/elements/basic/form/form.js +70 -0
  130. package/core/lib/elements/basic/form/form.scss +4 -0
  131. package/core/lib/elements/basic/image/image.js +45 -0
  132. package/core/lib/elements/basic/image/image.scss +17 -0
  133. package/core/lib/elements/basic/image/readme.md +26 -0
  134. package/core/lib/elements/basic/image-viewer/image-viewer.js +109 -0
  135. package/core/lib/elements/basic/image-viewer/image-viewer.scss +8 -0
  136. package/core/lib/elements/basic/input/input.js +81 -0
  137. package/core/lib/elements/basic/input/readme.md +77 -0
  138. package/core/lib/elements/basic/json-input/json-input.js +51 -0
  139. package/core/lib/elements/basic/menu-dashboard/menu-dashboard.js +216 -0
  140. package/core/lib/elements/basic/menu-dashboard/menu-dashboard.scss +28 -0
  141. package/core/lib/elements/basic/modal/modal.js +64 -0
  142. package/core/lib/elements/basic/modal/readme.md +62 -0
  143. package/core/lib/elements/basic/popconfirm/popconfirm.js +18 -0
  144. package/core/lib/elements/basic/popover/popover.js +13 -0
  145. package/core/lib/elements/basic/radio/radio.js +18 -0
  146. package/core/lib/elements/basic/rangepicker/rangepicker.js +51 -0
  147. package/core/lib/elements/basic/rangepicker/rangepicker.scss +18 -0
  148. package/core/lib/elements/basic/rangepicker/readme.md +82 -0
  149. package/core/lib/elements/basic/reference-select/readme.md +19 -0
  150. package/core/lib/elements/basic/reference-select/reference-select.js +337 -0
  151. package/core/lib/elements/basic/row/row.js +16 -0
  152. package/core/lib/elements/basic/select/select.js +47 -0
  153. package/core/lib/elements/basic/select-box/readme.md +53 -0
  154. package/core/lib/elements/basic/select-box/select-box.js +63 -0
  155. package/core/lib/elements/basic/skeleton/readme.md +35 -0
  156. package/core/lib/elements/basic/skeleton/skeleton.js +36 -0
  157. package/core/lib/elements/basic/skeleton/skeleton.scss +53 -0
  158. package/core/lib/elements/basic/space/space.js +13 -0
  159. package/core/lib/elements/basic/switch/readme.md +29 -0
  160. package/core/lib/elements/basic/switch/switch.js +58 -0
  161. package/core/lib/elements/basic/tab/tab.js +15 -0
  162. package/core/lib/elements/basic/table/readme.md +9 -0
  163. package/core/lib/elements/basic/table/table.js +100 -0
  164. package/core/lib/elements/basic/table/table.scss +0 -0
  165. package/core/lib/elements/basic/tag/tag.js +63 -0
  166. package/core/lib/elements/basic/tag/tag.scss +3 -0
  167. package/core/lib/elements/basic/timeline/timeline.js +14 -0
  168. package/core/lib/elements/basic/title/readme.md +20 -0
  169. package/core/lib/elements/basic/title/title.js +38 -0
  170. package/core/lib/elements/basic/title/title.scss +0 -0
  171. package/core/lib/elements/basic/user-search/user-search.js +192 -0
  172. package/core/lib/elements/complex/barcode/barcode.js +27 -0
  173. package/core/lib/elements/complex/bargraph/bar-graph.js +262 -0
  174. package/core/lib/elements/complex/basic-table/basic-table.js +111 -0
  175. package/core/lib/elements/complex/basic-table/basic-table.scss +4 -0
  176. package/core/lib/elements/complex/date-display/date-display.js +37 -0
  177. package/core/lib/elements/complex/error-boundary/error-boundary.js +29 -0
  178. package/core/lib/elements/complex/google-location-input/map-container-library-load.js +93 -0
  179. package/core/lib/elements/complex/google-map/google-map.js +230 -0
  180. package/core/lib/elements/complex/google-map/google-map.scss +13 -0
  181. package/core/lib/elements/complex/line-graph/line-graph.js +108 -0
  182. package/core/lib/elements/complex/location-search-input/location-search-input.js +100 -0
  183. package/core/lib/elements/complex/maps/maps.js +0 -0
  184. package/core/lib/elements/complex/pie-chart/pie-chart.js +203 -0
  185. package/core/lib/elements/complex/qr-code/qr-code.js +27 -0
  186. package/core/lib/elements/complex/qrscanner/qrscanner.js +57 -0
  187. package/core/lib/elements/complex/search-debounce/search-debounce.js +37 -0
  188. package/core/lib/elements/complex/statistic-card/dashboard-statistic-card.js +76 -0
  189. package/core/lib/elements/complex/statistic-card/statistic-card.js +28 -0
  190. package/core/lib/elements/index.js +226 -0
  191. package/core/lib/hooks/device-detect.js +26 -0
  192. package/core/lib/hooks/index.js +19 -0
  193. package/core/lib/hooks/use-location.js +33 -0
  194. package/core/lib/hooks/use-window-size.js +34 -0
  195. package/core/lib/i18n.js +70 -0
  196. package/core/lib/index.js +106 -0
  197. package/core/lib/introduction.md +74 -0
  198. package/core/lib/js-styleguide.md +4112 -0
  199. package/core/lib/models/actions/actions.js +128 -0
  200. package/core/lib/models/actions/components/action-detail/action-detail.js +190 -0
  201. package/core/lib/models/actions/components/action-detail/action-detail.scss +0 -0
  202. package/core/lib/models/actions/components/custom-actions/custom-actions.js +186 -0
  203. package/core/lib/models/actions/components/custom-actions/custom-actions.scss +0 -0
  204. package/core/lib/models/attachments/attachments.js +231 -0
  205. package/core/lib/models/base-loader.js +99 -0
  206. package/core/lib/models/base.js +716 -0
  207. package/core/lib/models/branches/branches.js +125 -0
  208. package/core/lib/models/checklists/checklists.js +115 -0
  209. package/core/lib/models/columns/columns.js +169 -0
  210. package/core/lib/models/columns/components/columns-add/columns-add.js +172 -0
  211. package/core/lib/models/columns/components/columns-add/columns-add.scss +0 -0
  212. package/core/lib/models/comments/comments.js +213 -0
  213. package/core/lib/models/departments/departments.js +107 -0
  214. package/core/lib/models/financial-years/financial_years.js +127 -0
  215. package/core/lib/models/forms/components/form-creator/form-creator.js +624 -0
  216. package/core/lib/models/forms/components/form-creator/form-creator.scss +30 -0
  217. package/core/lib/models/forms/components/form-detail/form-detail.js +224 -0
  218. package/core/lib/models/forms/components/form-detail/form-detail.scss +0 -0
  219. package/core/lib/models/forms/forms.js +122 -0
  220. package/core/lib/models/index.js +203 -0
  221. package/core/lib/models/invoice-numbers/invoice_numbers.js +204 -0
  222. package/core/lib/models/lookup-types/components/lookup-detail/lookup-detail.js +145 -0
  223. package/core/lib/models/lookup-types/components/lookup-detail/lookup-detail.scss +0 -0
  224. package/core/lib/models/lookup-types/lookup-types.js +113 -0
  225. package/core/lib/models/lookup-values/components/lookup-values-add/lookup-values-add.js +126 -0
  226. package/core/lib/models/lookup-values/components/lookup-values-add/lookup-values-add.scss +0 -0
  227. package/core/lib/models/lookup-values/lookup-values.js +107 -0
  228. package/core/lib/models/menu-roles/menu-roles.js +127 -0
  229. package/core/lib/models/menus/components/menu-add/menu-add.js +228 -0
  230. package/core/lib/models/menus/components/menu-add/menu-add.scss +0 -0
  231. package/core/lib/models/menus/components/menu-detail/menu-detail.js +170 -0
  232. package/core/lib/models/menus/components/menu-detail/menu-detail.scss +0 -0
  233. package/core/lib/models/menus/components/menu-list/menu-list.js +593 -0
  234. package/core/lib/models/menus/components/menu-list/menu-list.scss +6 -0
  235. package/core/lib/models/menus/components/menu-roles-add/menu-roles-add.js +183 -0
  236. package/core/lib/models/menus/components/menu-roles-add/menu-roles-add.scss +0 -0
  237. package/core/lib/models/menus/menus.js +499 -0
  238. package/core/lib/models/models/components/model-detail/model-detail.js +137 -0
  239. package/core/lib/models/models/components/model-detail/model-detail.scss +0 -0
  240. package/core/lib/models/models/components/models.js +128 -0
  241. package/core/lib/models/modules/modules.js +204 -0
  242. package/core/lib/models/outbox/outbox.js +73 -0
  243. package/core/lib/models/pages/pages.js +107 -0
  244. package/core/lib/models/permissions/permissions.js +71 -0
  245. package/core/lib/models/process/components/process-add/process-add.js +181 -0
  246. package/core/lib/models/process/components/process-add/process-add.scss +0 -0
  247. package/core/lib/models/process/components/process-dashboard/process-dashboard.js +602 -0
  248. package/core/lib/models/process/components/process-dashboard/process-dashboard.scss +62 -0
  249. package/core/lib/models/process/components/process-detail/process-detail.js +140 -0
  250. package/core/lib/models/process/components/process-detail/process-detail.scss +0 -0
  251. package/core/lib/models/process/components/process-timeline/process-timeline.js +140 -0
  252. package/core/lib/models/process/components/task-detail/task-detail.js +240 -0
  253. package/core/lib/models/process/components/task-detail/task-detail.scss +27 -0
  254. package/core/lib/models/process/components/task-form/task-form.js +529 -0
  255. package/core/lib/models/process/components/task-form/task-form.scss +7 -0
  256. package/core/lib/models/process/components/task-list/task-list.js +221 -0
  257. package/core/lib/models/process/components/task-list/task-list.scss +14 -0
  258. package/core/lib/models/process/components/task-overview/task-overview.js +300 -0
  259. package/core/lib/models/process/components/task-overview/task-overview.scss +0 -0
  260. package/core/lib/models/process/components/task-overview-legacy/task-overview-legacy.js +192 -0
  261. package/core/lib/models/process/components/task-overview-legacy/task-overview.scss +0 -0
  262. package/core/lib/models/process/components/task-routes/task-routes.js +45 -0
  263. package/core/lib/models/process/components/task-status/task-status.js +176 -0
  264. package/core/lib/models/process/components/task-status/task-status.scss +11 -0
  265. package/core/lib/models/process/process.js +781 -0
  266. package/core/lib/models/process-transactions/process-transactions.js +124 -0
  267. package/core/lib/models/roles/roles.js +106 -0
  268. package/core/lib/models/scripts/scripts.js +111 -0
  269. package/core/lib/models/step-transactions/step-transcations.js +148 -0
  270. package/core/lib/models/steps/components/step-add/step-add.js +261 -0
  271. package/core/lib/models/steps/components/step-add/step-add.scss +0 -0
  272. package/core/lib/models/steps/components/step-detail/step-detail.js +157 -0
  273. package/core/lib/models/steps/components/step-detail/step-detail.scss +0 -0
  274. package/core/lib/models/steps/steps.js +357 -0
  275. package/core/lib/models/user-preferences/user-preferences.js +83 -0
  276. package/core/lib/models/users/components/user-add/user-add.js +226 -0
  277. package/core/lib/models/users/components/user-add/user-add.scss +0 -0
  278. package/core/lib/models/users/users.js +120 -0
  279. package/core/lib/modules/business/launch-page/launch-page.js +29 -0
  280. package/core/lib/modules/business/launch-page/launch-page.scss +6 -0
  281. package/core/lib/modules/business/slots/slots.js +231 -0
  282. package/core/lib/modules/business/slots/slots.scss +108 -0
  283. package/core/lib/modules/forms/components/field-customizer/field-customizer.js +139 -0
  284. package/core/lib/modules/forms/components/field-customizer/field-customizer.scss +0 -0
  285. package/core/lib/modules/forms/components/field-selector/field-selector.js +157 -0
  286. package/core/lib/modules/forms/components/field-selector/field-selector.scss +25 -0
  287. package/core/lib/modules/forms/components/form-display/form-display.js +203 -0
  288. package/core/lib/modules/forms/components/form-display/form-display.scss +9 -0
  289. package/core/lib/modules/forms/components/tab-customizer/tab-customizer.js +125 -0
  290. package/core/lib/modules/forms/components/tab-customizer/tab-customizer.scss +0 -0
  291. package/core/lib/modules/generic/generic-add/generic-add.js +213 -0
  292. package/core/lib/modules/generic/generic-add/generic-add.scss +0 -0
  293. package/core/lib/modules/generic/generic-detail/generic-detail.js +199 -0
  294. package/core/lib/modules/generic/generic-detail/generic-detail.scss +0 -0
  295. package/core/lib/modules/generic/generic-edit/generic-edit.js +120 -0
  296. package/core/lib/modules/generic/generic-edit/generic-edit.scss +0 -0
  297. package/core/lib/modules/generic/generic-list/ExportReactCSV.js +62 -0
  298. package/core/lib/modules/generic/generic-list/generic-list.js +705 -0
  299. package/core/lib/modules/generic/generic-list/generic-list.scss +34 -0
  300. package/core/lib/modules/generic/generic-upload/generic-upload.js +484 -0
  301. package/core/lib/modules/generic/generic-upload/generic-upload.scss +0 -0
  302. package/core/lib/modules/generic/table-settings/table-settings.js +226 -0
  303. package/core/lib/modules/generic/table-settings/table-settings.scss +37 -0
  304. package/core/lib/modules/index.js +52 -0
  305. package/core/lib/modules/modules-routes/module-routes.js +35 -0
  306. package/core/lib/modules/modules-routes/module-routes.scss +0 -0
  307. package/core/lib/pages/change-password/change-password.js +211 -0
  308. package/core/lib/pages/change-password/change-password.scss +76 -0
  309. package/core/lib/pages/homepage/homepage.js +53 -0
  310. package/core/lib/pages/index.js +20 -0
  311. package/core/lib/pages/login/login.js +617 -0
  312. package/core/lib/pages/login/login.scss +346 -0
  313. package/core/lib/pages/manage-users/manage-users.js +429 -0
  314. package/core/lib/pages/manage-users/manage-users.scss +26 -0
  315. package/core/lib/pages/profile/profile.js +247 -0
  316. package/core/lib/pages/profile/profile.scss +107 -0
  317. package/core/lib/pages/profile/theme-config.js +18 -0
  318. package/core/lib/pages/profile/themes-backup.json +311 -0
  319. package/core/lib/pages/profile/themes.json +254 -0
  320. package/core/lib/pages/register/register.js +177 -0
  321. package/core/lib/pages/register/register.scss +128 -0
  322. package/core/lib/react-styleguide.md +757 -0
  323. package/core/lib/utils/api/api.utils.js +188 -0
  324. package/core/lib/utils/api/readme.md +426 -0
  325. package/core/lib/utils/async.js +36 -0
  326. package/core/lib/utils/common/common.utils.js +123 -0
  327. package/core/lib/utils/common/readme.md +30 -0
  328. package/core/lib/utils/date/date.utils.js +295 -0
  329. package/core/lib/utils/date/readme.md +2 -0
  330. package/core/lib/utils/firebase.support.utils.js +99 -0
  331. package/core/lib/utils/firebase.utils.js +808 -0
  332. package/core/lib/utils/form/Form.md +0 -0
  333. package/core/lib/utils/form/form.utils.js +256 -0
  334. package/core/lib/utils/generic/generic.utils.js +69 -0
  335. package/core/lib/utils/http/auth.helper.js +95 -0
  336. package/core/lib/utils/http/http.utils.js +157 -0
  337. package/core/lib/utils/http/readme.md +14 -0
  338. package/core/lib/utils/index.js +46 -0
  339. package/core/lib/utils/location/location.utils.js +137 -0
  340. package/core/lib/utils/location/readme.md +18 -0
  341. package/core/lib/utils/modal.utils.js +16 -0
  342. package/core/lib/utils/notification.utils.js +35 -0
  343. package/core/lib/utils/pwa/pwa.utils.js +88 -0
  344. package/core/lib/utils/script.utils.js +235 -0
  345. package/core/lib/utils/setting.utils.js +69 -0
  346. package/core/lib/utils/upload.utils.js +30 -0
  347. package/core/models/Preference/Preferences.js +46 -0
  348. package/core/models/base/base.js +399 -0
  349. package/core/models/base-clone-loader.js +107 -0
  350. package/core/models/base-clone.js +187 -0
  351. package/core/models/base-loader.js +97 -0
  352. package/core/models/core-scripts/core-scripts.js +150 -0
  353. package/core/models/dashboard/dashboard.js +187 -0
  354. package/core/models/detail-loader.js +88 -0
  355. package/core/models/groups.js +82 -0
  356. package/core/models/index.js +94 -0
  357. package/core/models/lookup-types/components/lookup-detail/lookup-detail.js +129 -0
  358. package/core/models/lookup-types/lookup-types.js +96 -0
  359. package/core/models/lookup-values/components/lookup-values-modal/lookup-values-modal.js +95 -0
  360. package/core/models/lookup-values/components/lookup-values-modal/lookup-values-modal.scss +0 -0
  361. package/core/models/lookup-values/lookup-values.js +92 -0
  362. package/core/models/menu-roles/components/menu-roles-add/menu-roles-add.js +153 -0
  363. package/core/models/menu-roles/components/menu-roles-add/menu-roles-add.scss +0 -0
  364. package/core/models/menu-roles/menu-roles.js +158 -0
  365. package/core/models/menus/components/menu-add/menu-add.js +325 -0
  366. package/core/models/menus/components/menu-add/menu-add.scss +31 -0
  367. package/core/models/menus/components/menu-detail/menu-detail.js +263 -0
  368. package/core/models/menus/components/menu-list/menu-list.js +392 -0
  369. package/core/models/menus/components/menu-lists/menu-lists.js +429 -0
  370. package/core/models/menus/components/menu-lists/menu-lists.scss +41 -0
  371. package/core/models/menus/menus.js +291 -0
  372. package/core/models/model-columns.js +121 -0
  373. package/core/models/models/components/model-detail/model-add.js +120 -0
  374. package/core/models/models/components/model-detail/model-detail.js +133 -0
  375. package/core/models/models/components/model-detail/model-detail.scss +0 -0
  376. package/core/models/models/models.js +154 -0
  377. package/core/models/pages/components/page-add/page-add.js +163 -0
  378. package/core/models/pages/components/page-add/page-add.scss +31 -0
  379. package/core/models/pages/components/page-details/page-details.js +210 -0
  380. package/core/models/pages/components/page-list/page-list.js +248 -0
  381. package/core/models/pages/pages.js +142 -0
  382. package/core/models/pages/pages.scss +0 -0
  383. package/core/models/pages.js +142 -0
  384. package/core/models/roles/components/role-add/role-add.js +248 -0
  385. package/core/models/roles/components/role-list/role-list.js +408 -0
  386. package/core/models/roles/roles.js +188 -0
  387. package/core/models/user-roles/components/user-roles-add/user-roles-add.js +149 -0
  388. package/core/models/user-roles/components/user-roles-add/user-roles-add.scss +0 -0
  389. package/core/models/user-roles/user-roles.js +99 -0
  390. package/core/models/users/components/user-add/user-add.js +458 -0
  391. package/core/models/users/components/user-detail/user-detail.js +236 -0
  392. package/core/models/users/components/user-detail/user-detail.scss +0 -0
  393. package/core/models/users/components/user-list/user-list.js +397 -0
  394. package/core/models/users/users.js +185 -0
  395. package/core/modules/Informations/change-info/change-info.js +618 -0
  396. package/core/modules/Informations/change-info/change-info.scss +135 -0
  397. package/core/modules/dashboard/components/dashboard-card/animations.js +65 -0
  398. package/core/modules/dashboard/components/dashboard-card/dashboard-card.js +197 -0
  399. package/core/modules/dashboard/components/dashboard-card/menu-dashboard-card.js +430 -0
  400. package/core/modules/dashboard/components/dashboard-card/menu-dashboard-card.scss +60 -0
  401. package/core/modules/dashboard/components/pop-query-dashboard/pop-query-dashboard.js +66 -0
  402. package/core/modules/generic/components/generic-add/generic-add.js +121 -0
  403. package/core/modules/generic/components/generic-add/generic-add.scss +13 -0
  404. package/core/modules/generic/components/generic-add-modal/generic-add-modal.js +125 -0
  405. package/core/modules/generic/components/generic-add-modal/generic-add-modal.scss +13 -0
  406. package/core/modules/generic/components/generic-detail/generic-detail.js +184 -0
  407. package/core/modules/generic/components/generic-detail/generic-detail.scss +25 -0
  408. package/core/modules/generic/components/generic-edit/generic-edit.js +123 -0
  409. package/core/modules/generic/components/generic-edit/generic-edit.scss +0 -0
  410. package/core/modules/generic/components/generic-list/generic-list.js +335 -0
  411. package/core/modules/generic/components/generic-list/generic-list.scss +35 -0
  412. package/core/modules/index.js +54 -0
  413. package/core/modules/module-routes/module-routes.js +37 -0
  414. package/core/modules/module-routes/module-routes.scss +0 -0
  415. package/core/modules/reporting/components/reporting-dashboard/reporting-dashboard.js +1101 -0
  416. package/core/modules/reporting/components/reporting-dashboard/reporting-dashboard.scss +171 -0
  417. package/core/pages/homepage-api/homepage-api.js +106 -0
  418. package/core/pages/homepage-api/homepage-api.scss +234 -0
  419. package/core/pages/homepage-api/menu-dashboard.js +169 -0
  420. package/core/pages/homepage-api/menu-dashboard.scss +12 -0
  421. package/core/translation.json +54 -0
  422. package/core/translations.json +20 -0
  423. package/core/utils/script.utils.js +130 -0
  424. package/core/utils/settings.utils.js +26 -0
  425. package/eslint.config.mjs +79 -0
  426. package/index.js +36 -0
  427. package/package.json +118 -0
  428. package/tsconfig.json +27 -0
  429. package/webpack.config.js +174 -0
@@ -0,0 +1,757 @@
1
+ ### React/JSX Style Guide
2
+
3
+ *A mostly reasonable approach to React and JSX*
4
+
5
+ This style guide is mostly based on the standards that are currently prevalent in JavaScript, although some conventions (i.e async/await or static class fields) may still be included or prohibited on a case-by-case basis. Currently, anything prior to stage 3 is not included nor recommended in this guide.
6
+
7
+ ## Table of Contents
8
+
9
+ 1. [Basic Rules](#basic-rules)
10
+ 1. [Class vs `React.createClass` vs stateless](#class-vs-reactcreateclass-vs-stateless)
11
+ 1. [Mixins](#mixins)
12
+ 1. [Naming](#naming)
13
+ 1. [Declaration](#declaration)
14
+ 1. [Alignment](#alignment)
15
+ 1. [Quotes](#quotes)
16
+ 1. [Spacing](#spacing)
17
+ 1. [Props](#props)
18
+ 1. [Refs](#refs)
19
+ 1. [Parentheses](#parentheses)
20
+ 1. [Tags](#tags)
21
+ 1. [Methods](#methods)
22
+ 1. [Ordering](#ordering)
23
+ 1. [`isMounted`](#ismounted)
24
+
25
+ ## Basic Rules
26
+
27
+ - Only include one React component per file.
28
+ - However, multiple [Stateless, or Pure, Components](https://facebook.github.io/react/docs/reusable-components.html#stateless-functions) are allowed per file. eslint: [`react/no-multi-comp`](https://github.com/yannickcr/eslint-plugin-react/blob/master/docs/rules/no-multi-comp.md#ignorestateless).
29
+ - Always use JSX syntax.
30
+ - Do not use `React.createElement` unless you’re initializing the app from a file that is not JSX.
31
+ - [`react/forbid-prop-types`](https://github.com/yannickcr/eslint-plugin-react/blob/master/docs/rules/forbid-prop-types.md) will allow `arrays` and `objects` only if it is explicitly noted what `array` and `object` contains, using `arrayOf`, `objectOf`, or `shape`.
32
+
33
+ ## Class vs `React.createClass` vs stateless
34
+
35
+ - If you have internal state and/or refs, prefer `class extends React.Component` over `React.createClass`. eslint: [`react/prefer-es6-class`](https://github.com/yannickcr/eslint-plugin-react/blob/master/docs/rules/prefer-es6-class.md) [`react/prefer-stateless-function`](https://github.com/yannickcr/eslint-plugin-react/blob/master/docs/rules/prefer-stateless-function.md)
36
+
37
+ ```jsx static
38
+ // bad
39
+ const Listing = React.createClass({
40
+ // ...
41
+ render() {
42
+ return <div>{this.state.hello}</div>;
43
+ }
44
+ });
45
+
46
+ // good
47
+ class Listing extends React.Component {
48
+ // ...
49
+ render() {
50
+ return <div>{this.state.hello}</div>;
51
+ }
52
+ }
53
+ ```
54
+
55
+ And if you don’t have state or refs, prefer normal functions (not arrow functions) over classes:
56
+
57
+ ```jsx static
58
+ // bad
59
+ class Listing extends React.Component {
60
+ render() {
61
+ return <div>{this.props.hello}</div>;
62
+ }
63
+ }
64
+
65
+ // bad (relying on function name inference is discouraged)
66
+ const Listing = ({ hello }) => (
67
+ <div>{hello}</div>
68
+ );
69
+
70
+ // good
71
+ function Listing({ hello }) {
72
+ return <div>{hello}</div>;
73
+ }
74
+ ```
75
+
76
+ ## Mixins
77
+
78
+ - [Do not use mixins](https://facebook.github.io/react/blog/2016/07/13/mixins-considered-harmful.html).
79
+
80
+ > Why? Mixins introduce implicit dependencies, cause name clashes, and cause snowballing complexity. Most use cases for mixins can be accomplished in better ways via components, higher-order components, or utility modules.
81
+
82
+ ## Naming
83
+
84
+ - **Extensions**: Use `.jsx` extension for React components. eslint: [`react/jsx-filename-extension`](https://github.com/yannickcr/eslint-plugin-react/blob/master/docs/rules/jsx-filename-extension.md)
85
+ - **Filename**: Use PascalCase for filenames. E.g., `ReservationCard.jsx`.
86
+ - **Reference Naming**: Use PascalCase for React components and camelCase for their instances. eslint: [`react/jsx-pascal-case`](https://github.com/yannickcr/eslint-plugin-react/blob/master/docs/rules/jsx-pascal-case.md)
87
+
88
+ ```jsx static
89
+ // bad
90
+ import reservationCard from './ReservationCard';
91
+
92
+ // good
93
+ import ReservationCard from './ReservationCard';
94
+
95
+ // bad
96
+ const ReservationItem = <ReservationCard />;
97
+
98
+ // good
99
+ const reservationItem = <ReservationCard />;
100
+ ```
101
+
102
+ - **Component Naming**: Use the filename as the component name. For example, `ReservationCard.jsx` should have a reference name of `ReservationCard`. However, for root components of a directory, use `index.jsx` as the filename and use the directory name as the component name:
103
+
104
+ ```jsx static
105
+ // bad
106
+ import Footer from './Footer/Footer';
107
+
108
+ // bad
109
+ import Footer from './Footer/index';
110
+
111
+ // good
112
+ import Footer from './Footer';
113
+ ```
114
+
115
+ - **Higher-order Component Naming**: Use a composite of the higher-order component’s name and the passed-in component’s name as the `displayName` on the generated component. For example, the higher-order component `withFoo()`, when passed a component `Bar` should produce a component with a `displayName` of `withFoo(Bar)`.
116
+
117
+ > Why? A component’s `displayName` may be used by developer tools or in error messages, and having a value that clearly expresses this relationship helps people understand what is happening.
118
+
119
+ ```jsx static
120
+ // bad
121
+ export default function withFoo(WrappedComponent) {
122
+ return function WithFoo(props) {
123
+ return <WrappedComponent {...props} foo />;
124
+ }
125
+ }
126
+
127
+ // good
128
+ export default function withFoo(WrappedComponent) {
129
+ function WithFoo(props) {
130
+ return <WrappedComponent {...props} foo />;
131
+ }
132
+
133
+ const wrappedComponentName = WrappedComponent.displayName
134
+ || WrappedComponent.name
135
+ || 'Component';
136
+
137
+ WithFoo.displayName = `withFoo(${wrappedComponentName})`;
138
+ return WithFoo;
139
+ }
140
+ ```
141
+
142
+ - **Props Naming**: Avoid using DOM component prop names for different purposes.
143
+
144
+ > Why? People expect props like `style` and `className` to mean one specific thing. Varying this API for a subset of your app makes the code less readable and less maintainable, and may cause bugs.
145
+
146
+ ```jsx static
147
+ // bad
148
+ <MyComponent style="fancy" />
149
+
150
+ // bad
151
+ <MyComponent className="fancy" />
152
+
153
+ // good
154
+ <MyComponent variant="fancy" />
155
+ ```
156
+
157
+ ## Declaration
158
+
159
+ - Do not use `displayName` for naming components. Instead, name the component by reference.
160
+
161
+ ```jsx static
162
+ // bad
163
+ export default React.createClass({
164
+ displayName: 'ReservationCard',
165
+ // stuff goes here
166
+ });
167
+
168
+ // good
169
+ export default class ReservationCard extends React.Component {
170
+ }
171
+ ```
172
+
173
+ ## Alignment
174
+
175
+ - Follow these alignment styles for JSX syntax. eslint: [`react/jsx-closing-bracket-location`](https://github.com/yannickcr/eslint-plugin-react/blob/master/docs/rules/jsx-closing-bracket-location.md) [`react/jsx-closing-tag-location`](https://github.com/yannickcr/eslint-plugin-react/blob/master/docs/rules/jsx-closing-tag-location.md)
176
+
177
+ ```jsx static
178
+ // bad
179
+ <Foo superLongParam="bar"
180
+ anotherSuperLongParam="baz" />
181
+
182
+ // good
183
+ <Foo
184
+ superLongParam="bar"
185
+ anotherSuperLongParam="baz"
186
+ />
187
+
188
+ // if props fit in one line then keep it on the same line
189
+ <Foo bar="bar" />
190
+
191
+ // children get indented normally
192
+ <Foo
193
+ superLongParam="bar"
194
+ anotherSuperLongParam="baz"
195
+ >
196
+ <Quux />
197
+ </Foo>
198
+
199
+ // bad
200
+ {showButton &&
201
+ <Button />
202
+ }
203
+
204
+ // bad
205
+ {
206
+ showButton &&
207
+ <Button />
208
+ }
209
+
210
+ // good
211
+ {showButton && (
212
+ <Button />
213
+ )}
214
+
215
+ // good
216
+ {showButton && <Button />}
217
+
218
+ // good
219
+ {someReallyLongConditional
220
+ && anotherLongConditional
221
+ && (
222
+ <Foo
223
+ superLongParam="bar"
224
+ anotherSuperLongParam="baz"
225
+ />
226
+ )
227
+ }
228
+
229
+ // good
230
+ {someConditional ? (
231
+ <Foo />
232
+ ) : (
233
+ <Foo
234
+ superLongParam="bar"
235
+ anotherSuperLongParam="baz"
236
+ />
237
+ )}
238
+ ```
239
+
240
+ ## Quotes
241
+
242
+ - Always use double quotes (`"`) for JSX attributes, but single quotes (`'`) for all other JS. eslint: [`jsx-quotes`](https://eslint.org/docs/rules/jsx-quotes)
243
+
244
+ > Why? Regular HTML attributes also typically use double quotes instead of single, so JSX attributes mirror this convention.
245
+
246
+ ```jsx static
247
+ // bad
248
+ <Foo bar='bar' />
249
+
250
+ // good
251
+ <Foo bar="bar" />
252
+
253
+ // bad
254
+ <Foo style={{ left: "20px" }} />
255
+
256
+ // good
257
+ <Foo style={{ left: '20px' }} />
258
+ ```
259
+
260
+ ## Spacing
261
+
262
+ - Always include a single space in your self-closing tag. eslint: [`no-multi-spaces`](https://eslint.org/docs/rules/no-multi-spaces), [`react/jsx-tag-spacing`](https://github.com/yannickcr/eslint-plugin-react/blob/master/docs/rules/jsx-tag-spacing.md)
263
+
264
+ ```jsx static
265
+ // bad
266
+ <Foo/>
267
+
268
+ // very bad
269
+ <Foo />
270
+
271
+ // bad
272
+ <Foo
273
+ />
274
+
275
+ // good
276
+ <Foo />
277
+ ```
278
+
279
+ - Do not pad JSX curly braces with spaces. eslint: [`react/jsx-curly-spacing`](https://github.com/yannickcr/eslint-plugin-react/blob/master/docs/rules/jsx-curly-spacing.md)
280
+
281
+ ```jsx static
282
+ // bad
283
+ <Foo bar={ baz } />
284
+
285
+ // good
286
+ <Foo bar={baz} />
287
+ ```
288
+
289
+ ## Props
290
+
291
+ - Always use camelCase for prop names, or PascalCase if the prop value is a React component.
292
+
293
+ ```jsx static
294
+ // bad
295
+ <Foo
296
+ UserName="hello"
297
+ phone_number={12345678}
298
+ />
299
+
300
+ // good
301
+ <Foo
302
+ userName="hello"
303
+ phoneNumber={12345678}
304
+ Component={SomeComponent}
305
+ />
306
+ ```
307
+
308
+ - Omit the value of the prop when it is explicitly `true`. eslint: [`react/jsx-boolean-value`](https://github.com/yannickcr/eslint-plugin-react/blob/master/docs/rules/jsx-boolean-value.md)
309
+
310
+ ```jsx static
311
+ // bad
312
+ <Foo
313
+ hidden={true}
314
+ />
315
+
316
+ // good
317
+ <Foo
318
+ hidden
319
+ />
320
+
321
+ // good
322
+ <Foo hidden />
323
+ ```
324
+
325
+ - Always include an `alt` prop on `<img>` tags. If the image is presentational, `alt` can be an empty string or the `<img>` must have `role="presentation"`. eslint: [`jsx-a11y/alt-text`](https://github.com/evcohen/eslint-plugin-jsx-a11y/blob/master/docs/rules/alt-text.md)
326
+
327
+ ```jsx static
328
+ // bad
329
+ <img src="hello.jpg" />
330
+
331
+ // good
332
+ <img src="hello.jpg" alt="Me waving hello" />
333
+
334
+ // good
335
+ <img src="hello.jpg" alt="" />
336
+
337
+ // good
338
+ <img src="hello.jpg" role="presentation" />
339
+ ```
340
+
341
+ - Do not use words like "image", "photo", or "picture" in `<img>` `alt` props. eslint: [`jsx-a11y/img-redundant-alt`](https://github.com/evcohen/eslint-plugin-jsx-a11y/blob/master/docs/rules/img-redundant-alt.md)
342
+
343
+ > Why? Screenreaders already announce `img` elements as images, so there is no need to include this information in the alt text.
344
+
345
+ ```jsx static
346
+ // bad
347
+ <img src="hello.jpg" alt="Picture of me waving hello" />
348
+
349
+ // good
350
+ <img src="hello.jpg" alt="Me waving hello" />
351
+ ```
352
+
353
+ - Use only valid, non-abstract [ARIA roles](https://www.w3.org/TR/wai-aria/#usage_intro). eslint: [`jsx-a11y/aria-role`](https://github.com/evcohen/eslint-plugin-jsx-a11y/blob/master/docs/rules/aria-role.md)
354
+
355
+ ```jsx static
356
+ // bad - not an ARIA role
357
+ <div role="datepicker" />
358
+
359
+ // bad - abstract ARIA role
360
+ <div role="range" />
361
+
362
+ // good
363
+ <div role="button" />
364
+ ```
365
+
366
+ - Do not use `accessKey` on elements. eslint: [`jsx-a11y/no-access-key`](https://github.com/evcohen/eslint-plugin-jsx-a11y/blob/master/docs/rules/no-access-key.md)
367
+
368
+ > Why? Inconsistencies between keyboard shortcuts and keyboard commands used by people using screenreaders and keyboards complicate accessibility.
369
+
370
+ ```jsx static
371
+ // bad
372
+ <div accessKey="h" />
373
+
374
+ // good
375
+ <div />
376
+ ```
377
+
378
+ - Avoid using an array index as `key` prop, prefer a stable ID. eslint: [`react/no-array-index-key`](https://github.com/yannickcr/eslint-plugin-react/blob/master/docs/rules/no-array-index-key.md)
379
+
380
+ > Why? Not using a stable ID [is an anti-pattern](https://medium.com/@robinpokorny/index-as-a-key-is-an-anti-pattern-e0349aece318) because it can negatively impact performance and cause issues with component state.
381
+
382
+ We don’t recommend using indexes for keys if the order of items may change.
383
+
384
+ ```jsx static
385
+ // bad
386
+ {todos.map((todo, index) =>
387
+ <Todo
388
+ {...todo}
389
+ key={index}
390
+ />
391
+ )}
392
+
393
+ // good
394
+ {todos.map(todo => (
395
+ <Todo
396
+ {...todo}
397
+ key={todo.id}
398
+ />
399
+ ))}
400
+ ```
401
+
402
+ - Always define explicit defaultProps for all non-required props.
403
+
404
+ > Why? propTypes are a form of documentation, and providing defaultProps means the reader of your code doesn’t have to assume as much. In addition, it can mean that your code can omit certain type checks.
405
+
406
+ ```jsx static
407
+ // bad
408
+ function SFC({ foo, bar, children }) {
409
+ return <div>{foo}{bar}{children}</div>;
410
+ }
411
+ SFC.propTypes = {
412
+ foo: PropTypes.number.isRequired,
413
+ bar: PropTypes.string,
414
+ children: PropTypes.node,
415
+ };
416
+
417
+ // good
418
+ function SFC({ foo, bar, children }) {
419
+ return <div>{foo}{bar}{children}</div>;
420
+ }
421
+ SFC.propTypes = {
422
+ foo: PropTypes.number.isRequired,
423
+ bar: PropTypes.string,
424
+ children: PropTypes.node,
425
+ };
426
+ SFC.defaultProps = {
427
+ bar: '',
428
+ children: null,
429
+ };
430
+ ```
431
+
432
+ - Use spread props sparingly.
433
+ > Why? Otherwise you’re more likely to pass unnecessary props down to components. And for React v15.6.1 and older, you could [pass invalid HTML attributes to the DOM](https://reactjs.org/blog/2017/09/08/dom-attributes-in-react-16.html).
434
+
435
+ Exceptions:
436
+
437
+ - HOCs that proxy down props and hoist propTypes
438
+
439
+ ```jsx static
440
+ function HOC(WrappedComponent) {
441
+ return class Proxy extends React.Component {
442
+ Proxy.propTypes = {
443
+ text: PropTypes.string,
444
+ isLoading: PropTypes.bool
445
+ };
446
+
447
+ render() {
448
+ return <WrappedComponent {...this.props} />
449
+ }
450
+ }
451
+ }
452
+ ```
453
+
454
+ - Spreading objects with known, explicit props. This can be particularly useful when testing React components with Mocha’s beforeEach construct.
455
+
456
+ ```jsx static
457
+ export default function Foo {
458
+ const props = {
459
+ text: '',
460
+ isPublished: false
461
+ }
462
+
463
+ return (<div {...props} />);
464
+ }
465
+ ```
466
+
467
+ Notes for use:
468
+ Filter out unnecessary props when possible. Also, use [prop-types-exact](https://www.npmjs.com/package/prop-types-exact) to help prevent bugs.
469
+
470
+ ```jsx static
471
+ // bad
472
+ render() {
473
+ const { irrelevantProp, ...relevantProps } = this.props;
474
+ return <WrappedComponent {...this.props} />
475
+ }
476
+
477
+ // good
478
+ render() {
479
+ const { irrelevantProp, ...relevantProps } = this.props;
480
+ return <WrappedComponent {...relevantProps} />
481
+ }
482
+ ```
483
+
484
+ ## Refs
485
+
486
+ - Always use ref callbacks. eslint: [`react/no-string-refs`](https://github.com/yannickcr/eslint-plugin-react/blob/master/docs/rules/no-string-refs.md)
487
+
488
+ ```jsx static
489
+ // bad
490
+ <Foo
491
+ ref="myRef"
492
+ />
493
+
494
+ // good
495
+ <Foo
496
+ ref={(ref) => { this.myRef = ref; }}
497
+ />
498
+ ```
499
+
500
+ ## Parentheses
501
+
502
+ - Wrap JSX tags in parentheses when they span more than one line. eslint: [`react/jsx-wrap-multilines`](https://github.com/yannickcr/eslint-plugin-react/blob/master/docs/rules/jsx-wrap-multilines.md)
503
+
504
+ ```jsx static
505
+ // bad
506
+ render() {
507
+ return <MyComponent variant="long body" foo="bar">
508
+ <MyChild />
509
+ </MyComponent>;
510
+ }
511
+
512
+ // good
513
+ render() {
514
+ return (
515
+ <MyComponent variant="long body" foo="bar">
516
+ <MyChild />
517
+ </MyComponent>
518
+ );
519
+ }
520
+
521
+ // good, when single line
522
+ render() {
523
+ const body = <div>hello</div>;
524
+ return <MyComponent>{body}</MyComponent>;
525
+ }
526
+ ```
527
+
528
+ ## Tags
529
+
530
+ - Always self-close tags that have no children. eslint: [`react/self-closing-comp`](https://github.com/yannickcr/eslint-plugin-react/blob/master/docs/rules/self-closing-comp.md)
531
+
532
+ ```jsx static
533
+ // bad
534
+ <Foo variant="stuff"></Foo>
535
+
536
+ // good
537
+ <Foo variant="stuff" />
538
+ ```
539
+
540
+ - If your component has multiline properties, close its tag on a new line. eslint: [`react/jsx-closing-bracket-location`](https://github.com/yannickcr/eslint-plugin-react/blob/master/docs/rules/jsx-closing-bracket-location.md)
541
+
542
+ ```jsx static
543
+ // bad
544
+ <Foo
545
+ bar="bar"
546
+ baz="baz" />
547
+
548
+ // good
549
+ <Foo
550
+ bar="bar"
551
+ baz="baz"
552
+ />
553
+ ```
554
+
555
+ ## Methods
556
+
557
+ - Use arrow functions to close over local variables. It is handy when you need to pass additional data to an event handler. Although, make sure they [do not massively hurt performance](https://www.bignerdranch.com/blog/choosing-the-best-approach-for-react-event-handlers/), in particular when passed to custom components that might be PureComponents, because they will trigger a possibly needless rerender every time.
558
+
559
+ ```jsx static
560
+ function ItemList(props) {
561
+ return (
562
+ <ul>
563
+ {props.items.map((item, index) => (
564
+ <Item
565
+ key={item.key}
566
+ onClick={(event) => { doSomethingWith(event, item.name, index); }}
567
+ />
568
+ ))}
569
+ </ul>
570
+ );
571
+ }
572
+ ```
573
+
574
+ - Bind event handlers for the render method in the constructor. eslint: [`react/jsx-no-bind`](https://github.com/yannickcr/eslint-plugin-react/blob/master/docs/rules/jsx-no-bind.md)
575
+
576
+ > Why? A bind call in the render path creates a brand new function on every single render. Do not use arrow functions in class fields, because it makes them [challenging to test and debug, and can negatively impact performance](https://medium.com/@charpeni/arrow-functions-in-class-properties-might-not-be-as-great-as-we-think-3b3551c440b1), and because conceptually, class fields are for data, not logic.
577
+
578
+ ```jsx static
579
+ // bad
580
+ class extends React.Component {
581
+ onClickDiv() {
582
+ // do stuff
583
+ }
584
+
585
+ render() {
586
+ return <div onClick={this.onClickDiv.bind(this)} />;
587
+ }
588
+ }
589
+
590
+ // very bad
591
+ class extends React.Component {
592
+ onClickDiv = () => {
593
+ // do stuff
594
+ }
595
+
596
+ render() {
597
+ return <div onClick={this.onClickDiv} />
598
+ }
599
+ }
600
+
601
+ // good
602
+ class extends React.Component {
603
+ constructor(props) {
604
+ super(props);
605
+
606
+ this.onClickDiv = this.onClickDiv.bind(this);
607
+ }
608
+
609
+ onClickDiv() {
610
+ // do stuff
611
+ }
612
+
613
+ render() {
614
+ return <div onClick={this.onClickDiv} />;
615
+ }
616
+ }
617
+ ```
618
+
619
+ - Do not use underscore prefix for internal methods of a React component.
620
+ > Why? Underscore prefixes are sometimes used as a convention in other languages to denote privacy. But, unlike those languages, there is no native support for privacy in JavaScript, everything is public. Regardless of your intentions, adding underscore prefixes to your properties does not actually make them private, and any property (underscore-prefixed or not) should be treated as being public. See issues [#1024](https://github.com/airbnb/javascript/issues/1024), and [#490](https://github.com/airbnb/javascript/issues/490) for a more in-depth discussion.
621
+
622
+ ```jsx static
623
+ // bad
624
+ React.createClass({
625
+ _onClickSubmit() {
626
+ // do stuff
627
+ },
628
+
629
+ // other stuff
630
+ });
631
+
632
+ // good
633
+ class extends React.Component {
634
+ onClickSubmit() {
635
+ // do stuff
636
+ }
637
+
638
+ // other stuff
639
+ }
640
+ ```
641
+
642
+ - Be sure to return a value in your `render` methods. eslint: [`react/require-render-return`](https://github.com/yannickcr/eslint-plugin-react/blob/master/docs/rules/require-render-return.md)
643
+
644
+ ```jsx static
645
+ // bad
646
+ render() {
647
+ (<div />);
648
+ }
649
+
650
+ // good
651
+ render() {
652
+ return (<div />);
653
+ }
654
+ ```
655
+
656
+ ## Ordering
657
+
658
+ - Ordering for `class extends React.Component`:
659
+
660
+ 1. optional `static` methods
661
+ 1. `constructor`
662
+ 1. `getChildContext`
663
+ 1. `componentWillMount`
664
+ 1. `componentDidMount`
665
+ 1. `componentWillReceiveProps`
666
+ 1. `shouldComponentUpdate`
667
+ 1. `componentWillUpdate`
668
+ 1. `componentDidUpdate`
669
+ 1. `componentWillUnmount`
670
+ 1. *event handlers starting with 'handle'* like `handleSubmit()` or `handleChangeDescription()`
671
+ 1. *event handlers starting with 'on'* like `onClickSubmit()` or `onChangeDescription()`
672
+ 1. *getter methods for `render`* like `getSelectReason()` or `getFooterContent()`
673
+ 1. *optional render methods* like `renderNavigation()` or `renderProfilePicture()`
674
+ 1. `render`
675
+
676
+ - How to define `propTypes`, `defaultProps`, `contextTypes`, etc...
677
+
678
+ ```jsx static
679
+ import React from 'react';
680
+ import PropTypes from 'prop-types';
681
+
682
+ const propTypes = {
683
+ id: PropTypes.number.isRequired,
684
+ url: PropTypes.string.isRequired,
685
+ text: PropTypes.string,
686
+ };
687
+
688
+ const defaultProps = {
689
+ text: 'Hello World',
690
+ };
691
+
692
+ class Link extends React.Component {
693
+ static methodsAreOk() {
694
+ return true;
695
+ }
696
+
697
+ render() {
698
+ return <a href={this.props.url} data-id={this.props.id}>{this.props.text}</a>;
699
+ }
700
+ }
701
+
702
+ Link.propTypes = propTypes;
703
+ Link.defaultProps = defaultProps;
704
+
705
+ export default Link;
706
+ ```
707
+
708
+ - Ordering for `React.createClass`: eslint: [`react/sort-comp`](https://github.com/yannickcr/eslint-plugin-react/blob/master/docs/rules/sort-comp.md)
709
+
710
+ 1. `displayName`
711
+ 1. `propTypes`
712
+ 1. `contextTypes`
713
+ 1. `childContextTypes`
714
+ 1. `mixins`
715
+ 1. `statics`
716
+ 1. `defaultProps`
717
+ 1. `getDefaultProps`
718
+ 1. `getInitialState`
719
+ 1. `getChildContext`
720
+ 1. `componentWillMount`
721
+ 1. `componentDidMount`
722
+ 1. `componentWillReceiveProps`
723
+ 1. `shouldComponentUpdate`
724
+ 1. `componentWillUpdate`
725
+ 1. `componentDidUpdate`
726
+ 1. `componentWillUnmount`
727
+ 1. *clickHandlers or eventHandlers* like `onClickSubmit()` or `onChangeDescription()`
728
+ 1. *getter methods for `render`* like `getSelectReason()` or `getFooterContent()`
729
+ 1. *optional render methods* like `renderNavigation()` or `renderProfilePicture()`
730
+ 1. `render`
731
+
732
+ ## `isMounted`
733
+
734
+ - Do not use `isMounted`. eslint: [`react/no-is-mounted`](https://github.com/yannickcr/eslint-plugin-react/blob/master/docs/rules/no-is-mounted.md)
735
+
736
+ > Why? [`isMounted` is an anti-pattern][anti-pattern], is not available when using ES6 classes, and is on its way to being officially deprecated.
737
+
738
+ [anti-pattern]: https://facebook.github.io/react/blog/2015/12/16/ismounted-antipattern.html
739
+
740
+ <!-- ## Translation
741
+
742
+ This JSX/React style guide is also available in other languages:
743
+
744
+ - ![cn](https://raw.githubusercontent.com/gosquared/flags/master/flags/flags/shiny/24/China.png) **Chinese (Simplified)**: [jhcccc/javascript](https://github.com/jhcccc/javascript/tree/master/react)
745
+ - ![tw](https://raw.githubusercontent.com/gosquared/flags/master/flags/flags/shiny/24/Taiwan.png) **Chinese (Traditional)**: [jigsawye/javascript](https://github.com/jigsawye/javascript/tree/master/react)
746
+ - ![es](https://raw.githubusercontent.com/gosquared/flags/master/flags/flags/shiny/24/Spain.png) **Español**: [agrcrobles/javascript](https://github.com/agrcrobles/javascript/tree/master/react)
747
+ - ![jp](https://raw.githubusercontent.com/gosquared/flags/master/flags/flags/shiny/24/Japan.png) **Japanese**: [mitsuruog/javascript-style-guide](https://github.com/mitsuruog/javascript-style-guide/tree/master/react)
748
+ - ![kr](https://raw.githubusercontent.com/gosquared/flags/master/flags/flags/shiny/24/South-Korea.png) **Korean**: [apple77y/javascript](https://github.com/apple77y/javascript/tree/master/react)
749
+ - ![pl](https://raw.githubusercontent.com/gosquared/flags/master/flags/flags/shiny/24/Poland.png) **Polish**: [pietraszekl/javascript](https://github.com/pietraszekl/javascript/tree/master/react)
750
+ - ![Br](https://raw.githubusercontent.com/gosquared/flags/master/flags/flags/shiny/24/Brazil.png) **Portuguese**: [ronal2do/javascript](https://github.com/ronal2do/airbnb-react-styleguide)
751
+ - ![ru](https://raw.githubusercontent.com/gosquared/flags/master/flags/flags/shiny/24/Russia.png) **Russian**: [leonidlebedev/javascript-airbnb](https://github.com/leonidlebedev/javascript-airbnb/tree/master/react)
752
+ - ![th](https://raw.githubusercontent.com/gosquared/flags/master/flags/flags/shiny/24/Thailand.png) **Thai**: [lvarayut/javascript-style-guide](https://github.com/lvarayut/javascript-style-guide/tree/master/react)
753
+ - ![tr](https://raw.githubusercontent.com/gosquared/flags/master/flags/flags/shiny/24/Turkey.png) **Turkish**: [alioguzhan/react-style-guide](https://github.com/alioguzhan/react-style-guide)
754
+ - ![ua](https://raw.githubusercontent.com/gosquared/flags/master/flags/flags/shiny/24/Ukraine.png) **Ukrainian**: [ivanzusko/javascript](https://github.com/ivanzusko/javascript/tree/master/react)
755
+ - ![vn](https://raw.githubusercontent.com/gosquared/flags/master/flags/flags/shiny/24/Vietnam.png) **Vietnam**: [uetcodecamp/jsx-style-guide](https://github.com/UETCodeCamp/jsx-style-guide) -->
756
+
757
+ **[⬆ back to top](#table-of-contents)**