小程序运营入口SmoUI 自研
组件总览定位
基础组件直接使用 shadcn/ui;SmoUI 维护中文业务规则、模板和验收流程。
源码路径
registry-src/smo-miniprogram-partner-operation-slot快速开始
页面里直接调用 SmoUI 业务组件。组件内部可以复用 shadcn/ui 底座,但对外暴露的是 Smo 场景语义。
安装到项目
npx shadcn@latest add https://smoui.xiaomolian.com/r/smo-miniprogram-partner-operation-slot.json页面直接调用
import { PartnerOperationSlot } from "@/components/PartnerOperationSlot"
export default function ExamplePage() {
return (
<PartnerOperationSlot
title="区域经营伙伴"
label="合作入口"
subtitle="一起服务本地商家"
actionText="了解一下"
onOpen={openPartnerEntry}
onClose={hidePartnerEntry}
/>
)
}Preview / Code
预览使用 Smo 业务语境命名,避免只停留在抽象控件展示。
registry-src/smo-miniprogram-partner-operation-slot区域经营伙伴
合作入口一起服务本地商家
了解一下›
区域经营伙伴
合作入口一起服务本地商家
查看›
区域经营伙伴
入口一起服务本地商家
了解一下›
变体
合作招募入口
生成页面时按业务语义选择,不按视觉喜好随机切换。
低优先级运营位
生成页面时按业务语义选择,不按视觉喜好随机切换。
可关闭提示
生成页面时按业务语义选择,不按视觉喜好随机切换。
静默弱化态
生成页面时按业务语义选择,不按视觉喜好随机切换。
业务组合
复用底座原语
底层继续使用 shadcn/ui 和 Base UI,不把基础按钮、弹窗、卡片重新发明一遍。
映射 Smo 场景
根据 SmoArch、SmoLink、smolink-online、SmoFan、SmoMark 的边界决定组件出现的位置和状态。
沉淀业务模板
成熟组合进入页面模板和 registry,让下一次从一句话生成 UI 时可以复用。
SMO 使用规则
对所有用户露出的入口不展示伙伴后台私有数据。
它是可配置运营位,不是固定系统菜单;父级必须允许按配置隐藏或被用户关闭。
默认放在业务主任务之后,不能抢占页面头部、核心操作或主视觉区域。
点击后的伙伴身份判断、招募页分流和后台跳转由业务页面或服务层处理,组件不内置身份逻辑。
文案保持中性,使用合作入口、一起服务本地商家、了解一下等表达,不写招募激励或结果承诺。
API 参考
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| title | ReactNode | "区域经营伙伴" | 入口主标题,建议保持为目标去向,不写后台数据状态。 |
| subtitle | ReactNode | "一起服务本地商家" | 短副文案,用于解释合作方向;应保持一行内可读。 |
| label | ReactNode | "合作入口" | 轻量标签,可传空隐藏。 |
| actionText | ReactNode | "了解一下" | 右侧动作文案;具体进入后台或招募页由点击后分流决定。 |
| icon | ReactNode | 内置邀请图标 | 左侧入口图标;业务侧可传自定义 Image 或图标节点替换默认样式。 |
| closable | boolean | true | 是否显示关闭按钮;关闭后的持久化由业务侧处理。 |
| variant | "default" | "quiet" | "default" | 视觉强度;低优先级区域可使用 quiet。 |
| onOpen | () => void | - | 点击入口回调;业务侧在这里执行伙伴身份判断和页面分流。 |
| onClose | () => void | - | 关闭回调;业务侧决定本地或服务端配置如何隐藏。 |