abstractMenuBuilder.ts 4.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171
  1. import type { RuntimeConfig } from '@nuxt/schema'
  2. import type { AnyAbility } from '@casl/ability'
  3. import type { Router } from 'vue-router'
  4. import type {
  5. IconItem,
  6. MenuBuilder,
  7. MenuGroup,
  8. MenuItem,
  9. MenuItems,
  10. } from '~/types/layout'
  11. import { MENU_LINK_TYPE } from '~/types/enum/layout'
  12. import UrlUtils from '~/services/utils/urlUtils'
  13. import type { AccessProfile, organizationState } from '~/types/interfaces'
  14. /**
  15. * Classe de base des menus et sous-menus.
  16. *
  17. * La méthode principale est la méthode build
  18. */
  19. abstract class AbstractMenuBuilder implements MenuBuilder {
  20. protected runtimeConfig: RuntimeConfig
  21. protected ability: AnyAbility
  22. protected organizationProfile: organizationState
  23. protected accessProfile: AccessProfile
  24. protected router: Router
  25. /**
  26. * Nom court désignant le menu que construit ce builder
  27. */
  28. static readonly menuName: string
  29. constructor(
  30. runtimeConfig: RuntimeConfig,
  31. ability: AnyAbility,
  32. organizationProfile: organizationState,
  33. accessProfile: AccessProfile,
  34. router: Router,
  35. ) {
  36. this.runtimeConfig = runtimeConfig
  37. this.ability = ability
  38. this.organizationProfile = organizationProfile
  39. this.accessProfile = accessProfile
  40. this.router = router
  41. }
  42. /**
  43. * Permet un accès non statique à la variable menuName
  44. */
  45. public getMenuName(): string {
  46. return Object.getPrototypeOf(this).constructor.menuName
  47. }
  48. /**
  49. * Construit et retourne un menu ou sous-menu selon le profil de l'utilisateur, le profil de son organisation
  50. * et les droits de l'utilisateur.
  51. *
  52. * Si le menu comporte plusieurs éléments, retourne une instance de MenuGroup
  53. * Si le menu ne comporte qu'un seul élément, retourne une instance de MenuItem
  54. * Si le menu ne comporte aucun élément, retourne null.
  55. */
  56. abstract build(): MenuItem | MenuGroup | null
  57. /**
  58. * Construit et retourne un MenuGroup
  59. *
  60. * @param label
  61. * @param icon
  62. * @param {Array<MenuItem>} children Tableau d'ItemMenu représentant les sous menu du menu principal
  63. * @param actions
  64. */
  65. protected createGroup(
  66. label: string,
  67. icon?: IconItem,
  68. children: MenuItems = [],
  69. actions: Array<MenuItem> = [],
  70. ): MenuGroup {
  71. return { label, icon, children, actions }
  72. }
  73. /**
  74. * Construit et retourne un MenuItem
  75. *
  76. * @param {IconItem} icon
  77. * @param {string} label Titre qui sera traduit
  78. * @param to
  79. * @param type
  80. * @param noWarning
  81. * @return {MenuItem}
  82. */
  83. protected createItem(
  84. label: string,
  85. icon?: IconItem,
  86. to: string = '',
  87. type: MENU_LINK_TYPE = MENU_LINK_TYPE.INTERNAL,
  88. newTab: boolean = false,
  89. ): MenuItem {
  90. let url: string
  91. if (type === MENU_LINK_TYPE.INTERNAL) {
  92. console.warn(
  93. "'createItem()' should not be used for internal links, use 'addChildItemIfAllowed()'",
  94. )
  95. }
  96. switch (type) {
  97. case MENU_LINK_TYPE.V1:
  98. // eslint-disable-next-line no-case-declarations
  99. const v1BaseURL =
  100. this.runtimeConfig.baseUrlAdminLegacy ||
  101. this.runtimeConfig.public.baseUrlAdminLegacy
  102. url = UrlUtils.join(v1BaseURL, '#', to)
  103. break
  104. case MENU_LINK_TYPE.EXTERNAL:
  105. url = UrlUtils.prependHttps(to)
  106. break
  107. default:
  108. url = to
  109. }
  110. return {
  111. icon,
  112. label,
  113. to: url,
  114. type,
  115. active: false,
  116. target: newTab ? '_blank' : '_self',
  117. }
  118. }
  119. protected buildSubmenu(menuBuilder: typeof AbstractMenuBuilder) {
  120. // @ts-expect-error this method has to be called from non-abstract subclasses
  121. // eslint-disable-next-line new-cap
  122. const builder = new menuBuilder(
  123. this.runtimeConfig,
  124. this.ability,
  125. this.organizationProfile,
  126. this.accessProfile,
  127. )
  128. return builder.build()
  129. }
  130. /**
  131. * Make a list of MenuItems according to user abilities
  132. *
  133. * @param items
  134. * @protected
  135. */
  136. protected makeChildren(
  137. items: Array<{ pageName: string; icon?: string }>,
  138. ): MenuItems {
  139. const children: MenuItems = []
  140. items.forEach((item) => {
  141. const { pageName, icon } = item
  142. if (this.ability.can('display', pageName)) {
  143. const to = this.router.resolve({ name: pageName })
  144. if (!to) {
  145. throw new Error('unknown page name : ' + pageName)
  146. }
  147. children.push({
  148. icon: icon ? { name: icon } : undefined,
  149. label: pageName,
  150. to: to.href,
  151. type: MENU_LINK_TYPE.INTERNAL,
  152. active: false,
  153. })
  154. }
  155. })
  156. return children
  157. }
  158. }
  159. export default AbstractMenuBuilder