更新记录

1.1.20（2026-02-01）

• [特别提醒]官方发布了sdk5.02版本，我在明年(2026-6月前)上半年前看官方的适配进度择机跟随推进。
• [重要提醒] 本次升级后，部分组件必须为4.87sdk
• 【重磅】发布x-webview-u原生插件，现在你可以使用内置的tmuijssdk.js嵌入到你的web页面中实现远程与宿主app融合的混合开发了。实现类似：淘宝等app变得更为容易简单上手
• 拥有完备快捷方法，权限控制。与宿主APP交互变得异常简单。sdk中已经为你封装了大部分uniappx内置api可在web页面中直接调用 。
• 安卓下载体验SDK；
• 开发文档
• 其它鸿蒙和ios需要自行编译，因此无法分发给大家体验，但体验是一致的。

• ---

• 【重要】多语言插件兼容sdk4.87
• [修复] 日历组件和多选日历组件，在click事件格式化时多打了个M。现已删除。
• 修复兼容了多语言最新的4.86+的类型在web上判断兼容情况
• 修改x-overlay动画效果，这个一直处于试验的新动画效果。目前鸿蒙不理想，因此退回了早期的1.0动画。
• xActionMenu设置为sapce是底部增加安全区域
• 扫码插件安卓版本升级以适应16kb大小兼容。
• xAnimation组件重构为setup并优化动画函数。
• 新增useTool工具函数，考虑到好多人需要一个方便简单点的工具函数，因此推出，但会尽量简洁，不搞大而全，要控制大小，里面包含了些防抖，节流等常用函数。
• radio,checkobx优化统一函数
• collapse改造并优化为setup模式。
• x-barcode改造并优化为setup模式。
• x-circle-progress改造并优化为setup模式，增加属性startAngle允许设置不同的起始角度。
• 优化x-float-drawer
• x-calendar-multiple优化currentDate参数控制。
• 调整uplaodMedio的上传配置，之前核心上传功能写于3.89那会压缩配置官方没兼容，目前已经兼容，放开了鸿蒙，微信的压缩配置功能。
• 【x-pull-refresh下拉刷新时添加了属性，让列表无法再次重复下拉，直接本次刷新结束，防止重复刷新，避免请示多次。（此效果参考淘宝APP改进）
• 优化跨平台app，web,小程序兼容性。
• x-progress重构为setup，增加属性linear-color，用于渐变进度条支持。
• x-circle-progress增加linearColor，仅web,小程序支持，app不支持（为了提高app渲染性能）。
• x-popover重构为setup
• 优化x-upload-media的回显。
• picker-data,betweent-tiem,weekbar等组件，默认起始改成'xx-xx-xx 00:00:00'和'xx-xx-xx 59:59:59'避免时区问题
• 补上xheet的注释说明（上次改的时候删除了，导致文档也没了说明）
• xtabbar内部的一个函数写错了，导致安卓可能出现内存泄露。

• ---

• xDate我更新下文档：很多人会因为一个方法fromBetweenLongTime自我陷入错觉以为是计算 错误 。
• 比如两个时间相减是7小时，返回的结果是5小时前，好多人以为是错的，其实是对的因为7在返回的模板里面它在5-23小时之间，所以它就是5小时前，不会是7小时前。
• 因为模板中没有具体到每个时，而是间隔。如果你细粒度更精准，就自己提供下第二个参数的模板就行了。

• ---

• x-link上增加属性_style，用于想写style给内部text上,大家用插槽可以更自由的。
• x-switch,x-stepper添加了异步函数beforeChange，用于确认是否允许相关的操作。返回异步假取消用户的操作。同时添加了事件：blurOn，focusOn和属性:foucs，autoFocus
• x-msg-notice修复触摸问题。
• slider-menu优化，点击左侧菜单，右边置顶为当前节点（之前相同选中的节点下不会去再滚动）
• x-scrollx添加属性marginTop
• x-drawer,添加了一个插槽：bg，它在所有内容的底部，可通过它布局一些个性的内容在内容下边。比如背景图，背景渐变，其它特殊的设计要求，皆可实现。
• 弹层类插件：x-toast-s,x-loading-s,x-tips-s,x-modal-s等统一更新，使用了sdk4.65+推出的接口来避免与官方的弹层冲突导致无法显示。
• x-drawer的round支持了左右圆角，但默认如果为空值时不会取全局值，因此默认左右圆角是不起效的，但你如果填写了值就会起效（主要是为了向下兼容，而这个左右圆角也不好看，但为了各种设计稿的支持我开放了）
• x-dropmenu,x-dropmenu-item修复offset-top失效的问题，同时重构组件为setup模式。
• x-divider组件在最新的sdk 4.8x中 ios端出现文字断行，系sdk兼容，已替换写法兼容。
• x-tabs的id索引，添加了联合类型string,number支持（升级后大家要记得清缓存再重新编译，否则会报错的）
• x-upload-file修复在微信小程序上会触发两次change事件。(其它平台正常)
• x-sticky组件改成了setup模式。同时修复在多页面时数据会串流。
• 优化了picker系列组件（共5个），本次在4.87上复现到了ios 的sdk bug已经全部做了特殊的兼容处理。本次更新后ios,鸿蒙应该可以正确默认选中选项了（之前ios会乱跳）.
• 针对sdk4.87,x-edit安卓失效，内容无法赋值的兼容，原因是这个版本的sdk的evaJs不需要对内容加引号了（之前的sdk需要的）
• 修复x-cmarkdown安卓渲染时无法解析换行符。（其它平台正常）

1.1.19（2025-12-10）

• 【非常重要】暗黑细节调整较大，整体上比旧版本要更柔和（不刺眼），至于喜好因人而异，但不会更改回旧版本配置，如果你执着于旧版本请在仓库中下载旧的配置即可。
• 同时，主题色也再次细节化修改了，暗黑时主题色也作了调整（原先没修改），这次设计细节上的调整会显得更整体，更协调，更柔和，希望大家适应下。
• 整体上：这次主要是针对 感观细节，触觉反馈。在扣小细节。【升级时要重新复制x-vuei18n-s，static，hybrid目录依赖切记】
• 多语言插件删除===条件（安卓不允许，写习惯了）
• [新增组件，重磅] 新增x-cmarkdown组件,可以用来渲染纯标签的html文章或者纯Markdown或者markdown+简单的html标签混合渲染，此为实验版本，大家可以体验其实渲染效果
• 如果是纯html时，尽量标准，不要太复杂后台编辑器要删除不支持的属性标签等，纯markdown时，一定也要标准（也可在里面写一些简单的html标签，用来设置文本颜色样式等）。
• [新增组件] x-swiper-c，这是一个纯动效轮播组件，相比x-swiper组件的dom操作及元素过多时，性能更强加，建议在一个页面需要好多轮播时此时本组件，而且更容易做动效处理
• x-swiper由于是dom原生的图片加载大小等受视图限制动效不好处理。x-swiper-c就不一样了，动效是可以随时扩展和添加，且动画更为流畅，效果更多（后续官方支持了像素类型后可以做更多的酷炫效果）
• [重要插件] x-mlkit-scannig-s，兼容鸿蒙原生系统，采用鸿蒙的扫码识别服务，需要真机测试，界面等与其它平台保持UI一致性，另外与官方的扫码是有区别的
• [重要组件] x-camera-u原生相机组件，兼容鸿蒙原生系统，可以录制视频，抓拍。【目前还未完善鸿蒙建议用来拍照图片可以，不建议录视频】
• 官方的扫码是调用华为自带的统一服务，界面不可定制，而我的是采用了相机+自定界面，因此可以根据需求修改界面，灵活性更高。
• [修复] 微信手写模板无法清除了（sdk 4.76+导致）
• [修复] canvas库，导出图片时在微信上报错，现改为使用base64方式，可以最大程序减少兼容性。但需要插件代码库中的x-base642file-s插件。使用时记得一并复制到插件目录。
• [修复] drag给微信加上stop事件阻止页面滚动。
• [修复] x-more在1.1.18的sdk上打不开了。
• [优化] x-ocr-s,方法已全部改成为DClound函数风格方式调用，请升级前作好备份，如果不愿意更改不要升级。另外sdk调整升级了，具体见插件文档介绍使用。
• [优化] x-tabbar，在app,web端时，凸起造型时，可能各端会有0.5px-0.8px对齐问题，现已找到了原因，是各平台对小数点绘制精度不同造成的。现统一了精度。
• [升级] 图标升级为remixicon到4.7，对应的x-icon升级及static目录的字体也要相应升级。(仅对非微信端)
• [优化+修复] x-sqlite-s,鸿蒙端增加了部分函数的路径及文件名校验，防止使用者没有按跨平台规范使用。修复web异步加载问题。
• [优化] x-cell新增了darklabelColor属性。
• [修复] x-markdown暗黑下表格及code背景没有为暗黑转换问题
• [优化] x-switch-slder增加属性longTimePress长按事件。新增：showBottomBorder控制显示下边线。
• [优化] x-float-button,x-switch-slider将点击事件改为更灵敏的5ms之上视为点击。见此讨论
• [优化] 日期组件增加showClear，showFooter及isSameDay(是否允许选择同一天，入驻酒店场景需要)
• [优化] 修改了主题色值，以跟上新的时代。
• [修复] 全局底层导航高变量拼写的错误tabbarHeight（请使用的人注意纠正下。）
• [修复+优化] 修复和适配了表单在鸿蒙上的校验及labelFontColor在暗黑是不生效的问题。但要注意一个校验的问题我已提交官方issue
• [修复] 在新的4.8x sdk上表单验证出现嵌套form-item在view下无效，及验证,动态字段，动态rule问题，这个牵涉修改到多个组件，现已修复见issue
• [修复] xImageGroup ,添加了个属性maxCount用于显示最大数量,同时添加了一个默认的slot插槽，用于自定布局更多的界面。
• [修复] xWeek，当颜色值为空时，ios端的sdk会有bug会解析成白色。现在以rgba(0,0,0,0)代替空值。
• [优化] 日历组件，click事件统一格式为，x-x-x。
• [优化] x-picker-datae某些日期出现不全
• [优化重要提醒] picker类组件，我全部重构了，以适应新的sdk，但目前ios真机端，打开后出现未选中的情况我还无法优化到最佳的样子，这个需要官方配合
• 重构这个组件，我才好进一步优化。重构后，放弃了子组件x-picker-item，同时样式只能选中高亮模式时无圆角间隔了（为了妥协我只能舍弃了）。另外ios暗黑样式白的问题
• 也需要官方配合（如果新的sdk修复了自然就正常）。总的来说这个组件：在ios上是有问题的，需要等sdk修复和优化。
• [修复+优化] x-tabs 修复在未开房dotTtype时，textStyle丢失。同时增加属性lineWidth，用于控制底部指示的线宽（如果设置宽和高相等可实现圆的样式指示点，可自己探索更多可能）
• [修复] x-vuei18n-s在app上切换时，语言不会即时响应渲染。（请大家在升级时务必重新复制这个插件到你的插件目录，删除原有的）
• [修复] x-modal类型批注错误。
• [优化] x-weekbar,增加了：disabled用于控制禁用用户滑动操作，同时优化为当vmodel切换时，禁用动画，当手势操作时再开启动画。
• [优化+修复] x-float-drawer在安卓上的体验表现，同时修复了手动打开和关闭事件时，未主动去同步状态，导致可能外部状态不一致，从而导致打开错乱。
• [修复] x-edite在微信平台上无法获取到正确的内容。
• [修复] x-switch-slider非微信平台时，当滑动边界时，sdk不会触发动画事件，导致无法同步关闭和打开状态。
• [重要] x-virtual-list，我删除了1.1.18针对鸿蒙的子协议滚动功能，原因等了官方两个月了，始终修复不好，干脆不用nestScroll了。代码在本版本中直接删除了，以全至少在鸿蒙中能显示使用。
• [优化] x-waterfall瀑布流组件，优化与之前不太一样了，建议大家迁移时看清文档和示例全身，主要是让组件可以被嵌套及添加悬浮置顶功能，这样组件在被放置在页面底部时，可以滑动到组件时自动置顶顶部并执行列表组件。
• [优化] x-search,添加autoFocus和disabled，用于自动弹键盘及禁用。修复在鸿蒙平台默认提示文字颜色为暗黑时为黑色（此为sdk bug）
• [优化] x-rolling-number,添加了属性fontStyle用于控制文本样式覆盖。
• [修复] x-tabs,在鸿蒙平台默认激活项时，指示条未显示。
• [优化+修复] x-sign-board优化在鸿蒙平台连续性问题，及修复在鸿蒙平台下导出的图片变形（此为sdk bug，现采用其它方案导出图片，非鸿蒙平台不变）
• [修复] x-drag,在鸿蒙平台下初始时尺寸不正确。针对最新的sdk 4.86做了兼容。
• [优化] x-popover,在增加非透明值的背景色时，增加背景动画渐显，另外针对不同平台指示三角形在鸿蒙平台会出现0.5px间隙的修复。
• [修复] x-calendar-view和x-calendar-multiple已经在sdk4.86+上兼容，可以正常使用了。此处在鸿蒙平台上作了特殊兼容处理，因为sdk布局bug迟迟未能修复，目前是曲线救国，后期如果sdk完善了会改回与其它平台一样的方案。
• [修复] 鸿蒙平台（真机）x-picker-selected输入框在暗黑时，颜色未转白，导致看不清。
• [修复] 鸿蒙平台（真机）x-input-tag，输入框在暗黑时，颜色未转白，导致看不清。
• [修复] x-dropdown-menu在web平台下，如果为static时，同时取消了系统导航，会导致位置不对。
• [修复] x-input的属性rightIcon未使用。
• [优化+修复] x-upload-media，修复在鸿蒙上显示异常（原因未知），另外修复了一个长期存在的手势bug(但不影响使用，影响使用过程的日志美观，会有意外出现日志错误。)

1.1.18（2025-09-25）

• [版本] 编译到app/web/h5请可以使用4.76+(鸿蒙还有部分组件有异常)，微信小程序请务必使用4.81+
• [重要] 整体组件细节样式调整，颜色计算逻辑调整，使得整体更有精致感（请使用细腻的屏幕重新感受对比）。主题要更偏年轻化。,css库中添加了对应的状态颜色如text-error,保持与主题匹配
• [优化] 大部分示例demo页面重构为setup版本。优化文档显示。
• [重要] x-echart,重构为setup，同时废除属性opts,请使用ref方法setOptions来设置数据，经过测试4.76+上通过组件属性设置过多数据的参数会导致失效，我也莫名其妙。
• 同时图表已经升级到最新百度图表6.0.0版本，经过我观察样式和主题默认颜色有些许变化。升级时微信请重新复制demo页面中的echart.esm.min.js(原先是echart.min.js)，非微信请复制hybrid到你目录中
• [重要] xtext修改单词highlight，因此你的highlight，highlightReg，highlightStyle都要修正为这三个，请一定注意修改。
• [新增插件] x-chinesetopinyin-s可以将中文转换为拼音（含声调注音及不带注音的两个属性）（全平台支持）
• [新增插件] x-texttovoice-s 文本转语音播报功能（小程序不支持，其它平台全支持）
• [重要优化] 画布ICanvas API库已经对鸿蒙兼容适配了，增加了画布30篇文档使用及介绍，同时增加了示例案例：语音录制动画，海报绘制，自动图形排版，新增图形二维码。目前优化已经基本可以适配商业场景：如海报分享图，动画绘制等业务场景。
• [重大优化] x-table,现在支持子元素列之间的合并（它是向右合并吞并下一列数据实现，因此它的下列会自动隐藏不显示），
• 同时单元格高不再固定高改为最小高如果出现大量数据会自动断行（其它列自动上下撑开对齐本行高），同时添加了行多选checkbox功能
• [重要优化] x-tabbar优化了canvas绘制时的逻辑
• [优化] x-tree组件现在允许最后一级（非异步且没有子节点的场景时）点击选中切换状态。
• [优化] 全局config中增加了：fontColor，fontDarkColor分别对应默认的文本色及默认的暗黑文本色。
• [优化] xfinger,对外暴露更多slot参数。
• [优化] xDrawer重构为setup版本,同时修复因为版本差异的web端嵌套的问题。
• [优化] xModal重构为setup版本
• [优化] xOverlay重构为setup版本
• [优化] xText重构为setup版本
• [优化] xRadio重构为setup版本,相关值类型改成为:string|boolean|number
• [优化] xRadioGroup重构为setup版本,相关值类型改成为:string|boolean|number
• [优化] xCheckbox重构为setup版本,相关值类型改成为:string|boolean|number
• [优化] xCheckboxGroup重构为setup版本,相关值类型改成为:string|boolean|number[]
• [优化] x-action-menu重构为setup版本,并且允许在不同平台嵌套使用
• [优化] x-action-modal重构为setup版本,并且允许在不同平台嵌套使用,修复多语言时默认为中文的问题
• [优化] x-alert重构为setup版本
• [优化] x-sheet重构为setup版本
• [优化] x-float-drawer重构为setup版本
• [优化] x-tag重构为setup版本
• [优化] x-tree-flat思维导图重构为setup版本，并在opts配置项中增加属性layout ?: 'horizontal' | 'vertical',用于左右，和上下排列（之前只有左右）
• [优化] x-text-cloud重构为setup版本(并已兼容鸿蒙Next),并设置新的散射样式。
• [优化] x-button重构为setup版本，loading icon大小同步图片大小一致
• [优化重构] x-float-drawer浮动面板优化重构，由于sdk版本导致在ios和微信端可能无法流畅滚动，因此重构了，已经在5个平台中测试较为流畅。
• [优化+修复] x-weekbar,优化体验问题，当设置了seekDay时，如果当前日期默认不在偏移范围内，可能会导致当前的日期不可可视范围内。
• 同时添加了同日历组件一样的状态属性，类型格式都是一模一样的。方便给日期底部添加对应状态提示。然后修复了拼写错误造成不能赋值，优化允许动态修改start,end
• [优化] x-search重构为setup版本,并新增属性showCancel
• [优化] x-table重构为setup，同时兼容一个sdk bug,即动态将list-item设置显示和隐藏会触sdk bug，大家要自己避免这个list-item的bug（后续可能官方 什么 修复）.
• [优化] x-cell重构为setup版本
• [优化] x-code-input重构为setup版本
• [优化] x-countdown重构为setup版本
• [优化] x-empty重构为setup版本
• [优化] x-float-button重构为setup版本
• [优化] x-grid重构为setup版本
• [优化] x-grid-item重构为setup版本
• [优化] x-icon重构为setup版本
• [优化] x-radio-button重构为setup版本
• [优化] x-rate重构为setup版本
• [优化] x-rolling-number重构为setup版本
• [优化] x-badge重构为setup版本
• [优化] x-virtual-list,兼容一个ios sdk的一个bug，即ios在设置滚动为子协商时会无法滚动（仅ios有此sdk bug，后续可能官方 什么 修复）
• [优化] x-slider-children重构为setup版本
• [优化] x-slider-tree重构为setup版本
• [优化] x-msg-notice重构为setup版本，同时增加了上和底拖拉时的反向操作阻尼反馈，让体验更完美。更新了示例效果。同时增加了对pc的鼠标手势支持。
• [优化] x-notice重构为setup版本
• [优化] x-snackbar重构为setup版本
• [优化] x-more重构为setup版本
• [优化] x-loading重构为setup版本
• [优化] x-input-tag重构为setup版本
• [优化] x-image-group重构为setup版本
• [优化] x-code-input重构为setup版本
• [优化] x-card重构为setup版本
• [优化] x-keyboard，x-keyboard-car，x-keyboard-idcard，x-keyboard-number重构为setup版本
• [优化] x-snackbar-item重构为setup版本,优化了动效。
• [优化] x-backtop重构为setup版本,同时增加了disabledPageScroll,scrollTop属性，以实现局部返回置顶功能，具体见demo实现案例。
• 【修复】日历相关组件在同时设置start和end会产生边界判断问题。
• 【修复】x-between-time未对外使用format格式同步数据。同时添加默认插件数据startVal，endVal,show
• 【优化】x-barcode对原生的条形码改为code-128标准条码见：标准128
• [优化] x-qrcoder添加新的属性wifi字段，用于生成自动连接的wifiQr码，详见demo示例页面展示。

平台兼容性

uni-app x(4.87)

其他

TMUI4.0x

设计

一款好的UI/UX，不止是功能，它还应该要有设计感，层次感。注重细微及用户的反馈体验。同时要保留它的高度可扩展性及性能。 功能的堆叠不是我所追求，也不是我的目标。我追求的是细致，可扩展，精美。不管是IOS，安卓，WEB/H5三端我都朝着这个方向。 让UNIAPPX 开发的商业应用更像商业应用。为让市场的组件审美提高一个档次而做出应有的贡献。 官方赛事一等奖第一名

丢掉市场劣质应用风与我一道让你的审美更上一层楼

• 可全局配置风格
• 可全局适应暗黑
• 精致化设计
• 三端适配
• 层次分明，颜色统一且协调

行业交流

你不仅仅是付费买应用开发解决方案，进来的都是各行大佬(技术牛人或老板)，交流，经验多，互通有余，畅聊行业，素质高。

tmui4.0文档

微信端

电脑端

电脑端

鸿蒙Next

进入链接后选择Harmony开头的下载即可，请务必使用鸿蒙真机并且是Next鸿蒙系统 Harmony

安卓端

进入链接后选择android开头的下载即可，请务必使用安卓5.0(含)以上系统 Android

Ios端

不提供，需要自行使用demo源码，通过自己的ios证书构建安装包。

目前VIP源码用户含以下原生插件

义务和免责声明

付费用户享受组件的免费使用，我有义务修复bug和提供的稳定版本

但我没义务免费为你24小时服务，我在有限的时间内解答你的所有问题，和开发帮助（力所能及范围内）。不接受即问即答模式，我不是专职。

bug提交

请进入内部VIP专属仓库提交需求和bug

安装和使用

支付费用后请通过市场上方的群聊联系我。