用途:<sgds-icon> 用于从 SGDS 内置图标注册表渲染 SVG 图标,在使用 SGDS 组件构建界面时,用它替代 <img> 标签或外部图标库。
主要能力:通过 name 属性指定图标名称即可渲染图标,图标完全来自内部 SVG 注册表,不接收 src;size 属性控制渲染尺寸,可选值为 xs、sm、md、lg、xl、2-xl、3-xl,默认 lg。组件没有插槽(slot)、事件或公开方法。
使用方式:必须先完成安装与框架集成,参见 sgds-components-setup(React 19+ 与 React ≤18、Vue、Angular 的集成方式不同)。基本用法:<sgds-icon name="announcement"></sgds-icon>;指定尺寸:<sgds-icon name="arrow-right" size="sm"></sgds-icon>;大号装饰图标:<sgds-icon name="star" size="xl"></sgds-icon>。
尺寸选择参考:小字内联用 xs 或 sm,正文内联用 md,独立图标默认 lg,突出功能图标用 xl、2-xl 或 3-xl。放在 <sgds-link> 内时,图标尺寸自动管理,不要手动设置 size。
限制与注意事项:name 为必填;缺失或未识别的名称会记录控制台警告且不渲染任何内容。组件不暴露自定义属性(custom properties)和 CSS part,不支持做 CSS 样式修改。在 <sgds-link>、<sgds-badge> 等组件内部,图标尺寸自动管理,不要用 size 覆盖。可用图标名称请查阅 Storybook 文档中的 SGDS 图标注册表。