常见问题 FAQ

本节介绍在开发过程当中遇到的部分 常见问题 以及 解决办法

目前支持哪些平台？

目前支持 微信小程序、支付宝小程序、钉钉小程序、H5、APP 等平台。

有没有最佳实践分享？

有，可以关注我的公众号「不如摸鱼去」，也可以访问我的博客不如摸鱼去，分享无数干货，等你来看。

组件库有没有提供可以单独引入的组件？

目前是没有的，首先在插件市场缺少CI/CD工具，无法实现自动化发布，维护一套单独引入的组件费时费力，其次组件库提供的安装方式均可以实现按需引入，所以是无需提供单独引入的组件的。

如何开启暗黑模式？

Wot UI支持深色模式、主题定制等能力，详见ConfigProvider 全局配置组件。

有没有技术交流群？

有！ 可以加入Wot UI 互助群，分享心得、交流体会。

Sass抛出大量警告？

如果遇到运行时抛出以下警告：

Deprecation Warning [legacy-js-api]: The legacy JS API is deprecated and will be removed in Dart Sass 2.0.0.

可以在 vite.config.ts 中这样做：

export default defineConfig({
  // ...
  css: {
    preprocessorOptions: {
      scss: {
        api: 'modern-compiler',
        silenceDeprecations: ['legacy-js-api']
      }
    }
  },
// ...
})

Sass 废弃了大批 API ，而 uni-app 仍然在使用这些 API ，导致警告的抛出。

小程序自定义组件渲染问题

微信/QQ/百度/抖音这四家小程序，自定义组件在渲染时会比 App/H5 端多一级节点，下面以divider组件举例：

<!-- 使用 -->
<wd-divider></wd-divider>

<!-- h5渲染 -->
<view class="wd-divider"></view>

<!-- 微信小程序渲染 -->
<wd-divider>
  <view class="wd-divider"></view>
</wd-divider>

解决办法

在微信端可以使用virtualHost解决，virtualHost设为true之后会将自定义节点设置成虚拟的，更加接近 Vue 组件的表现，可以去掉微信小程序自定义组件多出的最外层标签，启用后还可以通过 mergeVirtualHostAttributes 合并合并组件虚拟节点外层属性。

// vue2使用virtualHost
export default {
  data() {
    return {}
  },
  options: {
    virtualHost: true
  }
}

// vue3 script setup 使用virtualHost
<script lang="ts">
export default {
  // 将自定义节点设置成虚拟的，更加接近Vue组件的表现，可以去掉微信小程序自定义组件多出的最外层标签
  options: {
    virtualHost: true
  }
}
</script>
<script lang="ts" setup>
</script>

启用 virtualHost 效果

这里我们还是以divider组件举例：

<!-- 使用 -->
<wd-divider></wd-divider>

<!-- h5渲染 -->
<view class="wd-divider"></view>

<!-- 微信小程序渲染 -->
<view class="wd-divider"></view>

如何定制主题？

我们为每个组件提供了css 变量，可以参考config-provider组件的使用介绍来定制主题。

Toast 和 MessageBox 组件调用无效果？

首先要检查一下用法是否正确，uni-app平台不支持全局挂载组件，所以Message、Toast等组件仍需在 SFC 中显式使用，例如:

<wd-toast></wd-toast>

Message、Toast的函数式调用是基于provide/inject实现的，所以你的调用要确保在setup中。

编译到支付宝小程序 Popup 组件的遮罩无法显示？

由于平台更新改变了默认的样式隔离策略导致的。详见 样式覆盖 - 特定平台样式穿透失效。

为什么组件库文档中都是从@/uni_modules/wot-ui导入方法和工具类？

当前组件库本身的开发方式是将组件库代码放到@/uni_modules/wot-ui这个目录的，所以文档中都是从@/uni_modules/wot-ui导入方法和工具类，使用npm方式安装组件库的时候可以这样调整：

// useToast、useNotify等同理
import { useDialog } from '@/uni_modules/wot-ui'

替换为

import { useDialog } from '@wot-ui/ui'

uni-app 如何自定义编译平台，例如钉钉小程序？

可以参考uni-app文档中package.json章节。

钉钉小程序示例：

{
    "uni-app": {
    "scripts": {
      "mp-dingtalk": {
        "title": "钉钉小程序",
        "env": {
          "UNI_PLATFORM": "mp-alipay"
        },
        "define": {
          "MP-DINGTALK": true
        }
      }
    }
  },
}

当前组件库提供的用于控制组件显示隐藏 hooks 不生效怎么办？

注意

多次执行use后，useToast、useDialog、useNotify、useQueue等 hooks 不生效的问题已在1.3.14版本修复，请升级到最新版本。

可以按照以下步骤进行排查

1. uni-app平台不支持全局挂载组件，所以Message、Toast、Notify等组件需在 SFC 中显式使用，例如：

<wd-toast></wd-toast>

2. useToast、useDialog、useNotify、useQueue等 hooks 不生效，请检查是否在setup中调用，如果setup中调用，请检查当前页面是否存在多次执行use的场景，例如在多个组件中执行，这样会导致上一次use的失效。针对此场景，组件的函数式调用都支持传入selector参数，可以通过selector参数来指定组件，例如：

<wd-toast></wd-toast>
<wd-toast selector="my-toast"></wd-toast>

const toast = useToast()
const myToast = useToast('my-toast')

为什么在微信小程序上使用Popup、ActionSheet、DropDownItem等弹出框组件包裹Slider、Tabs等组件时，Slider、Tabs表现异常？

目前uni-app使用v-if控制插槽是否显示编译到微信小程序端存在问题，具体可以参考issue:4755、4847。而Popup、ActionSheet、DropDownItem恰好正是使用v-if控制插槽是否显示，所以会导致Slider、Tabs在未渲染时执行了相关生命周期。Slider、Tabs等组件的一些数据如Slider的宽度，Tabs的滑块位置等会在onMounted等生命周期进行获取，此时这些数据将会存在异常。

解决办法：

1. 在Slider、Tabs等组件外部使用v-if控制弹框打开前不展示，例如：

<wd-slider v-if="showSlider"></wd-slider>

1. 在Popup、ActionSheet、DropDownItem等组件完全打开时的钩子中重新初始化Slider、Tabs组件，例如：

<wd-popup v-model="show" position="bottom" closable custom-style="height: 200px;" @after-enter="handleOpened">
<wd-slider v-model="value" ref="slider"></wd-slider>
</wd-popup>

const slider = ref()

function handleOpened() {
  slider.value!.initSlider()
}

为何 Dialog 弹出了多个？

检查一下弹出多个Dialog的页面是否存在多个相同selector或无selector的<wd-dialog></wd-dialog>标签(当前页面包括页面中使用的组件)。toast亦是同理，在子组件中使用Dialog等组件需要指定selector并确保selector唯一。

Toast、Message、Loading 等如何全局调用？

全局调用方案见 wot-starter，支持在路由导航守卫和网络请求拦截器等场景使用的可全局调用的反馈组件。

如何快速解决你的问题？

提问的智慧，可以帮助你快速提出正确的问题，获得更快的解答。

关于我们

如果您的问题不在上述列表中或您有更好的建议，请联系我们 Moonofweisheng