@hamsterbase/ui 0.2.0 → 0.3.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.
- package/dist/components/Select/Select.d.ts +17 -0
- package/dist/components/Select/layout.d.ts +39 -0
- package/dist/components/Select/styles.d.ts +26 -0
- package/dist/components/Select/useScrollAffordance.d.ts +12 -0
- package/dist/components/Select/useSelectValue.d.ts +15 -0
- package/dist/components/Tooltip/Tooltip.d.ts +10 -0
- package/dist/components/Tooltip/coordinator.d.ts +79 -0
- package/dist/components/Tooltip/layout.d.ts +28 -0
- package/dist/components/Tooltip/styles.d.ts +6 -0
- package/dist/index.d.ts +4 -0
- package/dist/index.js +956 -9
- package/dist/styles.css +480 -1
- package/dist/utils/css.d.ts +6 -0
- package/docs/Select.md +20 -0
- package/docs/Tooltip.md +20 -0
- package/docs/index.md +2 -0
- package/package.json +1 -1
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
/** CSS 变量的计算值(去除首尾空白)。 */
|
|
2
|
+
export declare function cssValue(element: Element, name: string): string;
|
|
3
|
+
/** 以 px 表示的 CSS 变量的数值。 */
|
|
4
|
+
export declare function cssPx(element: Element, name: string): number;
|
|
5
|
+
/** CSS 变量里的时长(ms 或 s),返回毫秒;读不到时为 0。 */
|
|
6
|
+
export declare function cssMs(element: Element, name: string): number;
|
package/docs/Select.md
ADDED
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# Select
|
|
2
|
+
|
|
3
|
+
| 属性 | 类型 | 默认值 | 说明 |
|
|
4
|
+
| --- | --- | --- | --- |
|
|
5
|
+
| options | `readonly SelectOption[]` | 必填 | 每项包含唯一 `value`、显示用 `label`,可选 `icon` 和 `disabled`。 |
|
|
6
|
+
| value | `string` | — | 受控值,勾选标记仅表示该值。 |
|
|
7
|
+
| defaultValue | `string` | `''` | 非受控初值。 |
|
|
8
|
+
| onValueChange | `(value: string) => void` | — | 点击或 Enter/Space 确认不同值时触发,移动高亮不触发。 |
|
|
9
|
+
| size | `'small' \| 'default'` | `'default'` | 小号触发器/选项高 24px、字号 12px;默认触发器高 30px、选项高 32px、字号 13px。 |
|
|
10
|
+
| placeholder | `string` | `'请选择'` | 无匹配选项时显示。 |
|
|
11
|
+
|
|
12
|
+
使用 `aria-label` 或 `aria-labelledby` 提供可访问名称。`name` 会提交隐藏表单字段,禁用时不提交;`form` 属性同样作用于该字段。所属表单重置时,非受控值恢复为 `defaultValue`。`className` 用于触发器。
|
|
13
|
+
|
|
14
|
+
菜单在浏览器 top layer 中显示,不受父级 overflow 裁剪,保留祖先的主题 token。
|
|
15
|
+
|
|
16
|
+
打开时高亮当前值。勾选与高亮独立:鼠标移动、上下方向键和 Home/End 改变高亮(不支持输入字符搜索),Enter/Space 才提交;Escape 取消并返回触发器;Tab 移到下一个控件;点击外部关闭。禁用选项不能被选择,键盘会跳过。菜单关闭时只响应打开菜单的按键,Escape 等其他按键照常冒泡给宿主(例如关闭外层对话框)。
|
|
17
|
+
|
|
18
|
+
默认将当前行与触发器对齐。部分超出视口时裁剪菜单并滚动至当前项,边缘以渐隐和箭头提示,悬停箭头连续滚动;当触发器贴近屏幕边缘、无法容纳当前行与滚动提示时,改为下方或上方展开。长列表限制高度并支持滚轮;滚动/窗口尺寸变化时关闭,避免脱离触发器。
|
|
19
|
+
|
|
20
|
+
示例的静态截图与示例脚本截图(含各种定位的展开状态)由 `component-docs` 采集。`playground/tests/e2e/select.spec.ts` 在 `tests/e2e/fixture/select/` 的页面上验证本文描述的交互(直接渲染文档示例),测试代码上报 Evidra `component-e2e-docs`,截图作为附带观察。新增基线需人工审核,测试不自动审批。
|
package/docs/Tooltip.md
ADDED
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# Tooltip
|
|
2
|
+
|
|
3
|
+
| 属性 | 类型 | 默认值 | 说明 |
|
|
4
|
+
| --- | --- | --- | --- |
|
|
5
|
+
| children | `ReactElement` | 必填 | 单个触发元素,需要将 ref、事件和 ARIA 属性传递给实际 DOM 元素。 |
|
|
6
|
+
| content | `ReactNode` | 必填 | 提示内容,仅包含文本或非交互内容。 |
|
|
7
|
+
| shortcut | `readonly string[]` | 不显示 | 同一组快捷键的各个按键,例如 `['1']` 或 `['⌘', 'K']`。空数组等同于不传。 |
|
|
8
|
+
| side | `'top' \| 'right' \| 'bottom' \| 'left'` | `'bottom'` | 优先显示方向,空间不足时自动调整。 |
|
|
9
|
+
| align | `'start' \| 'center' \| 'end'` | `'center'` | 沿触发器边缘的对齐方式,start 和 end 遵循文字方向。 |
|
|
10
|
+
| disabled | `boolean` | `false` | 禁用提示;变为 true 时关闭浮层并取消等待。 |
|
|
11
|
+
|
|
12
|
+
不需要 Provider:同一文档中的 Tooltip 自动共享状态,同一时刻最多显示一个。触发元素原有的 ref、事件和 `aria-describedby` 都会保留,不额外包裹元素;图标按钮的 `aria-label` 和业务快捷键的 `aria-keyshortcuts` 仍由宿主提供。触发器不要同时设置原生 `title`,原生 disabled 控件不能作为触发器。
|
|
13
|
+
|
|
14
|
+
首次鼠标悬停等待 500ms 后显示。提示显示期间或关闭后 300ms 内移到另一个触发器,立即切换。键盘使触发器获得可见焦点时立即显示,鼠标点击带来的聚焦不显示。鼠标可以移到提示内容上,停留期间继续显示。
|
|
15
|
+
|
|
16
|
+
点击触发器会关闭提示,之后需要重新进入或聚焦才会再次显示;Escape 不关闭提示。触摸不模拟悬停。页面滚动、窗口尺寸变化、窗口失焦和页面隐藏时关闭;由键盘焦点保持的提示在滚动时跟随触发器,触发器离开视口或被滚动容器完全裁剪后关闭。触发器位于 top layer 内时,仅检查浮层自身及内部祖先的裁剪,不受浮层外祖先的 overflow 影响。
|
|
17
|
+
|
|
18
|
+
`shortcut` 的每一项渲染成一个 `<kbd>`,按下对应的键时高亮。高亮只反映当前按键状态,Tooltip 不注册快捷键、不执行操作,也不拦截键盘事件。显示文字原样展示,常用写法会映射到键名:`⌘`/`Cmd`/`Command`/`Meta`、`Ctrl`/`Control`/`⌃`、`Alt`/`Option`/`⌥`、`Shift`/`⇧`、`Esc`、`Enter`/`Return`/`↵`、`Space`/`␣` 和方向箭头;单个字母忽略大小写,其余按 `KeyboardEvent.key` 匹配。
|
|
19
|
+
|
|
20
|
+
提示在浏览器 top layer 中显示,不受父级 overflow 裁剪,保留祖先的主题 token。首选方向放不下时改用反方向,并始终留在视口内;长内容限制宽度并换行,超出视口高度时可在提示内滚动。提示浮层显式排除在 Tab 顺序之外,长内容滚动区域也不会插入额外的焦点位置。
|
package/docs/index.md
CHANGED