From 49e0a0c79b505f150e4d8cc495d550fcdd7218c1 Mon Sep 17 00:00:00 2001
From: zhangshengming <1464963064@qq.com>
Date: Sun, 18 Oct 2026 19:02:46 +0800
Subject: [PATCH] fix(client): make timeline layers keyboard accessible

---
 packages/client/src/pages/timeline.vue        |  40 +++--
 ...-timeline-layer-keyboard-selection.test.ts | 165 ++++++++++++++++++
 2 files changed, 194 insertions(+), 11 deletions(-)
 create mode 100644 tests/integration/client/issue-885-timeline-layer-keyboard-selection.test.ts

diff --git a/packages/client/src/pages/timeline.vue b/packages/client/src/pages/timeline.vue
index d1b936302..0dca217b9 100644
--- a/packages/client/src/pages/timeline.vue
+++ b/packages/client/src/pages/timeline.vue
@@ -353,24 +353,32 @@ onUnmounted(() => {
             <li
               v-for="layer in layerOptions"
               :key="layer.id"
-              class="group relative min-h-7 cursor-pointer rounded-1 px-2 py-1 color-base flex items-center gap-2 text-3.5 hover:bg-active"
+              class="timeline-layer group relative rounded-1 color-base text-3.5 hover:bg-active"
               :class="{
                 'active bg-primary-600! text-white hover:bg-primary-600!':
                   layer.id === activeTimelineLayer,
-                op60: !isLayerEnabled(layer.id),
               }"
-              @click="selectLayer(layer.id)"
             >
-              <span
-                class="h-2.5 w-2.5 shrink-0 rounded-full"
-                :style="{ backgroundColor: getLayerColor(layer) }"
-                aria-hidden="true"
-              />
-              <span class="min-w-0 flex-1 truncate">{{ layer.label }}</span>
               <button
-                class="absolute right-2 rounded-1 border-0 bg-primary-500 px-1 color-white text-3 op0 group-hover:op80 hover:op100 [.active_&]:(bg-primary-400 dark:bg-gray-600)"
+                class="timeline-layer-select min-h-7 min-w-0 w-full rounded-1 border-0 bg-transparent py-1 pl-2 pr-18 color-inherit flex items-center gap-2 text-left"
                 type="button"
-                :aria-label="isLayerEnabled(layer.id) ? 'Disable layer' : 'Enable layer'"
+                :aria-pressed="layer.id === activeTimelineLayer"
+                @click="selectLayer(layer.id)"
+              >
+                <span
+                  class="h-2.5 w-2.5 shrink-0 rounded-full"
+                  :class="{ op60: !isLayerEnabled(layer.id) }"
+                  :style="{ backgroundColor: getLayerColor(layer) }"
+                  aria-hidden="true"
+                />
+                <span class="min-w-0 flex-1 truncate" :class="{ op60: !isLayerEnabled(layer.id) }">
+                  {{ layer.label }}
+                </span>
+              </button>
+              <button
+                class="timeline-layer-toggle absolute right-2 top-1/2 -translate-y-1/2 rounded-1 border-0 bg-primary-500 px-1 color-white text-3 op0 group-hover:op80 hover:op100 [.active_&]:(bg-primary-400 dark:bg-gray-600)"
+                type="button"
+                :aria-label="`${isLayerEnabled(layer.id) ? 'Disable' : 'Enable'} ${layer.label} layer`"
                 @click.stop="toggleLayerEnabled(layer.id)"
               >
                 {{ isLayerEnabled(layer.id) ? 'Disable' : 'Enable' }}
@@ -542,4 +550,14 @@ onUnmounted(() => {
   transition-duration: 1s;
   box-shadow: #ef4444 0 0 8px;
 }
+
+.timeline-layer:focus-within .timeline-layer-toggle {
+  opacity: 1;
+}
+
+.timeline-layer-select:focus-visible,
+.timeline-layer-toggle:focus-visible {
+  outline: 2px solid currentColor;
+  outline-offset: -2px;
+}
 </style>
diff --git a/tests/integration/client/issue-885-timeline-layer-keyboard-selection.test.ts b/tests/integration/client/issue-885-timeline-layer-keyboard-selection.test.ts
new file mode 100644
index 000000000..22d5b7741
--- /dev/null
+++ b/tests/integration/client/issue-885-timeline-layer-keyboard-selection.test.ts
@@ -0,0 +1,165 @@
+// @vitest-environment happy-dom
+
+import { flushPromises, mount } from '@vue/test-utils'
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+import { effectScope, ref } from 'vue'
+import { createDevtoolsTimeline } from '../../../packages/client/src/composables/devtools-timeline'
+import Timeline from '../../../packages/client/src/pages/timeline.vue'
+
+vi.mock('../../../packages/client/src/composables/devtools-client', () => ({
+  useDevtoolsClient: () => client,
+}))
+
+function createClient() {
+  return {
+    ...createDevtoolsTimeline(() => undefined),
+    apps: ref([]),
+    selectedAppId: ref('app:0'),
+    formatValue: vi.fn(() => ''),
+    inspectTimelineEvent: vi.fn(),
+  }
+}
+
+let client: ReturnType<typeof createClient>
+let scope: ReturnType<typeof effectScope>
+let wrapper: ReturnType<typeof mount> | undefined
+
+beforeEach(() => {
+  localStorage.clear()
+  scope = effectScope()
+  client = scope.run(createClient)!
+  client.selectTimelineLayer('mouse')
+})
+
+afterEach(() => {
+  wrapper?.unmount()
+  scope.stop()
+  localStorage.clear()
+})
+
+function mountTimeline() {
+  wrapper = mount(Timeline, {
+    attachTo: document.body,
+    global: {
+      directives: { tooltip: {} },
+      stubs: {
+        AppList: true,
+        Pane: { template: '<div><slot /></div>' },
+        Splitpanes: { template: '<div><slot /></div>' },
+        RecycleScroller: {
+          props: ['items'],
+          methods: { scrollToItem: vi.fn() },
+          template:
+            '<ul class="event-list"><li v-for="item in items" :key="item.id"><slot :item="item" /></li></ul>',
+        },
+      },
+    },
+  })
+  return wrapper
+}
+
+// https://github.com/vuejs/devtools/issues/885
+describe('Timeline layer keyboard selection', () => {
+  it('renders built-in and dynamic layers with separate focusable selection and collection buttons', async () => {
+    client.timelineLayers.value = [
+      { id: 'plugin:actions', label: 'Plugin actions', appId: 'app:0' },
+    ]
+    client.timeline.value = [
+      { id: 1, type: 'timeline:eventAdded', time: 1, label: 'action', layerId: 'custom-events' },
+    ]
+    const select = vi.spyOn(client, 'selectTimelineLayer')
+    const page = mountTimeline()
+    await flushPromises()
+    const rows = page.get('ul.no-scrollbar').findAll('li')
+
+    expect(rows).toHaveLength(6)
+    expect(page.find('button button').exists()).toBe(false)
+    expect(rows.map((row) => row.findAll('button').length)).toEqual([2, 2, 2, 2, 2, 2])
+    expect(rows.map((row) => row.get('button').text())).toEqual([
+      'Mouse',
+      'Keyboard',
+      'Component events',
+      'Performance',
+      'Plugin actions',
+      'Custom Events',
+    ])
+    expect(rows.map((row) => row.get('button').attributes('aria-pressed'))).toEqual([
+      'true',
+      'false',
+      'false',
+      'false',
+      'false',
+      'false',
+    ])
+    for (const row of rows) {
+      for (const button of row.findAll('button')) {
+        expect(button.attributes('type')).toBe('button')
+        expect((button.element as HTMLButtonElement).tabIndex).toBe(0)
+        ;(button.element as HTMLButtonElement).focus()
+        expect(document.activeElement).toBe(button.element)
+      }
+      expect(row.findAll('button')[1]!.attributes('aria-label')).toBe(
+        `Disable ${row.get('button').text()} layer`,
+      )
+    }
+    expect(select).not.toHaveBeenCalled()
+    expect(client.selectedTimelineLayerId.value).toBe('mouse')
+  })
+
+  it('selects layers without changing collection state, including repeated selection', async () => {
+    const select = vi.spyOn(client, 'selectTimelineLayer')
+    const toggle = vi.spyOn(client, 'toggleTimelineLayerEnabled')
+    const page = mountTimeline()
+    await flushPromises()
+    const rows = page.get('ul.no-scrollbar').findAll('li')
+    const keyboard = rows[1]!.get('button')
+
+    await keyboard.trigger('click')
+    expect(select).toHaveBeenCalledExactlyOnceWith('keyboard')
+    expect(client.selectedTimelineLayerId.value).toBe('keyboard')
+    expect(rows[0]!.get('button').attributes('aria-pressed')).toBe('false')
+    expect(keyboard.attributes('aria-pressed')).toBe('true')
+
+    await keyboard.trigger('click')
+    expect(select).toHaveBeenCalledTimes(2)
+    expect(keyboard.attributes('aria-pressed')).toBe('true')
+    expect(toggle).not.toHaveBeenCalled()
+    expect(client.inspectTimelineEvent).not.toHaveBeenCalled()
+  })
+
+  it('toggles collection independently while keeping a disabled layer selectable and focused', async () => {
+    client.timeline.value = [
+      { id: 1, type: 'timeline:eventAdded', time: 1, label: 'mouse event', layerId: 'mouse' },
+    ]
+    const select = vi.spyOn(client, 'selectTimelineLayer')
+    const clear = vi.spyOn(client, 'clearTimelineEvents')
+    const page = mountTimeline()
+    await flushPromises()
+    const rows = page.get('ul.no-scrollbar').findAll('li')
+    const mouse = rows[0]!.get('button')
+    const toggleMouse = rows[0]!.get('button[aria-label="Disable Mouse layer"]')
+    ;(toggleMouse.element as HTMLButtonElement).focus()
+
+    await toggleMouse.trigger('click')
+    expect(client.isTimelineLayerEnabled('mouse')).toBe(false)
+    expect(select).not.toHaveBeenCalled()
+    expect(client.selectedTimelineLayerId.value).toBe('mouse')
+    expect(mouse.attributes('aria-pressed')).toBe('true')
+    expect(mouse.attributes('disabled')).toBeUndefined()
+    expect(mouse.attributes('aria-disabled')).toBeUndefined()
+    expect(toggleMouse.attributes('aria-label')).toBe('Enable Mouse layer')
+    expect(document.activeElement).toBe(toggleMouse.element)
+    expect(page.find('.event-list').exists()).toBe(false)
+
+    await rows[1]!.get('button').trigger('click')
+    await mouse.trigger('click')
+    expect(client.selectedTimelineLayerId.value).toBe('mouse')
+    expect(client.isTimelineLayerEnabled('mouse')).toBe(false)
+    await toggleMouse.trigger('click')
+    expect(toggleMouse.attributes('aria-label')).toBe('Disable Mouse layer')
+    expect(page.get('.event-list').text()).toContain('mouse event')
+    expect(client.timeline.value).toHaveLength(1)
+    expect(clear).not.toHaveBeenCalled()
+    expect(client.inspectTimelineEvent).not.toHaveBeenCalled()
+  })
+})