图标概览

图标来自内嵌的 Lucide 目录。打开 icon feature 后，在组件里按名字引用即可。

基础用法

use arkit::prelude::*;

rsx! {
    row {
        {icon("settings", 24.0, 0xFF334155)}
        text { "设置" }
    }
}

icon 返回完整 Element；业务组件不要把它当成 image source，也不要假设任意字符串名称都存在。

查询目录

assert!(has_icon("settings"));

for name in icon_names() {
    // 用于图标浏览器或开发期搜索
}

icon_names() 适合工具页，不建议在每次业务 render 中扫描完整目录。常用图标名集中成模块常量，可以减少拼写错误。

与组件库的关系

shadcn 自动启用 icon，组件内部使用同一套资源和缓存。业务可以直接使用原生图标，也可以把图标作为 Button/Menu 等组件的内容。渲染参数、缓存边界和性能注意事项见下一章。