本技能是 Syncfusion Angular 按钮组件的综合实现指南,围绕四类按钮组件展开:Button、ButtonGroup、DropDownButton 和 Floating Action Button(FAB)。
一、用途 该指南用于指导开发者在 Angular 应用中集成和使用 Syncfusion 的按钮类组件,覆盖从安装、渲染到样式定制、事件处理和无障碍适配的完整流程。
二、主要能力
- Button:通过 ejs-button 指令渲染,支持文本、图标或两者组合,提供预定义颜色样式(e-primary、e-success、e-info、e-warning、e-danger、e-link)、HTML 提交/重置类型、扁平/轮廓/圆角/切换按钮、图标按钮(iconCss、iconPosition)、SVG 图标、按钮尺寸(e-small)、块级按钮(e-block)、禁用状态、RTL、工具提示、重复按钮等。
- ButtonGroup:纯 CSS 组件,将多个按钮组合为统一 UI,支持水平/垂直布局、单选(radio)与多选(checkbox)行为、轮廓与颜色样式、图标按钮、嵌套 DropDownButton 或 SplitButton、RTL、表单集成,并可通过 createButtonGroup 工具进行程序化初始化。
- DropDownButton:通过 ejs-dropdownbutton 指令渲染,点击后弹出操作项菜单,支持图标、自定义模板、动画(None、SlideDown、ZoomIn、FadeIn)、导航链接、分隔项、动态增删项(addItems、removeItems、toggle)、弹出宽度、延迟创建、HTML 净化、状态持久化等。
- Floating Action Button(FAB):通过 ejs-fab 指令渲染的圆形浮动按钮,支持九种预定义位置、target 容器限定、图标与文本组合、预定义样式、点击与创建事件、refreshPosition() 方法等。
三、使用方式 安装:使用 ng add @syncfusion/ej2-angular-buttons(DropDownButton 相关包为 @syncfusion/ej2-angular-splitbuttons)。 样式:在 styles.css 中导入 @syncfusion/ej2-base、@syncfusion/ej2-buttons、@syncfusion/ej2-splitbuttons 等对应主题 CSS(如 material.css)。 组件导入:在独立组件的 imports[] 中引入 ButtonModule、DropDownButtonModule 或 FabModule。 模板使用:通过 ejs-button、ejs-dropdownbutton、ejs-fab 等指令在模板中声明组件,并绑定属性与事件。
四、适用场景 适用于需要在 Angular 项目中构建交互式按钮、按钮组、下拉操作菜单和浮动主操作按钮的界面开发场景,尤其适合关注无障碍合规(WCAG 2.2、Section 508)和 RTL 支持的项目。
五、限制 资料未提供具体的收费、价格、平台兼容范围或性能效果数据;部分细节(如各组件完整 API 默认值)需查阅对应 references 文件。e-vertical 不支持嵌套 SplitButton。Angular 20+ 与 19 及以下在文件命名上存在差异(app.ts 与 app.component.ts)。