前言
element-ui 是一套基于 Vue.js 的前端 UI 组件库,它提供了丰富的组件和丰富的特性,在前端开发中被广泛使用。本教程将介绍一个基于 element-ui 的 npm 包 element-ui-uwgd。
element-ui-uwgd 是一个基于 element-ui 封装的 npm 包,它提供了更加方便的使用方式和更加丰富的特性。本教程将详细介绍 element-ui-uwgd 的使用方法。
安装
首先需要安装 element-ui-uwgd,可以使用 npm 进行安装:
npm install element-ui-uwgd --save
使用
组件引入
在使用 element-ui-uwgd 之前,需要先引入 element-ui 的样式和 js 文件,然后再引入 element-ui-uwgd。具体可以参考以下代码示例:
import Vue from 'vue' import ElementUI from 'element-ui' import 'element-ui/lib/theme-chalk/index.css' import EW from 'element-ui-uwgd' Vue.use(ElementUI) Vue.use(EW)
注意:引入 element-ui-uwgd 之前,必须先引入 element-ui。
组件使用
可以使用 ew-
前缀来使用 element-ui-uwgd 的组件。例如,使用 ew-table
组件:
<template> <ew-table :data="tableData" border> <el-table-column prop="name" label="姓名"></el-table-column> <el-table-column prop="age" label="年龄"></el-table-column> <el-table-column prop="address" label="地址"></el-table-column> </ew-table> </template>
api
ew-icon-button
ew-icon-button
组件是一个图标按钮组件,支持 element-ui 中的所有图标。
Attributes
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
type | 按钮类型 | String | - | - |
icon | 按钮图标 | String | - | - |
size | 按钮大小 | String | medium / small / mini | - |
disabled | 是否禁用 | Boolean | true / false | false |
round | 是否圆角 | Boolean | true / false | false |
plain | 是否朴素样式 | Boolean | true / false | false |
loading | 是否加载中状态 | Boolean | true / false | false |
autofocus | 是否自动获取焦点 | Boolean | true / false | false |
Events
事件名称 | 说明 | 回调参数 |
---|---|---|
click | 点击按钮时触发 | event: Event |
ew-search-input
ew-search-input
组件是一个搜索框组件,支持 element-ui 的所有输入框属性和事件。
Attributes
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
placeholder | 输入框占位文本 | String | - | - |
value | 绑定值 | String / Number | - | - |
clearable | 是否可清空 | Boolean | true / false | true |
disabled | 是否禁用 | Boolean | true / false | false |
size | 输入框尺寸 | String | medium / small / mini | - |
Events
事件名称 | 说明 | 回调参数 |
---|---|---|
input | 输入框内容变化时触发 | value: string / number |
change | 输入框内容变化时触发,与 input 的区别在于输入框失去焦点或用户按下回车键才会触发 | value: string / number |
clear | 点击清空按钮时触发 | - |
ew-image-upload
ew-image-upload
组件是一个图片上传组件,支持 element-ui 的所有上传组件的属性和事件。
Attributes
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
action | 图片上传 URL | String | - | - |
method | 图片上传方法 | String | - | - |
headers | 图片上传请求头 | Object | - | - |
data | 图片上传时附带的额外参数 | Object | - | - |
name | 上传的文件字段名 | String | - | file |
withCredentials | 是否允许携带 cookie | Boolean | true / false | false |
accept | 接受上传的文件类型(详见input的accept属性) | String | - | image/* |
fileList | 已上传图片列表,常用于编辑页回显 | Array | - | [] |
limit | 最多允许上传图片的数量 | Number | - | 1 |
size | 图片限制大小,单位 kb | Number | - | - |
disabled | 是否禁用 | Boolean | true / false | false |
minWidth | 图片最小宽度,单位 px | Number | - | - |
minHeight | 图片最小高度,单位 px | Number | - | - |
ratio | 图片宽高比 | Number | - | - |
Events
事件名称 | 说明 | 回调参数 |
---|---|---|
before-upload | 每个文件上传前触发,返回 false 则停止上传 | file: File |
success | 每个文件上传成功时触发 | response: Object, file: File |
error | 每个文件上传失败时触发 | error: Error, file: File |
removed | 每个文件被移除时触发 | file: Object |
exceed | 上传文件超出限制数量时触发 | files: Array, fileList: Array |
size-exceed | 上传文件超出限制大小时触发 | file: File |
dimension-exceed | 上传文件宽高超出限制时触发 | file: File |
invalid-format | 上传文件格式不正确时触发 | file: File |
示例
一个使用 element-ui-uwgd 的示例:
-- -------------------- ---- ------- ---------- ----- --------------- --------------------- ------------- ----------------------------------- ---------------- -------------------- ---------------------- ---------------------------- ---------------- -------------------- --------------------- ---------- ----------- ---------------- ----------------- ------------------------ -------------------- ------------------------ ---------------------- ------------------------------- ----------------------------------------- ------------------------------------- - ---------- ------------ ------------------------------- ------------------ ------ ----------- -------- ------ - ------------- -------------- ------------- - ---- ----------------- ------ ------- - ----------- - ----------------- ------------- ------------------ -------------- ------------------ ------------- -- ------ - ------ - ----------- --- --------- -- - -- -------- - -------- - ----------------- ---------------- -- ------------------- - ----------------- ------ -- ----------------------- ----- - --------------------------------- -- ------------------ ----- - -------------------- -- ------------------- - ----- ----- - --------------------------- -- ------ --- --- - --------------------------- -- - -- ------------------- --------- - ----------------------------- ------------- ----- -- ---------------------- - ------------------------------- ------------ ---- -- --------------------------- - ------------------------------- ---------------- - ------------------- -- ------------------------- - ----------------------------------------------------- - - - ---------
结语
本教程详细介绍了使用 element-ui-uwgd 的方法,并提供了实际示例代码。希望能对前端开发者有所帮助。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60066b5751ab1864dac66d62