view-ui-plus-derive 0.0.2 → 0.1.0

package/README.md

@@ -1,11 +1,11 @@
 # view-ui-plus-derive
 
-基于view-ui-plus的组件等扩展，需要vue 3.5+
+基于vue 3.5+与view-ui-plus的组件&优化扩展等
 
 ## 安装
 
 ```bash
-npm install view-ui-plus-derive
+npm i view-ui-plus-derive
 
 or
 
@@ -14,7 +14,21 @@ yarn add view-ui-plus-derive
 
 [TOC]
 
-## 使用
+### CDN引入
+
+```html
+<link rel="stylesheet" href="https://unpkg.com/view-ui-plus/dist/styles/viewuiplus.css">
+<link rel="stylesheet" href="https://unpkg.com/view-ui-plus-derive/dist/umd/index.css">
+<script src="https://unpkg.com/vue"></script>
+<script src="https://unpkg.com/view-ui-plus"></script>
+<script src="https://unpkg.com/view-ui-plus-derive/dist/umd/index.js"></script>
+
+<!-- <script src="https://unpkg.com/view-ui-plus-derive/dist/umd/en-US.js"></script> -->
+
+<script>
+  Vue.createApp().use(ViewUIPlus).use(iviewDerive /*,{msg: iviewDeriveENUS} */).mount('#app')
+</script>
+```
 
 ### 全局引入
 
@@ -22,12 +36,12 @@ yarn add view-ui-plus-derive
 import { createApp } from 'vue'
 import ViewUIPlus from 'view-ui-plus'
 import 'view-ui-plus/dist/styles/viewuiplus.css'
-import plugin from 'view-ui-plus-derive' // 注册组件与指令
+import iviewDerive from 'view-ui-plus-derive' // 包含所有组件与指令
 import 'view-ui-plus-derive/style' // 引入所有组件样式
 
 import App from './App.vue'
 
-createApp(App).use(ViewUIPlus).use(plugin).mount('#app')
+createApp(App).use(ViewUIPlus).use(iviewDerive).mount('#app')
 ```
 
 ### 按需引入
@@ -44,7 +58,7 @@ import App from './App.vue'
 createApp(App).use(ViewUIPlus).component(Combi.name, Combi).mount('#app')
 ```
 
-仅部分组件有对应样式，如图
+仅部分组件需要对应样式，如图
 ![css](./assets/import%20component%20css.png)
 
 ### 多语言
@@ -57,14 +71,14 @@ createApp(App).use(ViewUIPlus).component(Combi.name, Combi).mount('#app')
 import { createApp } from 'vue'
 import ViewUIPlus from 'view-ui-plus'
 import 'view-ui-plus/dist/styles/viewuiplus.css'
-import viewUiDerive from 'view-ui-plus-derive'
+import iviewDerive from 'view-ui-plus-derive'
 import enUS from 'view-ui-plus-derive/locale/en-US'
 
 import App from './App.vue'
 
 createApp(App)
   .use(ViewUIPlus)
-  .use(viewUiDerive, {
+  .use(iviewDerive, {
     msg: enUS
   })
   .mount('#app')
@@ -76,13 +90,13 @@ createApp(App)
 import { createApp } from 'vue'
 import ViewUIPlus from 'view-ui-plus'
 import 'view-ui-plus/dist/styles/viewuiplus.css'
-import viewUiDerive from 'view-ui-plus-derive'
+import iviewDerive from 'view-ui-plus-derive'
 
 import App from './App.vue'
 
 createApp(App)
   .use(ViewUIPlus)
-  .use(viewUiDerive, {
+  .use(iviewDerive, {
     msg: {
       d: {
         lang: 'zh-Hant',
@@ -136,7 +150,7 @@ import ViewUIPlus from 'view-ui-plus'
 import zh from 'view-ui-plus/dist/locale/zh-CN'
 import en from 'view-ui-plus/dist/locale/en-US'
 import 'view-ui-plus/dist/styles/viewuiplus.css'
-import viewUiDerive from 'view-ui-plus-derive'
+import iviewDerive from 'view-ui-plus-derive'
 import zhCN from 'view-ui-plus-derive/locale/zh-CN'
 import enUS from 'view-ui-plus-derive/locale/en-US'
 
@@ -169,14 +183,14 @@ const i18n = createI18n({
 createApp(App)
   .use(i18n)
   .use(ViewUIPlus)
-  .use(viewUiDerive, {
+  .use(iviewDerive, {
     i18n
     // msgPrefix: 'someKey' // 该值仅针对使用vue-i18n的情况生效
   })
   .mount('#app')
 ```
 
-### 其它扩展
+### 更多优化
 
 - 为多选模式的iview Select添加全选功能。**若全局安装了插件则无需再次注册指令**
 
@@ -185,7 +199,7 @@ createApp(App)
 import { createApp } from 'vue'
 import ViewUIPlus from 'view-ui-plus'
 import 'view-ui-plus/dist/styles/viewuiplus.css'
-import { iviewSelect } from "view-ui-plus-derive";
+import { iviewSelect } from "view-ui-plus-derive"
 import App from './App.vue'
 
 createApp(App).use(ViewUIPlus).directive('iviewSelect', iviewSelect).mount('#app')
@@ -221,19 +235,31 @@ import 'view-ui-plus-derive/iview-mods/table'
 也可以一次性引入iview-mods下的input-number、select、table
 
 ```js
+// 本地引入
 import 'view-ui-plus-derive/iview-mod'
 ```
 
+```html
+<!-- CDN引入 -->
+<script src="https://unpkg.com/view-ui-plus-derive/dist/umd/iview-mod.js"></script>
+```
+
 针对iview组件的样式优化
 
 - 修复带有固定列的Table存在水平滚动条时，固定列下方的滚动条无法点中
 - 防止Select在关闭选项时可能出现的点击更换选项bug
-- 调整Input、InputNumber、Select、Button在禁用状态下非placeholder的文本颜色为#7a7a7a
+- 适当调整Input、InputNumber、Select、Button在禁用状态下非placeholder的文本颜色
 
 ```js
+// 本地引入
 import 'view-ui-plus-derive/iview-mod.css'
 ```
 
+```html
+<!-- CDN引入 -->
+<link rel="stylesheet" href="https://unpkg.com/view-ui-plus-derive/dist/iview-mod.css">
+```
+
 ### 组件
 
 #### AllCheckbox
@@ -326,7 +352,7 @@ default({item})
 
 #### BaseSwitch
 
-省去重复写slot的Switch
+更易于使用的Switch
 
 ```html
 <template>
@@ -387,7 +413,7 @@ close()
 
 #### RemoteSelect
 
-远程请求数据的Select
+远程Select
 
 ```html
 <template>
@@ -553,7 +579,7 @@ text( { text })
 
 #### CacheSelect
 
-同一个cacheId只请求一次数据的RemoteSelect
+避免重复调用远程接口的RemoteSelect，同一个cacheId对应只触发一次请求
 
 ```html
 <template>
@@ -1687,7 +1713,7 @@ emit('load', res)
  * 勾选项变更后触发
  * @param selections 勾选项
  */
-emit('select-rows', selections)
+emit('selection-change', selections)
 
 /**
  * 更改全选框后触发

package/dist/index.d.ts

@@ -324,7 +324,6 @@ autoGet: boolean;
 textMode: boolean;
 cache: boolean;
 strict: boolean;
-check: Function;
 getSelected: Function;
 }> & Omit<{
 readonly all: boolean;
@@ -337,7 +336,6 @@ readonly autoGet: boolean;
 readonly textMode: boolean;
 readonly cache: boolean;
 readonly strict: boolean;
-readonly check: Function;
 readonly getSelected: Function;
 readonly list?: Obj[] | undefined;
 readonly modelValue?: SelectValue | undefined;
@@ -351,13 +349,14 @@ readonly optionTag?: Function | undefined;
 readonly loader?: Function | undefined;
 readonly chosen?: Record<string, any> | unknown[] | undefined;
 readonly formatLabel?: Function | undefined;
+readonly check?: Function | undefined;
 readonly parentCode?: string | number | unknown[] | undefined;
 readonly "onUpdate:modelValue"?: ((val: SelectValue) => any) | undefined;
 readonly "onUpdate:chosen"?: ((item: Obj) => any) | undefined;
 readonly "onUpdate:list"?: ((list: Obj[]) => any) | undefined;
 readonly "onUpdate:refresh"?: ((handle: () => Promise<void>) => any) | undefined;
 readonly onLoad?: ((val: any) => any) | undefined;
-} & VNodeProps & AllowedComponentProps & ComponentCustomProps, "all" | "multiple" | "valueKey" | "labelKey" | "keyMap" | "valueAsKey" | "autoGet" | "textMode" | "cache" | "strict" | "check" | "getSelected">;
+} & VNodeProps & AllowedComponentProps & ComponentCustomProps, "all" | "multiple" | "valueKey" | "labelKey" | "keyMap" | "valueAsKey" | "autoGet" | "textMode" | "cache" | "strict" | "getSelected">;
 $attrs: {
 [x: string]: unknown;
 };
@@ -403,7 +402,6 @@ type: FunctionConstructor;
 };
 check: {
 type: FunctionConstructor;
-default: () => boolean;
 };
 textMode: BooleanConstructor;
 textFormat: FunctionConstructor;
@@ -457,7 +455,6 @@ autoGet: boolean;
 textMode: boolean;
 cache: boolean;
 strict: boolean;
-check: Function;
 getSelected: Function;
 }, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & {
 beforeCreate?: (() => void) | (() => void)[];
@@ -490,7 +487,6 @@ autoGet: boolean;
 textMode: boolean;
 cache: boolean;
 strict: boolean;
-check: Function;
 getSelected: Function;
 }> & Omit<Readonly<ExtractPropTypes<    {
 modelValue: PropType<SelectValue>;
@@ -523,7 +519,6 @@ type: FunctionConstructor;
 };
 check: {
 type: FunctionConstructor;
-default: () => boolean;
 };
 textMode: BooleanConstructor;
 textFormat: FunctionConstructor;
@@ -554,7 +549,7 @@ default: boolean;
 "onUpdate:list"?: ((list: Obj[]) => any) | undefined;
 "onUpdate:refresh"?: ((handle: () => Promise<void>) => any) | undefined;
 onLoad?: ((val: any) => any) | undefined;
-}>, "code" | "search" | "changeCode" | "loaded" | "codes" | ("all" | "multiple" | "valueKey" | "labelKey" | "keyMap" | "valueAsKey" | "autoGet" | "textMode" | "cache" | "strict" | "check" | "getSelected")> & ShallowUnwrapRef<    {
+}>, "code" | "search" | "changeCode" | "loaded" | "codes" | ("all" | "multiple" | "valueKey" | "labelKey" | "keyMap" | "valueAsKey" | "autoGet" | "textMode" | "cache" | "strict" | "getSelected")> & ShallowUnwrapRef<    {
 code: Ref<SelectValue, SelectValue>;
 changeCode: (val: SelectValue) => void;
 loaded: Ref<boolean, boolean>;
@@ -1967,7 +1962,7 @@ search: (stay?: boolean) => void;
 setMaxHeight: () => void;
 table: {
 data: Obj[];
-maxHeight: number | string | void;
+maxHeight: string | number | undefined;
 selectType: {
 align: string;
 className: string;
@@ -1986,7 +1981,7 @@ load: (res: any) => any;
 "update:loading": (value: boolean | undefined) => any;
 "update:selection": (val: Obj[]) => any;
 "select-all": (val: Obj[], args_1: boolean) => any;
-"select-rows": (val: Obj[]) => any;
+"selection-change": (val: Obj[]) => any;
 reload: () => any;
 "change-col": (val: Obj | Obj[]) => any;
 }, string, PublicProps, Readonly<ExtractPropTypes<    {
@@ -2143,7 +2138,7 @@ onLoad?: ((res: any) => any) | undefined;
 "onUpdate:loading"?: ((value: boolean | undefined) => any) | undefined;
 "onUpdate:selection"?: ((val: Obj[]) => any) | undefined;
 "onSelect-all"?: ((val: Obj[], args_1: boolean) => any) | undefined;
-"onSelect-rows"?: ((val: Obj[]) => any) | undefined;
+"onSelection-change"?: ((val: Obj[]) => any) | undefined;
 onReload?: (() => any) | undefined;
 "onChange-col"?: ((val: Obj | Obj[]) => any) | undefined;
 }>, {
@@ -2215,7 +2210,6 @@ type: FunctionConstructor;
 */
 check: {
 type: FunctionConstructor;
-default: () => boolean;
 };
 textMode: BooleanConstructor;
 textFormat: FunctionConstructor;
@@ -2308,7 +2302,6 @@ type: FunctionConstructor;
 */
 check: {
 type: FunctionConstructor;
-default: () => boolean;
 };
 textMode: BooleanConstructor;
 textFormat: FunctionConstructor;
@@ -2363,7 +2356,6 @@ autoGet: boolean;
 textMode: boolean;
 cache: boolean;
 strict: boolean;
-check: Function;
 getSelected: Function;
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>, Readonly<{
     default(_: {