Quasar App Extension fight-group

Add a short description of your App Extension. What does it do? How is it beneficial? Why would someone want to use it?

First of all,please install v-viewer

npm i v-viewer

Install

quasar ext add fight-group

Quasar CLI will retrieve it from NPM and install the extension.

Prompts

If your app extension uses prompts, explain them here, otherwise remove this section and remove prompts.js file.

Uninstall

quasar ext remove fight-group

Info

Add longer information here that will help the user of your app extension.

Other Info

Add other information that's not as important to know

Donate

If you appreciate the work that went into this App Extension, please consider donating to Quasar.

License

MIT (c) Destini [email protected]

组件属性

| Name（属性名称） | Type（属性类型） | Description（属性描述） | Default（默认值） | | :--------------: | :--------------: | :--------------------------------: | :---------------: | | messages | Array | 消息列表 | [] | | userId | String | 传入的 userId,用于判断是否是发送人 | '' | | isShowJC | Boolean | 名称是否显示机构 | false | | buttons | Array | 工具栏按钮 | [] | | timeFormat | String | 时间格式 | 'MM-DD hh:mm' | | timeStamp | Boolean | 聊天对话是否显示时间 | false | | chatBgColor | String | 聊天对话背景颜色 | 'grey-2' | | chatTextColor | String | 聊天对话文字颜色 | 'blcak' | | avatarColor | String | 头像背景颜色 | 'secondary' | | linkColor | String | 点位链接颜色 | 'blue' | | toolBoxBgColor | String | 工具栏背景颜色 | '' | | inputPlaceholder | String | 输入框占位符 | '' | | toolIconColor | String | 工具栏旁边加号按钮颜色 | 'white' |

可自定义的颜色变量

需要在全局样式中定义，否则会使用默认值

:root {
  --color-avatar-text: white;//头像字体颜色
  --color-text: white;//聊天对话框标题字体颜色
  --toolBox-bg-color: #e9e9e9;//工具栏背景颜色  
  --toolBox-btn-color: #495060; //工具栏按钮字体颜色
  --padding: 1rem;//内边距  
  --border-radius: 0.5rem;//外边框圆角  
  --font-size: 16px;//字体大小 
}

消息头像

消息中的头像默认截取为机构名称前四位，若没有机构名称但名称为系统默认头像会显示为系统，若都不存在则为"我"。

另外，我在消息头像中放置了插槽，可自定义消息头像样式，并且存在该插槽时，会默认覆盖掉原有的消息头像样式。插槽使用方式如下：

<template v-slot:avater>
	//自定义的头像内容
	<q-avatar color="primary" size="2rem" text-color="white" style="margin:0 0.5rem;">
		<span class="name">我</span>
	</q-avatar>
</template>

消息类型

在不同消息类型中，已经对案件信息变更、处置要点、安全提示、警情快报、文字、图片、视频、点位8种类型进行了处理，其中消息类型为点位还抛出了一个onNav事件需要使用者自行定义处理。

另外，我在消息类型的处理中放置了插槽，以便存在更多的消息类型去进行自定义样式，并且存在该插槽时，会覆盖掉原有的消息类型样式。

举个例子：如果此时有两个消息类型名分别为要点、提示，那么可以自定义消息类型代码如下

<template v-slot:要点="{ message }">
	<div class="case-update" style="max-width: 16rem;">
		<span>要点</span>
		<div class="info" v-html="message" />
	</div>
</template>
<template v-slot:提示="{ message }">
	<div class="case-update" style="max-width: 16rem;">
		<span>提示</span>
		<div class="info" v-html="message" />
	</div>
</template>

工具栏

1.在工具栏中，我们默认配置了图片、视频两种按钮，但需要你在使用组件时定义buttons属性时自行添加如下两个按钮对象，注意**type: 'image'或type: 'video'必须存在，此时你还需要在组件上配置@getFile="你定义的函数"**去对已选择的图片或者视频文件进行处理。

<FightGroup :messages="messages" :buttons="buttons" @getFile="getFile" @onNav="onNav" @sendText="sendText" />
		  
const buttons = [{
  type: 'image', //类型
  name: '图片', //显示在图标下方的名称
  icon: 'bi-camera-fill', //图标
  textColor: 'blue-9' //图标颜色
},
{
  type: 'video',
  name: '视频',
  icon: 'bi-camera-reels-fill',
  textColor: 'green-7',
}]

function getFile(e){
	console.log('getFile', e.target.files[0]);
	//e.target.files[0]为已选择的文件内容
}

2.在工具栏中，如果你需要自定义按钮，请模仿下面代码：

const buttons = [{
  // type: 'location', //自定义按钮的类型可写可不写
  name: '定位', //显示在图标下方的名称
  icon: 'bi-geo-alt-fill', //图标
  textColor: 'orange-8', //图标颜色
  caseClick: 
  //按钮的自定义点击事件
  () => {
    console.log('点击了定位');
  }
}]

3.在工具栏输入框中，抛出了一个sendText事件需要使用者自行定义处理

4.在工具栏中，对于输入框非空时，右边的图标按钮我放置了插槽，以便存在更多自定义按钮进行处理，并且存在该插槽时，会覆盖掉原有的发送样式。插槽使用方式如下：

<template v-slot:toolBtn>
	//自定义发送样式
	<q-btn unelevated color="primary" icon="message"/>
    <q-btn unelevated color="primary" icon="bi-soundwave" style="margin-left: 0.5rem;"/>
</template>

注意事项

需要在quasar.config.js里面至少引入如下三种图标，否则可能会出现图标无法显示的清空

module.exports = function (ctx) {
  return {
    ...
    extras: [
      'mdi-v5',
      'material-icons',
      'bootstrap-icons'
    ]
	...
}