《前端》vue-vant学习--轻量、可靠的移动端 Vue 组件库--2020年7月4日

    技术2025-02-03  8

    Vant - 轻量、可靠的移动端 Vue 组件库  https://youzan.github.io/vant/#/zh-CN/

    一、安装及快速上手

    1.1 通过 CDN 引入

    <!-- 引入样式文件 -->

    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/vant@2.9/lib/index.css" />

    <!-- 引入 Vue 和 Vant 的 JS 文件 -->

    <script src="https://cdn.jsdelivr.net/npm/vue/dist/vue.min.js"></script>

    <script src="https://cdn.jsdelivr.net/npm/vant@2.9/lib/vant.min.js"></script>

    <!-- 引入样式文件 --> <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/vant@2.9/lib/index.css"/> <!-- 引入 Vue 和 Vant 的 JS 文件 --> <script src="https://cdn.jsdelivr.net/npm/vue/dist/vue.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/vant@2.9/lib/vant.min.js"></script> <div id="app"></div> <script> // 在 #app 标签下渲染一个按钮组件 new Vue({ el: '#app', template: `<van-button>按钮</van-button>`, }); // 调用函数组件,弹出一个 Toast vant.Toast('提示'); // 通过 CDN 引入时不会自动注册 Lazyload 组件 // 可以通过下面的方式手动注册 Vue.use(vant.Lazyload); </script>

    1.2 组件实例方法

    Vant 中的许多组件提供了实例方法,调用实例方法时,我们需要通过 ref 来注册组件引用信息,引用信息将会注册在父组件的$refs对象上。注册完成后,我们可以通过this.$refs.xxx访问到对应的组件实例,并调用上面的实例方法。

    以下提供的webpack的方法。使用传统方法可以自行转换,原理应该一样。

    <!-- 将该组件绑定到 this.$refs.checkbox 上 --> <van-checkbox v-model="checked" ref="checkbox"> 复选框 </van-checkbox> export default { data() { return { checked: false, }; }, // 注意:组件挂载后才能访问到 ref 对象 mounted() { this.$refs.checkbox.toggle(); }, };

    2 基本组件

    2.1 按钮

    基本使用:<van-button>默认按钮</van-button>

    Props

    参数说明类型默认值type类型,可选值为 primary info warning dangerstringdefaultsize尺寸,可选值为 large small ministringnormaltext按钮文字string-color v2.1.8按钮颜色,支持传入linear-gradient渐变色string-icon左侧图标名称或图片链接string-icon-prefix v2.6.0图标类名前缀,同 Icon 组件的 class-prefix 属性stringvan-icontag根节点的 HTML 标签stringbuttonnative-type原生 button 标签的 type 属性string-block是否为块级元素booleanfalseplain是否为朴素按钮booleanfalsesquare是否为方形按钮booleanfalseround是否为圆形按钮booleanfalsedisabled是否禁用按钮booleanfalsehairline是否使用 0.5px 边框booleanfalseloading是否显示为加载状态booleanfalseloading-text加载状态提示文字string-loading-type加载图标类型,可选值为spinnerstringcircularloading-size加载图标大小string20pxurl点击后跳转的链接地址string-to点击后跳转的目标路由对象,同 vue-router 的 to 属性string | object-replace是否在跳转时替换当前页面历史boolean

    false

     

    Events

    事件名说明回调参数click点击按钮,且按钮状态不为加载或禁用时触发event: Eventtouchstart开始触摸按钮时触发event: TouchEvent

     

    Processed: 0.009, SQL: 9