常见问题

如何自定义 Vant 组件的样式？

1. 主题定制

Vant 基于 CSS 变量提供了主题定制的能力，可以对组件样式进行统一修改，详见 ConfigProvider 全局配置 组件。

2. 覆盖默认样式

如果主题定制不能满足你的需求，也可以通过自定义样式类来覆盖默认样式，参考下面的示例：

  1. <template>
  2.   <van-button class="my-button">按钮</van-button>
  3. </template>
  5. <style>
  6.   /** 覆盖 Button 最外层元素的样式 */
  7.   .my-button {
  8.     width: 200px;
  9.   }
  11.   /** 覆盖 Button 内部子元素的样式 */
  12.   .my-button .van-button__text {
  13.     color: red;
  14.   }
  15. </style>

在 HTML 中无法正确渲染组件？

在 HTML 中使用 Vant 组件时，你可能会碰到部分示例代码无法正确渲染的情况，比如下面的用法：

  1. <van-cell-group>
  2.   <van-cell title="单元格" value="内容" />
  3.   <van-cell title="单元格" value="内容" />
  4. </van-cell-group>

这是因为 HTML 并不支持自闭合的自定义元素，也就是说 <van-cell /> 这样的语法是不被识别的，使用完整的闭合标签可以避免这个问题：

  1. <van-cell-group>
  2.   <van-cell title="单元格" value="内容"></van-cell>
  3.   <van-cell title="单元格" value="内容"></van-cell>
  4. </van-cell-group>

在单文件组件、字符串模板和 JSX 中可以使用自闭合的自定义元素，因此不会出现这个问题。

在 iOS 上点击组件时，无法触发点击反馈效果？

这是因为 iOS Safari 默认不会触发 :active 伪类，解决方法是在 body 标签上添加一个空的 ontouchstart 属性：

  1. <body ontouchstart="">
  2.   ...
  3. </body>

参考链接：stackoverflow - :active pseudo-class doesn’t work in mobile safari

为什么没有 Select 组件？

Select 是桌面端常用的组件，但它的交互形式不适合移动端。

在移动端，我们推荐使用 Picker 选择器组件 作为代替。

是否支持在 uni-app 中使用？

Vant 所有组件都是基于 Vue 框架实现的，没有针对 uni-app 进行适配，因此不保证各个组件在 uni-app 下的可用性。

如果你在 uni-app 中使用 Vant 遇到问题，建议向 uni-app 进行反馈。

部分组件无法在桌面端进行操作？

参见桌面端适配。

如何进行移动端响应式适配？

参见浏览器适配。

常见问题 - 图1