一、今日实战目标

• 实现自定义组件

二、实战步骤

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组件库封装格式，熟练了进阶组件就可以多研究下类似的高级组件。