Hacktoberfest 2026：维护者为十月标记出来的 issue，仍然开放、适合新手。 浏览 Hacktoberfest issue

Drag-to-reorder has no keyboard alternative in Grid, Replicator, Bard or structure trees

未关闭
  • 哪里不对？
#15,390 1 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
4/5
预计耗时
3-5 天
新手友好度
48/100
Issue 类型
缺陷
描述清晰度
描述清楚
活跃度
活跃
技术栈
javascript
领域
accessibility, frontend

调研方向

Start by reading resources/js/components/sortable/SortableList.vue and Sortable.js, then inspect ui/DragHandle.vue and the affected row, set, and tree components named in the issue. The issue proposes menu-based Move Up/Move Down actions as a first step, with keyboard drag handling and announcements as a further step. Done means reordering is possible without a pointer across the affected controls and keyboard users receive the expected feedback.

由索引模型根据 Issue 内容生成。

描述

accessibility fieldtypes
Bug description

Reordering in the CP is implemented entirely through @shopify/draggable pointer events. There is no keyboard handling anywhere in the sortable layer and no menu-based alternative, so reordering is mouse-only across the whole Control Panel.

Affected: Grid rows, Replicator sets, Bard sets, the page tree, the navigation tree, blueprint fields and tabs, Table rows, List items.

Verified:

ui/DragHandle.vue is a real <button> with aria-label="Drag to reorder", so it announces itself as actionable, but pressing Space, Enter or arrow keys on it does nothing and emits nothing to any live region.

WCAG 2.1 SC 2.1.1 Keyboard (Level A). Under WCAG 2.2 this would also fail SC 2.5.7 Dragging Movements.

How to reproduce
  1. composer create-project statamic/statamic
  2. Add a Grid field with two or more rows to a blueprint, or a Replicator with two sets
  3. Open the entry and Tab to a row's drag handle
  4. Press Space, then ArrowDown, then Enter

Expected: the row moves. Actual: row order is unchanged and nothing is announced.

Suggested fix

Two steps, and the first is worth shipping on its own:

  1. Add Move Up / Move Down items to every row and set dropdown menu. Grid rows, Replicator sets, Bard sets, tree branches. This alone satisfies 2.1.1 and needs no new drag machinery.
  2. Wire a keyboard sensor onto ui/DragHandle.vue (Space to lift, arrows to move, Enter to drop, Escape to cancel) with an aria-live announcement of the new position.

Also worth making the Bard set handle a <button> so it is at least reachable.

Environment

Environment
Laravel Version: 13.30.1
PHP Version: 8.4.23
Composer Version: 2.10.2
Environment: local
Debug Mode: ENABLED
Maintenance Mode: OFF
Timezone: UTC
Locale: en

Cache
Config: NOT CACHED
Events: NOT CACHED
Routes: NOT CACHED
Views: CACHED

Drivers
Broadcasting: log
Cache: file
Database: sqlite
Logs: stack / single
Mail: log
Queue: sync
Session: file

Storage
public/storage: NOT LINKED

Statamic
Addons: 0
License Key: Not set
Sites: 1
Stache Watcher: Enabled (auto)
Static Caching: Disabled
Version: 6.31.0 PRO
Installation

Fresh statamic/statamic site via CLI

Additional details

Found during a WCAG 2.1 AA audit of a vanilla composer create-project statamic/statamic install with no addons and no custom code. Tested with axe-core 4.x on Chromium 153 at 1440x1000, plus manual keyboard traversal. Source references point at v6.31.0.

主要语言
PHP
星标
4.9k
派生
647
平均合并
1 天 11 小时
30 天内合并 PR
137

环境准备

这个项目没有提供开发容器、Dockerfile 或贡献指南，环境需要你自己搭建：先看它的 README，通用步骤见我们的新手贡献指南。

从这里开始

  1. 先读完整个 Issue，再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库，在一个分支上完成修改。
  4. 提交 Pull Request，并在描述里引用这个 Issue 编号。

statamic/cms 的其他 Issue

查看 statamic/cms 的全部 Issue

相似的 Issue

更多 PHP Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。