MiniUI 使用文档 MiniUI 使用文档
MiniUI文档
ColorUI文档
GitHub (opens new window)
MiniUI文档
ColorUI文档
GitHub (opens new window)
  • 快速开始

    • 介绍
    • 快速使用
    • 基础组件

      • Button按钮
      • Cell单元格
      • Icon组件
      • Text文字
    • 反馈组件

      • ActionSheet 动作面板
      • Circle 环形进度条
      • CountDown 倒计时
      • CountTo 数字滚动
      • Dialog 对话框
      • Empty 空状态
      • Loading 加载指示器
      • NoticeBar 通知栏
      • Notify 通知
      • Overlay 遮罩层
      • Popover 气泡卡片
      • Popup 弹出层
      • Progress 进度条
      • SortButton 排序按钮
      • SwipeAction 滑动操作
      • Toast 轻提示
      • Transition 动画
    • 表单组件

      • Calendar 日历
      • CalendarView 日历视图
      • Cascader 级联选择器
      • Checkbox 复选框
      • DatetimePicker 日期时间选择器
      • DatetimePickerView 日期时间选择器视图
      • Form 表单
      • Input 输入框
      • InputNumber 计数器
      • Keyboard 键盘
      • Picker 选择器
      • Radio 单选框
      • Rate 评分
      • Search 搜索框
      • SelectPicker 选择器
      • Signature 签名
      • Slider 滑块
      • SlideVerify 滑块验证
      • Switch 开关
      • Textarea 文本域
      • Upload 上传
    • 布局组件

      • Grid 宫格
      • Layout 布局
    • 导航组件

      • Backtop 返回顶部
      • Fab 浮动按钮
      • IndexBar 索引栏
      • Navbar 导航栏
      • Pagination 分页
      • Segmented 分段器
      • Sidebar 侧边栏
      • Tabbar 底部导航
      • Tabs 标签页
    • 展示组件

      • Avatar头像
      • Badge 徽标
      • Card 卡片
      • Collapse 折叠面板
      • Curtain 幕帘
      • Divider 分割线
      • ImagePreview 图片预览
      • Img 图片
      • ImgCropper 图片裁剪
      • Loadmore 加载更多
      • Skeleton 骨架屏
      • Sticky 粘性布局
      • Steps 步骤条
      • Swiper 轮播
      • Table 表格
      • Tag 标签
      • VideoPreview 视频预览
      • Watermark 水印
    • 视图模式
    • 目录模式
    目录

    快速使用

    以下是 mini-ui 组件库快速使用指南,可直接用于文档站点:

    # mi-ui 快速上手

    1. 获取源码
    git clone https://github.com/miren521/mi-ui.git
    

    将仓库中的 packages 目录复制到你 UniApp 项目的根目录下。

    1. 配置 easycom

    在 pages.json 中添加(UniApp 默认已开启 easycom,只需补充自定义规则):

    {
      "easycom": {
        "autoscan": true,
        "custom": {
          "^m-(.*)": "@/packages/m-1/m-1.vue"
        }
      }
    }
    

    ⚠️ 修改 pages.json 后需重新编译项目才能生效。

    1. 直接使用

    无需 import / 注册,在任意 .vue 文件中按 <m-组件名> 格式书写即可:

    <template>
      <m-button type="primary">按钮</m-button>
      <m-tag color="red">标签</m-tag>
    </template>
    

    组件会自动解析到 @/packages/m-button/m-button.vue、@/packages/m-tag/m-tag.vue。

    1. 高度自定义

    由于是本地源码引用,你可以直接修改 packages/m-xxx/m-xxx.vue 中的模板、样式和逻辑,改动即时生效,完全掌控每一行代码。

    注意事项

    事项 说明
    目录结构 每个组件必须遵循 packages/m-xxx/m-xxx.vue 命名规范
    新增组件 新建文件夹 + 同名 .vue 文件即可,easycom 自动识别
    HBuilderX 若智能提示缺失,重启 IDE 或手动刷新 easycom 缓存
    版本更新 重新 git pull 并覆盖 packages 目录,注意备份本地修改
    上次更新: 2026/09/10, 17:17:02
    介绍
    Button按钮

    ← 介绍 Button按钮→

    Theme by Vdoing | Copyright © 2022-2026 miren | MIT License
    • 跟随系统
    • 浅色模式
    • 深色模式
    • 阅读模式