用途:本技能聚焦FineUI的按钮、按钮分组与下拉菜单控件,帮助开发者按所选写法正确声明按钮外观与点击行为。工具栏(Toolbar)相关内容见fineui-panel技能。
主要能力:按钮支持语义色、图标、尺寸、徽标;支持服务端与客户端点击、点击前确认;提供超链接按钮LinkButton;按钮分组ButtonGroup支持无间距拼接、互斥按下(单选)、多按下与纵向排列;下拉菜单Menu/MenuButton支持子菜单与可勾选菜单项。
使用方式:先确定写法(F.js、Pro、Core-MVC、Core-RazorForms、Core-RazorPages、Java Spring Boot,判定见fineui-foundation),再决定是否回发服务端。服务端事件用OnClick/on-click;纯客户端用页面具名函数加ClickHandler/click-handler。各写法属性命名不同:F.js用camelCase(如color、handler),C#用PascalCase(如ButtonColor、OnClick),Java用kebab-case(如button-color、on-click),但语义色取值仍为Primary/Success/Danger/Warning/Info。注意C#的Type是ButtonType(Button/Submit/Reset)而非颜色。
约束:不混用写法;新代码不使用OnClientClick;Pro推荐站点统一设置EnableImplicitPostBack="false"与EnableImplicitChangeEvents="false";确认按钮用ConfirmText/ConfirmTarget/ConfirmTitle/ConfirmIcon声明式属性;C#/Java菜单项是MenuButton/MenuHyperLink/MenuCheckBox/MenuText/MenuSeparator而非MenuItem;按钮分组按下用enablePress/EnablePress/EnablePressGroup,而非废弃的enableToggle。不确定API时查阅官网在线API。
限制:具体图标名、尺寸取值、徽标写法及完整示例细节未在资料中详述,需查阅references/button.md与references/menu.md及官网API。