用途:在 Rails 视图中通过 lucide-rails gem 以内联 SVG 方式渲染 Lucide 图标,用于按钮、导航、徽章和空状态等界面元素。
主要能力:提供图标名称选择建议(kebab-case)、尺寸指南、CSS 样式方法以及与 Stimulus/Turbo 的集成模式;同时说明无障碍处理规则(装饰性图标无需标签,交互图标必须提供可访问文本)。
必要用法:在 Gemfile 添加 gem "lucide-rails" 后执行 bundle install,无需 JavaScript 或导入映射。视图中使用 <%= lucide_icon "home", size: 18 %>,可传 size、class、stroke_width 等参数,额外属性会透传至 svg 元素。图标使用 currentColor 继承文字颜色,样式应作用于父元素。
适用场景:Rails 视图中的按钮、导航链接、徽章、空状态、图标按钮等。
限制:图标名称仅支持 kebab-case,若图标不存在会在渲染时抛错;图标默认 aria-hidden,图标按钮必须添加 aria-label 或 sr-only 文本。尺寸与描边宽度建议需遵循文档指南。