Merge branch 'worktree-agent-a1dd614394ee20ff2'
This commit is contained in:
31 files changed
+409
-156
No files matched your search
@@ -13,7 +13,7 @@ view := func(c *ui.Context) {
|
||||
mujica.Use(c, mujica.Settings{})
|
||||
mujica.Text(c, "Order ID: 4821-AX", mujica.TextOptions{Selectable: true})
|
||||
mujica.Text(c, "A long note that stops after two lines.", mujica.TextOptions{MaxLines: 2})
|
||||
if mujica.EditableText(c, &name, mujica.EditableTextOptions{Error: saveErr}).Changed() {
|
||||
if mujica.EditableText(c, &name, mujica.EditableTextOptions{Error: saveErr}).Changed {
|
||||
saveErr = "" // save name here; set saveErr on failure
|
||||
}
|
||||
}
|
||||
@@ -28,33 +28,35 @@ view := func(c *ui.Context) {
|
||||
| `MaxLines` | `int` | `0` | 超过该行数时以省略号截断；`0` 不截断；`1` 为单行。负数 panic。 |
|
||||
| `Selectable` | `bool` | `false` | 允许用指针或键盘选择并复制文本。 |
|
||||
|
||||
`func EditableText(c *ui.Context, value *string, opts EditableTextOptions) *ui.Element`
|
||||
`func EditableText(c *ui.Context, value *string, opts EditableTextOptions) EditableTextView`
|
||||
|
||||
| 字段 | 类型 | 默认值 | 含义 |
|
||||
| --- | --- | --- | --- |
|
||||
| `Saving` | `bool` | `false` | 调用方正在保存：显示加载标记，并禁止再次编辑。 |
|
||||
| `Error` | `string` | `""` | 调用方保存失败的说明，显示在文本下方并报告给辅助技术。 |
|
||||
| `Label` | `string` | `""` | 辅助技术读出的名称。 |
|
||||
| `Label` | `string` | `""` | 辅助技术读出的名称；同时用在显示状态和编辑输入框上。 |
|
||||
|
||||
返回值 `EditableTextView`：`Element`；`Changed` 表示本帧确认了新值；`Canceled` 表示本帧按 Escape 放弃了编辑。
|
||||
|
||||
## 状态
|
||||
|
||||
- 默认：可编辑文本带虚线下边，提示可以编辑。
|
||||
- 悬停：背景变为 `SurfaceHover`，尺寸不变。
|
||||
- 聚焦：2 DIP 焦点环。
|
||||
- 编辑中：显示 MyGo 文本输入框，酒红边框，选中扩展名之前的部分。
|
||||
- 聚焦：2 DIP 焦点环（可编辑文本与 `Selectable` 文本）。
|
||||
- 编辑中：显示文本输入框，酒红边框；名称与错误说明附在输入框上。
|
||||
- 保存中（`Saving`）：显示加载标记，阻止进入编辑。
|
||||
- 错误（`Error`）：虚线变为 `Danger`，下方显示错误说明，保留已确认的值。
|
||||
|
||||
## 事件
|
||||
|
||||
- `EditableText(...).Changed()`：用户确认了一个新值，`*value` 已更新。调用方在此保存，并通过 `Saving` 与 `Error` 回传结果。
|
||||
- 取消编辑不产生事件，`*value` 不变。
|
||||
- `EditableTextView.Changed`：用户确认了新值，`*value` 已更新。调用方在此保存，并通过 `Saving` 与 `Error` 回传结果。
|
||||
- `EditableTextView.Canceled`：用户按 Escape 放弃编辑，`*value` 不变。
|
||||
|
||||
## 键盘操作
|
||||
|
||||
| 按键 | 作用 |
|
||||
| --- | --- |
|
||||
| Tab | 聚焦可编辑文本 |
|
||||
| Tab | 聚焦可编辑文本；`Selectable` 文本也在 Tab 顺序中 |
|
||||
| Enter / 双击 | 开始编辑 |
|
||||
| Enter | 确认 |
|
||||
| Escape | 取消并恢复原值 |
|
||||
@@ -63,7 +65,7 @@ view := func(c *ui.Context) {
|
||||
|
||||
## 限制
|
||||
|
||||
- 编辑模式基于 `ui.EditableText`。MyGo 不报告“取消”事件，组件只能保证取消后值不变，不能通知调用方。
|
||||
- 编辑模式基于 `ui.TextInputBase` 构建，而不是 `ui.EditableText`，因为后者内部的输入框无法通过公开接口设置名称和错误说明。代价是开始编辑时不会像 Finder 那样自动选中扩展名之前的部分，光标停在文本末尾（可用 Cmd/Ctrl+A 全选）。
|
||||
- 编辑模式只支持单行文本。
|
||||
- 值为空字符串时文本区域没有可见文字；组件保留最小宽度和虚线，保证仍可点击。
|
||||
- MyGo 无法检测文本是否真的被截断，所以截断时不会自动显示完整内容的提示。
|
||||
@@ -29,7 +29,7 @@ view := func(c *ui.Context) {
|
||||
|
||||
| 字段 | 类型 | 默认值 | 含义 |
|
||||
| --- | --- | --- | --- |
|
||||
| `Width`, `Height` | `float32` | `0` | 盒子尺寸（DIP）。为 0 时图片使用自身尺寸；占位、加载、错误状态为 160×120。负数 panic。 |
|
||||
| `Width`, `Height` | `float32` | `0` | 盒子尺寸（DIP）。为 0 时使用 `src` 的尺寸（只给一边时按比例补齐），在占位、加载、错误状态下也保持这个尺寸；`src` 为 nil 时为 160×120。负数 panic。 |
|
||||
| `Crop` | `bool` | `false` | `true` 覆盖并裁切（`ui.Cover`）；`false` 完整放入（`ui.Contain`）。 |
|
||||
| `Alt` | `string` | `""` | 替代说明，供辅助技术读取；在其他状态下作为描述。 |
|
||||
| `Loading` | `bool` | `false` | 调用方正在加载。 |
|
||||
|
||||
@@ -43,5 +43,7 @@ view := func(c *ui.Context) {
|
||||
|
||||
## 限制
|
||||
|
||||
- 首字母字号随头像直径而定，不随系统文本缩放放大，以免溢出圆形。
|
||||
|
||||
- 中文姓名没有空格时按一个词处理，只取第一个字，例如“张伟”显示为“张”。
|
||||
- 头像不使用 MyGo `ui.Avatar`，因为它的尺寸固定为字号的 2.25 倍，无法配置（`ui/indicators.go:383`）。
|
||||
@@ -33,7 +33,7 @@ view := func(c *ui.Context) {
|
||||
## 状态
|
||||
|
||||
- 默认：头像之间重叠四分之一直径，用 2 DIP 窗口背景色描边分隔。
|
||||
- “+N”按钮：悬停、按下改变背景；聚焦时显示 2 DIP 焦点环。
|
||||
- “+N”按钮：基于 `ui.CollapsibleBase` 的 Trigger，辅助技术读作展开/收起按钮，并报告是否已展开。命中区域至少 28×28 DIP（`Size` 很小时也如此）。悬停、按下改变背景；聚焦时显示 2 DIP 焦点环。
|
||||
- 展开：按钮下方弹出 6 DIP 圆角面板，列出全部头像与姓名，超过 240 DIP 时滚动；遵循减少动画设置。
|
||||
|
||||
## 事件
|
||||
|
||||
@@ -34,7 +34,7 @@ view := func(c *ui.Context) {
|
||||
|
||||
## 状态
|
||||
|
||||
纯展示。强调和危险色调使用实色填充（`OnAccent` 配 `Accent`，`OnDanger` 配 `DangerFill`）；成功、警告、信息色调只把语义色用在文字和边框上。
|
||||
纯展示。字号与最小尺寸随系统文本缩放放大。强调和危险色调使用实色填充（`OnAccent` 配 `Accent`，`OnDanger` 配 `DangerFill`）；成功、警告、信息色调只把语义色用在文字和边框上。
|
||||
|
||||
## 事件
|
||||
|
||||
|
||||
@@ -12,8 +12,10 @@ view := func(c *ui.Context) {
|
||||
mujica.Use(c, mujica.Settings{})
|
||||
ui.Row(c).Gap(8).Children(func() {
|
||||
for i, t := range tags {
|
||||
v := mujica.Tag(c, t, mujica.TagOptions{Icon: "star", Clickable: true, Closable: true})
|
||||
v.Element.Key(t)
|
||||
var v mujica.TagView
|
||||
ui.Box(c).Key(t).Children(func() {
|
||||
v = mujica.Tag(c, t, mujica.TagOptions{Icon: "star", Clickable: true, Closable: true})
|
||||
})
|
||||
if v.Closed {
|
||||
tags = append(tags[:i:i], tags[i+1:]...)
|
||||
}
|
||||
@@ -42,7 +44,8 @@ view := func(c *ui.Context) {
|
||||
- 默认：`Surface` 底色、细边框、2 DIP 圆角。
|
||||
- 悬停 / 按下：可点击部分和关闭按钮分别变为 `SurfaceHover` / `Selection`。
|
||||
- 聚焦：对应部分显示 2 DIP 焦点环。
|
||||
- 禁用：由 MyGo 统一调暗，不响应输入。
|
||||
- 禁用：由 MyGo 统一调暗，不响应输入；祖先元素禁用时同样不响应，包括 Delete/Backspace。
|
||||
- 文字随系统文本缩放放大。
|
||||
|
||||
## 事件
|
||||
|
||||
@@ -59,5 +62,7 @@ view := func(c *ui.Context) {
|
||||
|
||||
## 限制
|
||||
|
||||
- 在循环中渲染多个标签时，把稳定的 Key 放在包住 Tag 的外层容器上（见示例）。Tag 在创建时就处理输入，事后再设置 Key 无法保持身份。
|
||||
|
||||
- 不可点击的标签不获取焦点，只能通过关闭按钮操作。
|
||||
- 标签不提供“选中”状态；需要可选标签时请使用 Toggle 类组件。
|
||||
@@ -39,7 +39,7 @@ view := func(c *ui.Context) {
|
||||
|
||||
## 状态
|
||||
|
||||
纯展示。键帽使用等宽字体、`Surface` 底色、`ControlBorder` 边框，底边 2 DIP。
|
||||
纯展示。键帽随系统文本缩放放大，使用等宽字体、`Surface` 底色、`ControlBorder` 边框，底边 2 DIP。
|
||||
|
||||
## 事件
|
||||
|
||||
|
||||
Reference in new issue
Block a user