文章目录
- 一、今日实战目标
- 二、实战步骤
- 1. 在components目录下创建组件
- 2. 编辑组件 （多版本）
- （1）基础组件 - - （完全静态内容）
- （2）进阶组件 - - （动态内容、样式等）
- （3）高级组件 （mixins）
- 总结
一、今日实战目标
- 实现自定义组件
二、实战步骤
1. 在components目录下创建组件
- 右键components文件夹会弹出菜单，点击新建组件
- 输入组件名，可以把创建同名目录给勾上
2. 编辑组件 （多版本）
（1）基础组件 - - （完全静态内容）
// 这种组件的内容是纯静态的，不接受任何动态数据
<template>
<view class="g-top hor-center">
<view class="row ">
<u-tag text="置顶" type="success" plain size="mini" borderColor="#16B998" color="#16B998"></u-tag>
<view class="label text-overflow text-overflow1">
纯享版-想阅读致敬！微信读书产品设计策略alkjhfkahfj
</view>
</view>
</view>
</template>（2）进阶组件 - - （动态内容、样式等）
// 利用props接收数据，$emit发送事件
**** 子组件 ******
<template>
<view class="setting-bar" v-if="info">
<view class="space-between hor-center" @click="go(info)">
<view class="row hor-center">
<image class="icon" :src="info.icon" mode=""></image>
<view class="menu">
{{info.title}}
</view>
</view>
<view class="row">
<view v-if="info.showNumber" class="label">
1
</view>
<image class="arrow" src="../../static/svg/arrowR.svg" mode=""></image>
</view>
</view>
</view>
</template>
<script>
export default {
name: "setting-bar",
data() {
return {
};
},
// props接受数据
props: {
info: Object
},
methods: {
// 向父组件发送事件
send() {
this.$emit("send")
},
go(e) {
if (e.id === 4) {
this.$store.commit("logout")
}
uni.navigateTo({
url: e.page
})
}
}
}
</script>- 在父组件中使用子组件
// 先引入你写的子组件,
import xxx from '@/components/setting-bar/xxx.vue'
export default {
components: {
xxx
},
data() {
return {
list: [{
id: 4,
icon: '../../static/svg/change.svg',
title: '切换账号',
page: '../login/login',
showNumber: false
}, {
id: 5,
icon: '../../static/svg/kefu.svg',
title: '帮助与客服',
page: '../../login/login',
showNumber: false
}]
}
// 遍历list
<view class="" v-for="(item,index) in list" :key="index">
<xxx :info="item" />
</view>（3）高级组件 （mixins）
- 举例自定义顶部导航栏
// props.js
export default {
props: {
// 是否开启顶部安全区适配
safeAreaInsetTop: {
type: Boolean,
default: uni.$u.props.navbar.safeAreaInsetTop
},
// 固定在顶部时，是否生成一个等高元素，以防止塌陷
placeholder: {
type: Boolean,
default: uni.$u.props.navbar.placeholder
},
// 是否固定在顶部
fixed: {
type: Boolean,
default: uni.$u.props.navbar.fixed
},
// 是否显示下边框
border: {
type: Boolean,
default: uni.$u.props.navbar.border
},
// 左边的图标
leftIcon: {
type: String,
default: uni.$u.props.navbar.leftIcon
},
// 左边的提示文字
leftText: {
type: String,
default: uni.$u.props.navbar.leftText
},
// 左右的提示文字
rightText: {
type: String,
default: uni.$u.props.navbar.rightText
},
// 右边的图标
rightIcon: {
type: String,
default: uni.$u.props.navbar.rightIcon
},
// 标题
title: {
type: [String, Number],
default: uni.$u.props.navbar.title
},
// 背景颜色
bgColor: {
type: String,
default: uni.$u.props.navbar.bgColor
},
// 标题的宽度
titleWidth: {
type: [String, Number],
default: uni.$u.props.navbar.titleWidth
},
// 导航栏高度
height: {
type: [String, Number],
default: uni.$u.props.navbar.height
},
// 左侧返回图标的大小
leftIconSize: {
type: [String, Number],
default: uni.$u.props.navbar.leftIconSize
},
// 左侧返回图标的颜色
leftIconColor: {
type: String,
default: uni.$u.props.navbar.leftIconColor
},
// 点击左侧区域(返回图标)，是否自动返回上一页
autoBack: {
type: Boolean,
default: uni.$u.props.navbar.autoBack
},
// 标题的样式，对象或字符串
titleStyle: {
type: [String, Object],
default: uni.$u.props.navbar.titleStyle
}
}
}// u-navbar.vue
<template>
<view class="u-navbar">
<view
class="u-navbar__placeholder"
v-if="fixed && placeholder"
:style="{
height: $u.addUnit($u.getPx(height) + $u.sys().statusBarHeight,'px'),
}"
></view>
<view :class="[fixed && 'u-navbar--fixed']">
<u-status-bar
v-if="safeAreaInsetTop"
:bgColor="bgColor"
></u-status-bar>
<view
class="u-navbar__content"
:class="[border && 'u-border-bottom']"
:style="{
height: $u.addUnit(height),
backgroundColor: bgColor,
}"
>
<view
class="u-navbar__content__left"
hover-class="u-navbar__content__left--hover"
hover-start-time="150"
@tap="leftClick"
>
<slot name="left">
<u-icon
v-if="leftIcon"
:name="leftIcon"
:size="leftIconSize"
:color="leftIconColor"
></u-icon>
<text
v-if="leftText"
:style="{
color: leftIconColor
}"
class="u-navbar__content__left__text"
>{{ leftText }}</text>
</slot>
</view>
<slot name="center">
<text
class="u-line-1 u-navbar__content__title"
:style="[{
width: $u.addUnit(titleWidth),
}, $u.addStyle(titleStyle)]"
>{{ title }}</text>
</slot>
<view
class="u-navbar__content__right"
v-if="$slots.right || rightIcon || rightText"
@tap="rightClick"
>
<slot name="right">
<u-icon
v-if="rightIcon"
:name="rightIcon"
size="20"
></u-icon>
<text
v-if="rightText"
class="u-navbar__content__right__text"
>{{ rightText }}</text>
</slot>
</view>
</view>
</view>
</view>
</template>
<script>
import props from './props.js';
/**
* Navbar 自定义导航栏
* @description 此组件一般用于在特殊情况下，需要自定义导航栏的时候用到，一般建议使用uni-app带的导航栏。
* @property {Boolean} safeAreaInsetTop 是否开启顶部安全区适配 （默认 true ）
* @property {Boolean} placeholder 固定在顶部时，是否生成一个等高元素，以防止塌陷 （默认 false ）
* @property {Boolean} fixed 导航栏是否固定在顶部 （默认 false ）
* @property {Boolean} border 导航栏底部是否显示下边框 （默认 false ）
* @property {String} leftIcon 左边返回图标的名称，只能为uView自带的图标 （默认 'arrow-left' ）
* @property {String} leftText 左边的提示文字
* @property {String} rightText 右边的提示文字
* @property {String} rightIcon 右边返回图标的名称，只能为uView自带的图标
* @property {String} title 导航栏标题，如设置为空字符，将会隐藏标题占位区域
* @property {String} bgColor 导航栏背景设置 （默认 '#ffffff' ）
* @property {String | Number} titleWidth 导航栏标题的最大宽度，内容超出会以省略号隐藏 （默认 '400rpx' ）
* @property {String | Number} height 导航栏高度(不包括状态栏高度在内，内部自动加上)（默认 '44px' ）
* @property {String | Number} leftIconSize 左侧返回图标的大小（默认 20px ）
* @property {String | Number} leftIconColor 左侧返回图标的颜色（默认 #303133 ）
* @property {Boolean} autoBack 点击左侧区域(返回图标)，是否自动返回上一页（默认 false ）
* @property {Object | String} titleStyle 标题的样式，对象或字符串
* @event {Function} leftClick 点击左侧区域
* @event {Function} rightClick 点击右侧区域
* @example <u-navbar title="剑未配妥，出门已是江湖" left-text="返回" right-text="帮助" @click-left="onClickBack" @click-right="onClickRight"></u-navbar>
*/
export default {
name: 'u-navbar',
mixins: [uni.$u.mpMixin, uni.$u.mixin, props],
data() {
return {
}
},
methods: {
// 点击左侧区域
leftClick() {
// 如果配置了autoBack，自动返回上一页
this.$emit('leftClick')
if(this.autoBack) {
uni.navigateBack()
}
},
// 点击右侧区域
rightClick() {
this.$emit('rightClick')
},
}
}
</script>
<style lang="scss" scoped>
.... 省略
</style>总结
在项目中，可复用的一些模块，尽量写成组件，能提高开发效率和方便后期维护更新，上午讲到的
（3）高级组件类似于在uniapp插件市场的ui组件库封装格式，熟练了进阶组件就可以多研究下类似的高级组件。
本文章为转载内容，我们尊重原作者对文章享有的著作权。如有内容错误或侵权问题，欢迎原作者联系我们进行内容更正或删除文章。
