@sdcorejs/angular 19.3.5 → 19.3.6
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.
- package/assets/STYLE-GUIDE.md +78 -1
- package/assets/THEME.md +45 -3
- package/assets/scss/core/_popover-panel.scss +90 -0
- package/assets/scss/core/form.scss +5 -2
- package/assets/scss/core/utilities/_grid.scss +15 -0
- package/assets/scss/core/utilities/_sizing.scss +4 -0
- package/assets/scss/themes/_component-tokens.scss +9 -4
- package/assets/scss/themes/_semantic.scss +6 -5
- package/components/anchor/src/components/anchor/anchor.component.d.ts +6 -1
- package/components/button/src/button-item.component.d.ts +7 -1
- package/components/calendar/index.d.ts +12 -0
- package/components/calendar/src/calendar-edge-scroll.d.ts +27 -0
- package/components/calendar/src/calendar-format.d.ts +51 -0
- package/components/calendar/src/calendar-host.d.ts +33 -0
- package/components/calendar/src/calendar-loader.d.ts +18 -0
- package/components/calendar/src/calendar-move.d.ts +189 -0
- package/components/calendar/src/calendar.component.d.ts +325 -0
- package/components/calendar/src/calendar.configuration.d.ts +24 -0
- package/components/calendar/src/calendar.model.d.ts +121 -0
- package/components/calendar/src/calendar.templates.d.ts +65 -0
- package/components/calendar/src/calendar.utils.d.ts +242 -0
- package/components/card/index.d.ts +3 -0
- package/components/card/src/card-actions.directive.d.ts +13 -0
- package/components/card/src/card-group.component.d.ts +32 -1
- package/components/card/src/card.component.d.ts +71 -5
- package/components/card/src/card.configuration.d.ts +20 -0
- package/components/card/src/card.format.d.ts +50 -0
- package/components/card/src/card.model.d.ts +83 -0
- package/components/card/src/card.utils.d.ts +5 -0
- package/components/file-explorer/src/file-explorer.utils.d.ts +1 -4
- package/components/index.d.ts +3 -1
- package/components/kanban/src/kanban-card-outlet.d.ts +16 -0
- package/components/kanban/src/kanban-loader.d.ts +45 -0
- package/components/kanban/src/kanban.component.d.ts +97 -37
- package/components/kanban/src/kanban.model.d.ts +93 -37
- package/components/kanban/src/kanban.utils.d.ts +38 -5
- package/components/modal/src/modal.component.d.ts +10 -1
- package/components/query-bar/src/components/actions-bar/actions-bar.component.d.ts +6 -2
- package/components/query-bar/src/components/chip-popover/chip-popover.component.d.ts +26 -22
- package/components/query-bar/src/components/field-picker/field-picker.component.d.ts +52 -31
- package/components/query-bar/src/components/inline-chip/inline-chip.component.d.ts +20 -1
- package/components/query-bar/src/components/inline-value-chip/inline-value-chip.component.d.ts +5 -1
- package/components/query-bar/src/components/panel/query-panel.d.ts +110 -0
- package/components/query-bar/src/components/popover-chip/popover-chip.component.d.ts +15 -8
- package/components/query-bar/src/components/saved-filters-menu/saved-filters-menu.component.d.ts +35 -18
- package/components/query-bar/src/components/saved-filters-menu/saved-filters-storage.d.ts +13 -0
- package/components/query-bar/src/query-bar-filter.d.ts +8 -0
- package/components/query-bar/src/query-bar.component.d.ts +62 -7
- package/components/query-bar/src/query-bar.model.d.ts +2 -0
- package/components/quick-action/index.d.ts +2 -0
- package/components/quick-action/src/selection-bar/selection-bar.component.d.ts +39 -0
- package/components/quick-action/src/selection-bar/selection-bar.model.d.ts +24 -0
- package/components/scheduler/index.d.ts +4 -0
- package/components/scheduler/src/scheduler.component.d.ts +345 -0
- package/components/scheduler/src/scheduler.model.d.ts +123 -0
- package/components/scheduler/src/scheduler.templates.d.ts +76 -0
- package/components/scheduler/src/scheduler.utils.d.ts +99 -0
- package/components/tab/src/tab-group.component.d.ts +6 -1
- package/components/tab-router/src/utils/tab-activated-route.d.ts +17 -0
- package/components/table/src/components/filter/quick-search/quick-search.component.d.ts +3 -1
- package/components/table/src/components/selector-action/action-filter.pipe.d.ts +3 -24
- package/components/table/src/components/selector-action/selector-action.component.d.ts +0 -10
- package/components/table/src/configurations/table.configuration.d.ts +44 -2
- package/components/table/src/models/table-option.model.d.ts +6 -0
- package/components/table/src/services/config.service.d.ts +0 -2
- package/components/table/src/services/table-filter/table-filter-callbacks.util.d.ts +25 -0
- package/components/table/src/services/table-filter/table-filter.model.d.ts +9 -0
- package/components/table/src/services/table-filter/table-query-bar.util.d.ts +1 -1
- package/components/table/src/services/table-query-params/table-query-params.util.d.ts +48 -0
- package/components/table/src/table.component.d.ts +21 -5
- package/components/timeline/index.d.ts +3 -0
- package/components/timeline/src/timeline.component.d.ts +95 -0
- package/components/timeline/src/timeline.model.d.ts +82 -0
- package/components/timeline/src/timeline.templates.d.ts +28 -0
- package/components/timeline/src/timeline.utils.d.ts +41 -0
- package/components/tree/index.d.ts +1 -0
- package/components/tree/src/tree-empty-def.directive.d.ts +13 -0
- package/components/tree/src/tree.component.d.ts +79 -5
- package/components/tree/src/tree.model.d.ts +29 -0
- package/directives/src/sd-scroll-pointer.service.d.ts +18 -0
- package/directives/src/sd-scroll.directive.d.ts +4 -2
- package/fesm2022/sdcorejs-angular-components-anchor.mjs +61 -2
- package/fesm2022/sdcorejs-angular-components-anchor.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components-button.mjs +13 -5
- package/fesm2022/sdcorejs-angular-components-button.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components-calendar.mjs +2481 -0
- package/fesm2022/sdcorejs-angular-components-calendar.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-components-card.mjs +485 -22
- package/fesm2022/sdcorejs-angular-components-card.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components-editor-engine.mjs +1 -1
- package/fesm2022/sdcorejs-angular-components-editor-engine.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components-file-explorer.mjs +4 -18
- package/fesm2022/sdcorejs-angular-components-file-explorer.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components-form-generic.mjs +7 -7
- package/fesm2022/sdcorejs-angular-components-form-generic.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components-import-excel.mjs +1 -1
- package/fesm2022/sdcorejs-angular-components-import-excel.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components-kanban.mjs +832 -153
- package/fesm2022/sdcorejs-angular-components-kanban.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components-modal.mjs +23 -6
- package/fesm2022/sdcorejs-angular-components-modal.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components-query-bar.mjs +1304 -212
- package/fesm2022/sdcorejs-angular-components-query-bar.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components-quick-action.mjs +68 -2
- package/fesm2022/sdcorejs-angular-components-quick-action.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components-scheduler.mjs +1934 -0
- package/fesm2022/sdcorejs-angular-components-scheduler.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-components-side-drawer.mjs +2 -2
- package/fesm2022/sdcorejs-angular-components-side-drawer.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components-tab-router.mjs +126 -26
- package/fesm2022/sdcorejs-angular-components-tab-router.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components-tab.mjs +30 -1
- package/fesm2022/sdcorejs-angular-components-tab.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components-table.mjs +612 -101
- package/fesm2022/sdcorejs-angular-components-table.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components-timeline.mjs +473 -0
- package/fesm2022/sdcorejs-angular-components-timeline.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-components-tree.mjs +596 -35
- package/fesm2022/sdcorejs-angular-components-tree.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components-upload-file.mjs +2 -4
- package/fesm2022/sdcorejs-angular-components-upload-file.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components.mjs +3 -1
- package/fesm2022/sdcorejs-angular-components.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-directives.mjs +109 -22
- package/fesm2022/sdcorejs-angular-directives.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-forms-date.mjs +140 -42
- package/fesm2022/sdcorejs-angular-forms-date.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-forms-datetime.mjs +70 -21
- package/fesm2022/sdcorejs-angular-forms-datetime.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-forms-directives.mjs +4 -3
- package/fesm2022/sdcorejs-angular-forms-directives.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-forms-entity-picker.mjs +1 -1
- package/fesm2022/sdcorejs-angular-forms-entity-picker.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-forms-tree-select.mjs +1 -1
- package/fesm2022/sdcorejs-angular-forms-tree-select.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-i18n.mjs +622 -52
- package/fesm2022/sdcorejs-angular-i18n.mjs.map +1 -1
- package/fesm2022/{sdcorejs-angular-modules-generic-generic-configuration.page-Bk3PrEf3.mjs → sdcorejs-angular-modules-generic-generic-configuration.page-DHrM12Z3.mjs} +3 -3
- package/fesm2022/{sdcorejs-angular-modules-generic-generic-configuration.page-Bk3PrEf3.mjs.map → sdcorejs-angular-modules-generic-generic-configuration.page-DHrM12Z3.mjs.map} +1 -1
- package/fesm2022/{sdcorejs-angular-modules-generic-generic-form-host.page-CwUegGgG.mjs → sdcorejs-angular-modules-generic-generic-form-host.page-f7ysKltl.mjs} +2 -2
- package/fesm2022/{sdcorejs-angular-modules-generic-generic-form-host.page-CwUegGgG.mjs.map → sdcorejs-angular-modules-generic-generic-form-host.page-f7ysKltl.mjs.map} +1 -1
- package/fesm2022/{sdcorejs-angular-modules-generic-generic-list.page-lF2trhfp.mjs → sdcorejs-angular-modules-generic-generic-list.page-BdGxuquq.mjs} +3 -3
- package/fesm2022/{sdcorejs-angular-modules-generic-generic-list.page-lF2trhfp.mjs.map → sdcorejs-angular-modules-generic-generic-list.page-BdGxuquq.mjs.map} +1 -1
- package/fesm2022/{sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-BbmeOduc.mjs → sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-DtPfIB97.mjs} +4 -4
- package/fesm2022/{sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-BbmeOduc.mjs.map → sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-DtPfIB97.mjs.map} +1 -1
- package/fesm2022/sdcorejs-angular-modules-generic.mjs +1 -1
- package/fesm2022/sdcorejs-angular-modules-layout.mjs +7 -2
- package/fesm2022/sdcorejs-angular-modules-layout.mjs.map +1 -1
- package/fesm2022/{sdcorejs-angular-modules-pattern-base-api.service-DK33LxHm.mjs → sdcorejs-angular-modules-pattern-base-api.service-Bj3iKGg_.mjs} +2 -2
- package/fesm2022/{sdcorejs-angular-modules-pattern-base-api.service-DK33LxHm.mjs.map → sdcorejs-angular-modules-pattern-base-api.service-Bj3iKGg_.mjs.map} +1 -1
- package/fesm2022/{sdcorejs-angular-modules-pattern-create.component-CPwGkrNk.mjs → sdcorejs-angular-modules-pattern-create.component-C27vASfj.mjs} +11 -7
- package/fesm2022/sdcorejs-angular-modules-pattern-create.component-C27vASfj.mjs.map +1 -0
- package/fesm2022/{sdcorejs-angular-modules-pattern-create.component-VCbA_FkZ.mjs → sdcorejs-angular-modules-pattern-create.component-C63mUjRM.mjs} +2 -2
- package/fesm2022/{sdcorejs-angular-modules-pattern-create.component-VCbA_FkZ.mjs.map → sdcorejs-angular-modules-pattern-create.component-C63mUjRM.mjs.map} +1 -1
- package/fesm2022/{sdcorejs-angular-modules-pattern-create.component-Bi2tMFHf.mjs → sdcorejs-angular-modules-pattern-create.component-DYn8jkTD.mjs} +2 -2
- package/fesm2022/{sdcorejs-angular-modules-pattern-create.component-Bi2tMFHf.mjs.map → sdcorejs-angular-modules-pattern-create.component-DYn8jkTD.mjs.map} +1 -1
- package/fesm2022/{sdcorejs-angular-modules-pattern-customer.service-CehsdBRP.mjs → sdcorejs-angular-modules-pattern-customer.service-BNVk2VIb.mjs} +2 -2
- package/fesm2022/{sdcorejs-angular-modules-pattern-customer.service-CehsdBRP.mjs.map → sdcorejs-angular-modules-pattern-customer.service-BNVk2VIb.mjs.map} +1 -1
- package/fesm2022/{sdcorejs-angular-modules-pattern-detail.component-5kI7wGdX.mjs → sdcorejs-angular-modules-pattern-detail.component-Bh8UD7ft.mjs} +57 -54
- package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-Bh8UD7ft.mjs.map +1 -0
- package/fesm2022/{sdcorejs-angular-modules-pattern-detail.component-CjAy-B9K.mjs → sdcorejs-angular-modules-pattern-detail.component-S7x8j9i5.mjs} +2 -2
- package/fesm2022/{sdcorejs-angular-modules-pattern-detail.component-CjAy-B9K.mjs.map → sdcorejs-angular-modules-pattern-detail.component-S7x8j9i5.mjs.map} +1 -1
- package/fesm2022/{sdcorejs-angular-modules-pattern-flow.component-DObN_wCR.mjs → sdcorejs-angular-modules-pattern-flow.component-CHtskh2X.mjs} +3 -3
- package/fesm2022/{sdcorejs-angular-modules-pattern-flow.component-DObN_wCR.mjs.map → sdcorejs-angular-modules-pattern-flow.component-CHtskh2X.mjs.map} +1 -1
- package/fesm2022/{sdcorejs-angular-modules-pattern-index.component-TTrWCXIT.mjs → sdcorejs-angular-modules-pattern-index.component-W8icBRPe.mjs} +2 -2
- package/fesm2022/{sdcorejs-angular-modules-pattern-index.component-TTrWCXIT.mjs.map → sdcorejs-angular-modules-pattern-index.component-W8icBRPe.mjs.map} +1 -1
- package/fesm2022/{sdcorejs-angular-modules-pattern-lines-table-form.component-B1qePLfk.mjs → sdcorejs-angular-modules-pattern-lines-table-form.component-DEwUiNkq.mjs} +5 -5
- package/fesm2022/{sdcorejs-angular-modules-pattern-lines-table-form.component-B1qePLfk.mjs.map → sdcorejs-angular-modules-pattern-lines-table-form.component-DEwUiNkq.mjs.map} +1 -1
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-8m-QmfUX.mjs +501 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-8m-QmfUX.mjs.map +1 -0
- package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-W9vY7HrT.mjs → sdcorejs-angular-modules-pattern-list.component-BDEm2v0W.mjs} +3 -3
- package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-W9vY7HrT.mjs.map → sdcorejs-angular-modules-pattern-list.component-BDEm2v0W.mjs.map} +1 -1
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-BgwTyRhE.mjs +506 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-BgwTyRhE.mjs.map +1 -0
- package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-CJ38CJXg.mjs → sdcorejs-angular-modules-pattern-list.component-BhFkL7tX.mjs} +30 -39
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-BhFkL7tX.mjs.map +1 -0
- package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-BY5gjtNS.mjs → sdcorejs-angular-modules-pattern-list.component-j7ZFxvlG.mjs} +3 -3
- package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-BY5gjtNS.mjs.map → sdcorejs-angular-modules-pattern-list.component-j7ZFxvlG.mjs.map} +1 -1
- package/fesm2022/{sdcorejs-angular-modules-pattern-mock-backend.factory-CI0H_5a4.mjs → sdcorejs-angular-modules-pattern-mock-backend.factory-CPAV_J3j.mjs} +2 -2
- package/fesm2022/{sdcorejs-angular-modules-pattern-mock-backend.factory-CI0H_5a4.mjs.map → sdcorejs-angular-modules-pattern-mock-backend.factory-CPAV_J3j.mjs.map} +1 -1
- package/fesm2022/{sdcorejs-angular-modules-pattern-pattern-source-viewer-BqHwKfoc.mjs → sdcorejs-angular-modules-pattern-pattern-source-viewer-DuhyXsGn.mjs} +4 -22
- package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source-viewer-DuhyXsGn.mjs.map +1 -0
- package/fesm2022/{sdcorejs-angular-modules-pattern-pattern-source.generated-CIiLOizq.mjs → sdcorejs-angular-modules-pattern-pattern-source.generated-bfpj85ke.mjs} +26 -27
- package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source.generated-bfpj85ke.mjs.map +1 -0
- package/fesm2022/{sdcorejs-angular-modules-pattern-product.service-D829aEk5.mjs → sdcorejs-angular-modules-pattern-product.service-B9Dc2NUr.mjs} +2 -2
- package/fesm2022/{sdcorejs-angular-modules-pattern-product.service-D829aEk5.mjs.map → sdcorejs-angular-modules-pattern-product.service-B9Dc2NUr.mjs.map} +1 -1
- package/fesm2022/{sdcorejs-angular-modules-pattern-profile.component-BEFVmSSj.mjs → sdcorejs-angular-modules-pattern-profile.component-097Hf7Bc.mjs} +24 -14
- package/fesm2022/sdcorejs-angular-modules-pattern-profile.component-097Hf7Bc.mjs.map +1 -0
- package/fesm2022/{sdcorejs-angular-modules-pattern-routes-B-TJUSV_.mjs → sdcorejs-angular-modules-pattern-routes-CahNEP9-.mjs} +5 -5
- package/fesm2022/{sdcorejs-angular-modules-pattern-routes-B-TJUSV_.mjs.map → sdcorejs-angular-modules-pattern-routes-CahNEP9-.mjs.map} +1 -1
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-CjfWGMvJ.mjs +65 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-CjfWGMvJ.mjs.map +1 -0
- package/fesm2022/{sdcorejs-angular-modules-pattern-routes-1kDb9T7_.mjs → sdcorejs-angular-modules-pattern-routes-DeE5hp5x.mjs} +4 -4
- package/fesm2022/{sdcorejs-angular-modules-pattern-routes-1kDb9T7_.mjs.map → sdcorejs-angular-modules-pattern-routes-DeE5hp5x.mjs.map} +1 -1
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-Di2ceIlM.mjs +56 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-Di2ceIlM.mjs.map +1 -0
- package/fesm2022/{sdcorejs-angular-modules-pattern-routes-B6z7KO0P.mjs → sdcorejs-angular-modules-pattern-routes-MEcCUESx.mjs} +3 -3
- package/fesm2022/{sdcorejs-angular-modules-pattern-routes-B6z7KO0P.mjs.map → sdcorejs-angular-modules-pattern-routes-MEcCUESx.mjs.map} +1 -1
- package/fesm2022/{sdcorejs-angular-modules-pattern-routes-DVlcUUzh.mjs → sdcorejs-angular-modules-pattern-routes-hKorxavO.mjs} +3 -3
- package/fesm2022/{sdcorejs-angular-modules-pattern-routes-DVlcUUzh.mjs.map → sdcorejs-angular-modules-pattern-routes-hKorxavO.mjs.map} +1 -1
- package/fesm2022/{sdcorejs-angular-modules-pattern-routes-DS39vgzU.mjs → sdcorejs-angular-modules-pattern-routes-sJfnmrVg.mjs} +3 -3
- package/fesm2022/{sdcorejs-angular-modules-pattern-routes-DS39vgzU.mjs.map → sdcorejs-angular-modules-pattern-routes-sJfnmrVg.mjs.map} +1 -1
- package/fesm2022/{sdcorejs-angular-modules-pattern-routes-DxWDWUdo.mjs → sdcorejs-angular-modules-pattern-routes-ygWsDRk9.mjs} +8 -8
- package/fesm2022/{sdcorejs-angular-modules-pattern-routes-DxWDWUdo.mjs.map → sdcorejs-angular-modules-pattern-routes-ygWsDRk9.mjs.map} +1 -1
- package/fesm2022/{sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-nV5dVFx2.mjs → sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-C5IG0tkk.mjs} +12 -12
- package/fesm2022/{sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-nV5dVFx2.mjs.map → sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-C5IG0tkk.mjs.map} +1 -1
- package/fesm2022/{sdcorejs-angular-modules-pattern-shell.component-0rRaWsuo.mjs → sdcorejs-angular-modules-pattern-shell.component-BPgXiYkB.mjs} +4 -4
- package/fesm2022/{sdcorejs-angular-modules-pattern-shell.component-0rRaWsuo.mjs.map → sdcorejs-angular-modules-pattern-shell.component-BPgXiYkB.mjs.map} +1 -1
- package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-DF0pm6_f.mjs +480 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-DF0pm6_f.mjs.map +1 -0
- package/fesm2022/{sdcorejs-angular-modules-pattern-update.component-DkAcDmsZ.mjs → sdcorejs-angular-modules-pattern-update.component-BXBxoTdB.mjs} +2 -2
- package/fesm2022/{sdcorejs-angular-modules-pattern-update.component-DkAcDmsZ.mjs.map → sdcorejs-angular-modules-pattern-update.component-BXBxoTdB.mjs.map} +1 -1
- package/fesm2022/{sdcorejs-angular-modules-pattern-update.component-BmsOgENL.mjs → sdcorejs-angular-modules-pattern-update.component-DS253vcu.mjs} +2 -2
- package/fesm2022/{sdcorejs-angular-modules-pattern-update.component-BmsOgENL.mjs.map → sdcorejs-angular-modules-pattern-update.component-DS253vcu.mjs.map} +1 -1
- package/fesm2022/{sdcorejs-angular-modules-pattern-update.component-DPZ_ucNB.mjs → sdcorejs-angular-modules-pattern-update.component-OOYioclV.mjs} +9 -6
- package/fesm2022/sdcorejs-angular-modules-pattern-update.component-OOYioclV.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern.mjs +1 -1
- package/fesm2022/sdcorejs-angular-services-confirm.mjs +171 -158
- package/fesm2022/sdcorejs-angular-services-confirm.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-services-query-params.mjs +226 -0
- package/fesm2022/sdcorejs-angular-services-query-params.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-utilities-extensions.mjs +24 -1
- package/fesm2022/sdcorejs-angular-utilities-extensions.mjs.map +1 -1
- package/forms/date/src/date.component.d.ts +2 -0
- package/forms/directives/src/search-field.component.d.ts +1 -1
- package/i18n/src/en.d.ts +121 -9
- package/modules/layout/components/page-list/page-list.component.d.ts +2 -1
- package/modules/pattern/README.md +5 -4
- package/modules/pattern/docs/detail.md +18 -9
- package/modules/pattern/docs/drawer.md +185 -83
- package/modules/pattern/docs/header-actions.md +1 -1
- package/modules/pattern/docs/list.md +3 -3
- package/modules/pattern/docs/states.md +1 -1
- package/modules/pattern/features/category/components/create-side-drawer/create-side-drawer.component.d.ts +6 -4
- package/modules/pattern/features/category/components/create-side-drawer/create-side-drawer.component.ts +12 -16
- package/modules/pattern/features/category/components/update-side-drawer/update-side-drawer.component.d.ts +13 -5
- package/modules/pattern/features/category/components/update-side-drawer/update-side-drawer.component.ts +58 -29
- package/modules/pattern/features/category/pages/list/list.component.d.ts +15 -3
- package/modules/pattern/features/category/pages/list/list.component.html +11 -3
- package/modules/pattern/features/category/pages/list/list.component.ts +36 -10
- package/modules/pattern/features/category/routes.d.ts +4 -1
- package/modules/pattern/features/category/routes.ts +5 -22
- package/modules/pattern/features/customer/components/create-side-drawer/create-side-drawer.component.d.ts +6 -5
- package/modules/pattern/features/customer/components/create-side-drawer/create-side-drawer.component.ts +7 -11
- package/modules/pattern/features/customer/components/detail-side-drawer/detail-side-drawer.component.d.ts +20 -8
- package/modules/pattern/features/customer/components/detail-side-drawer/detail-side-drawer.component.ts +70 -27
- package/modules/pattern/features/customer/components/summary-cards/summary-cards.component.d.ts +5 -3
- package/modules/pattern/features/customer/components/summary-cards/summary-cards.component.ts +9 -53
- package/modules/pattern/features/customer/components/update-side-drawer/update-side-drawer.component.d.ts +18 -7
- package/modules/pattern/features/customer/components/update-side-drawer/update-side-drawer.component.ts +53 -19
- package/modules/pattern/features/customer/entity.resolver.d.ts +1 -1
- package/modules/pattern/features/customer/entity.resolver.ts +1 -1
- package/modules/pattern/features/customer/pages/list/list.component.d.ts +21 -3
- package/modules/pattern/features/customer/pages/list/list.component.html +18 -3
- package/modules/pattern/features/customer/pages/list/list.component.ts +43 -16
- package/modules/pattern/features/customer/pages/profile/profile.component.d.ts +5 -2
- package/modules/pattern/features/customer/pages/profile/profile.component.ts +17 -8
- package/modules/pattern/features/customer/routes.d.ts +3 -2
- package/modules/pattern/features/customer/routes.ts +6 -27
- package/modules/pattern/features/order/components/approval-steps/approval-steps.component.d.ts +11 -3
- package/modules/pattern/features/order/components/approval-steps/approval-steps.component.ts +37 -56
- package/modules/pattern/features/order/components/summary-cards/summary-cards.component.d.ts +7 -4
- package/modules/pattern/features/order/components/summary-cards/summary-cards.component.ts +14 -76
- package/modules/pattern/features/order/pages/create/create.component.d.ts +1 -1
- package/modules/pattern/features/order/pages/create/create.component.ts +7 -3
- package/modules/pattern/features/order/pages/detail/detail.component.ts +1 -1
- package/modules/pattern/features/order/pages/update/update.component.d.ts +1 -1
- package/modules/pattern/features/order/pages/update/update.component.ts +5 -2
- package/package.json +29 -17
- package/services/confirm/src/lib/components/dialog-confirm/dialog-confirm.component.d.ts +6 -1
- package/services/confirm/src/lib/confirm.service.d.ts +23 -12
- package/services/confirm/src/public-api.d.ts +0 -1
- package/services/query-params/index.d.ts +1 -0
- package/services/query-params/src/query-param-sync.d.ts +63 -0
- package/utilities/extensions/index.d.ts +1 -0
- package/utilities/extensions/src/format-bytes.d.ts +8 -0
- package/components/history/index.d.ts +0 -1
- package/components/history/models/history.model.d.ts +0 -13
- package/components/history/pipes/view-date.pipe.d.ts +0 -9
- package/components/history/src/history.component.d.ts +0 -7
- package/fesm2022/sdcorejs-angular-components-history.mjs +0 -54
- package/fesm2022/sdcorejs-angular-components-history.mjs.map +0 -1
- package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-B1BUBiag.mjs +0 -145
- package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-B1BUBiag.mjs.map +0 -1
- package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-B27ZX8Co.mjs +0 -144
- package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-B27ZX8Co.mjs.map +0 -1
- package/fesm2022/sdcorejs-angular-modules-pattern-create.component-CPwGkrNk.mjs.map +0 -1
- package/fesm2022/sdcorejs-angular-modules-pattern-customer.model-C3fr4yNw.mjs +0 -18
- package/fesm2022/sdcorejs-angular-modules-pattern-customer.model-C3fr4yNw.mjs.map +0 -1
- package/fesm2022/sdcorejs-angular-modules-pattern-detail-side-drawer.component-CPhLTiyx.mjs +0 -148
- package/fesm2022/sdcorejs-angular-modules-pattern-detail-side-drawer.component-CPhLTiyx.mjs.map +0 -1
- package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-5kI7wGdX.mjs.map +0 -1
- package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-D6eKR2cq.mjs +0 -87
- package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-D6eKR2cq.mjs.map +0 -1
- package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-FcJS3Nbd.mjs +0 -232
- package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-FcJS3Nbd.mjs.map +0 -1
- package/fesm2022/sdcorejs-angular-modules-pattern-general-information-view.component-BA-3FR1J.mjs +0 -70
- package/fesm2022/sdcorejs-angular-modules-pattern-general-information-view.component-BA-3FR1J.mjs.map +0 -1
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-CJ38CJXg.mjs.map +0 -1
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-CdgPtSjJ.mjs +0 -164
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-CdgPtSjJ.mjs.map +0 -1
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-DKIwrluh.mjs +0 -118
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-DKIwrluh.mjs.map +0 -1
- package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source-viewer-BqHwKfoc.mjs.map +0 -1
- package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source.generated-CIiLOizq.mjs.map +0 -1
- package/fesm2022/sdcorejs-angular-modules-pattern-profile.component-BEFVmSSj.mjs.map +0 -1
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-r9CTj-8C.mjs +0 -74
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-r9CTj-8C.mjs.map +0 -1
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-xI1XYRo6.mjs +0 -99
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-xI1XYRo6.mjs.map +0 -1
- package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-6uH7sDEg.mjs +0 -143
- package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-6uH7sDEg.mjs.map +0 -1
- package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-DglN2sS_.mjs +0 -132
- package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-DglN2sS_.mjs.map +0 -1
- package/fesm2022/sdcorejs-angular-modules-pattern-update.component-DPZ_ucNB.mjs.map +0 -1
- package/modules/pattern/features/category/entity.resolver.d.ts +0 -6
- package/modules/pattern/features/category/entity.resolver.ts +0 -27
|
@@ -12,7 +12,7 @@ Màn mẫu theo entity, chạy trên Core thật với mock API. Mỗi màn là
|
|
|
12
12
|
| Xem một bản ghi | [detail](docs/detail.md) | `sd-page-detail` | `product/:id/detail`, `order/:id/detail`, `customer/:id/360` |
|
|
13
13
|
| Tạo / cập nhật một bước | [form](docs/form.md) | `sd-page-form` (`toc` khi nhiều nhóm) | `product/create`, `order/create`, `settings` |
|
|
14
14
|
| Quy trình nhiều bước | [flow](docs/flow.md) | `sd-page` hẹp + `sd-stepper`, nút bước ở footer | `import`, `partner/create` |
|
|
15
|
-
| Xem / sửa ngay trên danh sách | [drawer](docs/drawer.md) | `sd-side-drawer`
|
|
15
|
+
| Xem / sửa ngay trên danh sách | [drawer](docs/drawer.md) | `sd-side-drawer` mở bằng `@if` trên danh sách, không đổi URL | `customer`, `category` |
|
|
16
16
|
| Xử lý nhanh từng mục | [split](docs/split.md) | `sd-page-list detail="none"` + `sd-splitter` | `approval` |
|
|
17
17
|
| Chọn entity / enum | [select](docs/select.md) | wrapper `<entity>-select` của feature sở hữu entity | `product-select`, `customer-select` |
|
|
18
18
|
| Hiện quan hệ theo ID | [relation](docs/relation.md) | pipe `<entity>Detail` | `customerDetail`, `productDetail` |
|
|
@@ -31,12 +31,12 @@ Thanh công cụ dưới cùng của `/pattern` (vai trò, độ trễ, lỗi gi
|
|
|
31
31
|
|
|
32
32
|
```text
|
|
33
33
|
features/<entity>/
|
|
34
|
-
routes.ts route list + route con (create, :id/detail, :id/update), service cấp ở đây
|
|
34
|
+
routes.ts route list + route con của trang (create, :id/detail, :id/update), service cấp ở đây
|
|
35
35
|
entity.resolver.ts tải bản ghi bằng detail(id) trước khi mở trang
|
|
36
36
|
services/<entity>.model.ts DTO, Req, const/enum, badge
|
|
37
37
|
services/<entity>.service.ts gọi API qua BaseApiService; không biết có mock hay không
|
|
38
38
|
pages/list|detail|create|update/ trang có route
|
|
39
|
-
components/ -form, -view, -select, *-side-drawer của entity
|
|
39
|
+
components/ -form, -view, -select, *-side-drawer của entity (drawer không có route)
|
|
40
40
|
pipes/<entity>-detail.pipe.ts relation theo ID cho màn khác
|
|
41
41
|
```
|
|
42
42
|
|
|
@@ -59,6 +59,7 @@ Tên feature đã có trong đường dẫn, không lặp lại trong tên file
|
|
|
59
59
|
| E11 | Tài liệu không ghi chú theo version; khác biệt giữa version ghi ở CHANGELOG. |
|
|
60
60
|
| E12 | `features/*` theo cấu trúc project-structure của Blueprint. |
|
|
61
61
|
| E13 | Sau lưu: page sang chi tiết, drawer đóng và danh sách tải lại. Lưu lỗi: focus field lỗi đầu tiên, lỗi API gắn vào field. Xoá, duyệt, từ chối, mọi tác vụ đổi trạng thái đều hỏi xác nhận, cả từng bản ghi lẫn hàng loạt; hàng loạt báo kết quả từng phần và cho thử lại phần lỗi. |
|
|
62
|
+
| E14 | Màn đọc query param của chính nó subscribe `ActivatedRoute.queryParamMap` (hoặc `toSignal`), không đọc `route.snapshot.queryParamMap` một lần: trong `sd-tab-router-outlet` cùng path khác query là cùng tab và component được giữ. Bản ghi cần tab riêng thì định danh nằm trong path. Bảng / tab / anchor muốn giữ state qua link thì bật `syncQueryParams` (cần `autoId`), không tự ghi query. Chi tiết: mục "Screens that read query params" trong [`sd-tab-router.md`](../../components/tab-router/sd-tab-router.md). |
|
|
62
63
|
|
|
63
64
|
## Mã quyền
|
|
64
65
|
|
|
@@ -73,4 +74,4 @@ Thêm hoặc sửa một màn mẫu:
|
|
|
73
74
|
- [ ] Mã quyền mới có trong `core/permission/pattern-permission.ts`; mã không còn dùng thì xoá.
|
|
74
75
|
- [ ] Tài liệu trong `docs/` trỏ tới file của feature bằng marker `@source`; chạy `npm run pattern:docs` (cập nhật cả manifest của tab Source).
|
|
75
76
|
- [ ] Playwright cho route trong `showcase/e2e/pattern/`.
|
|
76
|
-
- [ ] Quy tắc review: không có chiều cao hay `overflow` tự viết trong danh sách, không có `hideInlineFilter: true`, không có nút Đóng thường trực trong drawer, không có chữ "Chỉnh sửa".
|
|
77
|
+
- [ ] Quy tắc review: không có chiều cao hay `overflow` tự viết trong danh sách, không có `hideInlineFilter: true`, không có nút Đóng thường trực trong drawer, không có chữ "Chỉnh sửa", không đọc `route.snapshot.queryParamMap` một lần (E14).
|
|
@@ -94,13 +94,13 @@ export class DetailComponent {
|
|
|
94
94
|
}
|
|
95
95
|
```
|
|
96
96
|
|
|
97
|
-
Hồ sơ 360°: tab trong `sdSubheader`, tab ghi trên URL, mở tab nào mới tải tab
|
|
97
|
+
Hồ sơ 360°: tab trong `sdSubheader`, tab ghi trên URL, mở tab nào mới tải tab đó. Cập nhật mở drawer ngay trên hồ sơ ([drawer](drawer.md)), lưu xong hồ sơ hiện bản ghi API trả về:
|
|
98
98
|
|
|
99
99
|
<!-- @source features/customer/pages/profile/profile.component.ts -->
|
|
100
100
|
```ts
|
|
101
|
-
import { ChangeDetectionStrategy, Component, computed, inject, linkedSignal, untracked } from '@angular/core';
|
|
101
|
+
import { ChangeDetectionStrategy, Component, computed, inject, linkedSignal, signal, untracked } from '@angular/core';
|
|
102
102
|
import { toSignal } from '@angular/core/rxjs-interop';
|
|
103
|
-
import { ActivatedRoute, Router
|
|
103
|
+
import { ActivatedRoute, Router } from '@angular/router';
|
|
104
104
|
import { map } from 'rxjs';
|
|
105
105
|
import { SdButton } from '@sdcorejs/angular/components/button';
|
|
106
106
|
import { SdTab, SdTabGroup } from '@sdcorejs/angular/components/tab';
|
|
@@ -110,6 +110,7 @@ import { DebtsViewComponent } from '../../components/debts-view/debts-view.compo
|
|
|
110
110
|
import { DocumentsViewComponent } from '../../components/documents-view/documents-view.component';
|
|
111
111
|
import { GeneralInformationViewComponent } from '../../components/general-information-view/general-information-view.component';
|
|
112
112
|
import { OrdersViewComponent } from '../../components/orders-view/orders-view.component';
|
|
113
|
+
import { UpdateSideDrawerComponent } from '../../components/update-side-drawer/update-side-drawer.component';
|
|
113
114
|
import { customerStatusBadge, customerTypeName, type CustomerDto } from '../../services/customer.model';
|
|
114
115
|
|
|
115
116
|
const TABS = [
|
|
@@ -122,13 +123,13 @@ type TabKey = (typeof TABS)[number]['key'];
|
|
|
122
123
|
|
|
123
124
|
/**
|
|
124
125
|
* Hồ sơ 360° (`:id/360`): thông tin chung và các quan hệ của khách hàng theo tab. Tab ghi trên URL (`?tab=`);
|
|
125
|
-
* mở tab nào mới tải tab đó, mỗi tab tự có trạng thái đang tải, rỗng và lỗi.
|
|
126
|
+
* mở tab nào mới tải tab đó, mỗi tab tự có trạng thái đang tải, rỗng và lỗi. Cập nhật mở drawer ngay trên hồ sơ,
|
|
127
|
+
* không đổi URL; lưu xong hồ sơ hiện bản ghi mới.
|
|
126
128
|
*/
|
|
127
129
|
@Component({
|
|
128
130
|
selector: 'profile',
|
|
129
131
|
standalone: true,
|
|
130
132
|
imports: [
|
|
131
|
-
RouterLink,
|
|
132
133
|
SdPageComponent,
|
|
133
134
|
SdButton,
|
|
134
135
|
SdTabGroup,
|
|
@@ -138,6 +139,7 @@ type TabKey = (typeof TABS)[number]['key'];
|
|
|
138
139
|
OrdersViewComponent,
|
|
139
140
|
DebtsViewComponent,
|
|
140
141
|
DocumentsViewComponent,
|
|
142
|
+
UpdateSideDrawerComponent,
|
|
141
143
|
],
|
|
142
144
|
changeDetection: ChangeDetectionStrategy.OnPush,
|
|
143
145
|
template: `
|
|
@@ -155,7 +157,7 @@ type TabKey = (typeof TABS)[number]['key'];
|
|
|
155
157
|
type="fill"
|
|
156
158
|
color="primary"
|
|
157
159
|
autoId="customer-profile-update"
|
|
158
|
-
|
|
160
|
+
(click)="updating.set(true)" />
|
|
159
161
|
<sd-tab-group sdSubheader [selectedIndex]="tabIndex()" (selectedIndexChange)="selectTab($event)">
|
|
160
162
|
@for (tab of tabs; track tab.key) {
|
|
161
163
|
<sd-tab [label]="tab.label" />
|
|
@@ -184,13 +186,20 @@ type TabKey = (typeof TABS)[number]['key'];
|
|
|
184
186
|
}
|
|
185
187
|
</div>
|
|
186
188
|
</sd-page-detail>
|
|
189
|
+
@if (updating()) {
|
|
190
|
+
<update-side-drawer [id]="customer.id" (saved)="entity.set($event)" (closed)="updating.set(false)" />
|
|
191
|
+
}
|
|
187
192
|
`,
|
|
188
193
|
})
|
|
189
194
|
export class ProfileComponent {
|
|
190
195
|
readonly #router = inject(Router);
|
|
191
196
|
readonly #route = inject(ActivatedRoute);
|
|
192
197
|
protected readonly tabs = TABS;
|
|
193
|
-
|
|
198
|
+
readonly #resolved = toSignal(this.#route.data.pipe(map(data => data['entity'] as CustomerDto)), { requireSync: true });
|
|
199
|
+
/** Bản ghi do resolver tải; lưu ở drawer cập nhật thì thay bằng bản ghi API trả về, không tải lại cả trang. */
|
|
200
|
+
protected readonly entity = linkedSignal(() => this.#resolved());
|
|
201
|
+
readonly #id = computed(() => this.entity().id);
|
|
202
|
+
protected readonly updating = signal(false);
|
|
194
203
|
protected readonly badges = computed(() => [customerStatusBadge(this.entity().status)]);
|
|
195
204
|
protected readonly typeName = computed(() => customerTypeName(this.entity().type));
|
|
196
205
|
readonly #tabParam = toSignal(this.#route.queryParamMap.pipe(map(params => params.get('tab'))), { requireSync: true });
|
|
@@ -201,8 +210,8 @@ export class ProfileComponent {
|
|
|
201
210
|
)
|
|
202
211
|
);
|
|
203
212
|
/** Tab đã mở ít nhất một lần: giữ lại khi chuyển tab, không tải lại. Đổi khách hàng thì bắt đầu lại. */
|
|
204
|
-
protected readonly opened = linkedSignal<
|
|
205
|
-
source: this
|
|
213
|
+
protected readonly opened = linkedSignal<string, ReadonlySet<TabKey>>({
|
|
214
|
+
source: this.#id,
|
|
206
215
|
// untracked: đổi tab không được đặt lại các tab đã mở; chỉ đổi khách hàng mới bắt đầu lại.
|
|
207
216
|
computation: () => new Set<TabKey>([TABS[untracked(this.tabIndex)].key]),
|
|
208
217
|
});
|
|
@@ -1,24 +1,78 @@
|
|
|
1
1
|
# Drawer
|
|
2
2
|
|
|
3
|
-
Xem, tạo, cập nhật ngay trên danh sách: `sd-side-drawer`
|
|
3
|
+
Xem, tạo, cập nhật ngay trên danh sách: `sd-side-drawer` mở bằng `@if` trên màn đang hiện, không đổi URL. Mẫu: `/pattern/customer` (chi tiết, tạo, cập nhật; cập nhật cũng mở từ hồ sơ 360°), `/pattern/category` (tạo danh mục gốc và danh mục con, cập nhật).
|
|
4
4
|
|
|
5
5
|
## Khi nào dùng / khi nào không
|
|
6
6
|
|
|
7
7
|
- Dùng khi người dùng cần giữ ngữ cảnh danh sách: xem nhanh, sửa vài field, tạo bản ghi con.
|
|
8
|
-
- Nhiều tab, bảng quan hệ lớn, form nhiều bước hoặc rộng hơn 800px: dùng trang ([detail](detail.md), [form](form.md)).
|
|
8
|
+
- Nhiều tab, bảng quan hệ lớn, form nhiều bước hoặc rộng hơn 800px: dùng trang ([detail](detail.md), [form](form.md)). Trang là route con, có URL riêng.
|
|
9
|
+
- Chi tiết cần link chia sẻ được: làm trang chi tiết (route con). `/pattern/order` cho trang đó hiện trong drawer bằng `sd-page-list detail="drawer"` ([list](list.md)); đó là trang chi tiết đổi cách hiện, không phải drawer của pattern này.
|
|
9
10
|
|
|
10
11
|
## Code mẫu
|
|
11
12
|
|
|
12
|
-
|
|
13
|
+
Màn danh sách giữ drawer đang mở trong một signal và dựng drawer bằng `@if`; mỗi lần mở là một drawer mới, đóng thì gỡ khỏi màn. Chi tiết sang cập nhật thay drawer này bằng drawer kia:
|
|
14
|
+
|
|
15
|
+
<!-- @source features/customer/pages/list/list.component.html -->
|
|
16
|
+
```html
|
|
17
|
+
@let _drawer = drawer();
|
|
18
|
+
<sd-page-list title="Khách hàng" description="Khách cá nhân và doanh nghiệp đang giao dịch.">
|
|
19
|
+
<sd-button
|
|
20
|
+
headerRight
|
|
21
|
+
*sdPermission="'PATTERN_CUSTOMER_C_CREATE'"
|
|
22
|
+
title="Tạo khách hàng"
|
|
23
|
+
prefixIcon="add"
|
|
24
|
+
type="fill"
|
|
25
|
+
color="primary"
|
|
26
|
+
autoId="customer-create"
|
|
27
|
+
(click)="drawer.set({ type: 'create' })" />
|
|
28
|
+
|
|
29
|
+
<summary-cards [counts]="counts()" [(segment)]="segment" />
|
|
30
|
+
|
|
31
|
+
<sd-table autoId="customer-list" [option]="tableOption">
|
|
32
|
+
<ng-template sdTableCellDef="code" let-customer="item">
|
|
33
|
+
<a *sdPermission="'PATTERN_CUSTOMER_R_DETAIL'" href="" (click)="openDetail($event, customer.id)">{{ customer.code }}</a>
|
|
34
|
+
@if (!canOpenDetail) {
|
|
35
|
+
<span>{{ customer.code }}</span>
|
|
36
|
+
}
|
|
37
|
+
</ng-template>
|
|
38
|
+
</sd-table>
|
|
39
|
+
</sd-page-list>
|
|
40
|
+
|
|
41
|
+
@if (_drawer?.type === 'create') {
|
|
42
|
+
<create-side-drawer (closed)="drawer.set(null)" />
|
|
43
|
+
}
|
|
44
|
+
@if (_drawer?.type === 'detail') {
|
|
45
|
+
<detail-side-drawer
|
|
46
|
+
[id]="_drawer.id"
|
|
47
|
+
(update)="drawer.set({ type: 'update', id: _drawer.id })"
|
|
48
|
+
(profile)="openProfile(_drawer.id)"
|
|
49
|
+
(closed)="drawer.set(null)" />
|
|
50
|
+
}
|
|
51
|
+
@if (_drawer?.type === 'update') {
|
|
52
|
+
<update-side-drawer [id]="_drawer.id" (closed)="drawer.set(null)" />
|
|
53
|
+
}
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
Chi tiết trong drawer: nhận `id`, tự tải bằng `detail(id)` và hiện trạng thái tải, lỗi bằng `sd-data-state`; footer có Hồ sơ 360° và Cập nhật, Xoá là icon đỏ cạnh X, chỉ đóng bằng X:
|
|
13
57
|
|
|
14
58
|
<!-- @source features/customer/components/detail-side-drawer/detail-side-drawer.component.ts -->
|
|
15
59
|
```ts
|
|
16
|
-
import {
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
60
|
+
import {
|
|
61
|
+
afterNextRender,
|
|
62
|
+
ChangeDetectionStrategy,
|
|
63
|
+
Component,
|
|
64
|
+
computed,
|
|
65
|
+
inject,
|
|
66
|
+
input,
|
|
67
|
+
OnInit,
|
|
68
|
+
output,
|
|
69
|
+
signal,
|
|
70
|
+
viewChild,
|
|
71
|
+
} from '@angular/core';
|
|
72
|
+
import { firstValueFrom, timeout } from 'rxjs';
|
|
20
73
|
import { SdBadge } from '@sdcorejs/angular/components/badge';
|
|
21
74
|
import { SdButton } from '@sdcorejs/angular/components/button';
|
|
75
|
+
import { SdDataState } from '@sdcorejs/angular/components/data-state';
|
|
22
76
|
import { SdSideDrawer } from '@sdcorejs/angular/components/side-drawer';
|
|
23
77
|
import { SdPermissionDirective } from '@sdcorejs/angular/modules/permission';
|
|
24
78
|
import { SdConfirmService } from '@sdcorejs/angular/services/confirm';
|
|
@@ -29,24 +83,30 @@ import { customerStatusBadge, customerTypeName, type CustomerDto } from '../../s
|
|
|
29
83
|
import { GeneralInformationViewComponent } from '../general-information-view/general-information-view.component';
|
|
30
84
|
|
|
31
85
|
/**
|
|
32
|
-
* Chi tiết khách hàng trong drawer
|
|
33
|
-
* `detail(id)`, không lấy dữ liệu của dòng
|
|
34
|
-
* Xoá là tác vụ hiếm dùng và phá huỷ: nút chỉ có icon màu đỏ ở header, cạnh X;
|
|
86
|
+
* Chi tiết khách hàng trong drawer, mở từ mã khách hàng bằng `@if` (không đổi URL). Drawer mở ngay rồi tải bản ghi
|
|
87
|
+
* bằng `detail(id)`, không lấy dữ liệu của dòng; trạng thái tải và lỗi do `sd-data-state` hiện. Chỉ đóng bằng X (cùng
|
|
88
|
+
* Esc, backdrop): không có nút Đóng (E4). Xoá là tác vụ hiếm dùng và phá huỷ: nút chỉ có icon màu đỏ ở header, cạnh X;
|
|
89
|
+
* footer giữ tác vụ thường dùng. Cập nhật và Hồ sơ 360° báo lên danh sách, danh sách thay drawer này.
|
|
35
90
|
*/
|
|
36
91
|
@Component({
|
|
37
92
|
selector: 'detail-side-drawer',
|
|
38
93
|
standalone: true,
|
|
39
|
-
imports: [
|
|
94
|
+
imports: [SdSideDrawer, SdBadge, SdButton, SdDataState, SdPermissionDirective, GeneralInformationViewComponent],
|
|
40
95
|
changeDetection: ChangeDetectionStrategy.OnPush,
|
|
41
96
|
template: `
|
|
42
97
|
@let customer = entity();
|
|
43
|
-
<sd-side-drawer width="600px" autoId="customer-detail" (sdClosed)="closed()">
|
|
98
|
+
<sd-side-drawer width="600px" autoId="customer-detail" (sdClosed)="closed.emit()">
|
|
44
99
|
<div sdHeaderLeft class="d-flex flex-column">
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
<
|
|
48
|
-
|
|
49
|
-
|
|
100
|
+
@if (customer) {
|
|
101
|
+
@let _badge = badge();
|
|
102
|
+
<div class="d-flex align-items-center gap-8">
|
|
103
|
+
<span class="T16M">Chi tiết khách hàng #{{ customer.code }}</span>
|
|
104
|
+
<sd-badge size="md" [type]="_badge?.type ?? 'round'" [title]="_badge?.title" [color]="_badge?.color" />
|
|
105
|
+
</div>
|
|
106
|
+
<span class="T14R text-secondary">{{ typeName() }} · {{ customer.phone }}</span>
|
|
107
|
+
} @else {
|
|
108
|
+
<span class="T16M">Chi tiết khách hàng</span>
|
|
109
|
+
}
|
|
50
110
|
</div>
|
|
51
111
|
<sd-button
|
|
52
112
|
sdHeaderRight
|
|
@@ -56,11 +116,16 @@ import { GeneralInformationViewComponent } from '../general-information-view/gen
|
|
|
56
116
|
type="text"
|
|
57
117
|
color="error"
|
|
58
118
|
autoId="customer-delete"
|
|
119
|
+
[disabled]="!customer"
|
|
59
120
|
[loading]="deleting()"
|
|
60
121
|
(click)="delete()" />
|
|
61
|
-
<
|
|
122
|
+
<sd-data-state [state]="state()" retryable (sdRetry)="load()">
|
|
123
|
+
@if (customer) {
|
|
124
|
+
<general-information-view [customer]="customer" />
|
|
125
|
+
}
|
|
126
|
+
</sd-data-state>
|
|
62
127
|
<div sdFooterRight class="d-flex align-items-center gap-8">
|
|
63
|
-
<sd-button title="Hồ sơ 360°" prefixIcon="contact_page" type="outline" autoId="customer-profile"
|
|
128
|
+
<sd-button title="Hồ sơ 360°" prefixIcon="contact_page" type="outline" autoId="customer-profile" (click)="profile.emit()" />
|
|
64
129
|
<sd-button
|
|
65
130
|
*sdPermission="'PATTERN_CUSTOMER_U_UPDATE'"
|
|
66
131
|
title="Cập nhật khách hàng"
|
|
@@ -68,35 +133,57 @@ import { GeneralInformationViewComponent } from '../general-information-view/gen
|
|
|
68
133
|
type="fill"
|
|
69
134
|
color="primary"
|
|
70
135
|
autoId="customer-update"
|
|
71
|
-
|
|
136
|
+
(click)="update.emit()" />
|
|
72
137
|
</div>
|
|
73
138
|
</sd-side-drawer>
|
|
74
139
|
`,
|
|
75
140
|
})
|
|
76
|
-
export class DetailSideDrawerComponent {
|
|
141
|
+
export class DetailSideDrawerComponent implements OnInit {
|
|
77
142
|
readonly #customerService = inject(CustomerService);
|
|
78
143
|
readonly #confirm = inject(SdConfirmService);
|
|
79
144
|
readonly #notify = inject(SdNotifyService);
|
|
80
|
-
readonly
|
|
81
|
-
|
|
145
|
+
readonly id = input.required<string>();
|
|
146
|
+
/** Người dùng chọn Cập nhật: danh sách thay drawer này bằng drawer cập nhật, không chồng hai lớp. */
|
|
147
|
+
readonly update = output<void>();
|
|
148
|
+
/** Người dùng chọn Hồ sơ 360°: danh sách đóng drawer này và mở trang hồ sơ. */
|
|
149
|
+
readonly profile = output<void>();
|
|
150
|
+
/** Drawer đã đóng (X, Esc, backdrop hoặc xoá xong): danh sách gỡ drawer khỏi màn. */
|
|
151
|
+
readonly closed = output<void>();
|
|
82
152
|
private readonly drawer = viewChild.required(SdSideDrawer);
|
|
83
|
-
protected readonly
|
|
84
|
-
protected readonly
|
|
85
|
-
protected readonly
|
|
153
|
+
protected readonly state = signal<'loading' | 'error' | 'success'>('loading');
|
|
154
|
+
protected readonly entity = signal<CustomerDto | null>(null);
|
|
155
|
+
protected readonly badge = computed(() => {
|
|
156
|
+
const customer = this.entity();
|
|
157
|
+
return customer ? customerStatusBadge(customer.status) : null;
|
|
158
|
+
});
|
|
159
|
+
protected readonly typeName = computed(() => {
|
|
160
|
+
const customer = this.entity();
|
|
161
|
+
return customer ? customerTypeName(customer.type) : '';
|
|
162
|
+
});
|
|
86
163
|
protected readonly deleting = signal(false);
|
|
87
164
|
|
|
88
165
|
constructor() {
|
|
89
166
|
afterNextRender(() => this.drawer().open());
|
|
90
167
|
}
|
|
91
168
|
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
169
|
+
ngOnInit(): void {
|
|
170
|
+
void this.load();
|
|
171
|
+
}
|
|
172
|
+
|
|
173
|
+
/** Tải bản ghi bằng `detail(id)`, không dùng object của dòng; lỗi hiện trong drawer kèm nút thử lại. */
|
|
174
|
+
protected async load(): Promise<void> {
|
|
175
|
+
this.state.set('loading');
|
|
176
|
+
try {
|
|
177
|
+
this.entity.set(await firstValueFrom(this.#customerService.detail(this.id()).pipe(timeout(10_000))));
|
|
178
|
+
this.state.set('success');
|
|
179
|
+
} catch {
|
|
180
|
+
this.state.set('error');
|
|
181
|
+
}
|
|
96
182
|
}
|
|
97
183
|
|
|
98
184
|
protected async delete(): Promise<void> {
|
|
99
185
|
const customer = this.entity();
|
|
186
|
+
if (!customer) return;
|
|
100
187
|
try {
|
|
101
188
|
await this.#confirm.confirm(`Xoá khách hàng ${customer.name}? Thao tác không hoàn tác được.`, {
|
|
102
189
|
title: 'Xoá khách hàng',
|
|
@@ -121,7 +208,7 @@ export class DetailSideDrawerComponent {
|
|
|
121
208
|
}
|
|
122
209
|
```
|
|
123
210
|
|
|
124
|
-
Cập nhật trong drawer: `beforeClose` hỏi trước khi bỏ thay đổi, lưu xong đóng drawer, danh sách tải lại, focus trở về dòng:
|
|
211
|
+
Cập nhật trong drawer: `beforeClose` hỏi trước khi bỏ thay đổi, lưu xong báo `saved` rồi đóng drawer, danh sách tải lại, focus trở về dòng:
|
|
125
212
|
|
|
126
213
|
<!-- @source features/customer/components/update-side-drawer/update-side-drawer.component.ts -->
|
|
127
214
|
```ts
|
|
@@ -133,14 +220,16 @@ import {
|
|
|
133
220
|
ElementRef,
|
|
134
221
|
inject,
|
|
135
222
|
Injector,
|
|
223
|
+
input,
|
|
224
|
+
OnInit,
|
|
225
|
+
output,
|
|
136
226
|
signal,
|
|
137
227
|
viewChild,
|
|
138
228
|
} from '@angular/core';
|
|
139
|
-
import { toSignal } from '@angular/core/rxjs-interop';
|
|
140
229
|
import { FormGroup } from '@angular/forms';
|
|
141
|
-
import {
|
|
142
|
-
import { firstValueFrom, map } from 'rxjs';
|
|
230
|
+
import { firstValueFrom, timeout } from 'rxjs';
|
|
143
231
|
import { SdButton } from '@sdcorejs/angular/components/button';
|
|
232
|
+
import { SdDataState } from '@sdcorejs/angular/components/data-state';
|
|
144
233
|
import { SdSideDrawer } from '@sdcorejs/angular/components/side-drawer';
|
|
145
234
|
import { SdConfirmService } from '@sdcorejs/angular/services/confirm';
|
|
146
235
|
import { SdNotifyService } from '@sdcorejs/angular/services/notify';
|
|
@@ -159,46 +248,65 @@ import {
|
|
|
159
248
|
} from '../general-information-form/general-information-form.component';
|
|
160
249
|
|
|
161
250
|
/**
|
|
162
|
-
* Cập nhật khách hàng trong drawer
|
|
163
|
-
*
|
|
251
|
+
* Cập nhật khách hàng trong drawer, mở bằng `@if` từ drawer chi tiết hoặc hồ sơ 360° (không đổi URL). Drawer mở ngay
|
|
252
|
+
* rồi tải bản ghi bằng `detail(id)`; trạng thái tải và lỗi do `sd-data-state` hiện. X, Esc và backdrop đi qua
|
|
253
|
+
* `beforeClose`: còn thay đổi thì hỏi trước khi bỏ. Lưu thành công thì báo `saved` rồi đóng drawer; danh sách tải lại
|
|
254
|
+
* và focus trở về phần tử đã mở drawer.
|
|
164
255
|
*/
|
|
165
256
|
@Component({
|
|
166
257
|
selector: 'update-side-drawer',
|
|
167
258
|
standalone: true,
|
|
168
|
-
imports: [SdSideDrawer, SdButton, GeneralInformationFormComponent],
|
|
259
|
+
imports: [SdSideDrawer, SdButton, SdDataState, GeneralInformationFormComponent],
|
|
169
260
|
changeDetection: ChangeDetectionStrategy.OnPush,
|
|
170
261
|
template: `
|
|
262
|
+
@let _entity = entity();
|
|
171
263
|
<sd-side-drawer
|
|
172
|
-
[title]="'Cập nhật khách hàng #' +
|
|
264
|
+
[title]="_entity ? 'Cập nhật khách hàng #' + _entity.code : 'Cập nhật khách hàng'"
|
|
173
265
|
width="600px"
|
|
174
266
|
autoId="customer-update"
|
|
175
267
|
[beforeClose]="beforeClose"
|
|
176
|
-
(sdClosed)="closed()">
|
|
177
|
-
<
|
|
268
|
+
(sdClosed)="closed.emit()">
|
|
269
|
+
<sd-data-state [state]="state()" retryable (sdRetry)="load()">
|
|
270
|
+
@if (_entity) {
|
|
271
|
+
<general-information-form [form]="form" [seed]="_entity" [errors]="apiErrors.errors()" [invalidGroups]="invalidGroups()" />
|
|
272
|
+
}
|
|
273
|
+
</sd-data-state>
|
|
178
274
|
<div sdFooterRight class="d-flex align-items-center gap-8">
|
|
179
|
-
<sd-button
|
|
275
|
+
<sd-button
|
|
276
|
+
title="Lưu"
|
|
277
|
+
prefixIcon="save"
|
|
278
|
+
type="fill"
|
|
279
|
+
color="primary"
|
|
280
|
+
autoId="customer-save"
|
|
281
|
+
[disabled]="!_entity"
|
|
282
|
+
[loading]="saving()"
|
|
283
|
+
(click)="save()" />
|
|
180
284
|
</div>
|
|
181
285
|
</sd-side-drawer>
|
|
182
286
|
`,
|
|
183
287
|
})
|
|
184
|
-
export class UpdateSideDrawerComponent {
|
|
288
|
+
export class UpdateSideDrawerComponent implements OnInit {
|
|
185
289
|
readonly #customerService = inject(CustomerService);
|
|
186
290
|
readonly #confirm = inject(SdConfirmService);
|
|
187
291
|
readonly #notify = inject(SdNotifyService);
|
|
188
|
-
readonly #router = inject(Router);
|
|
189
|
-
readonly #route = inject(ActivatedRoute);
|
|
190
292
|
readonly #injector = inject(Injector);
|
|
293
|
+
readonly id = input.required<string>();
|
|
294
|
+
/** Lưu thành công, kèm bản ghi API trả về: màn đang hiện bản ghi (hồ sơ 360°) cập nhật theo. */
|
|
295
|
+
readonly saved = output<CustomerDto>();
|
|
296
|
+
/** Drawer đã đóng (X, Esc, backdrop hoặc lưu xong): màn mở drawer gỡ nó khỏi màn. */
|
|
297
|
+
readonly closed = output<void>();
|
|
191
298
|
private readonly drawer = viewChild.required(SdSideDrawer);
|
|
192
299
|
// why: sd-side-drawer chuyển nội dung ra body, nên tìm field lỗi trong form chứ không trong host của component.
|
|
193
300
|
private readonly formElement = viewChild.required(GeneralInformationFormComponent, { read: ElementRef });
|
|
194
|
-
protected readonly
|
|
301
|
+
protected readonly state = signal<'loading' | 'error' | 'success'>('loading');
|
|
302
|
+
protected readonly entity = signal<CustomerDto | null>(null);
|
|
195
303
|
protected readonly form: CustomerForm = new FormGroup({});
|
|
196
304
|
protected readonly saving = signal(false);
|
|
197
305
|
protected readonly apiErrors = formApiErrors(this.form);
|
|
198
306
|
protected readonly invalidGroups = signal<CustomerFormGroup[]>([]);
|
|
199
307
|
readonly #unsaved = registerSdUnsavedChangesForm(inject(SdUnsavedChangesService), this.form, { id: 'customer-update', dirty: 'value' });
|
|
200
308
|
|
|
201
|
-
/** Đóng khi còn thay đổi chưa lưu: hỏi, đồng ý thì bỏ thay đổi (guard rời
|
|
309
|
+
/** Đóng khi còn thay đổi chưa lưu: hỏi, đồng ý thì bỏ thay đổi (guard rời trang không hỏi lại). */
|
|
202
310
|
protected readonly beforeClose = async (): Promise<boolean> => {
|
|
203
311
|
if (!this.#unsaved.dirty() || this.saving()) return !this.saving();
|
|
204
312
|
try {
|
|
@@ -220,12 +328,24 @@ export class UpdateSideDrawerComponent {
|
|
|
220
328
|
inject(DestroyRef).onDestroy(() => this.#unsaved.destroy());
|
|
221
329
|
}
|
|
222
330
|
|
|
223
|
-
|
|
224
|
-
void this
|
|
331
|
+
ngOnInit(): void {
|
|
332
|
+
void this.load();
|
|
333
|
+
}
|
|
334
|
+
|
|
335
|
+
/** Tải bản ghi bằng `detail(id)`, không dùng object của dòng; lỗi hiện trong drawer kèm nút thử lại. */
|
|
336
|
+
protected async load(): Promise<void> {
|
|
337
|
+
this.state.set('loading');
|
|
338
|
+
try {
|
|
339
|
+
this.entity.set(await firstValueFrom(this.#customerService.detail(this.id()).pipe(timeout(10_000))));
|
|
340
|
+
this.state.set('success');
|
|
341
|
+
} catch {
|
|
342
|
+
this.state.set('error');
|
|
343
|
+
}
|
|
225
344
|
}
|
|
226
345
|
|
|
227
346
|
protected async save(): Promise<void> {
|
|
228
|
-
|
|
347
|
+
const entity = this.entity();
|
|
348
|
+
if (!entity || this.saving()) return;
|
|
229
349
|
this.form.markAllAsTouched();
|
|
230
350
|
if (this.form.invalid) {
|
|
231
351
|
this.#showErrors();
|
|
@@ -233,9 +353,10 @@ export class UpdateSideDrawerComponent {
|
|
|
233
353
|
}
|
|
234
354
|
this.saving.set(true);
|
|
235
355
|
try {
|
|
236
|
-
await firstValueFrom(this.#customerService.update(
|
|
356
|
+
const customer = await firstValueFrom(this.#customerService.update(entity.id, customerSaveReq(this.form)));
|
|
237
357
|
this.#unsaved.markPristine();
|
|
238
358
|
this.#notify.success('Đã cập nhật khách hàng.');
|
|
359
|
+
this.saved.emit(customer);
|
|
239
360
|
this.saving.set(false);
|
|
240
361
|
this.drawer().close();
|
|
241
362
|
} catch (error) {
|
|
@@ -400,7 +521,7 @@ export class GeneralInformationFormComponent {
|
|
|
400
521
|
}
|
|
401
522
|
```
|
|
402
523
|
|
|
403
|
-
|
|
524
|
+
Drawer không có route; chỉ hồ sơ 360° (trang) là route con. Route của màn mở drawer có `sdPageFormLeaveGuard`, nên Back của trình duyệt lúc drawer còn thay đổi vẫn hỏi:
|
|
404
525
|
|
|
405
526
|
<!-- @source features/customer/routes.ts -->
|
|
406
527
|
```ts
|
|
@@ -411,8 +532,9 @@ import { entityResolver } from './entity.resolver';
|
|
|
411
532
|
import { CustomerService } from './services/customer.service';
|
|
412
533
|
|
|
413
534
|
/**
|
|
414
|
-
* Chi tiết, tạo và cập nhật mở trong drawer
|
|
415
|
-
*
|
|
535
|
+
* Chi tiết, tạo và cập nhật mở trong drawer trên danh sách, không đổi URL. Hồ sơ 360° là trang, route con thay chỗ
|
|
536
|
+
* danh sách; quay lại vẫn giữ bộ lọc, trang và vị trí cuộn. Guard rời trang hỏi trước khi bỏ thay đổi khi màn bị rời
|
|
537
|
+
* lúc drawer còn thay đổi chưa lưu (Back của trình duyệt).
|
|
416
538
|
*/
|
|
417
539
|
export const routes: Routes = [
|
|
418
540
|
{
|
|
@@ -424,36 +546,14 @@ export const routes: Routes = [
|
|
|
424
546
|
path: '',
|
|
425
547
|
title: 'Khách hàng',
|
|
426
548
|
data: { permission: 'PATTERN_CUSTOMER_R_LIST' },
|
|
549
|
+
canDeactivate: [sdPageFormLeaveGuard],
|
|
427
550
|
loadComponent: () => import('./pages/list/list.component').then(module => module.ListComponent),
|
|
428
551
|
children: [
|
|
429
|
-
{
|
|
430
|
-
path: 'create',
|
|
431
|
-
data: { permission: 'PATTERN_CUSTOMER_C_CREATE' },
|
|
432
|
-
canDeactivate: [sdPageFormLeaveGuard],
|
|
433
|
-
loadComponent: () =>
|
|
434
|
-
import('./components/create-side-drawer/create-side-drawer.component').then(module => module.CreateSideDrawerComponent),
|
|
435
|
-
},
|
|
436
|
-
{
|
|
437
|
-
path: ':id/detail',
|
|
438
|
-
data: { permission: 'PATTERN_CUSTOMER_R_DETAIL' },
|
|
439
|
-
resolve: { entity: entityResolver },
|
|
440
|
-
runGuardsAndResolvers: 'paramsChange',
|
|
441
|
-
loadComponent: () =>
|
|
442
|
-
import('./components/detail-side-drawer/detail-side-drawer.component').then(module => module.DetailSideDrawerComponent),
|
|
443
|
-
},
|
|
444
|
-
{
|
|
445
|
-
path: ':id/update',
|
|
446
|
-
data: { permission: 'PATTERN_CUSTOMER_U_UPDATE' },
|
|
447
|
-
resolve: { entity: entityResolver },
|
|
448
|
-
runGuardsAndResolvers: 'paramsChange',
|
|
449
|
-
canDeactivate: [sdPageFormLeaveGuard],
|
|
450
|
-
loadComponent: () =>
|
|
451
|
-
import('./components/update-side-drawer/update-side-drawer.component').then(module => module.UpdateSideDrawerComponent),
|
|
452
|
-
},
|
|
453
552
|
{
|
|
454
553
|
path: ':id/360',
|
|
455
554
|
title: 'Hồ sơ khách hàng',
|
|
456
|
-
data: { permission: 'PATTERN_CUSTOMER_R_DETAIL'
|
|
555
|
+
data: { permission: 'PATTERN_CUSTOMER_R_DETAIL' },
|
|
556
|
+
canDeactivate: [sdPageFormLeaveGuard],
|
|
457
557
|
resolve: { entity: entityResolver },
|
|
458
558
|
runGuardsAndResolvers: 'paramsChange',
|
|
459
559
|
loadComponent: () => import('./pages/profile/profile.component').then(module => module.ProfileComponent),
|
|
@@ -467,18 +567,20 @@ export const routes: Routes = [
|
|
|
467
567
|
|
|
468
568
|
## Quy tắc
|
|
469
569
|
|
|
470
|
-
- MUST
|
|
570
|
+
- MUST mở drawer bằng `@if` trên màn đang hiện (danh sách, hồ sơ) theo một signal của màn; drawer không có route và không đổi URL. `sdClosed` của drawer báo `closed`, màn đặt signal về `null` để gỡ drawer.
|
|
571
|
+
- MUST truyền vào drawer `id` của bản ghi (hoặc dữ liệu tối thiểu cho bản ghi con, như danh mục cha); drawer tự tải bằng `detail(id)` và hiện tải, lỗi bằng `sd-data-state` có thử lại. Không dùng object của dòng làm dữ liệu chi tiết.
|
|
471
572
|
- MUST chỉ đóng bằng X, Esc, backdrop (E4); không có nút Đóng hay Huỷ thường trực.
|
|
472
|
-
- MUST đi qua `beforeClose` cho mọi đường đóng khi còn thay đổi; đồng ý bỏ thì `markPristine()` để
|
|
573
|
+
- MUST đi qua `beforeClose` cho mọi đường đóng khi còn thay đổi; đồng ý bỏ thì `markPristine()`. Route của màn mở drawer khai báo `canDeactivate: [sdPageFormLeaveGuard]` để rời màn lúc drawer còn thay đổi vẫn hỏi.
|
|
473
574
|
- MUST đặt tác vụ thường dùng ở `sdFooterRight`: nút chính (`fill`, có icon) ở ngoài cùng bên phải, nút phụ (`outline`) bên trái nó. Mở màn khác (Hồ sơ 360°) cũng là nút, không phải link.
|
|
474
575
|
- MUST đặt tác vụ phá huỷ ít dùng (Xoá) ở `sdHeaderRight`, cạnh X: nút chỉ có icon màu đỏ (`type="text"`, `color="error"`) với `tooltip` làm tên, và vẫn hỏi xác nhận (E13).
|
|
475
|
-
- MUST
|
|
476
|
-
- MUST chỉ tải lại danh sách khi lưu thành công
|
|
576
|
+
- MUST chuyển chi tiết sang cập nhật bằng cách thay drawer trong cùng signal: mỗi lúc chỉ một drawer.
|
|
577
|
+
- MUST chỉ tải lại danh sách khi lưu thành công, sau khi drawer đã đóng; `sd-side-drawer` trả focus về phần tử đã mở drawer.
|
|
477
578
|
- SHOULD dùng bề rộng 600px cho chi tiết và form thường, 480px cho nội dung ngắn, tối đa 800px (E9).
|
|
478
579
|
- SHOULD tách `detail-side-drawer`, `create-side-drawer`, `update-side-drawer`; dùng chung `-form`/`-view`, không gộp ba chế độ vào một drawer.
|
|
479
580
|
|
|
480
581
|
## Lỗi hay gặp
|
|
481
582
|
|
|
482
|
-
-
|
|
583
|
+
- Đặt drawer làm route con (`create`, `:id/update`): mỗi lần mở đổi URL, Back của trình duyệt mở lại form đã đóng, link dẫn thẳng vào form mất ngữ cảnh danh sách.
|
|
584
|
+
- Giữ drawer luôn trong DOM rồi gọi `open()`: form còn giá trị của lần mở trước. Dựng lại bằng `@if` mỗi lần mở.
|
|
483
585
|
- Mở chồng drawer cập nhật lên drawer chi tiết: hai lớp backdrop, Esc chỉ đóng một lớp.
|
|
484
586
|
- Tải lại danh sách mỗi lần đóng drawer: mất vị trí cuộn và lựa chọn dù không có gì thay đổi.
|
|
@@ -202,7 +202,7 @@ import { canUpdateOrder, orderApprovalBadge, orderStatusBadge, type OrderAction,
|
|
|
202
202
|
<sd-section-item label="Ghi chú">{{ order.note | sdEmpty }}</sd-section-item>
|
|
203
203
|
</sd-section>
|
|
204
204
|
</div>
|
|
205
|
-
<approval-steps sdAside [steps]="order.approvalHistory" />
|
|
205
|
+
<approval-steps sdAside [steps]="order.approvalHistory" [createdAt]="order.createdAt" [creator]="order.creator" />
|
|
206
206
|
</sd-page-detail>
|
|
207
207
|
}
|
|
208
208
|
`,
|
|
@@ -121,7 +121,7 @@ export class ListComponent {
|
|
|
121
121
|
}
|
|
122
122
|
```
|
|
123
123
|
|
|
124
|
-
|
|
124
|
+
Trang chi tiết, tạo và cập nhật là route con của danh sách, nên quay lại vẫn giữ bộ lọc, trang và vị trí cuộn:
|
|
125
125
|
|
|
126
126
|
<!-- @source features/product/routes.ts -->
|
|
127
127
|
```ts
|
|
@@ -232,8 +232,8 @@ protected readonly counts = signal<OrderCounts | null>(null);
|
|
|
232
232
|
- MUST dùng `sd-page-list`; bảng chính là `sd-table` trực tiếp trong thân (hoặc phần tử gắn `sdPageListMain`). Không viết `h-full`, `overflow` hay chiều cao cho danh sách (E1).
|
|
233
233
|
- MUST mở chi tiết bằng link trên mã hoặc tên ở cột dữ liệu đầu tiên. Không có tác vụ Xem/Cập nhật trên dòng, trên thanh chọn nhiều hay ở header.
|
|
234
234
|
- MUST hiện mã dạng chữ khi thiếu quyền xem chi tiết; chuẩn bị cờ quyền trong TS (`hasPermission` sau khi guard đã nạp quyền), không gọi service quyền trong template.
|
|
235
|
-
- MUST đặt chi tiết, tạo, cập nhật là route con của danh sách; `detail="page"` ẩn danh sách, `detail="drawer"` giữ danh sách trên màn.
|
|
236
|
-
- MUST tải lại danh sách khi trang con đã lưu thành công (service đếm số lần thay đổi), không tải lại mỗi lần đóng.
|
|
235
|
+
- MUST đặt trang chi tiết, tạo, cập nhật là route con của danh sách; `detail="page"` ẩn danh sách, `detail="drawer"` hiện trang con trong drawer và giữ danh sách trên màn. Drawer xem/sửa nhanh ([drawer](drawer.md)) không phải route con: mở bằng `@if`, không đổi URL.
|
|
236
|
+
- MUST tải lại danh sách khi trang con hay drawer đã lưu thành công (service đếm số lần thay đổi), không tải lại mỗi lần đóng.
|
|
237
237
|
- MUST giữ một chỗ lọc cho mỗi field (E6): field có cột lọc dưới cột; external filter chỉ chứa field không có cột; có tab trạng thái thì tắt filter dưới cột Trạng thái. Không bật quick search cùng external filter.
|
|
238
238
|
- MUST truyền nguyên `PagingReq` (tham số thứ hai của `items`) vào service; service chuyển sang định dạng của API.
|
|
239
239
|
- SHOULD giữ mặc định `hideInlineFilter: false`; màn ít dữ liệu dùng `'auto'`; không dùng `true` (E7).
|
|
@@ -76,7 +76,7 @@ import { map, timeout } from 'rxjs';
|
|
|
76
76
|
import { CustomerService } from './services/customer.service';
|
|
77
77
|
import type { CustomerDto } from './services/customer.model';
|
|
78
78
|
|
|
79
|
-
/** Tải khách hàng bằng `detail(id)` trước khi mở
|
|
79
|
+
/** Tải khách hàng bằng `detail(id)` trước khi mở hồ sơ 360°; lỗi đi tới navigation error handler của host. */
|
|
80
80
|
export const entityResolver: ResolveFn<CustomerDto> = route => {
|
|
81
81
|
const id = route.paramMap.get('id');
|
|
82
82
|
if (!id?.trim()) throw new HttpErrorResponse({ status: 404 });
|