鱼皮AI导航
鱼皮AI导航
  • 主页
  • 社区
  • AI工具
  • AI知识库
  • AI提示词
  • MCP
  • Skills
  • AI学习资源
  • AI资讯
  • GitHub开源
登录/注册

gpui-focus-handle

提供 GPUI 应用中键盘导航与焦点控制的核心能力,支持元素聚焦状态跟踪、Tab 键顺序切换、焦点获取与失去事件响应,以及模态框内焦点约束等交互模式,确保界面符合无障碍访问标准。

软件开发
访问 GitHub
文档Skills.MD
name
gpui-focus-handle
description
Focus management and keyboard navigation in GPUI. Use when handling focus, focus handles, or keyboard navigation. Enables keyboard-driven interfaces with proper focus tracking and navigation between focusable elements.

Overview

GPUI's focus system enables keyboard navigation and focus management.

Key Concepts:

  • FocusHandle: Reference to focusable element
  • Focus tracking: Current focused element
  • Keyboard navigation: Tab/Shift-Tab between elements
  • Focus events: on_focus, on_blur

Quick Start

Creating Focus Handles

▼
rust
复制代码
struct FocusableComponent { focus_handle: FocusHandle, } impl FocusableComponent { fn new(cx: &mut Context<Self>) -> Self { Self { focus_handle: cx.focus_handle(), } } }

Making Elements Focusable

▼
rust
复制代码
impl Render for FocusableComponent { fn render(&mut self, _: &mut Window, cx: &mut Context<Self>) -> impl IntoElement { div() .track_focus(&self.focus_handle) .on_action(cx.listener(Self::on_enter)) .child("Focusable content") } fn on_enter(&mut self, _: &Enter, cx: &mut Context<Self>) { // Handle Enter key when focused cx.notify(); } }

Focus Management

▼
rust
复制代码
impl MyComponent { fn focus(&mut self, cx: &mut Context<Self>) { self.focus_handle.focus(cx); } fn is_focused(&self, cx: &App) -> bool { self.focus_handle.is_focused(cx) } fn blur(&mut self, cx: &mut Context<Self>) { cx.blur(); } }

Focus Events

Handling Focus Changes

▼
rust
复制代码
impl Render for MyInput { fn render(&mut self, _: &mut Window, cx: &mut Context<Self>) -> impl IntoElement { let is_focused = self.focus_handle.is_focused(cx); div() .track_focus(&self.focus_handle) .on_focus(cx.listener(|this, _event, cx| { this.on_focus(cx); })) .on_blur(cx.listener(|this, _event, cx| { this.on_blur(cx); })) .when(is_focused, |el| { el.bg(cx.theme().focused_background) }) .child(self.render_content()) } } impl MyInput { fn on_focus(&mut self, cx: &mut Context<Self>) { // Handle focus gained cx.notify(); } fn on_blur(&mut self, cx: &mut Context<Self>) { // Handle focus lost cx.notify(); } }

Keyboard Navigation

Tab Order

Elements with track_focus() automatically participate in Tab navigation.

▼
rust
复制代码
div() .child( input1.track_focus(&focus1) // Tab order: 1 ) .child( input2.track_focus(&focus2) // Tab order: 2 ) .child( input3.track_focus(&focus3) // Tab order: 3 )

Focus Within Containers

▼
rust
复制代码
impl Container { fn focus_first(&mut self, cx: &mut Context<Self>) { if let Some(first) = self.children.first() { first.update(cx, |child, cx| { child.focus_handle.focus(cx); }); } } fn focus_next(&mut self, cx: &mut Context<Self>) { // Custom focus navigation logic } }

Common Patterns

1. Auto-focus on Mount

▼
rust
复制代码
impl MyDialog { fn new(cx: &mut Context<Self>) -> Self { let focus_handle = cx.focus_handle(); // Focus when created focus_handle.focus(cx); Self { focus_handle } } }

2. Focus Trap (Modal)

▼
rust
复制代码
impl Modal { fn render(&mut self, _: &mut Window, cx: &mut Context<Self>) -> impl IntoElement { div() .track_focus(&self.focus_handle) .on_key_down(cx.listener(|this, event: &KeyDownEvent, cx| { if event.key == Key::Tab { // Keep focus within modal this.focus_next_in_modal(cx); cx.stop_propagation(); } })) .child(self.render_content()) } }

3. Conditional Focus

▼
rust
复制代码
impl Searchable { fn render(&mut self, _: &mut Window, cx: &mut Context<Self>) -> impl IntoElement { div() .track_focus(&self.focus_handle) .when(self.search_active, |el| { el.on_mount(cx.listener(|this, _, cx| { this.focus_handle.focus(cx); })) }) .child(self.search_input()) } }

Best Practices

✅ Track Focus on Interactive Elements

▼
rust
复制代码
// ✅ Good: Track focus for keyboard interaction input() .track_focus(&self.focus_handle) .on_action(cx.listener(Self::on_enter))

✅ Provide Visual Focus Indicators

▼
rust
复制代码
let is_focused = self.focus_handle.is_focused(cx); div() .when(is_focused, |el| { el.border_color(cx.theme().focused_border) })

❌ Don't: Forget to Track Focus

▼
rust
复制代码
// ❌ Bad: No track_focus, keyboard navigation won't work div() .on_action(cx.listener(Self::on_enter))

Reference Documentation

  • API Reference: See api-reference.md
    • FocusHandle API, focus management
    • Events, keyboard navigation
    • Best practices
软件开发

快捷安装

复制到终端去安装 Skill

npxskillsaddlongbridge/gpui-component--skill"gpui-focus-handle"
站长:程序员鱼皮 老鱼简历 商务合作 增值电信业务经营许可证
2026 鱼皮AI导航 | 沪ICP备19026706号-6
站长:程序员鱼皮 老鱼简历 商务合作 增值电信业务经营许可证
2026 鱼皮AI导航 | 沪ICP备19026706号-6
🔥热门工具
朱雀AI检测朱雀AI检测
朱雀AI检测助手朱雀AI检测助手
LovartLovart
老鱼简历老鱼简历
WritePass官网WritePass官网
面多多面多多
CursorCursor
星月写作星月写作
朱雀AI检测助手朱雀AI检测助手
零感AI零感AI
Skills 推荐
debug
debug 是一个系统化定位软件缺陷根因的技能,适用于用户报告 'fix'、'broken'、'error' 等问题或测试意外失败时。它通过可验证的假设、最小复现、因果链分析和回归测试,确保在修复前准确定位根本原因。
retrieving-developer-knowledge
retrieving-developer-knowledge 用于搜索、获取和整合 Google 官方开发者文档,覆盖 Google Cloud、AI/Gemini、Android、Chrome、Web、Flutter、Go、Firebase 等平台,适用于查询 gcloud CLI 命令、API 语法、IAM 权限或架构对比等场景。
diff-intake
diff-intake 读取 PR 或分支差异,生成结构化 YAML 变更摘要,用于下游 analytics instrumentation 技能。适用于用户提交 PR 链接、分支对比或原始 diff 后需理解变更内容、评估分析覆盖或启动埋点流程的场景。
implement
实现 Linus Dashboard 的功能开发与集成,基于 TypeScript 和 Python 构建前后端组件,遵循严格的代码规范与架构模式,完成视图、卡片、服务及传感器等模块的创建与验证,确保高质量交付并兼容 Home Assistant 生态。
pypi-server
支持从源码构建 Python 软件包,并搭建本地 PyPI 服务,实现私有包的托管与分发,使团队可通过 pip 直接安装内部开发的模块。