Info 不要使用pnpm

2022年8月20日
- 建议用npm，因为使用了"file:./local_moduels",pnpm似乎还没有支持......

非最佳实践，尽量多样： Just for fun :)

TODO
BOUNDLESS
I18N
ISSUE
npm i -g mirror-config-china --registry=https://registry.npm.taobao.org ~~Germinal~~
Actions: deploy app
TODO

/* README: */
/* NOTICE: */
/* TODO: */

初次运行：

# install package and generate language
npm run bs npm start

package.json

file:./local_moduels/**
- 有朝一日稳定了，可以独立发布出去（UI）。
- 放一些不与业务代码耦合的代码（单纯 API 发请求，Mock 数据）

样式

/* App.less TODO:更新后不会刷新页面  */
/* 变量在configs.jsx中，加载为全应用的css原生变量*/
/* less 样式可以单独使用webpack、rollup等工具打包（build目录下），生成不同主题 */
html,
body,
#app {
	height: 100%;
	overflow: hidden;
}

@import url("./layout/User.less");
...;

boundless demo 页面

https://shonesinglone.github.io/germinal/boundless/index.html?APP_ENTRY_NAME=demo http://localhost:3000/boundless/index.html?APP_ENTRY_NAME=demo

开发测试 demo 页面

http://localhost:3000/#/dev-demo http://localhost:3000/yapi.html#/dev

编写客户端的 Programs Language

boundless js
app js-ts
yapi ts

Reference

- npm update --depth=9999 vue-loader
Vue3
ant-design-vue
- Ant Design Vue3
- ant-design-vue-pro
  - pro-layout
URL-friendly characters
popover
popper
regexper 正则可视化

关于命令式代码，私以为诸如 tips、popover、confirm、dialog 这类的场景都是合适的，一味无脑使用声明，颇有一种手里只有一把锤子的意思。

jsx slot 的写法

vue-jsx-next

const genMenu = () => {
	const MenuItemRender = menuInfo => {
		if (_.isArrayFill(menuInfo.children)) {
			/* 第一种 */
			return (
				<SubMenu
					v-slots={{
						icon: () => <AppleOutlined />,
						title: () => menuInfo.label,
						default: () => _.map(menuInfo.children, MenuItemRender)
					}}
				/>
			);
		} else {
			/* 第二种 */
			return (
				<MenuItem key={menuInfo.id}>
					{{
						icon: () => <UserOutlined />,
						default: () => <span>{menuInfo.label}</span>
					}}
				</MenuItem>
			);
		}
	};
	return _.map(props.tree, MenuItemRender);
};

常用函数

$t 多语言转换

懒加载，最好是当前模块用到的才加载。
如何做到异步？使用 DelayCall function？

单一数据源build/make/language.js

{
	"make:language": "node ./build/make.js language"
}

return { label: "显示的对应语言", prop: "key" };

/* main.js 第一行 window._ 工具 常用工具函数 */
import "@ventose/ui/loadCommonUtil.js";

appPlugins

针对 popover 单例的使用，Vue3 以应用为单位配置属性的方式相较于 Vue2 的全局配置，带来了灵活，就需要但对每个应用单独配置，

/* Vue3 组件方式加载 popover content */
if (this.options.component) {
	this.$popoverMountDOM = $(
		`<div id="${this.id}" class="x-popover-content"/>`
	).prependTo($("body"));
	const popoverApp = createApp(this.options.component);
	/* 独立应用，配置是否共享、同步，可以配置，此处用appPlugins方法，保持一致 */
	appPlugins(popoverApp);
	const vm = popoverApp.mount(`#${this.id}`);
	this.$popoverDOM = $(vm.$el);
	this.$popoverDOM.appendTo(this.$popoverMountDOM);
	return;
}

与 Vue2 处理方式不同，需要使用 appPlugins 给createApp返回的app添加 plugin。应对 app 独立化后，无法共享 component 依赖的特性。

状态管理 VueX

视图归视图，状态归状态

State_*: 状态（变量）
Methods_*: 方法
Cpt_*: 计算属性 .value

Vue2 中的 this 就是用来保存状态，Vue3 的进步之处在于状态的解耦。

xItem 的设计与使用充分基于这种原则，xItem 视图本身，与 configs 相关，状态与 v-model 绑定相关。

xItem value可以直接用configs里面的value 不需要额外的v-model

/* FILE:src\state\State_App.js */
/* state State_App 相当于命名空间*/
export const State_App = reactive({ configs: lStorage.appConfigs });

/* getter 就用computed代替;commit直接修改StateApp  */
export const APP_LANGUAGE = computed({
	get: () => State_UI.language,
	set: lang => (State_UI.language = lang)
});

/* 副作用 effect */
/* 同步AppConfigs 到 localStorage */
watchEffect(() => (lStorage.appConfigs = State_App.configs));

/* actions 异步修改 效果同事务 自己去保证原子性 */
export const Actions_App = {
	GetInfo: async () => {},
	Login: async () => {},
	Logout: async () => {}
};

开发

App.vue 中完成

pro-component

xItem

错误信息可以单独提供，默认是在 formItem 下方展示 tips ，也可以利用错误信息做其他展现方式，比如 popup，提供 id 定位，方便滑动定位 vModel 与配置信息分开

参考
- src/views/user/LoginCredentials.vue
- src/views/user/State_Login.jsx

import {State_App} from "@ventose/state/State_App";
import {defItem, ITEM_TYPE} from "@ventose/ui";
import {watch} from "vue";

- [ ] 自定义组件的校验如何处理?

const inputConfigs = defItem({
    type: ITEM_TYPE.input,
    onAfterValueChange: (configs) => {
        State_App.count++;
    }
});
const state = reactive({name: ''})

watch(() => State_App.count, (count) => {
    State_App.count = count;
});

State_App.count: {{State_App.count}}
<xItem :configs="inputConfigs" v-model="state.name" />

xDataGrid

拖动排序字典下拉顺序=> order 的修改

Utils

设置 title
- setDocumentTitle()
root var css 变量
- setCSSVariables

自定义的折叠按钮(未使用)

<!--    <xRender :render="render.collapsedButton" :collapsed="State_App.collapsed"/>-->

log

no-mutating-props:MutatingProps
pickValueFrom：从 xItem 的 configs 中获取 value；
xItem 错误提示随语言切换变更涉及到 $t 的配置项都需要 ()=>

20211117 登陆框 blur 未触发 update 校验
20211127022841 v-uiPopover
20220110095314
- xIcon ：异步，动态懒加载 src\assets\svg 目录下单个文件，经过插件处理，分别打包成独立文件
- SvgRender: 同步，首页不想让用户看到 loading 状态，可提前加载图标

<!-- src\assets\svg\lockStrok.svg -->
<xIcon
	icon="lockStrok"
	style="color: red; height: 100px; width: 100px; outline: 1px solid black; margin: 10px; " />

20220328210842

国际化,用于内部通信

export const State_UI = reactive({
	language: lStorage["language"] || "zh-CN",
	/* svg 的路径  */
	assetsSvgPath:'',
	$t: (prop, payload) => ({
		label: prop
	})
});

xItem msg 可以是 function 根据传入的参数显示不同信息

20220506234727 如果 response 是 auth 清空 token refresh 页面

链式调用，延迟异步操作

api.service.request
- service 是可以延迟调用的
- 但是可以将异步操作放在request里面，
- 需要将参数传递到request

ShoneSingLone/germinal