@sdcorejs/angular 22.3.3 → 22.3.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (152) hide show
  1. package/fesm2022/sdcorejs-angular-components-form-generic.mjs +5 -5
  2. package/fesm2022/sdcorejs-angular-components-form-generic.mjs.map +1 -1
  3. package/fesm2022/sdcorejs-angular-components-import-excel.mjs +1 -1
  4. package/fesm2022/sdcorejs-angular-components-import-excel.mjs.map +1 -1
  5. package/fesm2022/sdcorejs-angular-components-modal.mjs +46 -10
  6. package/fesm2022/sdcorejs-angular-components-modal.mjs.map +1 -1
  7. package/fesm2022/sdcorejs-angular-components-query-bar.mjs +549 -82
  8. package/fesm2022/sdcorejs-angular-components-query-bar.mjs.map +1 -1
  9. package/fesm2022/sdcorejs-angular-components-table.mjs +6528 -3510
  10. package/fesm2022/sdcorejs-angular-components-table.mjs.map +1 -1
  11. package/fesm2022/sdcorejs-angular-forms-entity-picker.mjs +1 -1
  12. package/fesm2022/sdcorejs-angular-forms-entity-picker.mjs.map +1 -1
  13. package/fesm2022/sdcorejs-angular-forms-select.mjs +23 -4
  14. package/fesm2022/sdcorejs-angular-forms-select.mjs.map +1 -1
  15. package/fesm2022/sdcorejs-angular-forms-tree-select.mjs +1 -1
  16. package/fesm2022/sdcorejs-angular-forms-tree-select.mjs.map +1 -1
  17. package/fesm2022/sdcorejs-angular-i18n.mjs +330 -5
  18. package/fesm2022/sdcorejs-angular-i18n.mjs.map +1 -1
  19. package/fesm2022/sdcorejs-angular-modules-layout.mjs +97 -11
  20. package/fesm2022/sdcorejs-angular-modules-layout.mjs.map +1 -1
  21. package/fesm2022/{sdcorejs-angular-modules-pattern-base-api.service-Cfmr0L_5.mjs → sdcorejs-angular-modules-pattern-base-api.service-C2o5xPVB.mjs} +2 -2
  22. package/fesm2022/{sdcorejs-angular-modules-pattern-base-api.service-Cfmr0L_5.mjs.map → sdcorejs-angular-modules-pattern-base-api.service-C2o5xPVB.mjs.map} +1 -1
  23. package/fesm2022/{sdcorejs-angular-modules-pattern-create-side-drawer.component-CxgmaNod.mjs → sdcorejs-angular-modules-pattern-create-side-drawer.component-CRc9T7rb.mjs} +18 -4
  24. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-CRc9T7rb.mjs.map +1 -0
  25. package/fesm2022/{sdcorejs-angular-modules-pattern-create-side-drawer.component-C7-itJqB.mjs → sdcorejs-angular-modules-pattern-create-side-drawer.component-Cz-MjRG0.mjs} +18 -4
  26. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-Cz-MjRG0.mjs.map +1 -0
  27. package/fesm2022/{sdcorejs-angular-modules-pattern-create.component-C2GdGhkJ.mjs → sdcorejs-angular-modules-pattern-create.component-CxicczH7.mjs} +19 -5
  28. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-CxicczH7.mjs.map +1 -0
  29. package/fesm2022/{sdcorejs-angular-modules-pattern-create.component-DIivNX4o.mjs → sdcorejs-angular-modules-pattern-create.component-D3MzNJ3F.mjs} +2 -2
  30. package/fesm2022/{sdcorejs-angular-modules-pattern-create.component-DIivNX4o.mjs.map → sdcorejs-angular-modules-pattern-create.component-D3MzNJ3F.mjs.map} +1 -1
  31. package/fesm2022/{sdcorejs-angular-modules-pattern-create.component-CzJh4LMR.mjs → sdcorejs-angular-modules-pattern-create.component-RBvVv88D.mjs} +36 -12
  32. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-RBvVv88D.mjs.map +1 -0
  33. package/fesm2022/{sdcorejs-angular-modules-pattern-customer.service-B0nhFd_M.mjs → sdcorejs-angular-modules-pattern-customer.service-3hWkJClX.mjs} +2 -2
  34. package/fesm2022/{sdcorejs-angular-modules-pattern-customer.service-B0nhFd_M.mjs.map → sdcorejs-angular-modules-pattern-customer.service-3hWkJClX.mjs.map} +1 -1
  35. package/fesm2022/{sdcorejs-angular-modules-pattern-detail-side-drawer.component-D1dqsKX0.mjs → sdcorejs-angular-modules-pattern-detail-side-drawer.component-DzDAX3B7.mjs} +2 -2
  36. package/fesm2022/{sdcorejs-angular-modules-pattern-detail-side-drawer.component-D1dqsKX0.mjs.map → sdcorejs-angular-modules-pattern-detail-side-drawer.component-DzDAX3B7.mjs.map} +1 -1
  37. package/fesm2022/{sdcorejs-angular-modules-pattern-detail.component-WK0AcxNJ.mjs → sdcorejs-angular-modules-pattern-detail.component-CEhbU12j.mjs} +2 -2
  38. package/fesm2022/{sdcorejs-angular-modules-pattern-detail.component-WK0AcxNJ.mjs.map → sdcorejs-angular-modules-pattern-detail.component-CEhbU12j.mjs.map} +1 -1
  39. package/fesm2022/{sdcorejs-angular-modules-pattern-detail.component-Dkmm0a2Y.mjs → sdcorejs-angular-modules-pattern-detail.component-CcpYULut.mjs} +28 -11
  40. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-CcpYULut.mjs.map +1 -0
  41. package/fesm2022/{sdcorejs-angular-modules-pattern-flow.component-BvhEMUgY.mjs → sdcorejs-angular-modules-pattern-flow.component-G5lHfG81.mjs} +2 -2
  42. package/fesm2022/{sdcorejs-angular-modules-pattern-flow.component-BvhEMUgY.mjs.map → sdcorejs-angular-modules-pattern-flow.component-G5lHfG81.mjs.map} +1 -1
  43. package/fesm2022/{sdcorejs-angular-modules-pattern-general-information-form.component-cxNRkeRU.mjs → sdcorejs-angular-modules-pattern-general-information-form.component-BJaYcNzf.mjs} +3 -3
  44. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-BJaYcNzf.mjs.map +1 -0
  45. package/fesm2022/{sdcorejs-angular-modules-pattern-index.component-D1zWXyN6.mjs → sdcorejs-angular-modules-pattern-index.component-CosbQK0W.mjs} +4 -4
  46. package/fesm2022/sdcorejs-angular-modules-pattern-index.component-CosbQK0W.mjs.map +1 -0
  47. package/fesm2022/sdcorejs-angular-modules-pattern-lines-table-form.component-DmmVKrgM.mjs +836 -0
  48. package/fesm2022/sdcorejs-angular-modules-pattern-lines-table-form.component-DmmVKrgM.mjs.map +1 -0
  49. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-CaXgC8wK.mjs → sdcorejs-angular-modules-pattern-list.component-BjehcQEk.mjs} +2 -2
  50. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-CaXgC8wK.mjs.map → sdcorejs-angular-modules-pattern-list.component-BjehcQEk.mjs.map} +1 -1
  51. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-1Xn1WaAP.mjs → sdcorejs-angular-modules-pattern-list.component-CNVqk3JC.mjs} +3 -3
  52. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-1Xn1WaAP.mjs.map → sdcorejs-angular-modules-pattern-list.component-CNVqk3JC.mjs.map} +1 -1
  53. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-Bv_l7vnz.mjs → sdcorejs-angular-modules-pattern-list.component-C_pVqRcC.mjs} +2 -2
  54. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-Bv_l7vnz.mjs.map → sdcorejs-angular-modules-pattern-list.component-C_pVqRcC.mjs.map} +1 -1
  55. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-ChwTb4BU.mjs → sdcorejs-angular-modules-pattern-list.component-EaNDEtCn.mjs} +2 -2
  56. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-ChwTb4BU.mjs.map → sdcorejs-angular-modules-pattern-list.component-EaNDEtCn.mjs.map} +1 -1
  57. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-B6Ndq542.mjs → sdcorejs-angular-modules-pattern-list.component-jB3E20UF.mjs} +2 -2
  58. package/fesm2022/{sdcorejs-angular-modules-pattern-list.component-B6Ndq542.mjs.map → sdcorejs-angular-modules-pattern-list.component-jB3E20UF.mjs.map} +1 -1
  59. package/fesm2022/{sdcorejs-angular-modules-pattern-mock-backend.factory-DKK3NmbN.mjs → sdcorejs-angular-modules-pattern-mock-backend.factory-CFljqhjv.mjs} +2 -2
  60. package/fesm2022/{sdcorejs-angular-modules-pattern-mock-backend.factory-DKK3NmbN.mjs.map → sdcorejs-angular-modules-pattern-mock-backend.factory-CFljqhjv.mjs.map} +1 -1
  61. package/fesm2022/{sdcorejs-angular-modules-pattern-pattern-source-viewer-BpLQaYP5.mjs → sdcorejs-angular-modules-pattern-pattern-source-viewer-BqHwKfoc.mjs} +9 -2
  62. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source-viewer-BqHwKfoc.mjs.map +1 -0
  63. package/fesm2022/{sdcorejs-angular-modules-pattern-pattern-source.generated-BrejHvB2.mjs → sdcorejs-angular-modules-pattern-pattern-source.generated-CIiLOizq.mjs} +21 -19
  64. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source.generated-CIiLOizq.mjs.map +1 -0
  65. package/fesm2022/{sdcorejs-angular-modules-pattern-product.service-GSlXwL2Z.mjs → sdcorejs-angular-modules-pattern-product.service-DitXmlr1.mjs} +2 -2
  66. package/fesm2022/{sdcorejs-angular-modules-pattern-product.service-GSlXwL2Z.mjs.map → sdcorejs-angular-modules-pattern-product.service-DitXmlr1.mjs.map} +1 -1
  67. package/fesm2022/{sdcorejs-angular-modules-pattern-profile.component-DPBwMafn.mjs → sdcorejs-angular-modules-pattern-profile.component-Dxw7Ix9d.mjs} +2 -2
  68. package/fesm2022/{sdcorejs-angular-modules-pattern-profile.component-DPBwMafn.mjs.map → sdcorejs-angular-modules-pattern-profile.component-Dxw7Ix9d.mjs.map} +1 -1
  69. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-B6z9lJYB.mjs → sdcorejs-angular-modules-pattern-routes-BOiWZHqg.mjs} +3 -3
  70. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-B6z9lJYB.mjs.map → sdcorejs-angular-modules-pattern-routes-BOiWZHqg.mjs.map} +1 -1
  71. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-h66efEeH.mjs → sdcorejs-angular-modules-pattern-routes-BWZxOMhB.mjs} +7 -7
  72. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-h66efEeH.mjs.map → sdcorejs-angular-modules-pattern-routes-BWZxOMhB.mjs.map} +1 -1
  73. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-DeThmv4f.mjs → sdcorejs-angular-modules-pattern-routes-BxXgJVsW.mjs} +4 -4
  74. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-DeThmv4f.mjs.map → sdcorejs-angular-modules-pattern-routes-BxXgJVsW.mjs.map} +1 -1
  75. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-t3O2L2J5.mjs → sdcorejs-angular-modules-pattern-routes-C43Q4Wtq.mjs} +3 -3
  76. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-t3O2L2J5.mjs.map → sdcorejs-angular-modules-pattern-routes-C43Q4Wtq.mjs.map} +1 -1
  77. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-D1fsRfRB.mjs → sdcorejs-angular-modules-pattern-routes-CJ-RAMa5.mjs} +5 -5
  78. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-D1fsRfRB.mjs.map → sdcorejs-angular-modules-pattern-routes-CJ-RAMa5.mjs.map} +1 -1
  79. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-DdCFCwxY.mjs → sdcorejs-angular-modules-pattern-routes-CWixJ2If.mjs} +3 -3
  80. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-DdCFCwxY.mjs.map → sdcorejs-angular-modules-pattern-routes-CWixJ2If.mjs.map} +1 -1
  81. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-1kifjm82.mjs → sdcorejs-angular-modules-pattern-routes-CophQH_L.mjs} +5 -5
  82. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-1kifjm82.mjs.map → sdcorejs-angular-modules-pattern-routes-CophQH_L.mjs.map} +1 -1
  83. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-bQpdxKlY.mjs → sdcorejs-angular-modules-pattern-routes-w4VY9P_H.mjs} +9 -9
  84. package/fesm2022/{sdcorejs-angular-modules-pattern-routes-bQpdxKlY.mjs.map → sdcorejs-angular-modules-pattern-routes-w4VY9P_H.mjs.map} +1 -1
  85. package/fesm2022/{sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-B6w4N6wo.mjs → sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-BQCWgQsr.mjs} +12 -12
  86. package/fesm2022/{sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-B6w4N6wo.mjs.map → sdcorejs-angular-modules-pattern-sdcorejs-angular-modules-pattern-BQCWgQsr.mjs.map} +1 -1
  87. package/fesm2022/{sdcorejs-angular-modules-pattern-shell.component-BIYHlzVQ.mjs → sdcorejs-angular-modules-pattern-shell.component-BOjJteMd.mjs} +4 -4
  88. package/fesm2022/{sdcorejs-angular-modules-pattern-shell.component-BIYHlzVQ.mjs.map → sdcorejs-angular-modules-pattern-shell.component-BOjJteMd.mjs.map} +1 -1
  89. package/fesm2022/{sdcorejs-angular-modules-pattern-update-side-drawer.component-nnldn2cz.mjs → sdcorejs-angular-modules-pattern-update-side-drawer.component-BT2PzXTG.mjs} +4 -4
  90. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-BT2PzXTG.mjs.map +1 -0
  91. package/fesm2022/{sdcorejs-angular-modules-pattern-update-side-drawer.component-DKgmhJT2.mjs → sdcorejs-angular-modules-pattern-update-side-drawer.component-qmGn2tCI.mjs} +4 -4
  92. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-qmGn2tCI.mjs.map +1 -0
  93. package/fesm2022/{sdcorejs-angular-modules-pattern-update.component-p9R5-eou.mjs → sdcorejs-angular-modules-pattern-update.component-CS3jlV-R.mjs} +5 -5
  94. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-CS3jlV-R.mjs.map +1 -0
  95. package/fesm2022/{sdcorejs-angular-modules-pattern-update.component-C0Bewuwz.mjs → sdcorejs-angular-modules-pattern-update.component-CUgQPcR4.mjs} +22 -12
  96. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-CUgQPcR4.mjs.map +1 -0
  97. package/fesm2022/{sdcorejs-angular-modules-pattern-update.component-Qlh3Lm2p.mjs → sdcorejs-angular-modules-pattern-update.component-lGwicZKW.mjs} +12 -10
  98. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-lGwicZKW.mjs.map +1 -0
  99. package/fesm2022/sdcorejs-angular-modules-pattern.mjs +1 -1
  100. package/fesm2022/sdcorejs-angular-services-api.mjs +11 -11
  101. package/fesm2022/sdcorejs-angular-services-api.mjs.map +1 -1
  102. package/fesm2022/sdcorejs-angular-services-cache.mjs +7 -5
  103. package/fesm2022/sdcorejs-angular-services-cache.mjs.map +1 -1
  104. package/fesm2022/sdcorejs-angular-services-excel.mjs +34 -0
  105. package/fesm2022/sdcorejs-angular-services-excel.mjs.map +1 -1
  106. package/fesm2022/sdcorejs-angular-services-storage.mjs +6 -4
  107. package/fesm2022/sdcorejs-angular-services-storage.mjs.map +1 -1
  108. package/modules/pattern/docs/drawer.md +1 -1
  109. package/modules/pattern/docs/form.md +445 -148
  110. package/modules/pattern/docs/header-actions.md +14 -12
  111. package/modules/pattern/docs/select.md +9 -1
  112. package/modules/pattern/features/category/components/create-side-drawer/create-side-drawer.component.ts +8 -1
  113. package/modules/pattern/features/category/components/update-side-drawer/update-side-drawer.component.ts +1 -1
  114. package/modules/pattern/features/customer/components/create-side-drawer/create-side-drawer.component.ts +8 -1
  115. package/modules/pattern/features/customer/components/update-side-drawer/update-side-drawer.component.ts +1 -1
  116. package/modules/pattern/features/order/components/general-information-form/general-information-form.component.ts +1 -1
  117. package/modules/pattern/features/order/components/lines-form/lines-form.component.ts +124 -147
  118. package/modules/pattern/features/order/components/lines-form/order-lines.ts +101 -0
  119. package/modules/pattern/features/order/components/lines-table-form/lines-table-form.component.ts +196 -0
  120. package/modules/pattern/features/order/pages/create/create.component.ts +18 -4
  121. package/modules/pattern/features/order/pages/detail/detail.component.ts +14 -12
  122. package/modules/pattern/features/order/pages/update/update.component.ts +11 -4
  123. package/modules/pattern/features/product/components/general-information-form/general-information-form.component.ts +1 -1
  124. package/modules/pattern/features/product/components/product-select/product-select.component.ts +9 -1
  125. package/modules/pattern/features/product/pages/create/create.component.ts +8 -1
  126. package/modules/pattern/features/product/pages/update/update.component.ts +1 -1
  127. package/modules/pattern/features/settings/pages/update/update.component.ts +5 -4
  128. package/package.json +1 -1
  129. package/types/sdcorejs-angular-components-modal.d.ts +6 -1
  130. package/types/sdcorejs-angular-components-query-bar.d.ts +154 -13
  131. package/types/sdcorejs-angular-components-table.d.ts +448 -29
  132. package/types/sdcorejs-angular-i18n.d.ts +66 -1
  133. package/types/sdcorejs-angular-services-api.d.ts +5 -5
  134. package/types/sdcorejs-angular-services-cache.d.ts +4 -2
  135. package/types/sdcorejs-angular-services-excel.d.ts +59 -0
  136. package/types/sdcorejs-angular-services-storage.d.ts +3 -1
  137. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-C7-itJqB.mjs.map +0 -1
  138. package/fesm2022/sdcorejs-angular-modules-pattern-create-side-drawer.component-CxgmaNod.mjs.map +0 -1
  139. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-C2GdGhkJ.mjs.map +0 -1
  140. package/fesm2022/sdcorejs-angular-modules-pattern-create.component-CzJh4LMR.mjs.map +0 -1
  141. package/fesm2022/sdcorejs-angular-modules-pattern-detail.component-Dkmm0a2Y.mjs.map +0 -1
  142. package/fesm2022/sdcorejs-angular-modules-pattern-general-information-form.component-cxNRkeRU.mjs.map +0 -1
  143. package/fesm2022/sdcorejs-angular-modules-pattern-index.component-D1zWXyN6.mjs.map +0 -1
  144. package/fesm2022/sdcorejs-angular-modules-pattern-lines-form.component-BK__9Mzb.mjs +0 -541
  145. package/fesm2022/sdcorejs-angular-modules-pattern-lines-form.component-BK__9Mzb.mjs.map +0 -1
  146. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source-viewer-BpLQaYP5.mjs.map +0 -1
  147. package/fesm2022/sdcorejs-angular-modules-pattern-pattern-source.generated-BrejHvB2.mjs.map +0 -1
  148. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-DKgmhJT2.mjs.map +0 -1
  149. package/fesm2022/sdcorejs-angular-modules-pattern-update-side-drawer.component-nnldn2cz.mjs.map +0 -1
  150. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-C0Bewuwz.mjs.map +0 -1
  151. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-Qlh3Lm2p.mjs.map +0 -1
  152. package/fesm2022/sdcorejs-angular-modules-pattern-update.component-p9R5-eou.mjs.map +0 -1
@@ -38,6 +38,10 @@ import { isObservable } from 'rxjs';
38
38
  import { SdInput } from '@sdcorejs/angular/forms';
39
39
 
40
40
  const SD_PAGE_MAX_BADGES = 2;
41
+ /** Section có mép trên cách mép trên vùng cuộn không quá số px này được coi là đã chạm đỉnh. */
42
+ const SD_PAGE_TOC_TOP_TOLERANCE = 8;
43
+ /** Không có sự kiện scroll trong khoảng này thì coi như cú cuộn do bấm mục lục đã dừng. */
44
+ const SD_PAGE_TOC_SCROLL_IDLE_MS = 150;
41
45
  // why: một component cho cả ba selector, mặc định khác nhau theo tên thẻ host.
42
46
  const SD_PAGE_DEFAULT_WIDTH = {
43
47
  'sd-page': 'full',
@@ -84,6 +88,11 @@ class SdPageComponent {
84
88
  ...(ngDevMode ? [{ debugName: "tocItems" }] : /* istanbul ignore next */ []));
85
89
  activeTocIndex = signal(0, /* @ts-ignore */
86
90
  ...(ngDevMode ? [{ debugName: "activeTocIndex" }] : /* istanbul ignore next */ []));
91
+ // why: cuộn mượt tới section vừa bấm đi ngang các section ở giữa; giữ mục vừa bấm tới khi cuộn dừng thay vì
92
+ // để mục lục nháy qua từng mục. Lưu phần tử, không lưu chỉ số, vì danh sách có thể đổi trong lúc cuộn.
93
+ #clickTarget = null;
94
+ #clickScrollTimer;
95
+ #tocResize = null;
87
96
  // why: fallback của slot headerLeft chỉ render khi không có headerLeft/sdHeaderLeft, nên vắng nó nghĩa là
88
97
  // vùng trái đã bị thay và backLink không có chỗ hiện.
89
98
  titleBlock = viewChild('titleBlock', /* @ts-ignore */
@@ -99,14 +108,37 @@ class SdPageComponent {
99
108
  effect(() => {
100
109
  const enabled = this.toc();
101
110
  const entries = this.#sections().map(entry => ({ title: entry.section.title(), el: entry.el }));
102
- afterNextRender(() => this.tocItems.set(enabled ? this.#collectToc(entries) : []), { injector: this.#injector });
111
+ afterNextRender(() => {
112
+ this.tocItems.set(enabled ? this.#collectToc(entries) : []);
113
+ this.#observeTocLayout();
114
+ // why: thêm/bớt section làm chỉ số cũ trỏ sai mục (hoặc ra ngoài danh sách) mà không có sự kiện scroll nào.
115
+ this.#syncActiveToc();
116
+ }, { injector: this.#injector });
103
117
  });
104
118
  afterNextRender(() => {
105
119
  const wrapper = this.wrapper().nativeElement;
106
- const onScroll = () => this.#syncActiveToc();
120
+ const onScroll = () => {
121
+ if (this.#clickTarget)
122
+ this.#armClickScrollEnd();
123
+ this.#syncActiveToc();
124
+ };
125
+ const onScrollEnd = () => {
126
+ if (this.#clickTarget)
127
+ this.#endClickScroll();
128
+ };
107
129
  // why: scroll bắn liên tục; chỉ signal đổi mới cần render lại, không cần chạy change detection mỗi lần.
108
- this.#zone.runOutsideAngular(() => wrapper.addEventListener('scroll', onScroll, { passive: true }));
109
- this.#destroyRef.onDestroy(() => wrapper.removeEventListener('scroll', onScroll));
130
+ this.#zone.runOutsideAngular(() => {
131
+ wrapper.addEventListener('scroll', onScroll, { passive: true });
132
+ wrapper.addEventListener('scrollend', onScrollEnd);
133
+ });
134
+ this.#destroyRef.onDestroy(() => {
135
+ wrapper.removeEventListener('scroll', onScroll);
136
+ wrapper.removeEventListener('scrollend', onScrollEnd);
137
+ });
138
+ });
139
+ this.#destroyRef.onDestroy(() => {
140
+ this.#tocResize?.disconnect();
141
+ clearTimeout(this.#clickScrollTimer);
110
142
  });
111
143
  if (isDevMode()) {
112
144
  effect(() => {
@@ -135,6 +167,8 @@ class SdPageComponent {
135
167
  if (!item)
136
168
  return;
137
169
  this.activeTocIndex.set(index);
170
+ this.#clickTarget = item.el;
171
+ this.#armClickScrollEnd();
138
172
  const reduceMotion = typeof matchMedia === 'function' && matchMedia('(prefers-reduced-motion: reduce)').matches;
139
173
  item.el.scrollIntoView({ block: 'start', behavior: reduceMotion ? 'auto' : 'smooth' });
140
174
  }
@@ -149,10 +183,58 @@ class SdPageComponent {
149
183
  .filter((entry) => !!entry.title && !!content?.contains(entry.el))
150
184
  .sort((left, right) => (left.el.compareDocumentPosition(right.el) & Node.DOCUMENT_POSITION_FOLLOWING ? -1 : 1));
151
185
  }
186
+ // why: section đổi chiều cao (bảng tải xong, section mở ra hay thu lại) hay khung cuộn đổi cỡ làm section đổi chỗ mà
187
+ // không có sự kiện scroll. `.c-page-content` không giãn theo nội dung nên phải theo dõi chính các section. Trang
188
+ // không có mục lục thì không giữ observer nào.
189
+ #observeTocLayout() {
190
+ this.#tocResize?.disconnect();
191
+ const items = this.tocItems();
192
+ if (!items.length || typeof ResizeObserver === 'undefined')
193
+ return;
194
+ this.#tocResize ??= this.#zone.runOutsideAngular(() => new ResizeObserver(() => this.#syncActiveToc()));
195
+ this.#tocResize.observe(this.wrapper().nativeElement);
196
+ for (const item of items)
197
+ this.#tocResize.observe(item.el);
198
+ }
199
+ // why: `scrollend` chưa có ở mọi trình duyệt. Hẹn giờ lại sau mỗi sự kiện scroll nên cú cuộn coi như dừng khi
200
+ // không còn sự kiện nào, kể cả khi section đã ở sẵn vị trí và không cuộn chút nào.
201
+ #armClickScrollEnd() {
202
+ clearTimeout(this.#clickScrollTimer);
203
+ this.#zone.runOutsideAngular(() => {
204
+ this.#clickScrollTimer = setTimeout(() => this.#endClickScroll(), SD_PAGE_TOC_SCROLL_IDLE_MS);
205
+ });
206
+ }
207
+ #endClickScroll() {
208
+ clearTimeout(this.#clickScrollTimer);
209
+ const target = this.#clickTarget;
210
+ this.#clickTarget = null;
211
+ if (!target)
212
+ return;
213
+ const index = this.tocItems().findIndex(item => item.el === target);
214
+ const area = this.wrapper().nativeElement.getBoundingClientRect();
215
+ const top = target.getBoundingClientRect().top;
216
+ // why: section gần cuối trang không cuộn lên tới mép trên được; còn nằm trong vùng nhìn thì giữ mục vừa bấm.
217
+ // Người dùng đã cuộn đi chỗ khác trong lúc đó thì tính lại theo vị trí cuộn.
218
+ if (index >= 0 && top >= area.top - SD_PAGE_TOC_TOP_TOLERANCE && top < area.bottom) {
219
+ this.activeTocIndex.set(index);
220
+ return;
221
+ }
222
+ this.#syncActiveToc();
223
+ }
152
224
  #syncActiveToc() {
153
225
  const items = this.tocItems();
154
226
  if (!items.length)
155
227
  return;
228
+ if (this.#clickTarget) {
229
+ const clicked = items.findIndex(item => item.el === this.#clickTarget);
230
+ if (clicked >= 0) {
231
+ this.activeTocIndex.set(clicked);
232
+ return;
233
+ }
234
+ // why: section vừa bấm đã bị gỡ khỏi trang; thôi giữ nó và tính theo vị trí cuộn.
235
+ this.#clickTarget = null;
236
+ clearTimeout(this.#clickScrollTimer);
237
+ }
156
238
  const wrapper = this.wrapper().nativeElement;
157
239
  // why: cuộn tới đáy thì section cuối có thể không bao giờ chạm mép trên; khi đó nó là section đang đọc.
158
240
  if (wrapper.scrollTop + wrapper.clientHeight >= wrapper.scrollHeight - 1) {
@@ -162,7 +244,7 @@ class SdPageComponent {
162
244
  const top = wrapper.getBoundingClientRect().top;
163
245
  let active = 0;
164
246
  items.forEach((item, index) => {
165
- if (item.el.getBoundingClientRect().top - top <= 8)
247
+ if (item.el.getBoundingClientRect().top - top <= SD_PAGE_TOC_TOP_TOLERANCE)
166
248
  active = index;
167
249
  });
168
250
  this.activeTocIndex.set(active);
@@ -1827,7 +1909,6 @@ function initialOf(title) {
1827
1909
 
1828
1910
  class SdLayoutUserMenuComponent {
1829
1911
  #configuration = inject(SD_LAYOUT_CONFIGURATION, { optional: true });
1830
- #destroyRef = inject(DestroyRef);
1831
1912
  #document = inject(DOCUMENT);
1832
1913
  #host = inject(ElementRef);
1833
1914
  trigger = viewChild('trigger', /* @ts-ignore */
@@ -1921,11 +2002,16 @@ class SdLayoutUserMenuComponent {
1921
2002
  return;
1922
2003
  this.close(false);
1923
2004
  };
1924
- this.#document.addEventListener('keydown', onDocumentKeydown);
1925
- this.#document.addEventListener('pointerdown', onDocumentPointerDown);
1926
- this.#destroyRef.onDestroy(() => {
1927
- this.#document.removeEventListener('keydown', onDocumentKeydown);
1928
- this.#document.removeEventListener('pointerdown', onDocumentPointerDown);
2005
+ effect(onCleanup => {
2006
+ if (!this.isOpen())
2007
+ return;
2008
+ // why: menu đóng không cần xử lý các phím và click của toàn trang.
2009
+ this.#document.addEventListener('keydown', onDocumentKeydown);
2010
+ this.#document.addEventListener('pointerdown', onDocumentPointerDown);
2011
+ onCleanup(() => {
2012
+ this.#document.removeEventListener('keydown', onDocumentKeydown);
2013
+ this.#document.removeEventListener('pointerdown', onDocumentPointerDown);
2014
+ });
1929
2015
  });
1930
2016
  }
1931
2017
  open() {