# GPUI Component

> Rust GUI components for building fantastic cross-platform desktop application by using GPUI.

## Table of Contents

- [Accordion](/gpui-component/docs/components/accordion.md): The accordion uses collapse internally to make it collapsible.
- [Accordion](/gpui-component/zh-CN/docs/components/accordion.md): 内部基于 collapse 实现的可折叠面板组件。
- [Accordion](/gpui-component/base/primitives/accordion.md): A disclosure group composed from independently styleable header, trigger, and panel parts.
- [Alert](/gpui-component/docs/components/alert.md): Displays a callout for user attention.
- [Alert](/gpui-component/zh-CN/docs/components/alert.md): 用于吸引用户注意的重要提示组件。
- [Alert Dialog](/gpui-component/base/primitives/alert-dialog.md): A modal confirmation surface for actions that need an explicit decision.
- [AlertDialog](/gpui-component/docs/components/alert-dialog.md): A modal dialog that interrupts the user with important content and expects a response.
- [AlertDialog](/gpui-component/zh-CN/docs/components/alert-dialog.md): 使用于重要确认场景的模态对话框组件。
- [Avatar](/gpui-component/docs/components/avatar.md): Displays a user avatar image with fallback options.
- [Avatar](/gpui-component/zh-CN/docs/components/avatar.md): 支持图片、姓名首字母和占位图标的头像组件。
- [Avatar](/gpui-component/base/primitives/avatar.md): An image with composable fallback content for a person or entity.
- [Badge](/gpui-component/docs/components/badge.md): A red dot that indicates the number of unread messages, status, or other notifications.
- [Badge](/gpui-component/zh-CN/docs/components/badge.md): 用于显示未读数、状态点或图标提示的小徽标组件。
- [Button](/gpui-component/docs/components/button.md): Displays a button or a component that looks like a button.
- [Button](/gpui-component/zh-CN/docs/components/button.md): 显示一个按钮，或外观表现为按钮的组件。
- [Button](/gpui-component/base/primitives/button.md): An unstyled, accessible pressable with semantic state and keyboard activation.
- [Calendar](/gpui-component/docs/components/calendar.md): A flexible calendar component for displaying months, navigating dates, and selecting single dates or date ranges.
- [Calendar](/gpui-component/zh-CN/docs/components/calendar.md): 用于展示月份、浏览日期和选择单日或区间的灵活日历组件。
- [Calendar](/gpui-component/base/primitives/calendar.md): A state-driven date grid with selection matchers and custom item rendering.
- [Chart](/gpui-component/zh-CN/docs/components/chart.md): 支持折线图、柱状图、面积图、饼图、雷达图、K 线图和桑基图的数据可视化组件。
- [Chart](/gpui-component/docs/components/chart.md): Beautiful charts and graphs for data visualization including line, bar, area, pie, radar, candlestick, and sankey charts.
- [Checkbox](/gpui-component/zh-CN/docs/components/checkbox.md): 用于切换选中与未选中状态的复选框组件。
- [Checkbox](/gpui-component/base/primitives/checkbox.md): A controlled tri-state check control with a separately styled indicator.
- [Checkbox](/gpui-component/docs/components/checkbox.md): A control that allows the user to toggle between checked and not checked.
- [Clipboard](/gpui-component/zh-CN/docs/components/clipboard.md): 用于复制文本或其它内容到剪贴板的按钮组件。
- [Clipboard](/gpui-component/docs/components/clipboard.md): A button component that helps you copy text or other content to your clipboard.
- [Collapsible](/gpui-component/zh-CN/docs/components/collapsible.md): 可展开和收起内容的交互式组件。
- [Collapsible](/gpui-component/base/primitives/collapsible.md): A composable region that shows or hides content without prescribing its trigger styling.
- [Collapsible](/gpui-component/docs/components/collapsible.md): An interactive element which expands/collapses.
- [Color Picker](/gpui-component/base/primitives/color-picker.md): State and interaction foundations for selecting colors in a custom picker UI.
- [ColorPicker](/gpui-component/zh-CN/docs/components/color-picker.md): 支持多种颜色格式、预设色和透明通道的颜色选择组件。
- [ColorPicker](/gpui-component/docs/components/color-picker.md): A comprehensive color selection interface with support for multiple color formats, presets, and alpha channel.
- [Combobox](/gpui-component/zh-CN/docs/components/combobox.md): 带有可搜索下拉列表的自动补全输入组件。
- [Combobox](/gpui-component/base/primitives/combobox.md): A text input paired with keyboard-navigable suggestions and selection behavior.
- [Combobox](/gpui-component/docs/components/combobox.md): An autocomplete input paired with a searchable dropdown list.
- [Components](/gpui-component/docs/components.md)
- [Context](/gpui-component/docs/context.md): Learn about the Window and Context in GPUI.
- [Custom I18n](/gpui-component/docs/i18n.md): Add or override GPUI Component translations from your application.
- [DataTable](/gpui-component/zh-CN/docs/components/data-table.md): 支持虚拟滚动、排序、筛选和列管理的高性能数据表格。
- [DataTable](/gpui-component/docs/components/data-table.md): High-performance data table with virtual scrolling, sorting, filtering, and column management.
- [Date Picker](/gpui-component/base/primitives/date-picker.md): A focus-aware date input that composes calendar behavior with a popup.
- [DatePicker](/gpui-component/zh-CN/docs/components/date-picker.md): 支持单日期和日期范围选择的日历选择器组件。
- [DatePicker](/gpui-component/docs/components/date-picker.md): A date picker component for selecting single dates or date ranges with calendar interface.
- [DescriptionList](/gpui-component/zh-CN/docs/components/description-list.md): 用于以整齐布局展示键值对详情信息的组件。
- [DescriptionList](/gpui-component/docs/components/description-list.md): Use to display details with a tidy layout for key-value pairs.
- [Dialog](/gpui-component/zh-CN/docs/components/dialog.md): 在应用内容上方显示浮层内容的对话框组件。
- [Dialog](/gpui-component/base/primitives/dialog.md): A composable modal surface with focus management, backdrop, title, and close parts.
- [Dialog](/gpui-component/docs/components/dialog.md): A dialog dialog for displaying content in a layer above the app.
- [DropdownButton](/gpui-component/zh-CN/docs/components/dropdown_button.md): DropdownButton 由一个主按钮和一个触发下拉菜单的按钮组合而成。
- [DropdownButton](/gpui-component/docs/components/dropdown_button.md): A DropdownButton is a combination of a button and a trigger button. It allows us to display a dropdown menu when the trigger is clicked, but the left Button can still respond to independent events.
- [Editor](/gpui-component/base/primitives/editor.md): An unstyled source-code editor with language, gutter, folding, and decoration support.
- [Editor](/gpui-component/docs/components/editor.md): Source-code editor with syntax highlighting, gutter, folding, and decorations.
- [Editor](/gpui-component/zh-CN/docs/components/editor.md): 支持语法高亮、行号、折叠和文本装饰的源代码编辑器。
- [ElementId](/gpui-component/docs/element_id.md): To introduce the ElementId concept in GPUI.
- [ElementId](/gpui-component/zh-CN/docs/element_id.md): 介绍 GPUI 中的 ElementId 概念。
- [Focus Trap](/gpui-component/docs/components/focus-trap.md): A utility element that traps keyboard focus within a container, preventing Tab navigation from escaping.
- [Focus Trap](/gpui-component/zh-CN/docs/components/focus-trap.md): 将键盘焦点限制在指定容器内的工具元素。
- [Form](/gpui-component/docs/components/form.md): Flexible form container with support for field layout, validation, and multi-column layouts.
- [Form](/gpui-component/zh-CN/docs/components/form.md): 支持字段布局、校验和多列排布的灵活表单容器。
- [Getting Started](/gpui-component/base/getting-started.md): Install, initialize, and render your first gpui-base control.
- [Getting Started](/gpui-component/docs/getting-started.md): Learn how to set up and use GPUI Component in your project
- [GPUI Base](/gpui-component/base.md): Unstyled, accessible foundations for building GPUI design systems.
- [GPUI Component](/gpui-component/zh-CN.md): 基于 Rust + GPUI 构建卓越的桌面应用程序
- [GPUI Component website](/gpui-component/README.md)
- [GroupBox](/gpui-component/docs/components/group-box.md): A styled container element with an optional title to group related content together.
- [GroupBox](/gpui-component/zh-CN/docs/components/group-box.md): 带可选标题的分组容器组件，用于组织相关内容。
- [Hover Card](/gpui-component/base/primitives/hover-card.md): A delayed floating card associated with a pointer or keyboard trigger.
- [HoverCard](/gpui-component/docs/components/hover-card.md): A floating overlay that displays rich content when hovering over a trigger element.
- [HoverCard](/gpui-component/zh-CN/docs/components/hover-card.md): 鼠标悬停时显示富内容浮层的组件。
- [Icon](/gpui-component/docs/components/icon.md): Display SVG icons with various sizes, colors, and transformations.
- [Icon](/gpui-component/zh-CN/docs/components/icon.md): 以不同尺寸、颜色和变换方式显示 SVG 图标。
- [Icons & Assets](/gpui-component/docs/assets.md)
- [Image](/gpui-component/docs/components/image.md): A flexible image display component with loading states, fallbacks, and responsive sizing options.
- [Image](/gpui-component/zh-CN/docs/components/image.md): 支持加载状态、回退内容和响应式尺寸的灵活图片展示组件。
- [Input](/gpui-component/docs/components/input.md): Text input component with validation, masking, and various features.
- [Input](/gpui-component/base/primitives/input.md): An unstyled single-line text input with masking, validation, and number stepping.
- [Input](/gpui-component/zh-CN/docs/components/input.md): 带校验、掩码和多种扩展能力的文本输入组件。
- [Installation](/gpui-component/docs/installation.md)
- [Introduction](/gpui-component/docs.md): Rust GUI components for building fantastic cross-platform desktop application by using GPUI.
- [Kbd](/gpui-component/docs/components/kbd.md): Displays keyboard shortcuts with platform-specific formatting.
- [Kbd](/gpui-component/zh-CN/docs/components/kbd.md): 以符合平台习惯的方式显示键盘快捷键。
- [Label](/gpui-component/docs/components/label.md): Text labels for form elements with highlighting and styling options.
- [Label](/gpui-component/zh-CN/docs/components/label.md): 支持高亮、次要文本和样式定制的文本标签组件。
- [Link](/gpui-component/base/primitives/link.md): An accessible link-like control with application-defined styling.
- [List](/gpui-component/docs/components/list.md): A flexible list component that displays a series of items with support for sections, search, selection, and infinite scrolling.
- [List](/gpui-component/zh-CN/docs/components/list.md): 支持分组、搜索、选择和无限滚动的灵活列表组件。
- [Menu](/gpui-component/docs/components/menu.md): Context menus and popup menus with support for icons, shortcuts, submenus, and various menu item types.
- [Menu](/gpui-component/zh-CN/docs/components/menu.md): 支持图标、快捷键、子菜单和多种菜单项类型的上下文菜单与弹出菜单。
- [Notification](/gpui-component/docs/components/notification.md): Display toast notifications that appear at the top right of the window with auto-dismiss functionality.
- [Notification](/gpui-component/zh-CN/docs/components/notification.md): 在窗口右上角显示支持自动消失的 toast 通知。
- [Number Input](/gpui-component/base/primitives/number-input.md): A numeric input with reusable increment, decrement, and step behavior.
- [NumberInput](/gpui-component/docs/components/number-input.md): Number input component with increment/decrement controls and numeric formatting.
- [NumberInput](/gpui-component/zh-CN/docs/components/number-input.md): 带增减按钮与数字格式化能力的数值输入组件。
- [OTP Input](/gpui-component/base/primitives/otp-input.md): A multi-cell one-time-code input driven by a shared text state.
- [OtpInput](/gpui-component/docs/components/otp-input.md): One-time password input component with multiple fields, auto-focus, and paste handling.
- [OtpInput](/gpui-component/zh-CN/docs/components/otp-input.md): 带多输入框、自动聚焦和粘贴处理的一次性验证码输入组件。
- [Pagination](/gpui-component/docs/components/pagination.md): Pagination with page navigation, next and previous links.
- [Pagination](/gpui-component/base/primitives/pagination.md): A controlled page navigator with explicit current and total page state.
- [Pagination](/gpui-component/zh-CN/docs/components/pagination.md): 提供页码、上一页和下一页导航的分页组件。
- [Plot](/gpui-component/docs/components/plot.md): A low-level plotting library for creating custom charts and data visualizations.
- [Plot](/gpui-component/zh-CN/docs/components/plot.md): 用于构建自定义图表和数据可视化的底层绘图库。
- [Popover](/gpui-component/docs/components/popover.md): A floating overlay that displays rich content relative to a trigger element.
- [Popover](/gpui-component/zh-CN/docs/components/popover.md): 相对于触发元素显示富内容的浮动层组件。
- [Popover](/gpui-component/base/primitives/popover.md): An anchored floating surface with controlled or internally managed open state.
- [Popup](/gpui-component/base/primitives/popup.md): A low-level trigger and anchored floating-content host.
- [Primitives](/gpui-component/base/primitives.md): The complete catalog of user-facing gpui-base primitives.
- [Progress](/gpui-component/base/primitives/progress.md): Composable track and indicator parts for reporting task completion.
- [Progress](/gpui-component/docs/components/progress.md): Displays an indicator showing the completion progress of a task, typically displayed as a progress bar or circular indicator.
- [Progress](/gpui-component/zh-CN/docs/components/progress.md): 用于显示任务完成进度的线性或环形指示器。
- [Radio](/gpui-component/base/primitives/radio.md): A controlled single-choice item with selectable and disabled semantics.
- [Radio](/gpui-component/docs/components/radio.md): A set of checkable buttons—known as radio buttons—where no more than one of the buttons can be checked at a time.
- [Radio](/gpui-component/zh-CN/docs/components/radio.md): 一组互斥的单选按钮，同一时间只能选中一个选项。
- [Radio Group](/gpui-component/base/primitives/radio-group.md): Groups radio items and provides keyboard navigation for a single selection.
- [Rating](/gpui-component/docs/components/rating.md): A simple interactive star rating component.
- [Rating](/gpui-component/zh-CN/docs/components/rating.md): 简单的交互式星级评分组件。
- [Resizable](/gpui-component/base/primitives/resizable.md): Panel groups and resize handles for user-adjustable split layouts.
- [Resizable](/gpui-component/docs/components/resizable.md): A flexible panel layout system with draggable resize handles and adjustable panels.
- [Resizable](/gpui-component/zh-CN/docs/components/resizable.md): 具有拖拽分隔条与尺寸约束的可调整面板布局系统。
- [Root View](/gpui-component/docs/root.md)
- [Root 视图](/gpui-component/zh-CN/docs/root.md)
- [Scrollable](/gpui-component/docs/components/scrollable.md): Scrollable container with custom scrollbars, scroll tracking, and virtualization support.
- [Scrollable](/gpui-component/zh-CN/docs/components/scrollable.md): 支持自定义滚动条、滚动跟踪与虚拟列表的可滚动容器。
- [Scrollbar](/gpui-component/base/primitives/scrollbar.md): An unstyled scrollbar connected to GPUI scroll or uniform-list handles.
- [Select](/gpui-component/base/primitives/select.md): A button-like selection control backed by an anchored, keyboard-navigable popup.
- [Select](/gpui-component/docs/components/select.md): Displays a list of options for the user to pick from—triggered by a button.
- [Select](/gpui-component/zh-CN/docs/components/select.md): 通过按钮触发的选项选择组件。
- [Settings](/gpui-component/docs/components/settings.md): A settings UI with grouped setting items and pages.
- [Settings](/gpui-component/zh-CN/docs/components/settings.md): 用于构建设置页、设置分组和设置项的界面组件。
- [Sheet](/gpui-component/base/primitives/sheet.md): A modal surface that enters from an edge while managing dismissal and focus.
- [Sheet](/gpui-component/docs/components/sheet.md): A sliding panel that appears from the edges of the screen for displaying content.
- [Sheet](/gpui-component/zh-CN/docs/components/sheet.md): 从屏幕边缘滑出的内容面板组件。
- [Sidebar](/gpui-component/docs/components/sidebar.md): A composable, themeable and customizable sidebar component for navigation and content organization.
- [Sidebar](/gpui-component/zh-CN/docs/components/sidebar.md): 一个可组合、可主题化、可自定义的侧边栏组件。
- [Skeleton](/gpui-component/docs/components/skeleton.md): Use to show a placeholder while content is loading.
- [Skeleton](/gpui-component/zh-CN/docs/components/skeleton.md): 在内容加载时显示占位骨架。
- [Skills](/gpui-component/skills.md): GPUI Component Skills - Available skills for working with GPUI Component
- [Skills](/gpui-component/zh-CN/skills.md): 适用于 GPUI Component 的开发技能与实践指南。
- [Slider](/gpui-component/base/primitives/slider.md): A state-driven range input with independently styleable track, indicator, and thumb.
- [Slider](/gpui-component/zh-CN/docs/components/slider.md): 通过拖动滑块在区间内选择数值的控件。
- [Slider](/gpui-component/docs/components/slider.md): A control that allows the user to select values from a range using a draggable thumb.
- [Spinner](/gpui-component/docs/components/spinner.md): Displays an animated loading showing the completion progress of a task.
- [Spinner](/gpui-component/zh-CN/docs/components/spinner.md): 显示旋转加载动画，用于反馈任务或异步操作的进行中状态。
- [StatusBar](/gpui-component/docs/components/status-bar.md): A horizontal status bar with left, center, and right regions, usually placed at the bottom of a window or pane.
- [StatusBar](/gpui-component/zh-CN/docs/components/status-bar.md): 一个分为左、中、右三个区域的水平状态栏,通常放置在窗口或面板底部。
- [Stepper](/gpui-component/docs/components/stepper.md): A step-by-step progress for users to navigate through a series of steps or stages.
- [Stepper](/gpui-component/zh-CN/docs/components/stepper.md): 用于引导用户按步骤完成流程的进度组件。
- [Switch](/gpui-component/base/primitives/switch.md): A controlled on/off control with separately styleable track and thumb.
- [Switch](/gpui-component/docs/components/switch.md): A control that allows the user to toggle between checked and not checked.
- [Switch](/gpui-component/zh-CN/docs/components/switch.md): 用于在选中和未选中之间切换的开关控件。
- [Table](/gpui-component/base/primitives/table.md): Semantic table primitives for composing headers, bodies, rows, and cells.
- [Table](/gpui-component/docs/components/table.md): A basic table component for directly rendering tabular data.
- [Table](/gpui-component/zh-CN/docs/components/table.md): 一个用于直接渲染表格数据的基础表格组件。
- [Tabs](/gpui-component/base/primitives/tabs.md): A tab list and accessible tab controls with controlled selection.
- [Tabs](/gpui-component/docs/components/tabs.md): A set of layered sections of content—known as tab panels—that are displayed one at a time.
- [Tabs](/gpui-component/zh-CN/docs/components/tabs.md): 将内容拆分为多个标签面板并逐个切换显示的组件。
- [Tag](/gpui-component/docs/components/tag.md): A short item that can be used to categorize or label content.
- [Tag](/gpui-component/zh-CN/docs/components/tag.md): 用于分类、标记和显示元数据的紧凑标签组件。
- [Text Selection](/gpui-component/base/text-selection.md): Add native window-level text selection to plain text and custom GPUI participants.
- [Textarea](/gpui-component/base/primitives/textarea.md): An unstyled multi-line text field with fixed rows or auto-grow behavior.
- [Textarea](/gpui-component/docs/components/textarea.md): Multi-line text input with fixed rows, soft wrapping, and auto-grow.
- [Textarea](/gpui-component/zh-CN/docs/components/textarea.md): 支持固定行数、软换行和自动增高的多行文本输入组件。
- [TextView](/gpui-component/docs/components/text-view.md): Renders Markdown and HTML text with optional custom Markdown plugins.
- [TextView](/gpui-component/zh-CN/docs/components/text-view.md): 渲染 Markdown 与 HTML 文本，并支持自定义 Markdown 插件。
- [Theme](/gpui-component/docs/theme.md)
- [TitleBar](/gpui-component/docs/components/title-bar.md): A custom window title bar component with window controls and custom content support.
- [TitleBar](/gpui-component/zh-CN/docs/components/title-bar.md): 支持窗口控制和自定义内容的自定义标题栏组件。
- [Toast](/gpui-component/base/primitives/toast.md): A managed, animated stack of temporary status messages.
- [Toggle](/gpui-component/base/primitives/toggle.md): A controlled two-state pressable for persistent choices such as formatting.
- [Toggle](/gpui-component/docs/components/toggle.md): A button-style toggle component for binary on/off or selected states.
- [Toggle](/gpui-component/zh-CN/docs/components/toggle.md): 以按钮形态表示开关或选中状态的切换组件。
- [Toggle Group](/gpui-component/base/primitives/toggle-group.md): Coordinates a set of toggle controls as a single- or multiple-selection group.
- [Tooltip](/gpui-component/base/primitives/tooltip.md): A delayed, positioned description associated with a trigger element.
- [Tooltip](/gpui-component/docs/components/tooltip.md): Display helpful information on hover or focus, with support for keyboard shortcuts and custom content.
- [Tooltip](/gpui-component/zh-CN/docs/components/tooltip.md): 在悬停或聚焦时显示提示信息，支持快捷键和自定义内容。
- [Tree](/gpui-component/base/primitives/tree.md): A virtualized hierarchical list with explicit expansion and selection state.
- [Tree](/gpui-component/docs/components/tree.md): A hierarchical tree view component for displaying and navigating tree-structured data.
- [Tree](/gpui-component/zh-CN/docs/components/tree.md): 用于显示和导航树形结构数据的层级树组件。
- [Untitled](/gpui-component/contributors.md)
- [Virtual List](/gpui-component/base/primitives/virtual-list.md): A high-performance vertical or horizontal list that renders only visible items.
- [VirtualList](/gpui-component/docs/components/virtual-list.md): High-performance virtualized list component for rendering large datasets with variable item sizes.
- [VirtualList](/gpui-component/zh-CN/docs/components/virtual-list.md): 用于大数据集渲染的高性能虚拟列表组件，支持可变尺寸项。
- [Website Design](/gpui-component/DESIGN.md)
- [上下文](/gpui-component/zh-CN/docs/context.md): 了解 GPUI 中的 Window 和 Context。
- [主题](/gpui-component/zh-CN/docs/theme.md)
- [介绍](/gpui-component/zh-CN/docs.md): 使用 GPUI 构建跨平台桌面应用的 Rust GPUI Component。
- [图标与资源](/gpui-component/zh-CN/docs/assets.md)
- [安装](/gpui-component/zh-CN/docs/installation.md)
- [开始使用](/gpui-component/zh-CN/docs/getting-started.md): 学习如何在项目中安装并使用 GPUI Component。
- [组件](/gpui-component/zh-CN/docs/components.md)
- [自定义国际化](/gpui-component/zh-CN/docs/i18n.md): 在应用中新增或覆盖 GPUI Component 的翻译。
- [贡献者](/gpui-component/zh-CN/contributors.md): 为 GPUI Component 做出贡献的开发者。