Admin:PDD 商品页工具条文案与宽度调整 #23

Closed
opened 2026-08-07 14:13:48 +08:00 by ila · 2 comments
Owner

基本信息

  • 类型:需求(界面微调)
  • 父级大工单:#14
  • 所属 MVP / 版本:#15 / MVP
  • 关联:#18(本工单调整 #18 交付的页面)

要解决什么

PDD 商品页工具条的三处使用体验问题:

  1. 「创建」这个按钮名说不清创建什么。 同一条工具条上还有「创建采集任务」,
    两个都以「创建」开头,第一次用的人分不清哪个是加商品、哪个是发起采集。
  2. 「商品 ID/链接」搜索框太宽,占满整条剩余空间。
  3. 「搜索」按钮被那个宽输入框顶到很右边,离输入框很远,视觉上不像一组。

做什么 / 不做什么

做:

  1. 「创建」按钮文案改为「添加 PDD 商品」
  2. PDD 页的「商品 ID/链接」输入框宽度收到 30%
  3. 「搜索」按钮紧挨输入框右侧

不做:

  • 不改其他四个页面(蝦皮 / 顺运宝 / 任务 / 客户端)的工具条
  • 不改创建弹窗内部的输入框
  • 不改任何行为、路由、查询逻辑

怎么做

必须用新的类名,不能改全局规则

当前 admin/static/css/app.css 里是:

.toolbar input[type="text"] { flex: 1; min-width: 160px; ... }

[必须] 这条全局规则不许改。5 个页面共用它
(client/list.html pdd/list.html task/list.html syb/list.html
shopee/list.html 各有一个搜索框),改了会把另外四页一起改掉,
而本工单的「不做」清单里明确排除了它们。

做法:给 PDD 页那个输入框加一个类名,再单独写一条更具体的规则。

/* PDD 页的搜索框收窄到 30%,让「搜索」按钮能紧挨着它。
   不改上面的 .toolbar input[type="text"]——那条被 5 个页面共用。 */
.toolbar input[type="text"].search-narrow { flex: 0 0 30%; }

[必须] 用 flex: 0 0 30% 而不是 width: 30%。
工具条是 flex 布局,width 会被 flex: 1 的 flex-grow 覆盖掉,看不出效果。

搜索按钮靠左是收窄的自然结果

搜索表单是 .inline.grow(flex: 1),输入框从 flex: 1 改成
flex: 0 0 30% 之后,表单里就没有会伸展的元素了,
多余空间会留在按钮之后,按钮自然就贴着输入框。

[必须] 表单上的 grow 类要保留。去掉的话「删除」按钮会从最右边
跑到搜索按钮旁边——grow 的作用是把删除按钮顶到右侧,注释里写着。

按钮文案

✗  <button type="button" data-modal-open="create-modal">创建</button>
✓  <button type="button" data-modal-open="create-modal">添加 PDD 商品</button>

[建议] 「PDD」和「商品」之间按现有文档习惯留一个空格。

预计修改文件

文件 改什么
admin/templates/pdd/list.html 按钮文案;搜索框加 search-narrow 类
admin/static/css/app.css 新增一条 .search-narrow 规则
docs/admin/05-ui-specification.md §5.1 工具条示意图与文案同步

验收标准

  • PDD 页第一个按钮显示「添加 PDD 商品」,点击仍打开创建弹窗
  • PDD 页搜索框明显变窄(约占搜索表单的 30%)
  • 「搜索」按钮紧挨输入框右侧
  • 「删除」按钮仍在工具条最右侧
  • 另外四个页面(蝦皮 / 顺运宝 / 任务 / 客户端)的搜索框宽度不变
  • 全局规则 .toolbar input[type="text"] 未被修改
  • 搜索功能本身不受影响(带关键词搜索仍能筛出结果)
  • 五个页面均返回 200
  • docs/admin/05 §5.1 已同步
  • go vet / gofmt -l . / go test ./... 全过

怎么验证

cd D:\chengma\cmautobuy\admin
go vet ./...
gofmt -l .
go test ./... -count=1
go run .

浏览器打开 http://127.0.0.1:8080/pdd 目视确认三点,
再打开 /shopee /syb /tasks /clients 确认搜索框宽度没变。

风险和回退

风险 应对
顺手改了全局规则,波及另外四页 已列为验收项,逐页目视比对
30% 在窄屏(1366×768)下过窄 保留 min-width: 160px 的兜底

回退:git revert,纯前端改动,无数据影响。

## 基本信息 - 类型:需求(界面微调) - 父级大工单:#14 - 所属 MVP / 版本:#15 / MVP - 关联:#18(本工单调整 #18 交付的页面) ## 要解决什么 PDD 商品页工具条的三处使用体验问题: 1. **「创建」这个按钮名说不清创建什么。** 同一条工具条上还有「创建采集任务」, 两个都以「创建」开头,第一次用的人分不清哪个是加商品、哪个是发起采集。 2. 「商品 ID/链接」搜索框**太宽**,占满整条剩余空间。 3. 「搜索」按钮被那个宽输入框顶到很右边,**离输入框很远**,视觉上不像一组。 ## 做什么 / 不做什么 做: 1. 「创建」按钮文案改为「**添加 PDD 商品**」 2. PDD 页的「商品 ID/链接」输入框宽度收到 **30%** 3. 「搜索」按钮紧挨输入框右侧 不做: - **不改其他四个页面**(蝦皮 / 顺运宝 / 任务 / 客户端)的工具条 - 不改创建弹窗内部的输入框 - 不改任何行为、路由、查询逻辑 ## 怎么做 ### 必须用新的类名,不能改全局规则 当前 `admin/static/css/app.css` 里是: ```css .toolbar input[type="text"] { flex: 1; min-width: 160px; ... } ``` `[必须]` **这条全局规则不许改**。5 个页面共用它 (`client/list.html` `pdd/list.html` `task/list.html` `syb/list.html` `shopee/list.html` 各有一个搜索框),改了会把另外四页一起改掉, 而本工单的「不做」清单里明确排除了它们。 做法:给 PDD 页那个输入框加一个类名,再单独写一条更具体的规则。 ```css /* PDD 页的搜索框收窄到 30%,让「搜索」按钮能紧挨着它。 不改上面的 .toolbar input[type="text"]——那条被 5 个页面共用。 */ .toolbar input[type="text"].search-narrow { flex: 0 0 30%; } ``` `[必须]` 用 `flex: 0 0 30%` 而不是 `width: 30%`。 工具条是 flex 布局,`width` 会被 `flex: 1` 的 `flex-grow` 覆盖掉,看不出效果。 ### 搜索按钮靠左是收窄的自然结果 搜索表单是 `.inline.grow`(`flex: 1`),输入框从 `flex: 1` 改成 `flex: 0 0 30%` 之后,表单里就没有会伸展的元素了, **多余空间会留在按钮之后**,按钮自然就贴着输入框。 `[必须]` 表单上的 `grow` 类**要保留**。去掉的话「删除」按钮会从最右边 跑到搜索按钮旁边——`grow` 的作用是把删除按钮顶到右侧,注释里写着。 ### 按钮文案 ```text ✗ <button type="button" data-modal-open="create-modal">创建</button> ✓ <button type="button" data-modal-open="create-modal">添加 PDD 商品</button> ``` `[建议]` 「PDD」和「商品」之间按现有文档习惯留一个空格。 ## 预计修改文件 | 文件 | 改什么 | |---|---| | `admin/templates/pdd/list.html` | 按钮文案;搜索框加 `search-narrow` 类 | | `admin/static/css/app.css` | 新增一条 `.search-narrow` 规则 | | `docs/admin/05-ui-specification.md` | §5.1 工具条示意图与文案同步 | ## 验收标准 - [ ] PDD 页第一个按钮显示「添加 PDD 商品」,点击仍打开创建弹窗 - [ ] PDD 页搜索框明显变窄(约占搜索表单的 30%) - [ ] 「搜索」按钮紧挨输入框右侧 - [ ] 「删除」按钮仍在工具条最右侧 - [ ] **另外四个页面(蝦皮 / 顺运宝 / 任务 / 客户端)的搜索框宽度不变** - [ ] 全局规则 `.toolbar input[type="text"]` 未被修改 - [ ] 搜索功能本身不受影响(带关键词搜索仍能筛出结果) - [ ] 五个页面均返回 200 - [ ] `docs/admin/05` §5.1 已同步 - [ ] `go vet` / `gofmt -l .` / `go test ./...` 全过 ## 怎么验证 ```powershell cd D:\chengma\cmautobuy\admin go vet ./... gofmt -l . go test ./... -count=1 go run . ``` 浏览器打开 http://127.0.0.1:8080/pdd 目视确认三点, 再打开 /shopee /syb /tasks /clients 确认搜索框宽度没变。 ## 风险和回退 | 风险 | 应对 | |---|---| | 顺手改了全局规则,波及另外四页 | 已列为验收项,逐页目视比对 | | 30% 在窄屏(1366×768)下过窄 | 保留 `min-width: 160px` 的兜底 | 回退:`git revert`,纯前端改动,无数据影响。
Author
Owner

实施完成,待验收

提交: 96267f4 feat: PDD 商品页工具条文案与宽度调整 (#23)

验证结果

go vet / gofmt -l . 无输出;go test ./... -count=1 全过。

服务端渲染逐项核对:

验收项 结果
按钮显示「添加 PDD 商品」 ✅
旧文案 >创建< 已无残留 ✅ 0 处
搜索框带 search-narrow 类 ✅
grow 类保留(删除按钮仍靠右) ✅
另外四页不含 search-narrow ✅ /shopee /syb /tasks /clients 均为 0
全局规则 .toolbar input[type="text"] 未被修改 ✅ 仍是 flex: 1; min-width: 160px
五个页面均 200 ✅
带关键词搜索仍能筛出结果 ✅

实现说明

用 .toolbar input[type="text"].search-narrow { flex: 0 0 30%; }:多一个类,
特异性高于通用规则,flex 覆盖生效;而 min-width: 160px 仍从通用规则继承,
窄屏时不会缩到没法输入。

「搜索」按钮靠左是收窄的自然结果——搜索表单里没有会伸展的元素之后,
多余空间留在按钮之后。没有额外加对齐样式。

未验证到的部分

  • 没有在真实浏览器里目视确认。只验证了服务端产出的 HTML 和 CSS 规则,
    30% 的实际视觉宽度、按钮间距是否舒服,需要你打开页面看一眼。
  • 深色/浅色主题、1366×768、显示缩放下的表现未实测。
## 实施完成,待验收 **提交:** `96267f4` feat: PDD 商品页工具条文案与宽度调整 (#23) ### 验证结果 `go vet` / `gofmt -l .` 无输出;`go test ./... -count=1` 全过。 服务端渲染逐项核对: | 验收项 | 结果 | |---|---| | 按钮显示「添加 PDD 商品」 | ✅ | | 旧文案 `>创建<` 已无残留 | ✅ 0 处 | | 搜索框带 `search-narrow` 类 | ✅ | | `grow` 类保留(删除按钮仍靠右) | ✅ | | **另外四页不含 `search-narrow`** | ✅ /shopee /syb /tasks /clients 均为 0 | | **全局规则 `.toolbar input[type="text"]` 未被修改** | ✅ 仍是 `flex: 1; min-width: 160px` | | 五个页面均 200 | ✅ | | 带关键词搜索仍能筛出结果 | ✅ | ### 实现说明 用 `.toolbar input[type="text"].search-narrow { flex: 0 0 30%; }`:多一个类, 特异性高于通用规则,`flex` 覆盖生效;而 `min-width: 160px` 仍从通用规则继承, 窄屏时不会缩到没法输入。 「搜索」按钮靠左是收窄的自然结果——搜索表单里没有会伸展的元素之后, 多余空间留在按钮之后。没有额外加对齐样式。 ### 未验证到的部分 - **没有在真实浏览器里目视确认**。只验证了服务端产出的 HTML 和 CSS 规则, 30% 的实际视觉宽度、按钮间距是否舒服,需要你打开页面看一眼。 - 深色/浅色主题、1366×768、显示缩放下的表现未实测。
Author
Owner

验收通过,关闭

用户实机确认通过。

提交: 96267f4 feat: PDD 商品页工具条文案与宽度调整 (#23)
归档: docs/task/23-admin-pdd-页工具条文案与宽度调整.md(bf81bad)

11 项验收标准全部通过,其中两项防回归的:另外四个页面均不含 search-narrow;全局规则 .toolbar input[type="text"] 未被修改。

遗留

另外四页(蝦皮 / 顺运宝 / 任务 / 客户端)的搜索框仍是撑满的,与 PDD 页不一致,而 docs/admin/05 §2 要求五页布局统一。是否统一改过来待定。

## 验收通过,关闭 用户实机确认通过。 **提交:** `96267f4` feat: PDD 商品页工具条文案与宽度调整 (#23) **归档:** `docs/task/23-admin-pdd-页工具条文案与宽度调整.md`(`bf81bad`) 11 项验收标准全部通过,其中两项防回归的:另外四个页面均不含 `search-narrow`;全局规则 `.toolbar input[type="text"]` 未被修改。 ### 遗留 另外四页(蝦皮 / 顺运宝 / 任务 / 客户端)的搜索框仍是撑满的,与 PDD 页不一致,而 `docs/admin/05` §2 要求五页布局统一。是否统一改过来待定。
ila closed this issue 2026-08-07 14:19:48 +08:00
Sign in to join this conversation.
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: chengma/cmautobuy#23