README
[toc]
介绍
vcgl为基于Vue.js开发的组件库,主要针对移动端。相对于常用一些组件库,vcgl自设计之初就贯彻着用户高度定制的原则,几乎所有的组件都能够根据用户的需求,通过改变不同参数值来实现不同样式设计,当然如果你觉得麻烦也可以使用默认的参数、应用默认的样式(默认样式也是很好看的哟)!
github地址:https://github.com/goodloving/vcgl (如果用的还可以,欢迎给☆)
快速开始
npm install vcgl -S
vue项目中引入和使用(按需引入):
import Vue from "vue"
import { VcglActionSheet } from "vcgl";
Vue.use(VcglActionSheet);
唤起ActionSheet的事件中调用:
this.$vgActionSheet.show({
menus: this.menus,
onSelected: index => this.onSelected(index),
onCancel: () => this.onCancel()
});
选择项和取消项对应的函数:
onCancel() {
this.$vactionsheet.hide(); //隐藏
},
onSelected(index) {
alert(index); //具体操作
}
使用说明
一、Button
局部引入(单个组件中):
<script>
import { VcglButton } from "vcgl";
export default {
components: {
VcglButton
}
}
</script>
使用:
<template>
<div>
<vcgl-button type="success">这是一个按钮</vcgl-button>
</div>
</template>
或者:
<template>
<div>
<vcgl-butto
type="success"
btn_font_size="20px"
btn_font_color="#000000"
btn_width="100%"
btn_height="100%"
btn_background="linear-gradient(to right, #000000 0%,#ffffff 100%)"
btn_border="1px solid red"
btn_border_radius="5px"
@click="onClickBtn"
>
<img class="img" src="../assets/images/delete.png" />
这是一个按钮
</vcgl-butto>
</div>
</template>
属性:
属性名 | 类型 | 描述 |
---|---|---|
type | String | 设置button的总体样式,默认default,可选primary,success,error |
btn_font_size | String | 设置button的字体大小,默认大小为"14px",设置格式"18px"等 |
btn_font_color | String | 设置button的字体颜色,默认黑色"#000000",设置格式"#000000"、"rgba(14,14,14,1)"等 |
btn_width | String | 设置button的宽度,默认为所包含字体的宽度,设置格式"50px"、"100%"等 |
btn_height | String | 设置button的高度,默认为所包含字体的高度,设置格式"50px"、"100%"等 |
btn_background | String | 设置button的背景色,默认大小为"14px" |
btn_font_color | String | 设置button的字体颜色,默认为" rgba(255, 255, 255, 1)",设置格式"#000000"、"rgba(14,14,14,1)"、"linear-gradient(to right, #000000 0%,#ffffff 100%)"等 |
btn_border | String | 设置button的边框样式,默认为"1px solid #999999" |
btn_border_radius | String | 设置button的边框圆角大小,默认大小为"4px" |
btn_disabled | String | 设置button是否可点击,默认为" true",设置格式"true"、"false" |
@click | Function | 设置button的点击事件 |
二、ActionSheet
全局引入(main.js):
import { VcglActionSheet } from "vcgl";
Vue.use(VcglActionSheet);
使用:
<template>
<div>
演示 actionsheet demo
</div>
</template>
<script>
export default {
data() {
return {
menus: {
1: "微信",
2: "支付宝",
3: "银联"
},
// 图标与menus对应,如果长度比menus大1,最后一个为"取消"图标
icons: [
require("../assets/images/delete.png"),
require("../assets/images/delete.png"),
require("../assets/images/delete.png"),
require("../assets/images/delete.png")
]
};
},
mounted() {
this.onClickActionSheet();
},
methods: {
onClickActionSheet() {
this.$vgActionSheet.show({
menus: this.menus,
icons: this.icons,
as_item_height: "45px",
as_font_size: "18px",
as_item_color: "rgba(99,34,200,1)",
as_cancel_color: "#999999",
onSelected: index => this.onSelected(index),
onCanncel: () => this.onCancel()
});
},
onSelected(index) {
alert(index);
},
onCancel() {
this.$vgActionSheet.hide();
}
}
};
</script>
<style></style>
属性:
属性名 | 类型 | 描述 |
---|---|---|
menus | Objiect | 需要显示的项,格式为menus: {gaodeMap: "高德地图",baiduMap: "百度地图",iosMap: "苹果地图"} |
icons | Array | 每一项中前面是否需要显示图标,默认为[],即不显示。图标与menus对应,如果长度比menus大1,最后一个为"取消"图标,格式为[require("../assets/images/delete.png"),require("../assets/images/delete.png"),require("../assets/images/delete.png"),require("../assets/images/delete.png")] |
as_item_height | String | 设置每一项(包括取消项)的高度,默认为"45px",格式为"50px"、"100%"等 |
as_font_size | String | 设置每一项(包括取消项)的字体大小,默认为"17px",格式为"50px"等 |
as_item_color | String | 设置每一项的字体颜色,默认为" rgba(255, 255, 255, 1)",设置格式"#000000"、"rgba(14,14,14,1)"、"linear-gradient(to right, #000000 0%,#ffffff 100%)"等 |
as_cancel_color | String | 设置"取消"项的字体颜色,默认为" #3c86f5",设置格式"#000000"、"rgba(14,14,14,1)"、"linear-gradient(to right, #000000 0%,#ffffff 100%)"等 |
onSelected | Function | 接受点击的item的值,根据值进行具体操作,完成后隐藏隐藏ActionSheet和蒙层区 |
onCancel | Function | 点击蒙层区和“取消”隐藏ActionSheet和蒙层区 |
三、Loading
全局引入(main.js):
import { VcglLoading } from "vcgl";
Vue.use(VcglLoading);
使用:
<template>
<div>
<div @click="showLoading">show loading</div>
</div>
</template>
<script>
export default {
methods: {
showLoading(){
this.$vgLoading.show({
text: "加载中...",
fontsize:"20px",
fontcolor:"#666666",
background:"red"
});
setTimeout(() => {
this.closeLoading()
}, 3000);
},
closeLoading() {
this.$vgLoading.close();
}
}
}
</script>
<style></style>
属性:
属性名 | 类型 | 描述 |
---|---|---|
text | String | loading上显示的文字 |
icon_loading | String | loading上显示的icon,内部设置了旋转,传输一行静态图片即可 |
width | String | 设置icon的高度,默认为"38px",格式为"50px"、"100%"等 |
height | String | 设置icon的高度,默认为"38px",格式为"50px"等 |
fontsize | String | 设置显示字体的大小,默认为"15px",格式为"50px"等 |
fontcolor | String | 设置显示字体颜色,默认为" #ffffff",设置格式"#000000"、"rgba(14,14,14,1)"、"linear-gradient(to right, #000000 0%,#ffffff 100%)"等 |
background | String | 设置显示字体颜色,默认为"rgba(17, 17, 17, 0.7)",设置格式"#000000"、"rgba(14,14,14,1)"、"linear-gradient(to right, #000000 0%,#ffffff 100%)"等 |