Taro 在小程序和H5的踩坑记录

Taro 踩坑记录

 

1、@taro/cli版本必须跟package.json的版本一致,否则使用Taro.xxx会报「 is not a function 」的错误

 

例如:「_tarojs_taro__WEBPACK_IMPORTED_MODULE_2___default.a.navigateTo is not a function」

 

解决方案1:重新按照官网文档初始化项目

解决方案2:package.json 文件引入的 Taro 的版本号改成与 Taro cli 工具的版本号保持一致(当前是3.0.18);

 

2、taro-ui form 表单的submit事件

https://github.com/NervJS/taro-ui/issues/1189

 

3、taro-ui 使用 modal 组件的时候 自定义内容和简化用法只能二选其一

使用AtContent来自定义内容的话,其他的title等参数也必须使用自定义的

 

4、taro-ui input输入框输入第一个字后或输入框内容删除完全部内容后,键盘隐藏了(不应该隐藏);

键盘隐藏后,再进行编辑,光标处于第一个字符之前了(应该是在最后一个字符之后)==> 解决方案:添加cusor 为文本长度

快速输入内容 会出现 光标乱跳 文字错乱的问题(未解决 --> 感觉是setState的原因)

 

5、app.tsx 在render中添加渲染组件不起作用

https://taro-docs.jd.com/taro/docs/react

在小程序端添加外部div 无效,在h5有效

 

6、taro ui InputNumber 组件在小程序的应用,设置了最小值后,无法删除最小值,只能输入以最小值为起始的值

 

贴上自己的博客链接~

https://blog.youkuaiyun.com/qq_39410421/article/details/117283092

 

7、在小程序中使用taro.createSelectorQuery 返回null,要跟 Taro.nextTick 搭配使用

 

8、taro ui AtImagePicker 组件sourceType属性在h5不起作用

https://github.com/NervJS/taro/issues/6347

 

9、Taro.getStorageSync 和 localStorage.setItem不能搭配使用,Taro.getStorageSync获取不到 localStorage.setItem的值

eg:

localStorage.setItem("test", "测试");

  setTimeout(() => {

    console.log(Taro.getStorageSync("test"), "getStorageSync");

  }, 1000);

 

10、小程序刷新web-view页面会增加history(这个应该是小程序的坑)

https://www.php.cn/xiaochengxu-407648.html

https://developers.weixin.qq.com/community/develop/doc/000666cbbb4d003b5348e5e755e400

 

11、Taro.previewImage在h5中无法缩放图片
可结合react-photo-view库使用
https://gitee.com/MinJieLiu/react-photo-view/tree/master

贴上自己的博客地址~

https://blog.youkuaiyun.com/qq_39410421/article/details/117387844

 

12、enablePullDownRefresh 在h5 上滑后下拉就触发了,且下拉之后无法上滑(未找到解决方案,先去掉了下拉刷新,自己根据scroll写下拉刷新的话 要注意防抖)

 

13、taro-ui的textarea组件在小程序应用中存在的问题:1、设置了maxLength为200,复制粘贴一个超过maxLength的文本,文件截断为200字,但count属性显示的文本长度不正确,且部分安卓手机可以自动删除前面的文本继续输入,在ios的话在输入过程中会截取拼音字母(最终解决方案为不限制maxLength,超出红色提示用户超出字数,ui参考微信反馈页面)2、在ios上会存在padding样式,无法设置,目前解决方案是判断手机系统,在ios上设置margin-top:12px,在iPhone12/xr没问题,其他机型未知(小屏幕机型疑似没问题)

 

### Taro 框架 H5 端常见问题与解决方法 #### 一、页面加载速度慢 当在 H5 环境下运行 Taro 应用时,可能会遇到页面加载缓慢的情况。这通常是因为打包后的文件体积过大或是网络请求过多造成的。 对于大文件体积的问题,可以考虑使用代码分割技术来减少初始加载时间。通过 Webpack 的 `splitChunks` 插件配置实现按需加载模块[^1]。另外,压缩资源文件也是提升加载效率的有效手段之一;例如图片可以通过工具进行无损压缩处理后再引入到项目里。 针对频繁发起 HTTP 请求影响体验的情形,则建议合并相似接口调用并合理设置缓存策略以降低服务器压力的同时加快响应速率[^2]。 ```javascript // webpack.config.js 中的部分配置项用于优化构建产物大小 optimization: { splitChunks: { chunks: 'all', minSize: 30000, maxSize: 0, cacheGroups: { vendor: { // 抽离第三方库 test: /[\\/]node_modules[\\/]/, name(module, chunks, cacheGroupKey) { const packageName = module.context.match(/[\\/]node_modules[\\/](.*?)([\\/]|$)/)[1]; return `${cacheGroupKey}.${packageName.replace('@', '')}`; } }, common: { // 提取公共部分 minChunks: 2, priority: -20, reuseExistingChunk: true } } } } ``` #### 二、样式兼容性差异 由于浏览器内核的不同,在开发过程中难免会碰到一些 CSS 属性或 HTML 结构上的跨平台显示效果不一致现象。为了确保良好的视觉呈现质量,应该遵循现代前端最佳实践: - 使用 Reset 或 Normalize.css 来消除默认样式的干扰; - 避免过度依赖特定厂商前缀属性,转而利用 PostCSS 自动补全必要声明; - 对于 flexbox/grid 这类较新的布局方式要特别留意其支持度范围,并准备好降级方案给老旧版本设备[^4]。 #### 三、路由跳转异常 有时会出现点击链接后无法正常导航至目标页面的现象,可能是由以下几个方面引起: - 如果是单页应用(SPA),则需要注意 history API 的正确运用以及 hashchange 事件监听机制是否健全; - 双向绑定框架下的路径参数解析逻辑可能存在漏洞,导致匹配失败进而阻止了预期的行为发生; - 当存在多个同名组件实例共存的情况下,务必保证它们之间的状态隔离以免互相干扰造成混乱局面。 ```javascript import Taro from '@tarojs/taro'; const navigateToPage = (url) => { try { Taro.navigateTo({ url }); } catch (error) { console.error('Navigation failed:', error); } }; ```
评论 2
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值