39 Star 76 Fork 80

Discuz / Discuz-Q-Web

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
MANY-SCENARIOS.md 3.11 KB
一键复制 编辑 原始数据 按行查看 历史

多场景开发方案

多场景开发方案是指在在既有的DZQ的样式,布局,交互或功能上提供进一步的修改,用于扩充DZQ的能力,或者是用于自定义样式和交互。

为了可以使DZQ同时可以进行多场景自定义修改,还能支持对于持续更新维护的DZQ做进一步的更新,所以必须遵从以下规范进行开发。

  • 对于多场景必须是建立一条长期维护分支,命名规范为(releases-xxx)。
  • 如果遇到对于样式重写或交互布局重写等,必须遵从mixins开发方式进行修改。
  • 如果多场景下对于原有功能不修改,补充新功能,必须做好判断以及使用多场景下对应自定义的环境变量进行条件编译

多场景开发命令

可以根据自己的场景进行命令,并替换下面代码中的pay即可

package.json

{
    // 以下命令为pay(支付场景下的命令)
    "scripts": {
        "dev:pay": "SCENE=pay nuxt",
        "build:pay-spa": "SCENE=pay nuxt build --spa",
        "build:pay": "SCENE=pay nuxt build",
        "start:pay": "SCENE=pay nuxt start",
        "build:pay-ssr": "npm run build:pay && npm run start:pay"
    },
}

nuxt.config.js

根据条件名称,为插件提供变量。

// 条件编译
const conditionalCompiler = {
  loader: 'js-conditional-compile-loader',
  options: {
    pay: process.env.SCENE === 'pay',
    ...
  }
}

mixin开发方式

假如现在有一个A.vue文件,在你的场景下,需要对A.vue进行重写样式,或者大量修改来满足你的场景需要的情况,那么你可以采用这种方式来进行编写。

home.vue


<template>
  <A></A>
</template>

<script>
export default {
    //....
}
</script>
<style lang="scss">
// ....
</style>

A.vue


<template>
  <view>A.vue</view>
</template>

<script>
export default {

}
</script>
<style lang="scss">
// ....
</style>

那么可以考虑这样编写新的A组件,例如Vue自身的mixin特性,编写一个新的组件,命名规范为(原组件名称-场景名称),然后通过mixin的方式,将原有组件mixin到新的组件上,然后根据场景要求,对组件的样式,dom结构或者组件的生命周期等进行重写,从而达到不修改原有代码的基础上,对于组件进行不同场景的修改,而且不影响正常DZQ的维护更新。

A-pay.vue


<template>
  <view>A-pay.vue</view>
</template>

<script>
export default {

}
</script>
<style lang="scss">
// ....
</style>

引用组件时,可以使用自定义的编译条件

home.vue


<template>
    <!-- IFTRUE_test --> 
    <A-pay></A-pay>
    <!-- FITRUE_test --> 
    <!-- IFTRUE_default --> 
    <A></A>
    <!-- FITRUE_default --> 
</template>

<script>
export default {
    //....
}
</script>
<style lang="scss">
// ....
</style>

分支管理

  • 场景分支的命名一般为releases-xxx(如:releases-pay)
  • 每一个场景原则上是不会同步到releases的,那么每一次DZQ版本发布后,都是需要主动的去同步releases到对应的场景分支当中,
JavaScript
1
https://gitee.com/Discuz/Discuz-Q-Web.git
git@gitee.com:Discuz/Discuz-Q-Web.git
Discuz
Discuz-Q-Web
Discuz-Q-Web
master

搜索帮助