@sdcorejs/angular 22.3.2 → 22.3.4
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/THEME.md +58 -6
- package/assets/scss/core/form.scss +291 -3
- package/assets/scss/themes/_component-tokens.scss +35 -6
- package/fesm2022/sdcorejs-angular-components-badge.mjs +2 -2
- package/fesm2022/sdcorejs-angular-components-badge.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components-form-generic.mjs +3 -3
- package/fesm2022/sdcorejs-angular-components-form-generic.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components-query-bar.mjs +489 -42
- package/fesm2022/sdcorejs-angular-components-query-bar.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components-section.mjs +15 -3
- package/fesm2022/sdcorejs-angular-components-section.mjs.map +1 -1
- 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-splitter.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components-tab-router.mjs +398 -78
- package/fesm2022/sdcorejs-angular-components-tab-router.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components-table.mjs +1715 -127
- package/fesm2022/sdcorejs-angular-components-table.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-components-upload-file.mjs +932 -174
- package/fesm2022/sdcorejs-angular-components-upload-file.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-forms-autocomplete.mjs +7 -2
- package/fesm2022/sdcorejs-angular-forms-autocomplete.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-forms-chip-calendar.mjs +5 -2
- package/fesm2022/sdcorejs-angular-forms-chip-calendar.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-forms-chip.mjs +437 -122
- package/fesm2022/sdcorejs-angular-forms-chip.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-forms-date-range.mjs +4 -0
- package/fesm2022/sdcorejs-angular-forms-date-range.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-forms-date.mjs +4 -0
- package/fesm2022/sdcorejs-angular-forms-date.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-forms-datetime.mjs +4 -0
- package/fesm2022/sdcorejs-angular-forms-datetime.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-forms-input-number.mjs +18 -2
- package/fesm2022/sdcorejs-angular-forms-input-number.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-forms-input.mjs +4 -0
- package/fesm2022/sdcorejs-angular-forms-input.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-forms-select.mjs +26 -20
- package/fesm2022/sdcorejs-angular-forms-select.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-forms-textarea.mjs +14 -1
- package/fesm2022/sdcorejs-angular-forms-textarea.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-i18n.mjs +350 -5
- package/fesm2022/sdcorejs-angular-i18n.mjs.map +1 -1
- package/fesm2022/{sdcorejs-angular-modules-generic-generic-configuration.page-BrJfOTWy.mjs → sdcorejs-angular-modules-generic-generic-configuration.page-SJIWI1dX.mjs} +3 -3
- package/fesm2022/{sdcorejs-angular-modules-generic-generic-configuration.page-BrJfOTWy.mjs.map → sdcorejs-angular-modules-generic-generic-configuration.page-SJIWI1dX.mjs.map} +1 -1
- package/fesm2022/{sdcorejs-angular-modules-generic-generic-form-host.page-DQYXx2nr.mjs → sdcorejs-angular-modules-generic-generic-form-host.page-BPhMLVbv.mjs} +3 -3
- package/fesm2022/{sdcorejs-angular-modules-generic-generic-form-host.page-DQYXx2nr.mjs.map → sdcorejs-angular-modules-generic-generic-form-host.page-BPhMLVbv.mjs.map} +1 -1
- package/fesm2022/{sdcorejs-angular-modules-generic-generic-list.page-Cjg3Dfq1.mjs → sdcorejs-angular-modules-generic-generic-list.page-aGhowe9Y.mjs} +3 -3
- package/fesm2022/{sdcorejs-angular-modules-generic-generic-list.page-Cjg3Dfq1.mjs.map → sdcorejs-angular-modules-generic-generic-list.page-aGhowe9Y.mjs.map} +1 -1
- package/fesm2022/{sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-DpXg2yI7.mjs → sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-N8_oGpqD.mjs} +4 -4
- package/fesm2022/{sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-DpXg2yI7.mjs.map → sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-N8_oGpqD.mjs.map} +1 -1
- package/fesm2022/sdcorejs-angular-modules-generic.mjs +1 -1
- package/fesm2022/sdcorejs-angular-modules-layout.mjs +371 -11
- package/fesm2022/sdcorejs-angular-modules-layout.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-modules-pattern-api-error-BBWwQ6h2.mjs +23 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-api-error-BBWwQ6h2.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-approval-inbox-BMwD6_FC.mjs +16 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-approval-inbox-BMwD6_FC.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-base-api.service-C2o5xPVB.mjs +51 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-base-api.service-C2o5xPVB.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-CRc9T7rb.mjs +146 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-CRc9T7rb.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-Cz-MjRG0.mjs +148 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-Cz-MjRG0.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-create.component-CxicczH7.mjs +114 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-create.component-CxicczH7.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-create.component-D3MzNJ3F.mjs +469 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-create.component-D3MzNJ3F.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-create.component-RBvVv88D.mjs +143 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-create.component-RBvVv88D.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-customer.model-C3fr4yNw.mjs +18 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-customer.model-C3fr4yNw.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-customer.service-3hWkJClX.mjs +67 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-customer.service-3hWkJClX.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-detail-side-drawer.component-DzDAX3B7.mjs +152 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-detail-side-drawer.component-DzDAX3B7.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-CEhbU12j.mjs +175 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-CEhbU12j.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-CcpYULut.mjs +496 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-CcpYULut.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-yJ5fPyYU.mjs +92 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-yJ5fPyYU.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-flow.component-G5lHfG81.mjs +533 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-flow.component-G5lHfG81.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-form-api-errors-Ydotvlyc.mjs +64 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-form-api-errors-Ydotvlyc.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-BJaYcNzf.mjs +179 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-BJaYcNzf.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-D8-WXUAE.mjs +92 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-D8-WXUAE.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-DHTxzjRN.mjs +242 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-DHTxzjRN.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-general-information-view.component-CTgHdGeQ.mjs +72 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-general-information-view.component-CTgHdGeQ.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-index.component-CosbQK0W.mjs +100 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-index.component-CosbQK0W.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-lines-table-form.component-DmmVKrgM.mjs +836 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-lines-table-form.component-DmmVKrgM.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-BjehcQEk.mjs +172 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-BjehcQEk.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-CNVqk3JC.mjs +647 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-CNVqk3JC.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-C_pVqRcC.mjs +73 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-C_pVqRcC.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-EaNDEtCn.mjs +118 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-EaNDEtCn.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-jB3E20UF.mjs +120 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-list.component-jB3E20UF.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-mock-backend.factory-CFljqhjv.mjs +1069 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-mock-backend.factory-CFljqhjv.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source-viewer-BqHwKfoc.mjs +193 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source-viewer-BqHwKfoc.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source.generated-CIiLOizq.mjs +99 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source.generated-CIiLOizq.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-product.model-BoHLJ8vf.mjs +12 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-product.model-BoHLJ8vf.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-product.service-DitXmlr1.mjs +49 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-product.service-DitXmlr1.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-profile.component-Dxw7Ix9d.mjs +301 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-profile.component-Dxw7Ix9d.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-BOiWZHqg.mjs +45 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-BOiWZHqg.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-BWZxOMhB.mjs +74 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-BWZxOMhB.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-BxXgJVsW.mjs +74 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-BxXgJVsW.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-C43Q4Wtq.mjs +43 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-C43Q4Wtq.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-CJ-RAMa5.mjs +66 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-CJ-RAMa5.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-CWixJ2If.mjs +50 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-CWixJ2If.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-CophQH_L.mjs +100 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-CophQH_L.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-w4VY9P_H.mjs +166 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-routes-w4VY9P_H.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-BQCWgQsr.mjs +413 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-BQCWgQsr.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-shell.component-BOjJteMd.mjs +325 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-shell.component-BOjJteMd.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-BT2PzXTG.mjs +135 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-BT2PzXTG.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-qmGn2tCI.mjs +146 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-qmGn2tCI.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-update.component-CS3jlV-R.mjs +101 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-update.component-CS3jlV-R.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-update.component-CUgQPcR4.mjs +139 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-update.component-CUgQPcR4.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-update.component-lGwicZKW.mjs +362 -0
- package/fesm2022/sdcorejs-angular-modules-pattern-update.component-lGwicZKW.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-modules-pattern.mjs +2 -0
- package/fesm2022/sdcorejs-angular-modules-pattern.mjs.map +1 -0
- package/fesm2022/sdcorejs-angular-services-api.mjs +11 -11
- package/fesm2022/sdcorejs-angular-services-api.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-services-cache.mjs +7 -5
- package/fesm2022/sdcorejs-angular-services-cache.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-services-storage.mjs +6 -4
- package/fesm2022/sdcorejs-angular-services-storage.mjs.map +1 -1
- package/fesm2022/sdcorejs-angular-services-unsaved-changes.mjs +104 -4
- package/fesm2022/sdcorejs-angular-services-unsaved-changes.mjs.map +1 -1
- package/modules/pattern/README.md +76 -0
- package/modules/pattern/docs/detail.md +237 -0
- package/modules/pattern/docs/drawer.md +484 -0
- package/modules/pattern/docs/flow.md +631 -0
- package/modules/pattern/docs/form.md +815 -0
- package/modules/pattern/docs/header-actions.md +344 -0
- package/modules/pattern/docs/list.md +247 -0
- package/modules/pattern/docs/relation.md +180 -0
- package/modules/pattern/docs/select.md +214 -0
- package/modules/pattern/docs/split.md +350 -0
- package/modules/pattern/docs/states.md +168 -0
- package/modules/pattern/features/approval/entity.resolver.ts +21 -0
- package/modules/pattern/features/approval/pages/detail/detail.component.ts +139 -0
- package/modules/pattern/features/approval/pages/list/approval-inbox.ts +7 -0
- package/modules/pattern/features/approval/pages/list/list.component.html +20 -0
- package/modules/pattern/features/approval/pages/list/list.component.ts +149 -0
- package/modules/pattern/features/approval/routes.ts +30 -0
- package/modules/pattern/features/approval/services/approval.model.ts +38 -0
- package/modules/pattern/features/approval/services/approval.service.ts +23 -0
- package/modules/pattern/features/category/components/create-side-drawer/create-side-drawer.component.ts +130 -0
- package/modules/pattern/features/category/components/general-information-form/general-information-form.component.ts +61 -0
- package/modules/pattern/features/category/components/update-side-drawer/update-side-drawer.component.ts +134 -0
- package/modules/pattern/features/category/entity.resolver.ts +27 -0
- package/modules/pattern/features/category/pages/list/list.component.html +20 -0
- package/modules/pattern/features/category/pages/list/list.component.ts +105 -0
- package/modules/pattern/features/category/routes.ts +42 -0
- package/modules/pattern/features/category/services/category.model.ts +39 -0
- package/modules/pattern/features/category/services/category.service.ts +36 -0
- package/modules/pattern/features/customer/components/create-side-drawer/create-side-drawer.component.ts +138 -0
- package/modules/pattern/features/customer/components/customer-select/customer-select.component.ts +72 -0
- package/modules/pattern/features/customer/components/customer-type-select/customer-type-select.component.ts +30 -0
- package/modules/pattern/features/customer/components/debts-view/debts-view.component.ts +28 -0
- package/modules/pattern/features/customer/components/detail-side-drawer/detail-side-drawer.component.ts +106 -0
- package/modules/pattern/features/customer/components/documents-view/documents-view.component.ts +50 -0
- package/modules/pattern/features/customer/components/general-information-form/general-information-form.component.ts +140 -0
- package/modules/pattern/features/customer/components/general-information-view/general-information-view.component.ts +39 -0
- package/modules/pattern/features/customer/components/orders-view/orders-view.component.ts +35 -0
- package/modules/pattern/features/customer/components/summary-cards/summary-cards.component.ts +101 -0
- package/modules/pattern/features/customer/components/update-side-drawer/update-side-drawer.component.ts +127 -0
- package/modules/pattern/features/customer/entity.resolver.ts +21 -0
- package/modules/pattern/features/customer/pages/list/list.component.html +22 -0
- package/modules/pattern/features/customer/pages/list/list.component.ts +113 -0
- package/modules/pattern/features/customer/pages/profile/profile.component.ts +120 -0
- package/modules/pattern/features/customer/pipes/customer-detail.pipe.ts +18 -0
- package/modules/pattern/features/customer/routes.ts +59 -0
- package/modules/pattern/features/customer/services/customer.model.ts +87 -0
- package/modules/pattern/features/customer/services/customer.service.ts +79 -0
- package/modules/pattern/features/import/components/mapping-form/mapping-form.component.ts +41 -0
- package/modules/pattern/features/import/components/preview-view/preview-view.component.ts +44 -0
- package/modules/pattern/features/import/pages/flow/flow.component.ts +269 -0
- package/modules/pattern/features/import/routes.ts +19 -0
- package/modules/pattern/features/import/services/import.model.ts +82 -0
- package/modules/pattern/features/import/services/import.service.ts +18 -0
- package/modules/pattern/features/order/components/approval-steps/approval-steps.component.ts +74 -0
- package/modules/pattern/features/order/components/bulk-result/bulk-result.component.ts +46 -0
- package/modules/pattern/features/order/components/general-information-form/general-information-form.component.ts +96 -0
- package/modules/pattern/features/order/components/lines-form/lines-form.component.ts +182 -0
- package/modules/pattern/features/order/components/lines-form/order-lines.ts +101 -0
- package/modules/pattern/features/order/components/lines-table-form/lines-table-form.component.ts +196 -0
- package/modules/pattern/features/order/components/lines-view/lines-view.component.ts +42 -0
- package/modules/pattern/features/order/components/summary-cards/summary-cards.component.ts +128 -0
- package/modules/pattern/features/order/entity.resolver.ts +37 -0
- package/modules/pattern/features/order/pages/create/create.component.ts +113 -0
- package/modules/pattern/features/order/pages/detail/detail.component.ts +224 -0
- package/modules/pattern/features/order/pages/list/list.component.html +38 -0
- package/modules/pattern/features/order/pages/list/list.component.ts +291 -0
- package/modules/pattern/features/order/pages/update/update.component.ts +126 -0
- package/modules/pattern/features/order/routes.ts +54 -0
- package/modules/pattern/features/order/services/order.model.ts +109 -0
- package/modules/pattern/features/order/services/order.service.ts +63 -0
- package/modules/pattern/features/partner/pages/create/create.component.ts +324 -0
- package/modules/pattern/features/partner/routes.ts +20 -0
- package/modules/pattern/features/partner/services/partner.model.ts +30 -0
- package/modules/pattern/features/partner/services/partner.service.ts +17 -0
- package/modules/pattern/features/product/components/general-information-form/general-information-form.component.ts +88 -0
- package/modules/pattern/features/product/components/product-select/product-select.component.ts +73 -0
- package/modules/pattern/features/product/components/product-status-select/product-status-select.component.ts +30 -0
- package/modules/pattern/features/product/entity.resolver.ts +21 -0
- package/modules/pattern/features/product/pages/create/create.component.ts +92 -0
- package/modules/pattern/features/product/pages/detail/detail.component.ts +53 -0
- package/modules/pattern/features/product/pages/list/list.component.html +30 -0
- package/modules/pattern/features/product/pages/list/list.component.ts +71 -0
- package/modules/pattern/features/product/pages/update/update.component.ts +86 -0
- package/modules/pattern/features/product/pipes/product-detail.pipe.ts +18 -0
- package/modules/pattern/features/product/routes.ts +48 -0
- package/modules/pattern/features/product/services/product.model.ts +38 -0
- package/modules/pattern/features/product/services/product.service.ts +48 -0
- package/modules/pattern/features/settings/pages/update/update.component.ts +228 -0
- package/modules/pattern/features/settings/routes.ts +24 -0
- package/modules/pattern/features/settings/services/settings.model.ts +18 -0
- package/modules/pattern/features/settings/services/settings.service.ts +15 -0
- package/modules/pattern/features/settings/settings.resolver.ts +8 -0
- package/package.json +5 -1
- package/types/sdcorejs-angular-components-badge.d.ts +19 -1
- package/types/sdcorejs-angular-components-query-bar.d.ts +126 -11
- package/types/sdcorejs-angular-components-section.d.ts +13 -1
- package/types/sdcorejs-angular-components-splitter.d.ts +1 -1
- package/types/sdcorejs-angular-components-tab-router.d.ts +47 -5
- package/types/sdcorejs-angular-components-table.d.ts +300 -25
- package/types/sdcorejs-angular-components-upload-file.d.ts +181 -21
- package/types/sdcorejs-angular-forms-chip.d.ts +136 -26
- package/types/sdcorejs-angular-i18n.d.ts +70 -1
- package/types/sdcorejs-angular-modules-layout.d.ts +89 -6
- package/types/sdcorejs-angular-modules-pattern.d.ts +50 -0
- package/types/sdcorejs-angular-services-api.d.ts +5 -5
- package/types/sdcorejs-angular-services-cache.d.ts +4 -2
- package/types/sdcorejs-angular-services-storage.d.ts +3 -1
- package/types/sdcorejs-angular-services-unsaved-changes.d.ts +11 -0
|
@@ -0,0 +1,815 @@
|
|
|
1
|
+
# Form
|
|
2
|
+
|
|
3
|
+
Tạo hoặc cập nhật một bản ghi trong một bước: `sd-page-form`. Route mẫu: `/pattern/product/create` và `/pattern/product/:id/update` (một section), `/pattern/order/create` và `/pattern/order/:id/update` (dòng hàng nhập trực tiếp, mục lục; thêm `?lines=sd-table` để xem cùng bảng dựng bằng `sd-table`), `/pattern/settings` (một bản ghi, nhiều nhóm, trạng thái lưu ở footer).
|
|
4
|
+
|
|
5
|
+
## Khi nào dùng / khi nào không
|
|
6
|
+
|
|
7
|
+
- Dùng khi form cần cả trang: nhiều nhóm, bảng dòng chi tiết, hoặc người dùng cần tập trung.
|
|
8
|
+
- Form ngắn sửa ngay trên danh sách: dùng drawer ([drawer](drawer.md)).
|
|
9
|
+
- Nhiều bước có điều kiện chuyển bước: dùng [flow](flow.md).
|
|
10
|
+
|
|
11
|
+
## Code mẫu
|
|
12
|
+
|
|
13
|
+
Nhóm field nằm trong component `-form` dùng chung cho tạo và cập nhật; field Core tự đăng ký control qua `[form]` + `name`. Thân section là `row px-16 pt-16 pb-8`: field thẳng lề 16px với title của section; dưới hàng cuối còn chỗ dành cho lỗi của field, nên đáy chỉ cần 8px:
|
|
14
|
+
|
|
15
|
+
<!-- @source features/product/components/general-information-form/general-information-form.component.ts -->
|
|
16
|
+
```ts
|
|
17
|
+
import { ChangeDetectionStrategy, Component, input } from '@angular/core';
|
|
18
|
+
import type { FormControl, FormGroup } from '@angular/forms';
|
|
19
|
+
import { SdSection } from '@sdcorejs/angular/components/section';
|
|
20
|
+
import { SdInput } from '@sdcorejs/angular/forms/input';
|
|
21
|
+
import { SdInputNumber } from '@sdcorejs/angular/forms/input-number';
|
|
22
|
+
import type { ProductSaveReq, ProductStatus } from '../../services/product.model';
|
|
23
|
+
import { ProductStatusSelectComponent } from '../product-status-select/product-status-select.component';
|
|
24
|
+
|
|
25
|
+
/** Các field Core tự đăng ký control qua `[form]` + `name`; page không khai báo trước control trùng tên. */
|
|
26
|
+
export type ProductForm = FormGroup<{
|
|
27
|
+
code?: FormControl<string>;
|
|
28
|
+
name?: FormControl<string>;
|
|
29
|
+
unit?: FormControl<string>;
|
|
30
|
+
price?: FormControl<number>;
|
|
31
|
+
status?: FormControl<ProductStatus>;
|
|
32
|
+
}>;
|
|
33
|
+
|
|
34
|
+
/** Giá trị form → request lưu. `code` truyền vào khi cập nhật (mã bị khoá). */
|
|
35
|
+
export function productSaveReq(form: ProductForm, code?: string): ProductSaveReq {
|
|
36
|
+
const value = form.getRawValue();
|
|
37
|
+
return {
|
|
38
|
+
code: code ?? value.code ?? '',
|
|
39
|
+
name: value.name ?? '',
|
|
40
|
+
unit: value.unit ?? '',
|
|
41
|
+
price: value.price ?? 0,
|
|
42
|
+
status: value.status ?? 'active',
|
|
43
|
+
};
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
/** Nhóm "Thông tin chung" của form sản phẩm, dùng chung cho tạo mới và cập nhật. */
|
|
47
|
+
@Component({
|
|
48
|
+
selector: 'general-information-form',
|
|
49
|
+
standalone: true,
|
|
50
|
+
imports: [SdInput, SdInputNumber, SdSection, ProductStatusSelectComponent],
|
|
51
|
+
changeDetection: ChangeDetectionStrategy.OnPush,
|
|
52
|
+
template: `<sd-section title="Thông tin chung">
|
|
53
|
+
<div class="row px-16 pt-16 pb-8">
|
|
54
|
+
<div class="col-12 col-md-6">
|
|
55
|
+
<sd-input
|
|
56
|
+
label="Mã sản phẩm"
|
|
57
|
+
name="code"
|
|
58
|
+
autoId="product-code"
|
|
59
|
+
[form]="form()"
|
|
60
|
+
[model]="seed().code"
|
|
61
|
+
[disabled]="editing()"
|
|
62
|
+
[inlineError]="errors()['code']"
|
|
63
|
+
maxlength="20"
|
|
64
|
+
required />
|
|
65
|
+
</div>
|
|
66
|
+
<div class="col-12 col-md-6">
|
|
67
|
+
<sd-input
|
|
68
|
+
label="Tên sản phẩm"
|
|
69
|
+
name="name"
|
|
70
|
+
autoId="product-name"
|
|
71
|
+
[form]="form()"
|
|
72
|
+
[model]="seed().name"
|
|
73
|
+
[inlineError]="errors()['name']"
|
|
74
|
+
maxlength="100"
|
|
75
|
+
required />
|
|
76
|
+
</div>
|
|
77
|
+
<div class="col-12 col-md-6">
|
|
78
|
+
<sd-input label="Đơn vị tính" name="unit" autoId="product-unit" [form]="form()" [model]="seed().unit" maxlength="20" />
|
|
79
|
+
</div>
|
|
80
|
+
<div class="col-12 col-md-6">
|
|
81
|
+
<sd-input-number
|
|
82
|
+
label="Giá bán (₫)"
|
|
83
|
+
name="price"
|
|
84
|
+
autoId="product-price"
|
|
85
|
+
type="positive"
|
|
86
|
+
[precision]="0"
|
|
87
|
+
[form]="form()"
|
|
88
|
+
[model]="seed().price"
|
|
89
|
+
[inlineError]="errors()['price']"
|
|
90
|
+
required />
|
|
91
|
+
</div>
|
|
92
|
+
<div class="col-12 col-md-6">
|
|
93
|
+
<product-status-select [form]="form()" [model]="seed().status" />
|
|
94
|
+
</div>
|
|
95
|
+
</div>
|
|
96
|
+
</sd-section>`,
|
|
97
|
+
})
|
|
98
|
+
export class GeneralInformationFormComponent {
|
|
99
|
+
readonly form = input.required<FormGroup>();
|
|
100
|
+
readonly seed = input.required<ProductSaveReq>();
|
|
101
|
+
readonly editing = input(false);
|
|
102
|
+
/** Lỗi theo field do API trả về. */
|
|
103
|
+
readonly errors = input<Readonly<Record<string, string>>>({});
|
|
104
|
+
}
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
Trang tạo: Huỷ · Tạo sản phẩm ở `headerRight`, lưu lỗi thì focus field lỗi đầu tiên và gắn lỗi của API vào field, lưu xong sang chi tiết bằng `replaceUrl`:
|
|
108
|
+
|
|
109
|
+
<!-- @source features/product/pages/create/create.component.ts -->
|
|
110
|
+
```ts
|
|
111
|
+
import { afterNextRender, ChangeDetectionStrategy, Component, DestroyRef, ElementRef, inject, Injector, signal } from '@angular/core';
|
|
112
|
+
import { FormGroup } from '@angular/forms';
|
|
113
|
+
import { ActivatedRoute, Router } from '@angular/router';
|
|
114
|
+
import { firstValueFrom } from 'rxjs';
|
|
115
|
+
import { SdButton } from '@sdcorejs/angular/components/button';
|
|
116
|
+
import { SdPageComponent } from '@sdcorejs/angular/modules/layout';
|
|
117
|
+
import { SdNotifyService } from '@sdcorejs/angular/services/notify';
|
|
118
|
+
import { registerSdUnsavedChangesForm, SdUnsavedChangesService } from '@sdcorejs/angular/services/unsaved-changes';
|
|
119
|
+
import { apiErrorMessage } from '../../../../utils/api-error';
|
|
120
|
+
import { focusFirstInvalid } from '../../../../utils/focus-first-invalid';
|
|
121
|
+
import { formApiErrors } from '../../../../utils/form-api-errors';
|
|
122
|
+
import {
|
|
123
|
+
GeneralInformationFormComponent,
|
|
124
|
+
productSaveReq,
|
|
125
|
+
type ProductForm,
|
|
126
|
+
} from '../../components/general-information-form/general-information-form.component';
|
|
127
|
+
import { ProductService } from '../../services/product.service';
|
|
128
|
+
import type { ProductSaveReq } from '../../services/product.model';
|
|
129
|
+
|
|
130
|
+
@Component({
|
|
131
|
+
selector: 'create',
|
|
132
|
+
standalone: true,
|
|
133
|
+
changeDetection: ChangeDetectionStrategy.OnPush,
|
|
134
|
+
imports: [SdPageComponent, SdButton, GeneralInformationFormComponent],
|
|
135
|
+
template: `
|
|
136
|
+
<sd-page-form title="Tạo mới sản phẩm" [backLink]="['..']">
|
|
137
|
+
<div headerRight class="d-flex align-items-center gap-8">
|
|
138
|
+
<sd-button title="Huỷ" type="outline" autoId="product-cancel" (click)="cancel()" />
|
|
139
|
+
<sd-button
|
|
140
|
+
title="Tạo sản phẩm"
|
|
141
|
+
prefixIcon="save"
|
|
142
|
+
type="fill"
|
|
143
|
+
color="primary"
|
|
144
|
+
autoId="product-save"
|
|
145
|
+
[loading]="saving()"
|
|
146
|
+
(click)="save()" />
|
|
147
|
+
</div>
|
|
148
|
+
<div class="py-16">
|
|
149
|
+
<general-information-form [form]="form" [seed]="seed" [errors]="apiErrors.errors()" />
|
|
150
|
+
</div>
|
|
151
|
+
</sd-page-form>
|
|
152
|
+
`,
|
|
153
|
+
})
|
|
154
|
+
export class CreateComponent {
|
|
155
|
+
readonly #productService = inject(ProductService);
|
|
156
|
+
readonly #notify = inject(SdNotifyService);
|
|
157
|
+
readonly #router = inject(Router);
|
|
158
|
+
readonly #route = inject(ActivatedRoute);
|
|
159
|
+
readonly #host: HTMLElement = inject(ElementRef).nativeElement;
|
|
160
|
+
readonly #injector = inject(Injector);
|
|
161
|
+
protected readonly seed: ProductSaveReq = { code: '', name: '', unit: 'Cái', price: 0, status: 'active' };
|
|
162
|
+
protected readonly form: ProductForm = new FormGroup({});
|
|
163
|
+
protected readonly saving = signal(false);
|
|
164
|
+
protected readonly apiErrors = formApiErrors(this.form);
|
|
165
|
+
// Dirty theo giá trị: gõ rồi xoá về như cũ thì rời trang không bị hỏi.
|
|
166
|
+
readonly #unsaved = registerSdUnsavedChangesForm(inject(SdUnsavedChangesService), this.form, { id: 'product-create', dirty: 'value' });
|
|
167
|
+
|
|
168
|
+
constructor() {
|
|
169
|
+
inject(DestroyRef).onDestroy(() => this.#unsaved.destroy());
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
protected cancel(): void {
|
|
173
|
+
void this.#router.navigate(['..'], { relativeTo: this.#route });
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
protected async save(): Promise<void> {
|
|
177
|
+
if (this.saving()) return;
|
|
178
|
+
this.form.markAllAsTouched();
|
|
179
|
+
if (this.form.invalid) {
|
|
180
|
+
this.#focusFirstInvalid();
|
|
181
|
+
return;
|
|
182
|
+
}
|
|
183
|
+
this.saving.set(true);
|
|
184
|
+
try {
|
|
185
|
+
const product = await firstValueFrom(this.#productService.create(productSaveReq(this.form)));
|
|
186
|
+
this.#unsaved.markPristine();
|
|
187
|
+
this.#notify.success(`Đã tạo sản phẩm ${product.code}.`);
|
|
188
|
+
// replaceUrl: Back ở trang chi tiết về danh sách, không quay lại form tạo mới.
|
|
189
|
+
await this.#router.navigate(['..', product.id, 'detail'], { relativeTo: this.#route, replaceUrl: true });
|
|
190
|
+
} catch (error) {
|
|
191
|
+
// Lưu lỗi: giữ nguyên dữ liệu đã nhập; lỗi theo field hiện ngay trên field.
|
|
192
|
+
if (this.apiErrors.set(error)) this.#focusFirstInvalid();
|
|
193
|
+
else this.#notify.error(apiErrorMessage(error, 'Không thể lưu. Dữ liệu đã nhập vẫn được giữ.'));
|
|
194
|
+
} finally {
|
|
195
|
+
this.saving.set(false);
|
|
196
|
+
}
|
|
197
|
+
}
|
|
198
|
+
|
|
199
|
+
#focusFirstInvalid(): void {
|
|
200
|
+
afterNextRender(() => focusFirstInvalid(this.#host), { injector: this.#injector });
|
|
201
|
+
}
|
|
202
|
+
}
|
|
203
|
+
```
|
|
204
|
+
|
|
205
|
+
Trang cập nhật: mã bị khoá, dirty tính theo giá trị:
|
|
206
|
+
|
|
207
|
+
<!-- @source features/product/pages/update/update.component.ts -->
|
|
208
|
+
```ts
|
|
209
|
+
import { afterNextRender, ChangeDetectionStrategy, Component, DestroyRef, ElementRef, inject, Injector, signal } from '@angular/core';
|
|
210
|
+
import { toSignal } from '@angular/core/rxjs-interop';
|
|
211
|
+
import { FormGroup } from '@angular/forms';
|
|
212
|
+
import { ActivatedRoute, Router } from '@angular/router';
|
|
213
|
+
import { firstValueFrom, map } from 'rxjs';
|
|
214
|
+
import { SdButton } from '@sdcorejs/angular/components/button';
|
|
215
|
+
import { SdPageComponent } from '@sdcorejs/angular/modules/layout';
|
|
216
|
+
import { SdNotifyService } from '@sdcorejs/angular/services/notify';
|
|
217
|
+
import { registerSdUnsavedChangesForm, SdUnsavedChangesService } from '@sdcorejs/angular/services/unsaved-changes';
|
|
218
|
+
import { apiErrorMessage } from '../../../../utils/api-error';
|
|
219
|
+
import { focusFirstInvalid } from '../../../../utils/focus-first-invalid';
|
|
220
|
+
import { formApiErrors } from '../../../../utils/form-api-errors';
|
|
221
|
+
import {
|
|
222
|
+
GeneralInformationFormComponent,
|
|
223
|
+
productSaveReq,
|
|
224
|
+
type ProductForm,
|
|
225
|
+
} from '../../components/general-information-form/general-information-form.component';
|
|
226
|
+
import { ProductService } from '../../services/product.service';
|
|
227
|
+
import type { ProductDto } from '../../services/product.model';
|
|
228
|
+
|
|
229
|
+
@Component({
|
|
230
|
+
selector: 'update',
|
|
231
|
+
standalone: true,
|
|
232
|
+
changeDetection: ChangeDetectionStrategy.OnPush,
|
|
233
|
+
imports: [SdPageComponent, SdButton, GeneralInformationFormComponent],
|
|
234
|
+
template: `
|
|
235
|
+
<sd-page-form [title]="'Cập nhật sản phẩm #' + entity().code" [backLink]="['../detail']">
|
|
236
|
+
<div headerRight class="d-flex align-items-center gap-8">
|
|
237
|
+
<sd-button title="Huỷ" type="outline" autoId="product-cancel" (click)="cancel()" />
|
|
238
|
+
<sd-button title="Lưu" prefixIcon="save" type="fill" color="primary" autoId="product-save" [loading]="saving()" (click)="save()" />
|
|
239
|
+
</div>
|
|
240
|
+
<div class="py-16">
|
|
241
|
+
<general-information-form [form]="form" [seed]="entity()" [editing]="true" [errors]="apiErrors.errors()" />
|
|
242
|
+
</div>
|
|
243
|
+
</sd-page-form>
|
|
244
|
+
`,
|
|
245
|
+
})
|
|
246
|
+
export class UpdateComponent {
|
|
247
|
+
readonly #productService = inject(ProductService);
|
|
248
|
+
readonly #notify = inject(SdNotifyService);
|
|
249
|
+
readonly #router = inject(Router);
|
|
250
|
+
readonly #route = inject(ActivatedRoute);
|
|
251
|
+
readonly #host: HTMLElement = inject(ElementRef).nativeElement;
|
|
252
|
+
readonly #injector = inject(Injector);
|
|
253
|
+
/** Sản phẩm do resolver tải; draft khởi tạo từ đây, sửa draft không đổi bản ghi trước khi lưu thành công. */
|
|
254
|
+
protected readonly entity = toSignal(this.#route.data.pipe(map(data => data['entity'] as ProductDto)), { requireSync: true });
|
|
255
|
+
protected readonly form: ProductForm = new FormGroup({});
|
|
256
|
+
protected readonly saving = signal(false);
|
|
257
|
+
protected readonly apiErrors = formApiErrors(this.form);
|
|
258
|
+
readonly #unsaved = registerSdUnsavedChangesForm(inject(SdUnsavedChangesService), this.form, { id: 'product-update', dirty: 'value' });
|
|
259
|
+
|
|
260
|
+
constructor() {
|
|
261
|
+
inject(DestroyRef).onDestroy(() => this.#unsaved.destroy());
|
|
262
|
+
}
|
|
263
|
+
|
|
264
|
+
protected cancel(): void {
|
|
265
|
+
void this.#router.navigate(['../detail'], { relativeTo: this.#route });
|
|
266
|
+
}
|
|
267
|
+
|
|
268
|
+
protected async save(): Promise<void> {
|
|
269
|
+
if (this.saving()) return;
|
|
270
|
+
this.form.markAllAsTouched();
|
|
271
|
+
if (this.form.invalid) {
|
|
272
|
+
this.#focusFirstInvalid();
|
|
273
|
+
return;
|
|
274
|
+
}
|
|
275
|
+
this.saving.set(true);
|
|
276
|
+
try {
|
|
277
|
+
// Mã bị khoá sau khi tạo: gửi mã của bản ghi, không lấy từ form.
|
|
278
|
+
await firstValueFrom(this.#productService.update(this.entity().id, productSaveReq(this.form, this.entity().code)));
|
|
279
|
+
this.#unsaved.markPristine();
|
|
280
|
+
this.#notify.success('Đã cập nhật sản phẩm.');
|
|
281
|
+
await this.#router.navigate(['../detail'], { relativeTo: this.#route, replaceUrl: true });
|
|
282
|
+
} catch (error) {
|
|
283
|
+
// Lưu lỗi: giữ nguyên draft để sửa và thử lại.
|
|
284
|
+
if (this.apiErrors.set(error)) this.#focusFirstInvalid();
|
|
285
|
+
else this.#notify.error(apiErrorMessage(error, 'Không thể lưu. Dữ liệu đã nhập vẫn được giữ.'));
|
|
286
|
+
} finally {
|
|
287
|
+
this.saving.set(false);
|
|
288
|
+
}
|
|
289
|
+
}
|
|
290
|
+
|
|
291
|
+
#focusFirstInvalid(): void {
|
|
292
|
+
afterNextRender(() => focusFirstInvalid(this.#host), { injector: this.#injector });
|
|
293
|
+
}
|
|
294
|
+
}
|
|
295
|
+
```
|
|
296
|
+
|
|
297
|
+
Dòng hàng nhập trực tiếp: trạng thái của dòng (FormArray `form.lines`, thành tiền, tổng, chọn sản phẩm thì điền đơn giá) nằm trong một hàm dùng chung cho hai cách dựng bảng bên dưới:
|
|
298
|
+
|
|
299
|
+
<!-- @source features/order/components/lines-form/order-lines.ts -->
|
|
300
|
+
```ts
|
|
301
|
+
import { computed, DestroyRef, effect, inject, signal, untracked, type Signal } from '@angular/core';
|
|
302
|
+
import { FormArray, FormGroup } from '@angular/forms';
|
|
303
|
+
import { firstValueFrom } from 'rxjs';
|
|
304
|
+
import { ProductService } from '../../../product/services/product.service';
|
|
305
|
+
import type { OrderLineDto } from '../../services/order.model';
|
|
306
|
+
import type { OrderForm } from '../general-information-form/general-information-form.component';
|
|
307
|
+
|
|
308
|
+
/** Một dòng đang nhập: field Core của dòng tự đăng ký vào `group`; `seed` là giá trị ban đầu của dòng. */
|
|
309
|
+
export interface OrderLineRow {
|
|
310
|
+
readonly key: number;
|
|
311
|
+
readonly group: FormGroup;
|
|
312
|
+
readonly seed: OrderLineDto;
|
|
313
|
+
}
|
|
314
|
+
|
|
315
|
+
export interface OrderLines {
|
|
316
|
+
readonly rows: Signal<readonly OrderLineRow[]>;
|
|
317
|
+
/** Thành tiền theo thứ tự của `rows`. */
|
|
318
|
+
readonly amounts: Signal<readonly number[]>;
|
|
319
|
+
readonly total: Signal<number>;
|
|
320
|
+
add(): void;
|
|
321
|
+
remove(row: OrderLineRow): void;
|
|
322
|
+
/** Chọn sản phẩm thì điền đơn giá hiện hành của sản phẩm. */
|
|
323
|
+
pick(row: OrderLineRow, productId: string | null | undefined): Promise<void>;
|
|
324
|
+
/** Gắn `form.lines` vào form khi field của các dòng vừa nạp đã đăng ký; gọi lại khi đã gắn thì không làm gì. */
|
|
325
|
+
attach(): void;
|
|
326
|
+
}
|
|
327
|
+
|
|
328
|
+
/**
|
|
329
|
+
* Dòng hàng của form đơn: mỗi dòng là một FormGroup trong `form.lines` (FormArray). Thành tiền và tổng tính lại khi
|
|
330
|
+
* giá trị đổi. `lines-form` (bảng HTML) và `lines-table-form` (`sd-table`) dùng chung, chỉ khác phần hiển thị.
|
|
331
|
+
* Gọi trong injection context của component.
|
|
332
|
+
*
|
|
333
|
+
* `registerSdUnsavedChangesForm(..., { dirty: 'value' })` lấy giá trị của một control lúc nó vào form làm giá trị đã
|
|
334
|
+
* lưu, nên `form.lines` chỉ vào form khi field của các dòng đã đăng ký; vào sớm hơn thì form vừa mở đã bị coi là có
|
|
335
|
+
* thay đổi. `<table>` vẽ dòng ngay trong lượt change detection đó (`attach: 'now'`); `sd-table` vẽ dòng sau lần đọc
|
|
336
|
+
* đầu, nên `lines-table-form` dùng `attach: 'manual'` rồi gọi `attach()` khi bảng đã vẽ.
|
|
337
|
+
*/
|
|
338
|
+
export function orderLines(
|
|
339
|
+
form: Signal<OrderForm>,
|
|
340
|
+
seed: Signal<readonly OrderLineDto[]>,
|
|
341
|
+
options: { readonly attach: 'now' | 'manual' } = { attach: 'now' }
|
|
342
|
+
): OrderLines {
|
|
343
|
+
const productService = inject(ProductService);
|
|
344
|
+
const array = new FormArray<FormGroup>([]);
|
|
345
|
+
const version = signal(0);
|
|
346
|
+
const rows = signal<readonly OrderLineRow[]>([]);
|
|
347
|
+
let nextKey = 0;
|
|
348
|
+
|
|
349
|
+
const attach = (): void => {
|
|
350
|
+
if (form().get('lines') !== array) form().setControl('lines', array);
|
|
351
|
+
};
|
|
352
|
+
const push = (line: OrderLineDto): void => {
|
|
353
|
+
const group = new FormGroup({});
|
|
354
|
+
array.push(group);
|
|
355
|
+
rows.update(items => [...items, { key: nextKey++, group, seed: line }]);
|
|
356
|
+
};
|
|
357
|
+
const load = (lines: readonly OrderLineDto[]): void => {
|
|
358
|
+
// why: gỡ ra rồi gắn lại, để giá trị đã lưu của `lines` là các dòng mới chứ không phải dòng của đơn trước.
|
|
359
|
+
if (form().get('lines') === array) form().removeControl('lines');
|
|
360
|
+
array.clear();
|
|
361
|
+
rows.set([]);
|
|
362
|
+
(lines.length ? lines : [{ productId: '', quantity: 1, unitPrice: 0 }]).forEach(push);
|
|
363
|
+
if (options.attach === 'now') attach();
|
|
364
|
+
};
|
|
365
|
+
|
|
366
|
+
const subscription = array.valueChanges.subscribe(() => version.update(value => value + 1));
|
|
367
|
+
inject(DestroyRef).onDestroy(() => subscription.unsubscribe());
|
|
368
|
+
// why: trang cập nhật được dùng lại khi chỉ đổi `:id`; dòng hàng phải theo đơn mới, không giữ dòng của đơn trước.
|
|
369
|
+
effect(() => {
|
|
370
|
+
const lines = seed();
|
|
371
|
+
untracked(() => load(lines));
|
|
372
|
+
});
|
|
373
|
+
|
|
374
|
+
const amounts = computed(() => {
|
|
375
|
+
version();
|
|
376
|
+
return rows().map(
|
|
377
|
+
row => Number(row.group.get('quantity')?.value ?? row.seed.quantity) * Number(row.group.get('unitPrice')?.value ?? row.seed.unitPrice)
|
|
378
|
+
);
|
|
379
|
+
});
|
|
380
|
+
|
|
381
|
+
return {
|
|
382
|
+
rows: rows.asReadonly(),
|
|
383
|
+
amounts,
|
|
384
|
+
total: computed(() => amounts().reduce((sum, amount) => sum + amount, 0)),
|
|
385
|
+
add: () => push({ productId: '', quantity: 1, unitPrice: 0 }),
|
|
386
|
+
remove: row => {
|
|
387
|
+
const index = rows().indexOf(row);
|
|
388
|
+
if (index < 0) return;
|
|
389
|
+
// why: đánh dấu đã sửa TRƯỚC khi gỡ, để dirty theo giá trị so với danh sách dòng lúc trước.
|
|
390
|
+
array.markAsDirty();
|
|
391
|
+
array.removeAt(index);
|
|
392
|
+
rows.update(items => items.filter(item => item !== row));
|
|
393
|
+
},
|
|
394
|
+
pick: async (row, productId) => {
|
|
395
|
+
if (!productId) return;
|
|
396
|
+
const product = await firstValueFrom(productService.cachedDetail(productId));
|
|
397
|
+
row.group.get('unitPrice')?.setValue(product.price);
|
|
398
|
+
},
|
|
399
|
+
attach,
|
|
400
|
+
};
|
|
401
|
+
}
|
|
402
|
+
```
|
|
403
|
+
|
|
404
|
+
Bảng dựng bằng `<table>`: field trong ô dùng `size="sm"` và `hideInlineError`, mọi ô căn giữa theo chiều dọc, lỗi của API là icon kèm tooltip trên đúng ô nên dòng không cao thêm:
|
|
405
|
+
|
|
406
|
+
<!-- @source features/order/components/lines-form/lines-form.component.ts -->
|
|
407
|
+
```ts
|
|
408
|
+
import { ChangeDetectionStrategy, Component, input } from '@angular/core';
|
|
409
|
+
import { SdButton } from '@sdcorejs/angular/components/button';
|
|
410
|
+
import { SdSection } from '@sdcorejs/angular/components/section';
|
|
411
|
+
import { SdInputNumber } from '@sdcorejs/angular/forms/input-number';
|
|
412
|
+
import { SdFormatNumberPipe } from '@sdcorejs/angular/pipes';
|
|
413
|
+
import { ProductSelectComponent } from '../../../product/components/product-select/product-select.component';
|
|
414
|
+
import type { OrderLineDto } from '../../services/order.model';
|
|
415
|
+
import type { OrderForm } from '../general-information-form/general-information-form.component';
|
|
416
|
+
import { orderLines } from './order-lines';
|
|
417
|
+
|
|
418
|
+
/**
|
|
419
|
+
* Bảng dòng hàng nhập trực tiếp, dựng bằng `<table>`: mỗi dòng là một FormGroup trong `form.lines` (FormArray, do
|
|
420
|
+
* `orderLines()` quản lý), các field Core tự đăng ký vào dòng. Chọn sản phẩm điền đơn giá; thành tiền và tổng tự
|
|
421
|
+
* tính. Field trong ô dùng `size="sm"` và `hideInlineError`: lỗi, kể cả lỗi API theo dòng (`lines.<i>.<field>`), là
|
|
422
|
+
* icon kèm tooltip ngay trên ô đó, dòng không cao thêm. Cùng bảng dựng bằng `sd-table`: `lines-table-form`.
|
|
423
|
+
*/
|
|
424
|
+
@Component({
|
|
425
|
+
selector: 'lines-form',
|
|
426
|
+
standalone: true,
|
|
427
|
+
imports: [SdSection, SdButton, SdInputNumber, SdFormatNumberPipe, ProductSelectComponent],
|
|
428
|
+
changeDetection: ChangeDetectionStrategy.OnPush,
|
|
429
|
+
template: `
|
|
430
|
+
<sd-section title="Dòng hàng">
|
|
431
|
+
<div sdHeaderRight>
|
|
432
|
+
<sd-button title="Thêm dòng" prefixIcon="add" type="text" autoId="order-line-add" (click)="lines.add()" />
|
|
433
|
+
</div>
|
|
434
|
+
<div class="lines-scroll">
|
|
435
|
+
<table class="lines">
|
|
436
|
+
<colgroup>
|
|
437
|
+
<col />
|
|
438
|
+
<col class="lines__quantity" />
|
|
439
|
+
<col class="lines__money" />
|
|
440
|
+
<col class="lines__money" />
|
|
441
|
+
<col class="lines__action" />
|
|
442
|
+
</colgroup>
|
|
443
|
+
<thead>
|
|
444
|
+
<tr>
|
|
445
|
+
<th scope="col">Sản phẩm <span class="text-error" aria-hidden="true">*</span></th>
|
|
446
|
+
<th scope="col" class="lines__number">Số lượng <span class="text-error" aria-hidden="true">*</span></th>
|
|
447
|
+
<th scope="col" class="lines__number">Đơn giá (₫) <span class="text-error" aria-hidden="true">*</span></th>
|
|
448
|
+
<th scope="col" class="lines__number">Thành tiền (₫)</th>
|
|
449
|
+
<th scope="col" class="lines__action"><span class="sd-visually-hidden">Xoá dòng</span></th>
|
|
450
|
+
</tr>
|
|
451
|
+
</thead>
|
|
452
|
+
<tbody>
|
|
453
|
+
@for (row of lines.rows(); track row.key; let index = $index) {
|
|
454
|
+
<tr [attr.data-line]="index">
|
|
455
|
+
<td>
|
|
456
|
+
<product-select
|
|
457
|
+
size="sm"
|
|
458
|
+
hideInlineError
|
|
459
|
+
[label]="undefined"
|
|
460
|
+
[form]="row.group"
|
|
461
|
+
[model]="row.seed.productId || null"
|
|
462
|
+
[inlineError]="errors()['lines.' + index + '.productId']"
|
|
463
|
+
[autoId]="'order-line-' + index + '-product'"
|
|
464
|
+
(modelChange)="lines.pick(row, $event)"
|
|
465
|
+
required />
|
|
466
|
+
</td>
|
|
467
|
+
<td class="lines__number">
|
|
468
|
+
<sd-input-number
|
|
469
|
+
name="quantity"
|
|
470
|
+
size="sm"
|
|
471
|
+
hideInlineError
|
|
472
|
+
type="positive"
|
|
473
|
+
[precision]="0"
|
|
474
|
+
[form]="row.group"
|
|
475
|
+
[model]="row.seed.quantity"
|
|
476
|
+
[inlineError]="errors()['lines.' + index + '.quantity']"
|
|
477
|
+
[autoId]="'order-line-' + index + '-quantity'"
|
|
478
|
+
required />
|
|
479
|
+
</td>
|
|
480
|
+
<td class="lines__number">
|
|
481
|
+
<sd-input-number
|
|
482
|
+
name="unitPrice"
|
|
483
|
+
size="sm"
|
|
484
|
+
hideInlineError
|
|
485
|
+
type="positive"
|
|
486
|
+
[precision]="0"
|
|
487
|
+
[form]="row.group"
|
|
488
|
+
[model]="row.seed.unitPrice"
|
|
489
|
+
[inlineError]="errors()['lines.' + index + '.unitPrice']"
|
|
490
|
+
[autoId]="'order-line-' + index + '-unit-price'"
|
|
491
|
+
required />
|
|
492
|
+
</td>
|
|
493
|
+
<td class="lines__number" [attr.data-autoid]="'order-line-' + index + '-amount'">
|
|
494
|
+
{{ lines.amounts()[index] | sdFormatNumber: 0 }}
|
|
495
|
+
</td>
|
|
496
|
+
<td class="lines__action">
|
|
497
|
+
<sd-button
|
|
498
|
+
prefixIcon="delete"
|
|
499
|
+
type="text"
|
|
500
|
+
color="error"
|
|
501
|
+
tooltip="Xoá dòng"
|
|
502
|
+
[autoId]="'order-line-' + index + '-remove'"
|
|
503
|
+
[disabled]="lines.rows().length === 1"
|
|
504
|
+
(click)="lines.remove(row)" />
|
|
505
|
+
</td>
|
|
506
|
+
</tr>
|
|
507
|
+
}
|
|
508
|
+
</tbody>
|
|
509
|
+
<tfoot>
|
|
510
|
+
<tr>
|
|
511
|
+
<th scope="row" colspan="3" class="lines__number">Tổng tiền (₫)</th>
|
|
512
|
+
<td class="lines__number lines__total" data-autoid="order-total">{{ lines.total() | sdFormatNumber: 0 }}</td>
|
|
513
|
+
<td class="lines__action"></td>
|
|
514
|
+
</tr>
|
|
515
|
+
</tfoot>
|
|
516
|
+
</table>
|
|
517
|
+
</div>
|
|
518
|
+
</sd-section>
|
|
519
|
+
`,
|
|
520
|
+
styles: `
|
|
521
|
+
/* Màn hẹp thì cuộn ngang trong section thay vì bóp cột sản phẩm. */
|
|
522
|
+
.lines-scroll {
|
|
523
|
+
overflow-x: auto;
|
|
524
|
+
}
|
|
525
|
+
/* Cột cố định, sản phẩm lấy phần còn lại: vừa thân 576px của sd-page-form. */
|
|
526
|
+
.lines {
|
|
527
|
+
width: 100%;
|
|
528
|
+
min-width: 544px;
|
|
529
|
+
border-collapse: collapse;
|
|
530
|
+
table-layout: fixed;
|
|
531
|
+
}
|
|
532
|
+
.lines__quantity {
|
|
533
|
+
width: 88px;
|
|
534
|
+
}
|
|
535
|
+
.lines__money {
|
|
536
|
+
width: 120px;
|
|
537
|
+
}
|
|
538
|
+
.lines__action {
|
|
539
|
+
width: 48px;
|
|
540
|
+
}
|
|
541
|
+
.lines th,
|
|
542
|
+
.lines td {
|
|
543
|
+
padding: 8px;
|
|
544
|
+
text-align: left;
|
|
545
|
+
vertical-align: middle;
|
|
546
|
+
}
|
|
547
|
+
/* Cột đầu và cuối thẳng lề 16px với title và nút "Thêm dòng" của section. */
|
|
548
|
+
.lines th:first-child,
|
|
549
|
+
.lines td:first-child {
|
|
550
|
+
padding-left: 16px;
|
|
551
|
+
}
|
|
552
|
+
.lines th:last-child,
|
|
553
|
+
.lines td:last-child {
|
|
554
|
+
padding-right: 16px;
|
|
555
|
+
}
|
|
556
|
+
.lines thead th {
|
|
557
|
+
color: var(--sd-text-secondary);
|
|
558
|
+
font-size: 12px;
|
|
559
|
+
font-weight: 500;
|
|
560
|
+
border-bottom: 1px solid var(--sd-border);
|
|
561
|
+
}
|
|
562
|
+
.lines tbody tr:first-child td {
|
|
563
|
+
padding-top: 12px;
|
|
564
|
+
}
|
|
565
|
+
.lines tbody tr:last-child td {
|
|
566
|
+
padding-bottom: 12px;
|
|
567
|
+
}
|
|
568
|
+
.lines__number {
|
|
569
|
+
text-align: right !important;
|
|
570
|
+
}
|
|
571
|
+
.lines tfoot th,
|
|
572
|
+
.lines tfoot td {
|
|
573
|
+
padding-top: 12px;
|
|
574
|
+
padding-bottom: 12px;
|
|
575
|
+
border-top: 1px solid var(--sd-border);
|
|
576
|
+
}
|
|
577
|
+
.lines__total {
|
|
578
|
+
font-weight: 500;
|
|
579
|
+
}
|
|
580
|
+
`,
|
|
581
|
+
})
|
|
582
|
+
export class LinesFormComponent {
|
|
583
|
+
readonly form = input.required<OrderForm>();
|
|
584
|
+
/** Dòng ban đầu (cập nhật) hoặc một dòng trống (tạo mới). */
|
|
585
|
+
readonly seed = input.required<readonly OrderLineDto[]>();
|
|
586
|
+
/** Lỗi theo field do API trả về, khoá dạng `lines.<index>.<field>`. */
|
|
587
|
+
readonly errors = input<Readonly<Record<string, string>>>({});
|
|
588
|
+
protected readonly lines = orderLines(this.form, this.seed);
|
|
589
|
+
}
|
|
590
|
+
```
|
|
591
|
+
|
|
592
|
+
Cùng dòng hàng dựng bằng `sd-table` (`/pattern/order/create?lines=sd-table`): nút thêm dòng ở header cột command (`sdTableCommandHeaderDef`), xoá dòng là command của bảng, số dòng và tổng tiền dưới bảng. Dòng đổi thì `reload()` bảng; `rowKey` giữ view của các dòng còn lại nên giá trị đang nhập không mất. `sd-table` vẽ dòng sau lần đọc đầu, nên `form.lines` chỉ vào form khi bảng đã vẽ (`attach: 'manual'` rồi `attach()` từ `reload.onReload`):
|
|
593
|
+
|
|
594
|
+
<!-- @source features/order/components/lines-table-form/lines-table-form.component.ts -->
|
|
595
|
+
```ts
|
|
596
|
+
import { afterNextRender, ChangeDetectionStrategy, Component, effect, inject, Injector, input, untracked, viewChild } from '@angular/core';
|
|
597
|
+
import { SdButton } from '@sdcorejs/angular/components/button';
|
|
598
|
+
import { SdSection } from '@sdcorejs/angular/components/section';
|
|
599
|
+
import {
|
|
600
|
+
SdTable,
|
|
601
|
+
SdTableCellDefDirective,
|
|
602
|
+
SdTableCommandHeaderDefDirective,
|
|
603
|
+
SdTableTitleDefDirective,
|
|
604
|
+
type SdTableOption,
|
|
605
|
+
} from '@sdcorejs/angular/components/table';
|
|
606
|
+
import { SdInputNumber } from '@sdcorejs/angular/forms/input-number';
|
|
607
|
+
import { SdFormatNumberPipe } from '@sdcorejs/angular/pipes';
|
|
608
|
+
import { ProductSelectComponent } from '../../../product/components/product-select/product-select.component';
|
|
609
|
+
import type { OrderLineDto } from '../../services/order.model';
|
|
610
|
+
import type { OrderForm } from '../general-information-form/general-information-form.component';
|
|
611
|
+
import { orderLines, type OrderLineRow } from '../lines-form/order-lines';
|
|
612
|
+
|
|
613
|
+
/** Dòng của `sd-table`: dòng form cộng tên các cột. Ô của mọi cột vẽ bằng `sdTableCellDef` từ `group`/`seed`. */
|
|
614
|
+
interface LineItem extends OrderLineRow {
|
|
615
|
+
readonly productId?: string;
|
|
616
|
+
readonly quantity?: number;
|
|
617
|
+
readonly unitPrice?: number;
|
|
618
|
+
readonly amount?: number;
|
|
619
|
+
}
|
|
620
|
+
|
|
621
|
+
/**
|
|
622
|
+
* Dòng hàng nhập trực tiếp, dựng bằng `sd-table` thay cho `<table>` của `lines-form`; trạng thái dòng vẫn là
|
|
623
|
+
* `orderLines()`. Bảng local, không phân trang, không lọc. Nút thêm dòng nằm ở header cột command
|
|
624
|
+
* (`sdTableCommandHeaderDef`), ngay trên nút xoá của từng dòng; field trong ô dùng `size="sm"` và `hideInlineError`,
|
|
625
|
+
* cột bắt buộc có `*` ở title; số dòng và tổng tiền ở dưới bảng. Dòng đổi thì `reload()` bảng; `rowKey` giữ view
|
|
626
|
+
* của các dòng còn lại nên giá trị đang nhập không mất. `form.lines` chỉ vào form khi bảng đã vẽ dòng (`attach`).
|
|
627
|
+
*/
|
|
628
|
+
@Component({
|
|
629
|
+
selector: 'lines-table-form',
|
|
630
|
+
standalone: true,
|
|
631
|
+
imports: [
|
|
632
|
+
SdSection,
|
|
633
|
+
SdButton,
|
|
634
|
+
SdTable,
|
|
635
|
+
SdTableCellDefDirective,
|
|
636
|
+
SdTableCommandHeaderDefDirective,
|
|
637
|
+
SdTableTitleDefDirective,
|
|
638
|
+
SdInputNumber,
|
|
639
|
+
SdFormatNumberPipe,
|
|
640
|
+
ProductSelectComponent,
|
|
641
|
+
],
|
|
642
|
+
changeDetection: ChangeDetectionStrategy.OnPush,
|
|
643
|
+
template: `
|
|
644
|
+
<sd-section title="Dòng hàng">
|
|
645
|
+
<sd-table autoId="order-lines" [option]="option">
|
|
646
|
+
<ng-template sdTableCommandHeaderDef>
|
|
647
|
+
<sd-button
|
|
648
|
+
tooltip="Thêm dòng"
|
|
649
|
+
prefixIcon="add"
|
|
650
|
+
size="sm"
|
|
651
|
+
type="light"
|
|
652
|
+
color="primary"
|
|
653
|
+
autoId="order-line-add"
|
|
654
|
+
(click)="lines.add()" />
|
|
655
|
+
</ng-template>
|
|
656
|
+
<ng-template sdTableTitleDef="productId">Sản phẩm <span class="text-error" aria-hidden="true">*</span></ng-template>
|
|
657
|
+
<ng-template sdTableTitleDef="quantity">Số lượng <span class="text-error" aria-hidden="true">*</span></ng-template>
|
|
658
|
+
<ng-template sdTableTitleDef="unitPrice">Đơn giá (₫) <span class="text-error" aria-hidden="true">*</span></ng-template>
|
|
659
|
+
<ng-template sdTableCellDef="productId" let-row="item">
|
|
660
|
+
@let index = lines.rows().indexOf(row);
|
|
661
|
+
<product-select
|
|
662
|
+
class="lines-table__input"
|
|
663
|
+
size="sm"
|
|
664
|
+
hideInlineError
|
|
665
|
+
[label]="undefined"
|
|
666
|
+
[form]="row.group"
|
|
667
|
+
[model]="row.seed.productId || null"
|
|
668
|
+
[inlineError]="errors()['lines.' + index + '.productId']"
|
|
669
|
+
[autoId]="'order-line-' + index + '-product'"
|
|
670
|
+
(modelChange)="lines.pick(row, $event)"
|
|
671
|
+
required />
|
|
672
|
+
</ng-template>
|
|
673
|
+
<ng-template sdTableCellDef="quantity" let-row="item">
|
|
674
|
+
@let index = lines.rows().indexOf(row);
|
|
675
|
+
<sd-input-number
|
|
676
|
+
class="lines-table__input"
|
|
677
|
+
name="quantity"
|
|
678
|
+
size="sm"
|
|
679
|
+
hideInlineError
|
|
680
|
+
type="positive"
|
|
681
|
+
[precision]="0"
|
|
682
|
+
[form]="row.group"
|
|
683
|
+
[model]="row.seed.quantity"
|
|
684
|
+
[inlineError]="errors()['lines.' + index + '.quantity']"
|
|
685
|
+
[autoId]="'order-line-' + index + '-quantity'"
|
|
686
|
+
required />
|
|
687
|
+
</ng-template>
|
|
688
|
+
<ng-template sdTableCellDef="unitPrice" let-row="item">
|
|
689
|
+
@let index = lines.rows().indexOf(row);
|
|
690
|
+
<sd-input-number
|
|
691
|
+
class="lines-table__input"
|
|
692
|
+
name="unitPrice"
|
|
693
|
+
size="sm"
|
|
694
|
+
hideInlineError
|
|
695
|
+
type="positive"
|
|
696
|
+
[precision]="0"
|
|
697
|
+
[form]="row.group"
|
|
698
|
+
[model]="row.seed.unitPrice"
|
|
699
|
+
[inlineError]="errors()['lines.' + index + '.unitPrice']"
|
|
700
|
+
[autoId]="'order-line-' + index + '-unit-price'"
|
|
701
|
+
required />
|
|
702
|
+
</ng-template>
|
|
703
|
+
<ng-template sdTableCellDef="amount" let-row="item">
|
|
704
|
+
@let index = lines.rows().indexOf(row);
|
|
705
|
+
<strong class="lines-table__amount" [attr.data-autoid]="'order-line-' + index + '-amount'">
|
|
706
|
+
{{ lines.amounts()[index] | sdFormatNumber: 0 }}
|
|
707
|
+
</strong>
|
|
708
|
+
</ng-template>
|
|
709
|
+
</sd-table>
|
|
710
|
+
<div class="lines-table__summary">
|
|
711
|
+
<span>{{ lines.rows().length }} dòng hàng</span>
|
|
712
|
+
<strong
|
|
713
|
+
>Tổng tiền: <span data-autoid="order-total">{{ lines.total() | sdFormatNumber: 0 }}</span> ₫</strong
|
|
714
|
+
>
|
|
715
|
+
</div>
|
|
716
|
+
</sd-section>
|
|
717
|
+
`,
|
|
718
|
+
styles: `
|
|
719
|
+
/* Field trong dòng: 6px trên dưới để dòng 44px vẫn thoáng. */
|
|
720
|
+
.lines-table__input {
|
|
721
|
+
display: block;
|
|
722
|
+
padding-block: 6px;
|
|
723
|
+
}
|
|
724
|
+
.lines-table__amount {
|
|
725
|
+
display: block;
|
|
726
|
+
text-align: right;
|
|
727
|
+
font-variant-numeric: tabular-nums;
|
|
728
|
+
}
|
|
729
|
+
.lines-table__summary {
|
|
730
|
+
display: flex;
|
|
731
|
+
justify-content: space-between;
|
|
732
|
+
gap: 8px;
|
|
733
|
+
padding: 12px 16px;
|
|
734
|
+
color: var(--sd-text-secondary);
|
|
735
|
+
}
|
|
736
|
+
.lines-table__summary strong {
|
|
737
|
+
color: var(--sd-text);
|
|
738
|
+
}
|
|
739
|
+
`,
|
|
740
|
+
})
|
|
741
|
+
export class LinesTableFormComponent {
|
|
742
|
+
readonly form = input.required<OrderForm>();
|
|
743
|
+
/** Dòng ban đầu (cập nhật) hoặc một dòng trống (tạo mới). */
|
|
744
|
+
readonly seed = input.required<readonly OrderLineDto[]>();
|
|
745
|
+
/** Lỗi theo field do API trả về, khoá dạng `lines.<index>.<field>`. */
|
|
746
|
+
readonly errors = input<Readonly<Record<string, string>>>({});
|
|
747
|
+
readonly #injector = inject(Injector);
|
|
748
|
+
private readonly table = viewChild(SdTable<LineItem>);
|
|
749
|
+
protected readonly lines = orderLines(this.form, this.seed, { attach: 'manual' });
|
|
750
|
+
protected readonly option: SdTableOption<LineItem> = {
|
|
751
|
+
type: 'local',
|
|
752
|
+
items: () => [...this.lines.rows()],
|
|
753
|
+
rowKey: 'key',
|
|
754
|
+
filter: { disabled: true },
|
|
755
|
+
paginate: { hidden: true, pageSize: 200 },
|
|
756
|
+
reload: {
|
|
757
|
+
visible: false,
|
|
758
|
+
// why: sd-table vẽ dòng sau lần đọc; field trong ô đăng ký xong thì mới gắn `form.lines` (xem `orderLines`).
|
|
759
|
+
onReload: () => {
|
|
760
|
+
afterNextRender(() => this.lines.attach(), { injector: this.#injector });
|
|
761
|
+
},
|
|
762
|
+
},
|
|
763
|
+
config: { visible: false },
|
|
764
|
+
columns: [
|
|
765
|
+
{ field: 'productId', title: 'Sản phẩm', type: 'string', minWidth: '180px' },
|
|
766
|
+
{ field: 'quantity', title: 'Số lượng', type: 'number', width: '88px' },
|
|
767
|
+
{ field: 'unitPrice', title: 'Đơn giá (₫)', type: 'number', width: '120px' },
|
|
768
|
+
{ field: 'amount', title: 'Thành tiền (₫)', type: 'number', width: '120px', align: 'right' },
|
|
769
|
+
],
|
|
770
|
+
command: {
|
|
771
|
+
commands: [
|
|
772
|
+
{
|
|
773
|
+
title: 'Xoá dòng',
|
|
774
|
+
icon: 'delete',
|
|
775
|
+
color: 'error',
|
|
776
|
+
disabled: () => this.lines.rows().length === 1,
|
|
777
|
+
click: row => this.lines.remove(row),
|
|
778
|
+
},
|
|
779
|
+
],
|
|
780
|
+
},
|
|
781
|
+
};
|
|
782
|
+
|
|
783
|
+
constructor() {
|
|
784
|
+
// why: bảng local chỉ đọc `items` khi tải; thêm, xoá dòng hay nạp đơn khác đều phải `reload()` để vẽ lại. Gọi sau
|
|
785
|
+
// lượt render, khi `option` của bảng đã được gán.
|
|
786
|
+
effect(() => {
|
|
787
|
+
this.lines.rows();
|
|
788
|
+
untracked(() => afterNextRender(() => void this.table()?.reload(), { injector: this.#injector }));
|
|
789
|
+
});
|
|
790
|
+
}
|
|
791
|
+
}
|
|
792
|
+
```
|
|
793
|
+
|
|
794
|
+
## Quy tắc
|
|
795
|
+
|
|
796
|
+
- MUST đặt Huỷ (outline) và nút lưu (fill, primary) ở `headerRight` của `sd-page-form` (E3); không lặp nút lưu ở cuối thân.
|
|
797
|
+
- SHOULD cho nút lưu icon `save`; trang tạo ghi rõ hành động ("Tạo đơn hàng"), trang cập nhật ghi "Lưu".
|
|
798
|
+
- MUST đặt title "Tạo mới <entity>" hoặc "Cập nhật <entity> #<mã>" (E5).
|
|
799
|
+
- MUST bảo vệ thay đổi chưa lưu: `canDeactivate: [sdPageFormLeaveGuard]` trên route và `registerSdUnsavedChangesForm(..., { dirty: 'value' })` trong trang. Gõ rồi sửa về như cũ không bị hỏi; đóng tab trình duyệt khi còn thay đổi có hộp thoại của trình duyệt.
|
|
800
|
+
- MUST kiểm tra khi rời field và khi bấm Lưu (`markAllAsTouched`); lưu lỗi thì focus field lỗi đầu tiên (E13).
|
|
801
|
+
- MUST gắn lỗi theo field của API vào đúng field (`[inlineError]`), giữ nguyên dữ liệu đã nhập; field đổi giá trị thì bỏ lỗi cũ của nó.
|
|
802
|
+
- MUST lưu xong thì `markPristine()` trước khi điều hướng, sang chi tiết với `replaceUrl: true` để Back không quay lại form tạo mới.
|
|
803
|
+
- MUST không khai báo trước FormControl trùng tên với field Core tự đăng ký.
|
|
804
|
+
- MUST dùng `size="sm"` và `hideInlineError` cho field trong ô của bảng dòng, dù bảng là `<table>` hay `sd-table`; field trong ô không có label, cột bắt buộc có `*` màu error sau title.
|
|
805
|
+
- SHOULD dùng `toc` khi form có từ ba nhóm trở lên; mục lục lấy các `sd-section` có title, cả section nằm trong component `-form` con.
|
|
806
|
+
- SHOULD giữ bản ghi một dòng (cài đặt) ở lại trang sau khi lưu: `form.markAsPristine()` làm giá trị vừa lưu thành mốc so sánh mới, footer báo trạng thái lưu.
|
|
807
|
+
|
|
808
|
+
## Lỗi hay gặp
|
|
809
|
+
|
|
810
|
+
- Chụp giá trị ban đầu lúc khởi tạo form khi field Core chưa đăng ký: form vừa mở đã bị coi là có thay đổi. Dùng `dirty: 'value'` của `registerSdUnsavedChangesForm`.
|
|
811
|
+
- Bắt mọi lỗi lưu rồi báo chung "Không thể lưu": lỗi theo field của API mất chỗ hiện.
|
|
812
|
+
- Điều hướng sau khi lưu mà chưa `markPristine()`: guard hỏi "Rời trang khi chưa lưu?" ngay sau khi lưu xong.
|
|
813
|
+
- Bấm Lưu liên tiếp tạo hai request: chặn bằng cờ `saving` và trạng thái `loading` của nút.
|
|
814
|
+
- Gắn FormArray dòng hàng vào form trước khi field của các dòng đăng ký xong (`sd-table` vẽ dòng sau lần đọc đầu): `dirty: 'value'` lấy dòng còn trống làm giá trị đã lưu, form vừa mở đã hỏi "Rời trang khi chưa lưu?".
|
|
815
|
+
- Để field trong ô bảng ở cỡ `md` và lỗi hiện dưới field: ô số và select cao khác nhau, dòng có lỗi cao hơn các dòng khác, cột thành tiền và nút xoá lệch dòng.
|