@xihan-ui/styles 3.1.0 → 4.0.0

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 (290) hide show
  1. package/CHANGELOG.md +470 -0
  2. package/component-tokens.d.ts +230 -60
  3. package/components.tokens.json +5156 -1557
  4. package/css/accordion.css +47 -20
  5. package/css/alert.css +16 -17
  6. package/css/anchor.css +2 -2
  7. package/css/approval.css +41 -17
  8. package/css/avatar-group.css +9 -12
  9. package/css/avatar.css +20 -18
  10. package/css/back-top.css +21 -7
  11. package/css/badge.css +5 -5
  12. package/css/breadcrumb.css +18 -16
  13. package/css/button-group.css +4 -6
  14. package/css/button.css +13 -12
  15. package/css/calendar-picker.css +178 -95
  16. package/css/calendar-range-picker.css +207 -122
  17. package/css/card.css +34 -6
  18. package/css/carousel.css +94 -46
  19. package/css/cartesian-chart.css +11 -11
  20. package/css/cascader.css +51 -39
  21. package/css/checkbox-group.css +9 -6
  22. package/css/checkbox.css +5 -4
  23. package/css/citation.css +9 -4
  24. package/css/clipboard.css +20 -4
  25. package/css/code-view.css +6 -6
  26. package/css/collapsible.css +29 -14
  27. package/css/color-field.css +4 -4
  28. package/css/color-picker.css +77 -23
  29. package/css/color-slider.css +10 -8
  30. package/css/color-swatch-picker.css +14 -9
  31. package/css/combobox.css +26 -14
  32. package/css/command.css +14 -9
  33. package/css/context-menu.css +10 -5
  34. package/css/date-field.css +12 -6
  35. package/css/date-picker.css +178 -109
  36. package/css/date-range-picker.css +199 -130
  37. package/css/description.css +10 -6
  38. package/css/descriptions.css +47 -19
  39. package/css/dialog.css +50 -35
  40. package/css/diff-view.css +8 -8
  41. package/css/drawer.css +75 -21
  42. package/css/editable.css +15 -41
  43. package/css/empty-state.css +21 -3
  44. package/css/field-array.css +5 -2
  45. package/css/field.css +17 -18
  46. package/css/fieldset.css +33 -13
  47. package/css/file-upload.css +66 -33
  48. package/css/float-button.css +60 -35
  49. package/css/floating-panel.css +1 -1
  50. package/css/form.css +30 -16
  51. package/css/graph-chart.css +2 -2
  52. package/css/grid-list.css +1 -1
  53. package/css/highlight.css +5 -5
  54. package/css/hover-card.css +19 -12
  55. package/css/image-viewer.css +77 -27
  56. package/css/image.css +13 -5
  57. package/css/infinite-scroll.css +8 -4
  58. package/css/input-group.css +74 -26
  59. package/css/kbd.css +1 -1
  60. package/css/label.css +27 -11
  61. package/css/layout.css +17 -10
  62. package/css/list.css +13 -9
  63. package/css/listbox.css +12 -7
  64. package/css/loading-bar.css +3 -0
  65. package/css/mention.css +11 -9
  66. package/css/menu.css +10 -5
  67. package/css/menubar.css +13 -8
  68. package/css/message-feed.css +1 -1
  69. package/css/navigation-menu.css +2 -2
  70. package/css/notification.css +132 -49
  71. package/css/number-animation.css +2 -2
  72. package/css/number-field.css +75 -52
  73. package/css/page-header.css +64 -27
  74. package/css/pagination.css +35 -38
  75. package/css/password-input.css +12 -68
  76. package/css/pin-input.css +18 -26
  77. package/css/popconfirm.css +23 -14
  78. package/css/popover.css +18 -12
  79. package/css/progress.css +14 -13
  80. package/css/prompt-input.css +3 -3
  81. package/css/question-flow.css +41 -15
  82. package/css/radar-chart.css +6 -6
  83. package/css/radio-group.css +120 -55
  84. package/css/rating.css +32 -15
  85. package/css/select.css +16 -12
  86. package/css/separator.css +24 -6
  87. package/css/side-nav.css +29 -24
  88. package/css/signature-pad.css +23 -9
  89. package/css/skeleton.css +12 -12
  90. package/css/slider.css +77 -48
  91. package/css/sortable.css +2 -2
  92. package/css/sparkline.css +8 -2
  93. package/css/spinner.css +40 -20
  94. package/css/statistic.css +14 -14
  95. package/css/steps.css +115 -84
  96. package/css/switch.css +9 -7
  97. package/css/table.css +29 -12
  98. package/css/tabs.css +35 -12
  99. package/css/tag-group.css +17 -6
  100. package/css/tag.css +54 -29
  101. package/css/tags-input.css +39 -20
  102. package/css/text-field.css +5 -5
  103. package/css/time-field.css +4 -4
  104. package/css/time-picker.css +150 -64
  105. package/css/time-range-picker.css +91 -62
  106. package/css/timeline.css +37 -20
  107. package/css/timer.css +3 -3
  108. package/css/toggle-group.css +4 -4
  109. package/css/tool-call.css +13 -11
  110. package/css/toolbar.css +6 -5
  111. package/css/tooltip.css +16 -17
  112. package/css/tour.css +14 -7
  113. package/css/transfer.css +22 -16
  114. package/css/tree-select.css +12 -12
  115. package/css/tree.css +26 -25
  116. package/css/typography.css +28 -25
  117. package/dist/css/accordion.css +296 -0
  118. package/dist/css/affix.css +47 -0
  119. package/dist/css/alert.css +246 -0
  120. package/dist/css/anchor.css +252 -0
  121. package/dist/css/approval.css +525 -0
  122. package/dist/css/avatar-group.css +96 -0
  123. package/dist/css/avatar.css +100 -0
  124. package/dist/css/back-top.css +175 -0
  125. package/dist/css/badge.css +205 -0
  126. package/dist/css/bar-code.css +62 -0
  127. package/dist/css/breadcrumb.css +232 -0
  128. package/dist/css/button-group.css +261 -0
  129. package/dist/css/button.css +216 -0
  130. package/dist/css/calendar-picker.css +550 -0
  131. package/dist/css/calendar-range-picker.css +639 -0
  132. package/dist/css/card.css +249 -0
  133. package/dist/css/carousel.css +726 -0
  134. package/dist/css/cartesian-chart.css +830 -0
  135. package/dist/css/cascader.css +973 -0
  136. package/dist/css/checkbox-group.css +361 -0
  137. package/dist/css/checkbox.css +258 -0
  138. package/dist/css/citation.css +475 -0
  139. package/dist/css/clipboard.css +331 -0
  140. package/dist/css/code-view.css +374 -0
  141. package/dist/css/collapsible.css +200 -0
  142. package/dist/css/color-field.css +176 -0
  143. package/dist/css/color-picker.css +649 -0
  144. package/dist/css/color-slider.css +283 -0
  145. package/dist/css/color-swatch-picker.css +250 -0
  146. package/dist/css/color-swatch.css +35 -0
  147. package/dist/css/combobox.css +578 -0
  148. package/dist/css/command.css +404 -0
  149. package/dist/css/context-menu.css +425 -0
  150. package/dist/css/date-field.css +317 -0
  151. package/dist/css/date-picker.css +931 -0
  152. package/dist/css/date-range-picker.css +949 -0
  153. package/dist/css/description.css +71 -0
  154. package/dist/css/descriptions.css +327 -0
  155. package/dist/css/dialog.css +470 -0
  156. package/dist/css/diff-view.css +513 -0
  157. package/dist/css/download-trigger.css +151 -0
  158. package/dist/css/drawer.css +606 -0
  159. package/dist/css/editable.css +269 -0
  160. package/dist/css/empty-state.css +181 -0
  161. package/dist/css/field-array.css +229 -0
  162. package/dist/css/field.css +165 -0
  163. package/dist/css/fieldset.css +122 -0
  164. package/dist/css/file-upload.css +462 -0
  165. package/dist/css/flex.css +441 -0
  166. package/dist/css/float-button.css +579 -0
  167. package/dist/css/floating-panel.css +429 -0
  168. package/dist/css/focus.css +46 -0
  169. package/dist/css/forced-colors.css +93 -0
  170. package/dist/css/form.css +407 -0
  171. package/dist/css/funnel-chart.css +106 -0
  172. package/dist/css/graph-chart.css +205 -0
  173. package/dist/css/grid-list.css +235 -0
  174. package/dist/css/grid.css +1201 -0
  175. package/dist/css/heatmap.css +552 -0
  176. package/dist/css/hierarchy-chart.css +298 -0
  177. package/dist/css/highlight.css +41 -0
  178. package/dist/css/hover-card.css +233 -0
  179. package/dist/css/icon.css +225 -0
  180. package/dist/css/image-cropper.css +373 -0
  181. package/dist/css/image-viewer.css +588 -0
  182. package/dist/css/image.css +106 -0
  183. package/dist/css/infinite-scroll.css +81 -0
  184. package/dist/css/input-group.css +323 -0
  185. package/dist/css/json-viewer.css +379 -0
  186. package/dist/css/kbd.css +72 -0
  187. package/dist/css/label.css +94 -0
  188. package/dist/css/layers.css +7 -0
  189. package/dist/css/layout.css +379 -0
  190. package/dist/css/liquid.css +106 -0
  191. package/dist/css/list.css +156 -0
  192. package/dist/css/listbox.css +395 -0
  193. package/dist/css/loading-bar.css +144 -0
  194. package/dist/css/log.css +306 -0
  195. package/dist/css/markdown-stream.css +149 -0
  196. package/dist/css/marquee.css +378 -0
  197. package/dist/css/masonry.css +70 -0
  198. package/dist/css/matrix-code.css +67 -0
  199. package/dist/css/mention.css +395 -0
  200. package/dist/css/menu.css +369 -0
  201. package/dist/css/menubar.css +461 -0
  202. package/dist/css/message-feed.css +318 -0
  203. package/dist/css/navigation-menu.css +513 -0
  204. package/dist/css/notification.css +865 -0
  205. package/dist/css/number-animation.css +44 -0
  206. package/dist/css/number-field.css +275 -0
  207. package/dist/css/overlay-arrow.css +56 -0
  208. package/dist/css/page-header.css +221 -0
  209. package/dist/css/pagination.css +447 -0
  210. package/dist/css/password-input.css +335 -0
  211. package/dist/css/pie-chart.css +247 -0
  212. package/dist/css/pin-input.css +191 -0
  213. package/dist/css/pointer.css +36 -0
  214. package/dist/css/popconfirm.css +329 -0
  215. package/dist/css/popover.css +285 -0
  216. package/dist/css/progress.css +502 -0
  217. package/dist/css/prompt-input.css +260 -0
  218. package/dist/css/question-flow.css +579 -0
  219. package/dist/css/radar-chart.css +233 -0
  220. package/dist/css/radio-group.css +663 -0
  221. package/dist/css/rating.css +311 -0
  222. package/dist/css/reasoning.css +343 -0
  223. package/dist/css/reset.css +117 -0
  224. package/dist/css/resizable.css +242 -0
  225. package/dist/css/sankey-chart.css +174 -0
  226. package/dist/css/scroll-area.css +240 -0
  227. package/dist/css/scrollbar.css +204 -0
  228. package/dist/css/select.css +616 -0
  229. package/dist/css/separator.css +140 -0
  230. package/dist/css/side-nav.css +481 -0
  231. package/dist/css/signature-pad.css +193 -0
  232. package/dist/css/skeleton.css +161 -0
  233. package/dist/css/slider.css +403 -0
  234. package/dist/css/sortable.css +228 -0
  235. package/dist/css/sparkline.css +170 -0
  236. package/dist/css/spinner.css +256 -0
  237. package/dist/css/splitter.css +159 -0
  238. package/dist/css/statistic.css +137 -0
  239. package/dist/css/steps.css +658 -0
  240. package/dist/css/switch.css +353 -0
  241. package/dist/css/table.css +1162 -0
  242. package/dist/css/tabs.css +967 -0
  243. package/dist/css/tag-group.css +258 -0
  244. package/dist/css/tag.css +335 -0
  245. package/dist/css/tags-input.css +341 -0
  246. package/dist/css/text-field.css +197 -0
  247. package/dist/css/time-field.css +277 -0
  248. package/dist/css/time-picker.css +793 -0
  249. package/dist/css/time-range-picker.css +775 -0
  250. package/dist/css/timeline.css +440 -0
  251. package/dist/css/timer.css +123 -0
  252. package/dist/css/timestamp.css +34 -0
  253. package/dist/css/toggle-group.css +424 -0
  254. package/dist/css/toggle.css +146 -0
  255. package/dist/css/tone.css +189 -0
  256. package/dist/css/tool-call.css +431 -0
  257. package/dist/css/toolbar.css +366 -0
  258. package/dist/css/tooltip.css +217 -0
  259. package/dist/css/tour.css +446 -0
  260. package/dist/css/transfer.css +644 -0
  261. package/dist/css/tree-select.css +878 -0
  262. package/dist/css/tree.css +734 -0
  263. package/dist/css/truncate.css +108 -0
  264. package/dist/css/typography.css +475 -0
  265. package/dist/css/undefined.css +58 -0
  266. package/dist/css/virtualizer.css +166 -0
  267. package/dist/css/visually-hidden.css +20 -0
  268. package/dist/css/watermark.css +82 -0
  269. package/dist/family/action-control.css +493 -0
  270. package/dist/family/chart.css +537 -0
  271. package/dist/family/check-mark.css +94 -0
  272. package/dist/family/choice-card.css +97 -0
  273. package/dist/family/collection-item.css +768 -0
  274. package/dist/family/field-chrome.css +296 -0
  275. package/dist/family/loading-ring.css +102 -0
  276. package/dist/family/material.css +72 -0
  277. package/dist/family/menu-choice.css +56 -0
  278. package/dist/family/motion.css +363 -0
  279. package/dist/family/swatch.css +59 -0
  280. package/dist/family/tag-list.css +65 -0
  281. package/family/action-control.css +33 -36
  282. package/family/chart.css +57 -0
  283. package/family/collection-item.css +12 -8
  284. package/family/field-chrome.css +28 -19
  285. package/family/loading-ring.css +20 -13
  286. package/family/swatch.css +4 -4
  287. package/family/tag-list.css +6 -0
  288. package/index.css +10349 -8756
  289. package/index.unlayered.css +10350 -8758
  290. package/package.json +165 -164
@@ -0,0 +1,461 @@
1
+ /*
2
+ * Copyright (c) 2021-Present XiHanFun and contributors.
3
+ * Licensed under the MIT License. See LICENSE in the project root for license information.
4
+ */
5
+
6
+ /* 定义 menubar 样式。 */
7
+
8
+ /* 共享关键帧由 family/motion.css 提供,条目走 Collection Item 家族;本皮肤 @import 它们,单独引入仍成立。 */
9
+ @import '../family/collection-item.css';
10
+ @import '../family/menu-choice.css';
11
+ @import '../family/motion.css';
12
+ @import '../family/material.css';
13
+
14
+ @layer xihan.components {
15
+ /* 皮肤在场的标记:开发模式下按 scope 探一次,取不到就说明这份皮肤没被引入。 */
16
+ .xh-scope-menubar {
17
+ --xh-menubar-skin: 1;
18
+ }
19
+
20
+ /* 一排 trigger。主轴跟着 data-orientation 走:菜单栏本身可以横排也可以竖排 */
21
+ .xh-scope-menubar[data-part='root'] {
22
+ /* 一行排不下就折行:菜单名宽度由文字决定,硬撑一行会把整条顶出容器,
23
+ 末尾几个菜单既看不见也点不到 */
24
+ display: flex;
25
+ flex-wrap: wrap;
26
+ align-items: center;
27
+ gap: var(--xh-menubar-gap, var(--xh-space-1));
28
+ padding-block: var(--xh-menubar-py, var(--xh-space-1));
29
+ padding-inline: var(--xh-menubar-px, var(--xh-space-1));
30
+ border-radius: var(--xh-menubar-radius, var(--xh-shape-control));
31
+ background: var(--xh-menubar-bg, transparent);
32
+ color: var(--xh-menubar-fg, var(--xh-fg-default));
33
+ }
34
+
35
+ .xh-scope-menubar[data-part='root'][hidden] {
36
+ display: none;
37
+ }
38
+
39
+ .xh-scope-menubar[data-part='root'][data-orientation='vertical'] {
40
+ flex-direction: column;
41
+ align-items: stretch;
42
+ flex-wrap: nowrap;
43
+ }
44
+
45
+ /* root 只是 roving tabindex 的兜底落点,焦点转投给 trigger 之后就不再停留,不画环 */
46
+ .xh-scope-menubar[data-part='root']:focus-visible {
47
+ outline: none;
48
+ }
49
+
50
+ .xh-scope-menubar[data-part='root'][data-disabled] {
51
+ color: var(--xh-fg-disabled);
52
+ }
53
+
54
+ /* 入口归 Collection Item 展开路径 / 打开中(nav 语境):几何、字号与面全经家族桥接槽。静息字色取 default
55
+ (菜单名不是次要文字,不取 nav 缺省的 muted),悬停走白底承载 hover 100,展开着的那一张由连接层投影
56
+ data-in-path,家族给与悬停同档的中性面——打开中不是选中,不用品牌色、不接语气、不加粗;
57
+ 按下 pressed 200 只换面不缩放;禁用走 aria-disabled,家族给禁用字色与 not-allowed。
58
+ 本条 (0,2,0) 压过家族基础块 (0,1,0),不能再写 background / color / cursor */
59
+ .xh-scope-menubar[data-part='trigger'] {
60
+ --xh-collection-block-padding: var(--xh-menubar-trigger-py, var(--xh-_menubar-trigger-py));
61
+ --xh-collection-inline-padding: var(--xh-menubar-trigger-px, var(--xh-_menubar-trigger-px));
62
+ --xh-collection-radius: var(--xh-menubar-trigger-radius, var(--xh-shape-control));
63
+ --xh-collection-font-size: var(--xh-menubar-trigger-font-size, var(--xh-_menubar-font-size));
64
+ --xh-collection-fg-rest: var(--xh-menubar-trigger-fg, var(--xh-fg-default));
65
+ --xh-collection-bg-hover: var(--xh-menubar-trigger-bg-hover, var(--xh-bg-subtle));
66
+ --xh-collection-bg-open-path: var(--xh-menubar-trigger-bg-active, var(--xh-bg-subtle));
67
+ --xh-collection-bg-pressed: var(--xh-menubar-trigger-bg-pressed, var(--xh-bg-subtle-hover));
68
+
69
+ display: inline-flex;
70
+ flex: none;
71
+ align-items: center;
72
+ gap: var(--xh-menubar-trigger-gap, var(--xh-control-gap-sm));
73
+ border: none;
74
+ /* 不再写 font: inherit:按钮的 UA 字体由 reset.css 抹平,这里再写一遍会把家族给的字号与字重一并盖掉。
75
+ 行高压回 none:家族基础块给条目写了 leading-normal,入口的高度只由内缩定 */
76
+ line-height: var(--xh-leading-none);
77
+ white-space: nowrap;
78
+ user-select: none;
79
+ }
80
+
81
+ .xh-scope-menubar[data-part='trigger'][hidden] {
82
+ display: none;
83
+ }
84
+
85
+ /* 坐标由定位引擎写进 style(inset-inline-start / inset-block-start),这里只定位模式与层级 */
86
+ .xh-scope-menubar[data-part='positioner'] {
87
+ /* 落定那一侧的可用高度,由定位引擎经内联自定义属性写进来,content 继承它限高;
88
+ 引擎没算(尚未落位 / 无引擎)时不额外限高 */
89
+ --xh-_menubar-available-h: 100vh;
90
+ /* 落定那一侧的可用宽度,同样由定位引擎经内联自定义属性写进来,行内轴据此夹取;
91
+ 引擎没算(尚未落位 / 无引擎 / 贴边归零)时退到视口宽 */
92
+ --xh-_menubar-available-w: 100vw;
93
+ /* WC 子菜单仍可能住在父 positioner 内;先截断父层方向,避免斜向继承。 */
94
+ --xh-_overlay-enter-up: 0;
95
+ --xh-_overlay-enter-down: 0;
96
+ --xh-_overlay-enter-left: 0;
97
+ --xh-_overlay-enter-right: 0;
98
+
99
+ /* 条目列表的自绘条浮在内容之上:轨道不上底色,实色轨道会在菜单右缘糊一条竖灰带 */
100
+ --xh-scrollbar-track-bg: transparent;
101
+
102
+ position: fixed;
103
+ z-index: var(--xh-menubar-layer, var(--xh-_layer, var(--xh-layer-popover)));
104
+ /* 空壳不吃指针,交互只发生在 content 上 */
105
+ pointer-events: none;
106
+ }
107
+
108
+ /* 锚点被滚出可视区:整个浮层随之收起 */
109
+ .xh-scope-menubar[data-part='positioner'][data-hidden] {
110
+ visibility: hidden;
111
+ }
112
+
113
+ /* 物理 placement 与定位引擎同口径,不随书写方向翻转。 */
114
+ .xh-scope-menubar[data-part='positioner'][data-placement^='top'] {
115
+ --xh-_overlay-enter-down: 1;
116
+ }
117
+
118
+ .xh-scope-menubar[data-part='positioner'][data-placement^='bottom'] {
119
+ --xh-_overlay-enter-up: 1;
120
+ }
121
+
122
+ .xh-scope-menubar[data-part='positioner'][data-placement^='left'] {
123
+ --xh-_overlay-enter-right: 1;
124
+ }
125
+
126
+ .xh-scope-menubar[data-part='positioner'][data-placement^='right'] {
127
+ --xh-_overlay-enter-left: 1;
128
+ }
129
+
130
+ /* —— 尺寸 —— */
131
+ /* 尺寸档只换这六个私有槽,换档不必给每个部件各写一条选择器。
132
+ root 与 positioner 各起一头:trigger 从 root 继承,菜单里的条目从 positioner 继承——
133
+ 浮层搬去了 portal 落点,不再是 root 的后代。
134
+ 缺省档写在第一条:trigger 与条目的行内内缩都走 control-px 档(随密度轴)、纵向走 space 档,换档各挪一级 */
135
+ .xh-scope-menubar:is([data-part='root'], [data-part='positioner']) {
136
+ /* 条目外的字形(分组标题、入口)按档取尺,缺省 md,随 data-size 换档;同样声明在 positioner 上,被搬走的
137
+ 浮层才拿得到;条目里作者放的图标由家族随 data-xh-collection-size 下发。菜单栏自绘的状态字形(标记位的盒、
138
+ 盒里兜底的勾、子菜单的展开 chevron)不读这支:它们是指示符,走 --xh-control-indicator-* 一族——标记位在
139
+ 自己身上把 --xh-icon-size 改接到盒的尺,子菜单箭头走 --xh-menubar-submenu-indicator-size */
140
+ --xh-icon-size: var(--xh-menubar-icon-size, var(--xh-glyph-size-md));
141
+
142
+ --xh-_menubar-trigger-py: var(--xh-space-2);
143
+ --xh-_menubar-trigger-px: var(--xh-control-px-md);
144
+ --xh-_menubar-item-py: var(--xh-list-option-py-md);
145
+ --xh-_menubar-item-h: var(--xh-list-option-h-md);
146
+ --xh-_menubar-item-px: var(--xh-control-px-md);
147
+ --xh-_menubar-item-gap: var(--xh-control-gap-md);
148
+ --xh-_menubar-font-size: var(--xh-control-font-md);
149
+ }
150
+
151
+ .xh-scope-menubar[data-size='sm']:is([data-part='root'], [data-part='positioner']) {
152
+ --xh-icon-size: var(--xh-menubar-icon-size, var(--xh-glyph-size-sm));
153
+ --xh-_menubar-trigger-py: var(--xh-space-1_5);
154
+ --xh-_menubar-trigger-px: var(--xh-control-px-sm);
155
+ --xh-_menubar-item-py: var(--xh-list-option-py-sm);
156
+ --xh-_menubar-item-h: var(--xh-list-option-h-sm);
157
+ --xh-_menubar-item-px: var(--xh-control-px-sm);
158
+ --xh-_menubar-item-gap: var(--xh-control-gap-sm);
159
+ --xh-_menubar-font-size: var(--xh-control-font-sm);
160
+ }
161
+
162
+ .xh-scope-menubar[data-size='lg']:is([data-part='root'], [data-part='positioner']) {
163
+ --xh-icon-size: var(--xh-menubar-icon-size, var(--xh-glyph-size-lg));
164
+ --xh-_menubar-trigger-py: var(--xh-space-2_5);
165
+ --xh-_menubar-trigger-px: var(--xh-control-px-lg);
166
+ --xh-_menubar-item-py: var(--xh-list-option-py-lg);
167
+ --xh-_menubar-item-h: var(--xh-list-option-h-lg);
168
+ --xh-_menubar-item-px: var(--xh-control-px-lg);
169
+ --xh-_menubar-item-gap: var(--xh-control-gap-lg);
170
+ --xh-_menubar-font-size: var(--xh-control-font-lg);
171
+ }
172
+
173
+ .xh-scope-menubar[data-part='content'] {
174
+ /* 材质由家族配方画(family/material.css 的 frosted 面:描边、底、1px 顶光、前景、投影与背景滤镜),
175
+ 这里只把使用者槽接进来 */
176
+ --xh-frosted-bg: var(--xh-menubar-content-bg, var(--xh-_material-bg));
177
+ --xh-frosted-border: var(--xh-menubar-border, var(--xh-_material-border));
178
+ --xh-frosted-fg: var(--xh-menubar-content-fg, var(--xh-_material-fg));
179
+ --xh-frosted-shadow: var(--xh-menubar-content-shadow, var(--xh-_material-shadow));
180
+ --xh-frosted-backdrop: var(--xh-menubar-backdrop, var(--xh-_material-backdrop));
181
+ --xh-frosted-highlight: var(--xh-menubar-highlight, var(--xh-_material-highlight));
182
+
183
+ position: relative;
184
+ display: flex;
185
+ flex-direction: column;
186
+ gap: var(--xh-menubar-content-gap, var(--xh-list-option-gap));
187
+ min-inline-size: var(--xh-menubar-min-w, var(--xh-overlay-menu-min-w));
188
+ /* 静态档与落位后的可用宽度取小:窄视口下面板伸出去,最右侧的内容就点不到了 */
189
+ max-inline-size: min(var(--xh-menubar-max-w, var(--xh-overlay-max-w)), var(--xh-_menubar-available-w));
190
+ /* 两道上限取更小的那道:自己的高度上限,以及落定那一侧真正剩下的空间。
191
+ 列表族的 16rem 对命令菜单偏矮,这里另给一档 */
192
+ max-block-size: min(var(--xh-menubar-max-h, var(--xh-overlay-menu-max-h)), var(--xh-_menubar-available-h));
193
+ padding-block: var(--xh-menubar-content-py, var(--xh-surface-pad-xs));
194
+ padding-inline: var(--xh-menubar-content-px, 0);
195
+ border-radius: var(--xh-menubar-content-radius, var(--xh-shape-overlay));
196
+ /* 条目超过上限就在菜单内部滚。条目的焦点环是内收的,滚动容器裁在内边距缘上,环切不着。
197
+ 浮层滚动面:到底后不把滚动链穿透给页面 */
198
+ overflow-y: auto;
199
+ overscroll-behavior: contain;
200
+ pointer-events: auto;
201
+ }
202
+
203
+ /* display 会盖掉 hidden 属性的 UA 规则,收起态显式让位。
204
+ 连接层给 content 发 hidden,这一条漏了整张菜单就永远收不起来 */
205
+ /* 这里刻意没有 [data-part='content'][hidden] { display: none },与 dialog 一致:
206
+ 收起态连接层会给 content 打 hidden,而上面那条 display 正是要盖掉 UA 的
207
+ [hidden]{display:none}——退场动画得先能播。真正的收起由宿主在退场结束后落成内联 display。 */
208
+
209
+ /* 容器只是"没有条目锚点时"的 Tab 兜底落点,落焦不画环:高亮永远长在条目上 */
210
+ .xh-scope-menubar[data-part='content']:focus-visible {
211
+ outline: none;
212
+ }
213
+
214
+ /* 首开从锚点一侧淡入短移,不缩放整张菜单面。 */
215
+ .xh-scope-menubar[data-part='content'][data-state='open'] {
216
+ animation: xh-overlay-slide-in var(--xh-motion-duration-enter) var(--xh-motion-ease-enter-strong);
217
+ }
218
+
219
+ /* 末收向锚点一侧淡出;forwards 防止动画完成到真正隐藏之间闪回原样。 */
220
+ .xh-scope-menubar[data-part='content'][data-state='closed'] {
221
+ will-change: opacity, translate;
222
+ animation: xh-overlay-slide-out var(--xh-motion-duration-exit) var(--xh-motion-ease-exit) forwards;
223
+ }
224
+
225
+ /* 在一排入口间换张时两侧都瞬时:交叉淡变读起来就是闪烁。原生菜单栏的成规——首开有进场、末收有退场、
226
+ 换张不播。没有动画时退场闸门当场落定,收起即藏 */
227
+ .xh-scope-menubar[data-part='content'][data-instant] {
228
+ animation: none;
229
+ }
230
+
231
+ .xh-scope-menubar[data-part='group'] {
232
+ display: flex;
233
+ flex-direction: column;
234
+ gap: var(--xh-menubar-group-gap, var(--xh-list-option-gap));
235
+ }
236
+
237
+ .xh-scope-menubar[data-part='group'][hidden] {
238
+ display: none;
239
+ }
240
+
241
+ /* 分组标题不是条目、进不了导航,画成小号常规字重的次要文字,上方让出 8px 与上一组分开;
242
+ 内缩与条目对齐(同一个 padding-inline),标题与条目文字才在一条竖线上 */
243
+ .xh-scope-menubar[data-part='group-label'] {
244
+ display: block;
245
+ margin-block-start: var(--xh-menubar-group-label-mt, var(--xh-space-2));
246
+ padding-block: var(--xh-menubar-group-label-py, var(--xh-space-1));
247
+ padding-inline: var(--xh-menubar-group-label-px, var(--xh-_menubar-item-px));
248
+ color: var(--xh-menubar-group-label-fg, var(--xh-material-frosted-fg-muted));
249
+ font-size: var(--xh-menubar-group-label-font-size, var(--xh-text-caption-size));
250
+ font-weight: var(--xh-menubar-group-label-font-weight, var(--xh-font-weight-regular));
251
+ line-height: var(--xh-leading-none);
252
+ user-select: none;
253
+ }
254
+
255
+ .xh-scope-menubar[data-part='group-label'][hidden] {
256
+ display: none;
257
+ }
258
+
259
+ /* 条目走 Collection Item 的 overlay 语境:悬停 / 键盘锚点(data-highlighted,白底承载 100)、按下(200)、
260
+ 子层开着的打开路径(data-in-path,与 hover 同档)与禁用面(aria-disabled)都由家族给,这里只把公开槽映射到
261
+ 桥接槽。布局保持 flex 而不用家族网格:图标、正文、快捷键按一行排布,说明另起一行靠 flex-wrap 折下去,
262
+ 子菜单箭头是行尾的伪元素;间距统一由行的 gap 给,家族按槽下发的外边距归零 */
263
+ .xh-scope-menubar[data-part='item'] {
264
+ --xh-collection-block-padding: var(--xh-menubar-item-py, var(--xh-_menubar-item-py));
265
+ --xh-collection-row-h: var(--xh-menubar-item-h, var(--xh-_menubar-item-h));
266
+ --xh-collection-inline-padding: var(--xh-menubar-item-px, var(--xh-_menubar-item-px));
267
+ --xh-collection-gap: 0;
268
+ --xh-collection-font-size: var(--xh-menubar-item-font-size, var(--xh-_menubar-font-size));
269
+ --xh-collection-radius: var(--xh-menubar-item-radius, 0);
270
+ --xh-collection-fg-rest: var(--xh-menubar-item-fg, var(--xh-material-frosted-fg));
271
+ --xh-collection-fg-hover: var(--xh-menubar-item-fg, var(--xh-material-frosted-fg));
272
+ --xh-collection-fg-keyboard-highlight: var(--xh-menubar-item-fg, var(--xh-material-frosted-fg));
273
+ --xh-collection-fg-pressed: var(--xh-menubar-item-fg, var(--xh-material-frosted-fg));
274
+ --xh-collection-fg-open-path: var(--xh-menubar-item-fg, var(--xh-material-frosted-fg));
275
+ --xh-collection-bg-hover: var(--xh-menubar-item-bg-hover, var(--xh-bg-subtle));
276
+ --xh-collection-bg-keyboard-highlight: var(--xh-menubar-item-bg-hover, var(--xh-bg-subtle));
277
+ --xh-collection-bg-pressed: var(--xh-menubar-item-bg-pressed, var(--xh-bg-subtle-hover));
278
+ --xh-collection-bg-open-path: var(--xh-menubar-item-bg-active, var(--xh-bg-subtle));
279
+ /* data-highlighted 同时覆盖指针与键盘路径:指针只换面,焦点环在 :focus-visible 下再接回 */
280
+ --xh-collection-outline-keyboard-highlight: transparent;
281
+
282
+ display: flex;
283
+ align-items: center;
284
+ gap: var(--xh-menubar-item-gap, var(--xh-_menubar-item-gap));
285
+ line-height: var(--xh-menubar-item-leading, var(--xh-leading-normal));
286
+ white-space: nowrap;
287
+ user-select: none;
288
+ }
289
+
290
+ /* 条目可以按需收起(按上下文过滤掉的命令),有 display 就得补这条 */
291
+ .xh-scope-menubar[data-part='item'][hidden] {
292
+ display: none;
293
+ }
294
+
295
+ /* 键盘焦点出现时环才接回并立即到位,不压在背景过渡的中间帧上 */
296
+ .xh-scope-menubar[data-part='item']:focus-visible:not(:hover) {
297
+ --xh-collection-outline-keyboard-highlight: var(--xh-ring-focus);
298
+
299
+ transition: none;
300
+ }
301
+
302
+ /* 带子菜单的条目行尾画右向小箭头:不点开也看得出还有下一级。
303
+ description 按 order 独占下一行,箭头仍留在主行末端。
304
+ 箭头是指示符:与标记位的盒同走 --xh-control-indicator-size,不读 --xh-icon-size——
305
+ 按图标档取的 20px 会比 16px 的标记位盒大一圈 */
306
+ .xh-scope-menubar[data-part='item'][aria-haspopup='menu']::after {
307
+ content: '';
308
+ flex: none;
309
+ order: 1;
310
+ margin-inline-start: auto;
311
+ inline-size: var(--xh-menubar-submenu-indicator-size, var(--xh-control-indicator-size));
312
+ block-size: var(--xh-menubar-submenu-indicator-size, var(--xh-control-indicator-size));
313
+ background-color: var(--xh-menubar-submenu-indicator-fg, currentColor);
314
+ -webkit-mask: var(--xh-glyph-mark-chevron-right) center / contain no-repeat;
315
+ mask: var(--xh-glyph-mark-chevron-right) center / contain no-repeat;
316
+ }
317
+
318
+ /* rtl 下子菜单开在左侧,箭头跟着指向行进方向 */
319
+ [dir='rtl'] .xh-scope-menubar[data-part='item'][aria-haspopup='menu']::after {
320
+ -webkit-mask-image: var(--xh-glyph-mark-chevron-left);
321
+ mask-image: var(--xh-glyph-mark-chevron-left);
322
+ }
323
+
324
+ .xh-scope-menubar[data-part='item-text'] {
325
+ flex: 1;
326
+ min-inline-size: 0;
327
+ overflow: hidden;
328
+ white-space: nowrap;
329
+ text-overflow: ellipsis;
330
+ }
331
+
332
+ .xh-scope-menubar[data-part='item-text'][hidden] {
333
+ display: none;
334
+ }
335
+
336
+ /* 标记位(勾选符号 / 图标)按作者写入的位置留在主行,不为没写的条目强制占列。盒是指示符:按指示符档
337
+ 取尺,与 Menu / ContextMenu 的标记位同走 --xh-control-indicator-size,不读家族按档下发的 --xh-icon-size——
338
+ 按图标档取的 20px 会比同一行 16px 的指示符档大一圈。盒在自己身上把 --xh-icon-size 改接到盒的尺,
339
+ 皮肤画的兜底勾与作者塞进标记位的 XhIcon 读同一把尺、与盒同边长(行尾标记不是勾选格,不取 × 0.75);
340
+ 条目上那支只管作者直接放进条目里的图标 */
341
+ .xh-scope-menubar[data-part='item-indicator'] {
342
+ --xh-icon-size: var(--xh-menubar-item-indicator-size, var(--xh-control-indicator-size));
343
+
344
+ display: inline-flex;
345
+ flex: none;
346
+ align-items: center;
347
+ justify-content: center;
348
+ inline-size: var(--xh-menubar-item-indicator-size, var(--xh-control-indicator-size));
349
+ block-size: var(--xh-menubar-item-indicator-size, var(--xh-control-indicator-size));
350
+ color: var(--xh-menubar-item-indicator-fg, var(--xh-_tone, var(--xh-fg-brand)));
351
+ }
352
+
353
+ .xh-scope-menubar[data-part='item-indicator'][hidden] {
354
+ display: none;
355
+ }
356
+
357
+ .xh-scope-menubar[data-part='item-indicator'][data-disabled] {
358
+ color: var(--xh-fg-disabled);
359
+ }
360
+
361
+ /* 副文本另起一行:整行占满,把条目的一行内容折成两行 */
362
+ .xh-scope-menubar[data-part='item-description'] {
363
+ flex: 1 0 100%;
364
+ order: 2;
365
+ min-inline-size: 0;
366
+ color: var(--xh-menubar-item-description-fg, var(--xh-material-frosted-fg-muted));
367
+ /* 与同一行的快捷键、Select 等列表的说明同档:控件次级字号,不取 caption 令牌 */
368
+ font-size: var(--xh-menubar-item-description-font-size, var(--xh-control-caption-md));
369
+ white-space: nowrap;
370
+ text-overflow: ellipsis;
371
+ overflow: hidden;
372
+ }
373
+
374
+ .xh-scope-menubar[data-part='item-description'][hidden] {
375
+ display: none;
376
+ }
377
+
378
+ .xh-scope-menubar[data-part='item-description'][data-disabled] {
379
+ color: var(--xh-fg-disabled);
380
+ }
381
+
382
+ /* 没有说明时主行不允许无意换行;有说明才开启第二行。任意图标/快捷键仍保留作者的 DOM 顺序。 */
383
+ .xh-scope-menubar[data-part='item']:has(> .xh-scope-menubar[data-part='item-description']) {
384
+ flex-wrap: wrap;
385
+ }
386
+
387
+ /* 箭头的底色与描边色,几何在 overlay-arrow.css。
388
+ 交叉轴落点由定位引擎经内联自定义属性写进来,没给时退回居中 */
389
+ .xh-scope-menubar[data-part='arrow'] {
390
+ --xh-_menubar-arrow-x: 50%;
391
+ --xh-_menubar-arrow-y: 50%;
392
+ --xh-_overlay-arrow-size: var(--xh-menubar-arrow-size, var(--xh-overlay-arrow-size));
393
+ --xh-_overlay-arrow-x: var(--xh-_menubar-arrow-x);
394
+ --xh-_overlay-arrow-y: var(--xh-_menubar-arrow-y);
395
+
396
+ background: var(--xh-menubar-content-bg, var(--xh-material-frosted-bg));
397
+ border: var(--xh-stroke-thin) solid var(--xh-menubar-border, var(--xh-material-frosted-border));
398
+ }
399
+
400
+ /* 分隔线横跨菜单,与菜单栏自身的 orientation 无关:菜单永远是一列条目。
401
+ 不给 display,因此 UA 的 [hidden]{display:none} 自己就压得住 */
402
+ .xh-scope-menubar[data-part='separator'] {
403
+ block-size: var(--xh-menubar-separator-thickness, var(--xh-stroke-thin));
404
+ margin-block: var(--xh-menubar-separator-my, var(--xh-space-0_5));
405
+ border-radius: var(--xh-menubar-separator-radius, var(--xh-shape-pill));
406
+ background: var(--xh-menubar-separator-color, var(--xh-material-frosted-separator));
407
+ }
408
+
409
+ /* 没写内容就由皮肤画兜底字形;作者往部件里塞了自己的图形,这几条即不命中。
410
+ 尺寸读标记位自己改接过的 --xh-icon-size:与盒同边长,随指示符档换档(见上面标记位那块) */
411
+ .xh-scope-menubar[data-part='item-indicator']:empty::before {
412
+ content: '';
413
+ display: inline-block;
414
+ inline-size: var(--xh-icon-size, var(--xh-glyph-size-text));
415
+ block-size: var(--xh-icon-size, var(--xh-glyph-size-text));
416
+ vertical-align: var(--xh-glyph-baseline-shift);
417
+ background-color: currentColor;
418
+ -webkit-mask: var(--xh-glyph-mark-check) center / contain no-repeat;
419
+ mask: var(--xh-glyph-mark-check) center / contain no-repeat;
420
+ }
421
+ }
422
+
423
+ @layer xihan.components {
424
+ @media print {
425
+ /* 打印:定位层与遮罩是交互期才存在的东西,落到纸上只会盖住底下的正文。
426
+ 收起写在这份皮肤里而不是 reset:reset 层排在组件层之前,组件层里任何一条 display 都压得住它。 */
427
+ .xh-scope-menubar[data-part='positioner'] {
428
+ display: none;
429
+ }
430
+ }
431
+
432
+ @media (forced-colors: active) {
433
+ /* 分组之间那条线画的是一块纯底色,这一档里底色被统一换成 Canvas,线整条消失,
434
+ 几组条目就连成了一长串。换成前景色画回来 */
435
+ .xh-scope-menubar[data-part='separator'] {
436
+ background: CanvasText;
437
+ }
438
+ }
439
+
440
+ @media (forced-colors: active) {
441
+ /* 兜底字形是 mask 挖出来的一块底色,这一档里底色被系统换成 Canvas,字形跟着消失。
442
+ 字形退出强制换色、直接写系统色(不能取 currentColor:退出强制换色的伪元素读到的是被系统换掉之前的作者色):
443
+ 条目面上取 CanvasText;按下与没被高亮时的悬停,家族把条目涂成 Highlight,字形换 HighlightText;
444
+ 禁用取 GrayText */
445
+ .xh-scope-menubar[data-part='item'][aria-haspopup='menu']::after,
446
+ .xh-scope-menubar[data-part='item-indicator']:empty::before {
447
+ forced-color-adjust: none;
448
+ background-color: CanvasText;
449
+ }
450
+
451
+ .xh-scope-menubar[data-part='item'][aria-haspopup='menu']:not([aria-disabled='true'], [data-disabled], [aria-busy='true'], [data-error]):is(:active, [data-pressed], :hover:not(:focus-visible, [data-highlighted]))::after,
452
+ .xh-scope-menubar[data-part='item']:not([aria-disabled='true'], [data-disabled], [aria-busy='true'], [data-error]):is(:active, [data-pressed], :hover:not(:focus-visible, [data-highlighted])) .xh-scope-menubar[data-part='item-indicator']:empty::before {
453
+ background-color: HighlightText;
454
+ }
455
+
456
+ .xh-scope-menubar[data-part='item'][aria-haspopup='menu']:is([aria-disabled='true'], [data-disabled])::after,
457
+ .xh-scope-menubar[data-part='item']:is([aria-disabled='true'], [data-disabled]) .xh-scope-menubar[data-part='item-indicator']:empty::before {
458
+ background-color: GrayText;
459
+ }
460
+ }
461
+ }