0.0.21 • Published 11 months ago
aegis-odyssey v0.0.21
AegisOdyssey 插件说明
实现项目内部分 ui 的全局化配置和使用。
安装
npm i aegis-odyssey
全局配置
- main.ts 引入对应插件
// 引入
import { Odyssey } from "aegis-odyssey";
// 全局挂载
app.use(Odyssey).mount("#app");
颗粒 UI 组件
- radio 多组 UI 组件
// 使用方法
<o-radio v-model="rValue" type="button" size="small" disabled :list=['项1','项2'] />
key | 条件 | value | default | description |
---|---|---|---|---|
v-model | 必填 | string | number | "" | 同 el |
type | 选填 | "default" | "border" | "button" | "default" | 同 el |
size | 选填 | "large" | "default" | "small" | "default" | 同 el |
disabled | 选填 | boolean | false | 同 el |
list | 选填 | (string | number) [] | "是","否" | 单选的选择列表 |
- select 组件
// 使用方法
<o-select v-model="rValue" type="button" size="small" disabled :list=['项1','项2'] />
key | 条件 | value | default | description |
---|---|---|---|---|
v-model | 必填 | string | number | "" | 同 el |
size | 选填 | "large" | "default" | "small" | "default" | 同 el |
clearable | 选填 | boolean | true | 同 el |
disabled | 选填 | boolean | false | 同 el |
placeholder | 选填 | string | "请选择" | 同 el |
list | 必填 | (string | number) [] | "A","B" | 下拉组件的选择列表 |
- date 组件
// 使用方法
<o-date v-model="date" type="date" defaultShortcuts short />
key | 条件 | value | default | description |
---|---|---|---|---|
v-model | 必填 | string | string[] | "" |[] | 同 el |
type | 选填 | "date" | "daterange" | "date" | 单日期或者双日期 |
size | 选填 | "large" | "default" | "small" | "default" | 同 el |
short | 选填 | boolean | false | 组件是否用最短样式 |
clearable | 选填 | boolean | true | 同 el |
disabled | 选填 | boolean | false | 同 el |
placeholder | 选填 | string | "请选择" | 单日期 placeholder |
startPlaceholder | 选填 | string | "开始时间" | 多日期起始 placeholder |
endPlaceholder | 选填 | string | "结束时间" | 多日期末尾 placeholder |
disabledDate | 选填 | Function | default | 不可选日期条件 |
defaultShortcuts | 选填 | boolean | false | 是否配置 shortcuts 默认值 |
shortcuts | 选填 | { text: string; value: Date | Function }[] | default | 不配置 defaultShortcuts 情况下,自定义 shortcuts 默认值 |
复合 UI 组件
- table 组件
// 依赖变量
const tableValue = ref([
{
type: "原告",
name: "Tom",
gender: "男",
country: "中国",
address: "No. 189, Grove St, Los Angeles",
info: "",
},
{
type: "原告",
name: "Johnny",
gender: "男",
country: "日本",
address: "No. 189, Grove St, Los Angeles",
info: "",
},
]);
const tableHeaderValue = ref({
label: {
type: "类型",
name: "姓名",
gender: "性别",
country: "国籍",
address: "地址",
info: "自定义",
},
width: {
type: 60,
name: 150,
gender: 116,
country: 116,
operate: 100,
},
edit: {
name: "input",
gender: "radio",
country: "select",
address: "textarea",
info: "custom",
},
});
const showSwitch = ref(false);
const handleSwitch = () => {
showSwitch.value = !showSwitch.value;
};
const tableAddValue = ref({
type: "原告",
name: "",
gender: "男",
country: "",
address: "",
info: "",
});
const addVerify = computed(() => {
return !!(tableAddValue.value.type && tableAddValue.value.name && tableAddValue.value.gender);
});
const handleOpen = (type: number, idx: number) => {
if (type === 1) {
console.log(idx);
} else {
tableValue.value.splice(idx, 1);
}
};
// 使用方法
<o-table
v-model="tableValue"
v-model:addValue="tableAddValue"
:header="tableHeaderValue"
merge="type"
:add="addVerify"
:list="{ country: ['中国', '日本', '美国'] }"
>
<template #info="scope">
<div v-show="!showSwitch" class="show" @click="handleSwitch">
{{ scope.row.name }}: {{ scope.row.gender }}
</div>
<el-input v-show="showSwitch" v-model="scope.row.date" type="textarea" autosize />
</template>
<template #operate="scope">
<el-button class="f12" type="primary" link @click="handleOpen(1, scope.$index)"> 打开 </el-button>
<el-button class="f12" type="primary" link @click="handleOpen(2, scope.$index)"> 删除 </el-button>
</template>
<template #add>
<o-select class="w100 mr10" v-model="tableAddValue.type" :list="['原告', '被告']" />
<el-input class="mr10" v-model="tableAddValue.name" placeholder="姓名" clearable />
<o-radio class="mr10" v-model="tableAddValue.gender" type="button" :list="['男', '女']" />
<o-select
class="w100 mr10"
v-model="tableAddValue.country"
:list="['中国', '日本', '美国']"
placeholder="国籍"
/>
<el-input class="mr10" v-model="tableAddValue.address" placeholder="地址" clearable />
</template>
</o-table>
key | 条件 | value | default | description |
---|---|---|---|---|
v-model | 必填 | {...} | table 数组对象 | |
v-model:addValue | 选填 | {...} | "新增"功能 + custom 的单项 item | |
header | 必填 | {} | table 渲染 th 的规则 | |
header.label | 必填 | string | 对应 th 里面的描述名,不可缺省 | |
header.width | 选填 | number | 对应单列宽度,不定义为自适应,可缺省 | |
header.edit | 选填 | input|radio|select|textarea|custom | 对应单列是否编辑,可缺省 | |
btnName | 选填 | string | "添加" | table"新增"功能默认按钮描述 |
index | 选填 | boolean | false | table 是否显示序列 |
merge | 选填 | string | "" | table 是否分组,分组 key 由 merge 值决定,需要放在列第一序列,最大分组仅支持 3 组 |
add | 选填 | boolean | false | table 是否显示"新增"功能,不配置$slots.add 的话(custom)默认给 v-model 的 item 点击新增后生成一组空数据 |
list | 必填 | (string | number) [] | {key: "A","B"} | table 单列为 select、radio 组件的默认选项值,key 位单列 prop 名称 |
#key | 选填 | #key="scope" | slot 插槽,对应 header.edit 属性里的 key,提供自定义单项的内容编写,通过 scope 获得当前 item 值 | |
#operate | 选填 | #operate="scope" | "新增"功能下,自动赋予删除 item 默认列。且该 slot 插槽,提供自定义“操作”的内容编写 | |
#add | 选填 | #add | "新增"功能下,该 slot 插槽,提供自定义“新增”项的内容编写 |
0.0.21
11 months ago
0.0.20
11 months ago
0.0.19
11 months ago
0.0.18
11 months ago
0.0.17
11 months ago
0.0.16
11 months ago
0.0.15
11 months ago
0.0.14
11 months ago
0.0.13
11 months ago
0.0.12
12 months ago
0.0.11
12 months ago
0.0.10
12 months ago
0.0.9
12 months ago
0.0.8
12 months ago
0.0.7
12 months ago
0.0.6
12 months ago
0.0.5
12 months ago
0.0.3
12 months ago
0.0.2
12 months ago
0.0.1
12 months ago
0.0.0
12 months ago