view-ui-plus-derive 0.0.1 → 0.0.3

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,7 +36,7 @@ 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 plugin from 'view-ui-plus-derive' // 包含所有组件与指令
 import 'view-ui-plus-derive/style' // 引入所有组件样式
 
 import App from './App.vue'
@@ -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)
 
 ### 多语言
@@ -102,7 +116,7 @@ createApp(App)
           beginHolder: '開始時間',
           endHolder: '結束時間'
         },
-        dCalendar: {
+        mCalendar: {
           mini: ['日', '一', '二', '三', '四', '五', '六'],
           short: ['週日', '週一', '週二', '週三', '週四', '週五', '週六'],
           long: ['禮拜日', '禮拜一', '禮拜二', '禮拜三', '禮拜四', '禮拜五', '禮拜六']
@@ -176,7 +190,7 @@ createApp(App)
   .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>
@@ -895,7 +921,6 @@ actionCol: {
   type: Object,
   default(props) {
     return {
-      title: props.actionText,
       slot: 'action',
       width: props.actionWidth,
       align: props.actionAlign,

package/dist/index.d.ts

@@ -90,10 +90,7 @@ modelValue: PropType<CheckValue>;
 /**
 * 全选框显示文本，默认“全选”
 */
-title: {
-type: StringConstructor;
-default(): string;
-};
+title: StringConstructor;
 /**
 * 选项数组，数组成员可以是数组或对象
 */
@@ -140,10 +137,7 @@ modelValue: PropType<CheckValue>;
 /**
 * 全选框显示文本，默认“全选”
 */
-title: {
-type: StringConstructor;
-default(): string;
-};
+title: StringConstructor;
 /**
 * 选项数组，数组成员可以是数组或对象
 */
@@ -187,7 +181,6 @@ all: BooleanConstructor;
 [x: `on${Capitalize<any>}`]: ((...args: any) => any) | undefined;
 }>, {
 all: boolean;
-title: string;
 hideAll: boolean;
 list: Obj[];
 valueKey: string | number;
@@ -699,17 +692,11 @@ maxClass: (ArrayConstructor | StringConstructor | ObjectConstructor)[];
 /**
 * 最小值占位文本
 */
-minHolder: {
-type: StringConstructor;
-default(): string;
-};
+minHolder: StringConstructor;
 /**
 * 最大值占位文本
 */
-maxHolder: {
-type: StringConstructor;
-default(): string;
-};
+maxHolder: StringConstructor;
 controlsOutside: BooleanConstructor;
 step: NumberConstructor;
 readonly: BooleanConstructor;
@@ -798,17 +785,11 @@ maxClass: (ArrayConstructor | StringConstructor | ObjectConstructor)[];
 /**
 * 最小值占位文本
 */
-minHolder: {
-type: StringConstructor;
-default(): string;
-};
+minHolder: StringConstructor;
 /**
 * 最大值占位文本
 */
-maxHolder: {
-type: StringConstructor;
-default(): string;
-};
+maxHolder: StringConstructor;
 controlsOutside: BooleanConstructor;
 step: NumberConstructor;
 readonly: BooleanConstructor;
@@ -858,8 +839,6 @@ controlsOutside: boolean;
 hideJoiner: boolean;
 begin: CountValue;
 end: CountValue;
-minHolder: string;
-maxHolder: string;
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, HTMLDivElement>;
 
 export declare type CountValue = number | null | undefined;
@@ -908,17 +887,13 @@ actionFixed: StringConstructor;
 /**
 * 控制列表头文本
 */
-actionText: {
-type: StringConstructor;
-default(): string;
-};
+actionText: StringConstructor;
 /**
 * 右侧控制列
 */
 actionCol: {
 type: ObjectConstructor;
 default(props: Obj): {
-title: any;
 slot: string;
 width: any;
 align: any;
@@ -975,10 +950,7 @@ delBtn: {
 type: ObjectConstructor;
 default: () => {};
 };
-addText: {
-type: StringConstructor;
-default(): string;
-};
+addText: StringConstructor;
 /**
 * 是否隐藏每行的删除按钮，通过函数返回值决定
 */
@@ -1039,17 +1011,13 @@ actionFixed: StringConstructor;
 /**
 * 控制列表头文本
 */
-actionText: {
-type: StringConstructor;
-default(): string;
-};
+actionText: StringConstructor;
 /**
 * 右侧控制列
 */
 actionCol: {
 type: ObjectConstructor;
 default(props: Obj): {
-title: any;
 slot: string;
 width: any;
 align: any;
@@ -1106,10 +1074,7 @@ delBtn: {
 type: ObjectConstructor;
 default: () => {};
 };
-addText: {
-type: StringConstructor;
-default(): string;
-};
+addText: StringConstructor;
 /**
 * 是否隐藏每行的删除按钮，通过函数返回值决定
 */
@@ -1134,7 +1099,6 @@ columns: Obj[];
 addable: boolean;
 actionWidth: number;
 actionAlign: string;
-actionText: string;
 actionCol: Record<string, any>;
 addRow: Function;
 addBtnType: string;
@@ -1145,7 +1109,6 @@ delBtnType: string;
 delBtnSize: string;
 delBtnGhost: boolean;
 delBtn: Record<string, any>;
-addText: string;
 delBtnDisabled: Function;
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, HTMLDivElement>, Partial<Record<any, (_: any) => any>> & {
     moreAction?(_: {
@@ -1206,17 +1169,11 @@ endClass: (ArrayConstructor | StringConstructor | ObjectConstructor)[];
 /**
 * 开始时间placeholder
 */
-beginHolder: {
-type: StringConstructor;
-default(): string;
-};
+beginHolder: StringConstructor;
 /**
 * 结束时间placeholder
 */
-endHolder: {
-type: StringConstructor;
-default(): string;
-};
+endHolder: StringConstructor;
 /**
 * 一次性传给开始组件的prop
 */
@@ -1299,17 +1256,11 @@ endClass: (ArrayConstructor | StringConstructor | ObjectConstructor)[];
 /**
 * 开始时间placeholder
 */
-beginHolder: {
-type: StringConstructor;
-default(): string;
-};
+beginHolder: StringConstructor;
 /**
 * 结束时间placeholder
 */
-endHolder: {
-type: StringConstructor;
-default(): string;
-};
+endHolder: StringConstructor;
 /**
 * 一次性传给开始组件的prop
 */
@@ -1353,8 +1304,6 @@ endDisabled: boolean;
 disableToday: boolean;
 autoNext: boolean;
 limitBegin: boolean;
-beginHolder: string;
-endHolder: string;
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, HTMLDivElement>;
 
 export declare const DateRangePicker: DefineComponent<ExtractPropTypes<    {
@@ -1741,17 +1690,11 @@ modelValue: BooleanConstructor;
 /**
 * 确定按钮文本
 */
-okText: {
-type: StringConstructor;
-default(): string;
-};
+okText: StringConstructor;
 /**
 * 取消按钮文本
 */
-cancelText: {
-type: StringConstructor;
-default(): string;
-};
+cancelText: StringConstructor;
 /**
 * 传递给确定按钮的props
 */
@@ -1803,17 +1746,11 @@ modelValue: BooleanConstructor;
 /**
 * 确定按钮文本
 */
-okText: {
-type: StringConstructor;
-default(): string;
-};
+okText: StringConstructor;
 /**
 * 取消按钮文本
 */
-cancelText: {
-type: StringConstructor;
-default(): string;
-};
+cancelText: StringConstructor;
 /**
 * 传递给确定按钮的props
 */
@@ -1867,8 +1804,6 @@ okDisabled: boolean;
 cancelLoading: boolean;
 cancelDisabled: boolean;
 rightCancel: boolean;
-okText: string;
-cancelText: string;
 cancelType: string;
 hasOk: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>, {
@@ -2007,10 +1942,7 @@ pure: BooleanConstructor;
 /**
 * head title
 */
-title: {
-type: StringConstructor;
-default(): string;
-};
+title: StringConstructor;
 /**
 * 是否显示header
 */
@@ -2184,10 +2116,7 @@ pure: BooleanConstructor;
 /**
 * head title
 */
-title: {
-type: StringConstructor;
-default(): string;
-};
+title: StringConstructor;
 /**
 * 是否显示header
 */
@@ -2218,7 +2147,6 @@ onLoad?: ((res: any) => any) | undefined;
 onReload?: (() => any) | undefined;
 "onChange-col"?: ((val: Obj | Obj[]) => any) | undefined;
 }>, {
-title: string;
 transfer: boolean;
 modelValue: Obj[];
 border: boolean;
@@ -2469,10 +2397,7 @@ export declare const ToggleColumn: __VLS_WithTemplateSlots_10<DefineComponent<Ex
 modelValue: {
 type: ArrayConstructor;
 };
-title: {
-type: StringConstructor;
-default(): string;
-};
+title: StringConstructor;
 /**
 * 仅显示图标
 */
@@ -2504,10 +2429,7 @@ change: (val: Obj | Obj[]) => any;
 modelValue: {
 type: ArrayConstructor;
 };
-title: {
-type: StringConstructor;
-default(): string;
-};
+title: StringConstructor;
 /**
 * 仅显示图标
 */
@@ -2537,7 +2459,6 @@ storeAt: StringConstructor;
 onChange?: ((val: Obj | Obj[]) => any) | undefined;
 }>, {
 all: boolean;
-title: string;
 transfer: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>, {
     default?(_: {}): any;