单选控件

本文详细介绍单选按钮的设计规范与用法。适用于需从一组选项中仅选其一且展示所有选项的场景。文章阐述了何时使用单选按钮、避免复选框的误区，以及默认选中项对提升用户体验和降低交互成本的重要性。同时提供了组件属性定义、帮助文本生成及无障碍访问等开发指南，帮助开发者构建高效友好的表单界面。

这是一个关于表单字段筛选功能的配置说明文档，详细描述了如何配置字段的筛选器属性、操作符（如大于、包含、等于等）、布局类型（Regular, Panel, Card, Row, Details）以及相关的显示格式和摘要字段设置。该文档还提到了项目作为 Gutenberg 包的一部分，采用 monorepo 组织形式。

本文介绍已弃用的单选按钮组（RadioGroup）组件及其替代方案 RadioControl 和 ToggleGroupControl。作为实验性功能，它适用于少量选项的单选场景。文章涵盖单选组的用法、状态管理、禁用处理及最佳实践，包括清晰标签、一致位置、默认选中项等设计指南，并区分受控与非受控组件的使用方式。

所有区块都会出现在插入器、区块转换菜单、样式指南等中。要将区块从用户界面的所有部分隐藏，以便只能通过编程方式插入，将 supports.interactivity.hidden 设置为 true。

本文深入解析 WordPress 4.1 引入的 JavaScript/Underscore.js 自定义控件渲染机制。文章详细说明了如何利用 JS 模板替代传统 PHP 渲染，通过 register_control_type 注册控件类型，并覆盖 content_template 和 to_json 方法导出数据。内容涵盖动态创建控件的优势、核心颜色与媒体控件的实现案例，以及将 PHP 逻辑转换为 Underscore 模板的完整步骤，旨在帮助开发者构建更灵活高效的自定义器体验。

SelectControl 是用于从列表中单选或多选选项的 UI 组件，作为原生 select 元素的包装器。它支持标签定位、禁用状态及数组值处理。适用于空间有限且存在默认选项的场景，需配合句子大小写标签与简短菜单项使用，确保良好的用户体验和无障碍访问支持。

本文深入解析 WordPress 4.1 引入的自定义器 JavaScript API，涵盖 wp-admin/js/customize-controls.js 文件结构及核心功能。文章详解如何利用 postMessage API 在预览与控件间通信，演示动态调整预览 URL、激活/隐藏 UI 对象及实现自动聚焦等高级技巧，并介绍 Controls、Sections 和 Panels 模型的交互逻辑与优先级设置方法，为开发者构建自定义主题提供实用指南。

本文介绍 Gutenberg 编辑器中区块设计的最佳实践。涵盖内容区域交互、工具栏控件分组、侧边栏高级设置及占位符使用规范。提供关于命名、图标选择、描述撰写等具体建议，帮助开发者创建直观且功能完善的区块组件，提升用户体验与编辑效率。

本文深入解析 WordPress 查询循环块（Query Loop block）的扩展方法。通过块变体 API，开发者可为自定义文章类型创建专属预设，简化用户设置并隐藏无关控件。教程涵盖注册变体、定义布局、连接模式、自定义 Inspector 控件及处理 REST API 查询参数，助您打造功能完善且用户体验友好的 Gutenberg 插件。

本文介绍 FormToggle 表单切换组件，用于开启或关闭单个设置。设计规范明确何时使用开关，如切换选项状态、立即激活功能。建议避免用单选按钮替代。状态变化时滑块滑动轨道表示成功。开关需带清晰行内标签，禁止内部含文本。行为上操作立即生效。开发指南提供 checked、disabled 等属性说明及 onChange 回调函数用法。