更新记录

0.2.1（2026-06-18） 下载此版本

demo增加蓝牙组件演示

0.2.0（2026-06-03） 下载此版本

给示例页面添加滚动容器 优化(i-ui-x): 更新组件库日志与文档 修复(页面样式): 移除冗余的页面高度样式

0.1.2（2026-06-02） 下载此版本

• 优化(样式): 统一页面容器高度为100%并清理冗余样式
• 优化(组件): 修复多组件样式兼容问题，移除不必要的gap和display属性
• 优化(蓝牙插件): 完善i-ble插件类型定义和导出配置
• 优化(UI组件): 修复i-ui-x组件的动画和样式兼容问题

平台兼容性

uni-app x(5.13)

I UI X

I UI X 是一个面向 UniAppX 的 uni_modules 组件库插件，组件以 .uvue 单文件组件形式提供，适合在移动端页面、小程序页面和 H5 页面中通过 easycom 自动引入使用。

本组件库依据 DCloud uni-app x 规范开发，优先使用 UniAppX 内置组件与 API，尽量保持组件结构轻量、参数命名清晰、交互行为真实可用。

插件信息

• 插件名称：i-ui-x
• 插件类型：前端组件 / 通用组件
• 组件前缀：i-
• 组件目录：src/uni_modules/i-ui-x/components
• 演示页面：src/subpkg
• 适用场景：UniAppX 项目的基础 UI、表单输入、数据展示、反馈交互、布局排版、导航入口和常用扩展能力。

安装使用

将本目录放入项目的 src/uni_modules/i-ui-x 下，UniAppX 会自动识别 components/*/*.uvue 组件。页面中可直接使用组件标签：

<template>
  <i-button type="primary">确认</i-button>
  <i-alert type="success" title="保存成功" description="操作已完成"></i-alert>
</template>

颜色、尺寸、状态、事件等能力请以组件演示页中的「效果演示」「Props 调试」「API」为准。

基础组件

• i-color：语义色板组件，支持点击、复制、禁用状态，以及主色、浅色、深色、禁用色等颜色展示。
• i-icon：图标组件，支持字体图标、图片地址、颜色、大小、旋转、旋转动画和点击事件。
• i-image：图片组件，支持裁剪模式、圆形/方形/圆角形状、懒加载、预览、加载中、加载失败和事件回调。
• i-button：按钮组件，支持类型、尺寸、形状、朴素、细边框、加载中、图标、颜色、节流点击和开放能力事件透传。
• i-text：文本组件，支持内容、字号、语义类型、颜色、装饰线、块级显示、加粗和点击事件。
• i-row / i-col：栅格布局组件，支持 24 栅格、间距、弹性对齐、换行、偏移、推拉和内边距。
• i-cell：单元格组件，支持头像/图标、标题、描述、右侧文字、卡片/普通模式、边框、跳转、插槽和点击事件。
• i-badge：角标组件，支持点状、数字、文本、最大值、位置、偏移、隐藏、字号、颜色和点击事件。
• i-tag：标签组件，支持语义类型、尺寸、样式、圆角、自定义颜色、图标、渐变、可关闭、禁用和事件。
• i-loading：局部加载组件，支持图标旋转、文字、横向/纵向排列、隐藏文字、语义颜色和显示控制。
• i-loading-page：加载页组件，支持全屏加载、遮罩、点击遮罩关闭和状态同步。

表单组件

• i-form / i-form-item：表单与表单项组件，支持模型数据、规则校验、必填校验、横向/纵向标签、操作按钮、实时状态、错误滚动和校验方法。
• i-calendar：日历组件，支持单选、多选、范围选择、默认日期、最小/最大日期、内联或弹层模式、主题色和确认/关闭事件。
• i-keyboard：数字键盘组件，支持弹层显示、长度限制、最大值限制、小数/整数、密码模式、长按和主题色。
• i-cascader：级联选择组件，支持树形数据、多级选择、禁用项、内联/弹层、列宽、横向自动滚动、自定义头部和选择事件。
• i-picker：选择器组件，支持滚轮选择、单列/多列、默认索引、默认值、加载状态、工具栏、输入触发和确认/取消事件。
• i-datetime-picker：日期时间选择器，支持日期、时间、年月、日期时间模式，最小/最大时间限制、时间范围限制和弹层确认。
• i-color-picker：颜色选择器，支持 RGB、光谱、色卡三种模式，透明度、HEX 输入、颜色预览、推荐颜色和弹层确认。
• i-select：选择器组件，支持字符串/对象选项、弹层位置、可清空、标签、禁用项、边框、文字对齐和值同步。
• i-rate：评分组件，支持数量、最低分、半星、只读、禁用、图标、颜色、尺寸、间距和评分事件。
• i-search：搜索组件，支持形状、清空、右侧操作、左右插槽、图标点击、搜索、聚焦、失焦和值同步。
• i-number-box：步进器组件，支持最小值、最大值、步长、整数/小数、异步变更、按钮禁用、输入禁用和自定义插槽。
• i-upload：上传组件，支持图片选择、预览、删除、数量限制、缩略图间距、自定义上传区域、自定义文件区域和读文件事件。
• i-input：输入框组件，支持前后插槽、清空、密码显示切换、字数统计、边框、形状和原生输入事件。
• i-textarea：多行输入组件，支持字数统计、自动高度、边框、背景、圆角和原生多行输入事件。
• i-checkbox：复选框组件，支持布尔值或数组值、方形/圆形/按钮等形态、插槽、标签控制、颜色和选中事件。
• i-radio：单选框组件，支持按名称匹配、圆形/方形/点状/按钮等形态、插槽、标签控制、颜色和值同步。
• i-switch：开关组件，支持加载中、禁用、形状、自定义开关值、异步变更、文字标签、颜色和事件。
• i-slider：滑块组件，支持单值/区间、最小值、最大值、步长、禁用、只读、禁止交叉、颜色、显示数值和拖动事件。
• i-album：相册组件，支持多图展示、键名配置、单图/多图尺寸、裁剪模式、最大数量、溢出提示和图片预览。
• i-slider-button：滑动按钮组件，支持轨道尺寸、圆角、轨道文字、阈值、自动复位、滑块插槽、成功/重置/变更事件和重置方法。

数据组件

• i-circle-progress：圆形进度组件，适合展示百分比进度。
• i-amount：金额组件，适合展示金额格式、符号、精度和分组。
• i-line-progress：线性进度组件，适合展示任务进度、状态色和百分比文字。
• i-countdown：倒计时组件，支持倒计时展示、结束回调和点击事件。
• i-count-to：数字滚动组件，支持从起始值滚动到目标值。

i-qrcode 和 ix-table 已拆分为独立 uni_modules 插件，不再作为 i-ui-x 聚合组件发布。

反馈组件

• i-popover：弹出气泡组件，支持内容提示、弹出方向、自定义内容、箭头偏移、空白区域关闭、插槽和方法。
• i-action-sheet：操作菜单组件，支持标题、选项、禁用项、图标、颜色、取消按钮、开放能力和选择事件。
• i-alert：警告提示组件，支持类型、主题、图标、关闭、插槽和点击事件。
• i-toast：消息提示组件，支持方法调用、图标、加载中、位置、自动关闭和关闭事件。
• i-notify：顶部通知组件，支持类型、文案、自定义样式、持续时间和关闭事件。
• i-notice-bar：滚动通知组件，支持横向/竖向滚动、可关闭、点击和关闭事件。
• i-swipe-action / i-swipe-action-item：滑动单元格组件，支持左右操作区、阈值拖动、插槽和状态事件。
• i-collapse / i-collapse-item：折叠面板组件，支持默认展开、手风琴、禁用、标题/内容/图标插槽和切换事件。
• i-popup：弹出层组件，支持上、下、左、右四个方向，遮罩、动画、标题、关闭按钮、底部按钮和滑动关闭。
• i-modal：模态框组件，支持确认、取消、异步关闭、按钮模式、淡入缩放动画、插槽和打开/关闭方法。
• i-curtain：幕帘组件，支持遮罩、关闭图标位置、自定义关闭区域和打开/关闭事件。
• i-float-panel：浮动面板组件，支持锚点、拖动、遮罩、手柄插槽、内容插槽、移动/变更事件和跳转锚点方法。

布局组件

• i-divider：分割线组件，支持文字、点状、虚线、细线、文字位置和插槽。
• i-line：线条组件，支持横向/纵向线条、颜色、宽度、高度和边距。
• i-gap：间隔组件，支持高度、背景色和上下间距。
• i-safe-bottom：底部安全区组件，适合为页面底部预留安全距离。
• i-card：卡片组件，支持头部、内容、底部区域和插槽。
• i-section：分组标题组件，支持标题、右侧区域、内容插槽和点击事件。
• i-skeleton：骨架屏组件，适合页面加载占位。
• i-sticky：吸顶/吸底组件，支持顶部或底部固定、导航栏偏移和固定状态事件。
• i-grid：宫格组件，支持列数、边框、图标、文字和点击事件。
• i-list：列表组件，适合承载长列表内容。
• i-waterfall：瀑布流组件，适合双列或多列不等高内容展示。
• i-empty：空状态组件，适合展示暂无数据、加载失败等状态。

导航组件

• i-navbar：导航栏组件，支持安全区、返回、标题、左右插槽和自动返回事件。
• i-tabbar：标签栏组件，支持安全区、高度、图标、角标、红点和值同步。
• i-tabs：标签页组件，支持横向滚动、角标、红点、禁用项和切换事件。
• i-subsection：分段器组件，支持多项切换、样式类型和值同步。
• i-index-list：索引列表组件，支持分组数据、右侧索引、点击/滑动索引定位和分组吸附。
• i-slider-menu：侧边菜单组件，支持左侧菜单、右侧内容滚动、选中同步、折叠、插槽和滚到底后衔接页面滚动。
• i-steps / i-steps-item：步骤条组件，支持步骤状态、方向、图标和内容。
• i-dropdown：下拉菜单组件，支持菜单项、固定模式、自由内容面板、图标、距离、关闭按钮和选择事件。
• i-fab：悬浮按钮组件，支持拖动、吸附、位置预设、边界、插槽、点击、长按和展开状态。
• i-pagination：分页组件，支持移动端页码窗口、上一页、下一页和值同步。
• i-back-top：返回顶部组件，支持页面滚动监听、显示阈值和点击返回顶部。
• i-link：链接组件，支持文本链接、跳转、禁用和点击事件。

其他组件

• i-signature：签名组件，支持画板尺寸、背景色、笔迹颜色、笔迹宽度、清空、导出图片和重新计算尺寸。
• i-code：验证码输入组件，支持系统键盘、外部键盘、皮肤、占位符、输入动画、值同步、确认事件和方法。
• i-cropper：图片裁剪组件，支持裁剪框尺寸、压缩、选择图片、拖动、缩放、旋转、翻转、双指缩放、确认预览和事件。
• i-swiper：轮播组件，支持当前值、露出边缘、自定义指示点、自动播放、循环、最后一页事件和插槽。
• i-avatar：头像组件，支持图片、文字、尺寸、形状和点击事件。
• i-read-more：展开阅读组件，支持内容折叠、展开和状态变更。
• i-watermark：水印组件，支持文字水印、布局和内容插槽。
• i-load-more：加载更多组件，支持加载中、无更多、失败重试等状态。

内部演示辅助组件

• i-demo-title：演示页标题组件，支持点击复制页面标题。
• i-code-demo：示例代码展示组件，支持查看代码、收起代码和复制代码。
• i-api-doc：API 文档展示组件，用于在演示页渲染 Props、Events、Slots、Methods。
• i-prop-radio：Props 调试辅助组件，用于枚举参数的按钮式单选。

演示页面

组件演示页面位于：

• src/subpkg/components/*/index.uvue
• src/subpkg/form/*/index.uvue
• src/subpkg/data/*/index.uvue
• src/subpkg/feedback/*/index.uvue
• src/subpkg/layout-extra/*/index.uvue
• src/subpkg/navigation/*/index.uvue
• src/subpkg/other/*/index.uvue

每个组件演示页通常包含三个页签：

• 效果演示：展示组件的典型使用场景，要求真实使用组件能力。
• Props 调试：覆盖组件真实支持的 props，修改后应立即影响演示效果。
• API：展示组件 Props、Events、Slots、Methods，内容来自本地 API 注册表。

新增或调整演示页时，需要同步维护 src/pages.json 和首页入口。

设计说明

I UI X 的组件 API 追求清晰、直接、可验证。组件参数应与实际能力一致，不保留看起来支持但没有真实功能的 props 或 events。

视觉风格以移动端稳定显示为优先：文本、图标、按钮内容需要垂直居中；卡片、列表、弹层、表单项、表格和导航区域保持统一间距；小程序与 H5 都要避免遮挡、溢出、错位或无法点击。

组件源码应保持 .uvue 格式，使用 Vue 3 Composition API 风格组织逻辑。除非明确要求，不引入第三方状态管理或第三方 UI 框架。

发布说明

发布到 DCloud 插件市场时，建议只打包 src/uni_modules/i-ui-x 插件目录，不包含项目根目录、pages.json、App.uvue、main.uts、unpackage、node_modules 或版本控制目录。

插件信息以 package.json 为准，组件能力说明以本文件、演示页和 API tab 为准。

使用过程中如果有疑问，可评论留言。