snail.vue 1.0.48 → 1.0.50

package/.code-snippets

@@ -39,5 +39,11 @@
 		"scope": "html",
 		"description": "公共类样式：提示文本",
 		"body": "class=\"text-tips\"",
+	},
+	".placeholder":{
+		"prefix": ".placeholder",
+		"scope": "html",
+		"description": "placeholder,针对div、span元素，设置placeholder样式",
+		"body": "placeholder",
 	}
 }

package/dist/snail.vue.d.ts

@@ -96,6 +96,17 @@ type DisabledOptions = {
      */
     disabled?: boolean;
 };
+/**
+ * 值 配置选项
+ */
+type ValueOptions<T> = {
+    /**
+     * 已有值
+     * - 用于渲染组件时，传入已有数据；
+     * - 具体传值规则，有组件自己决定
+     */
+    value?: T;
+};
 /**
  * 确认区域 配置选项
  * - 约束 确认区域 的 确定、取消 按钮
@@ -450,6 +461,13 @@ interface ITreeBaseContext<T> {
      * @returns 从【顶级节点】->【指定节点】的全路径数据
      */
     getPath(node: TreeNode<T, TreeNodeExtend>): TreeNode<T, TreeNodeExtend>[];
+    /**
+     * 获取指定【树节点】的唯一Key值
+     * - 相同节点确保唯一，且不变；用于唯一标记此节点
+     * @param node
+     * @returns 返回节点唯一Key值
+     */
+    getKey(node: TreeNode<T>): string;
 }
 /**
  * 树搜索结果
@@ -777,6 +795,12 @@ type SelectBaseOptions<T> = {
      * - 仅针对【单选模式】生效
      */
     showPath?: boolean;
+    /**
+     * 是否显示【清空已选】按钮
+     * - true：则在弹窗的底部显示【清空已选】按钮，点击时清空所有已选选项
+     * - 若存在多级选项，仅在第一级弹窗中显示
+     */
+    showClear?: boolean;
     /**
      * 选择项 follow弹窗样式
      * - 支持指定弹窗高度，如最大高度，不指定则默认尽可能展示全
@@ -789,7 +813,7 @@ type SelectBaseOptions<T> = {
 type SelectBaseEvents<T> = {
     /**
      * 选中的【选择项】改变时
-     * - @param values 已选的【选择项】：多级单选时，为【选择项】路径（父->子）；其他情况为已选的【选择项】
+     * - @param values 已选的【选择项】，未选中则为空数组：单选时，为【选择项】路径（父->子）；其他情况为已选的【选择项】
      */
     change: [values: SelectItem<T>[]];
 };
@@ -806,8 +830,9 @@ type SelectItem<T> = TreeNode<T, TreeNodeExtend & {
 }>;
 /**
  * 选项菜单组件 配置选项
+ * - value 已选的【选择项】;单选时，为【选择项】路径（父->子）；其他情况为已选的【选择项】
  */
-type SelectOptions<T> = ReadonlyOptions & PlaceholderOptions & SelectBaseOptions<T> & {};
+type SelectOptions<T> = ReadonlyOptions & PlaceholderOptions & SelectBaseOptions<T> & ValueOptions<SelectItem<T>[]> & {};
 /**
  * 选项菜单 组件 事件
  */
@@ -862,6 +887,20 @@ type SelectPopupOptions<T> = SelectBaseOptions<T> & {
      */
     level: number;
 };
+/**
+ * 【选项菜单】 弹窗组件事件
+ */
+type SelectPopupEvents<T> = {
+    /**
+     * 清空选项
+     */
+    clear: [];
+    /**
+     * 选项点击事件
+     * @param path 选中的【选择项】路径；父->子
+     */
+    click: [path: SelectItem<T>[]];
+};
 /**
  * 【选项菜单】 弹窗组件扩展
  */
@@ -939,6 +978,18 @@ type IconOptions = TitleOptions & {
      * 图标大小：默认24
      */
     size?: number;
+    /**
+     * 轮廓描边颜色
+     * - 配合 strokeWidth 使用，完成图标加粗效果等
+     * @see https://developer.mozilla.org/zh-CN/docs/Web/SVG/Reference/Attribute/stroke
+     */
+    stroke?: string;
+    /**
+     * 轮廓宽度
+     * - 配合 stroke 使用，完成图标加粗效果等
+     * @see https://developer.mozilla.org/zh-CN/docs/Web/SVG/Reference/Attribute/stroke-width
+     */
+    strokeWidth?: number;
     /**
      * 图标绘制路径
      * - 等效 svg-path的d属性
@@ -968,10 +1019,12 @@ type IconOptions = TitleOptions & {
  * - 指向类：
  * - - arrow        向右箭头
  * - 其他类：
+ * - - plus         加号
+ * - - subtract     减号
  * - - grip         紧握图标，垂直方向，一般用于拖动句柄
  * - - custom       自定义图标：此时IconOptions.draw属性传入绘制路径
  */
-type IconType = "success" | "error" | "warn" | "close" | "trash" | "download" | "print" | "edit" | "arrow" | "grip" | "custom";
+type IconType = "success" | "error" | "warn" | "close" | "trash" | "download" | "print" | "edit" | "arrow" | "plus" | "subtract" | "grip" | "custom";
 
 /**
  * 检查选项 数据结构
@@ -1231,11 +1284,11 @@ declare function triggerAppCreated(app: App, type?: AppType): App;
 
 /**
  * 基于类型获取Svg图标绘制路径
- * @param type 图标类型
- * @param color 填充颜色，不传入则使用默认的
+ * @param iconType 图标类型
+ * @param draw 绘制路径；自定义时生效
  * @returns 图标路径
  */
-declare function getSvgDraw(options: IconOptions): string[];
+declare function getSvgDraw(iconType: IconType, draw: string[] | string): string[];
 
 /**
  * 排序组件 配置选项
@@ -1862,14 +1915,10 @@ declare const components: {
         "onUpdate:modelValue"?: (value: string) => any;
     }>, {}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
     Select: {
-        new (...args: any[]): vue.CreateComponentPublicInstanceWithMixins<Readonly<ReadonlyOptions & PlaceholderOptions & SelectBaseOptions<any> & {
-            modelValue?: SelectItem<any>[];
-        }> & Readonly<{
+        new (...args: any[]): vue.CreateComponentPublicInstanceWithMixins<Readonly<SelectOptions<any>> & Readonly<{
             onChange?: (values: SelectItem<any>[]) => any;
-            "onUpdate:modelValue"?: (value: SelectItem<any>[]) => any;
         }>, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
             change: (values: SelectItem<any>[]) => any;
-            "update:modelValue": (value: SelectItem<any>[]) => any;
         }, vue.PublicProps, {}, false, {}, {}, vue.GlobalComponents, vue.GlobalDirectives, string, {}, any, vue.ComponentProvideOptions, {
             P: {};
             B: {};
@@ -1877,23 +1926,16 @@ declare const components: {
             C: {};
             M: {};
             Defaults: {};
-        }, Readonly<ReadonlyOptions & PlaceholderOptions & SelectBaseOptions<any> & {
-            modelValue?: SelectItem<any>[];
-        }> & Readonly<{
+        }, Readonly<SelectOptions<any>> & Readonly<{
             onChange?: (values: SelectItem<any>[]) => any;
-            "onUpdate:modelValue"?: (value: SelectItem<any>[]) => any;
         }>, {}, {}, {}, {}, {}>;
         __isFragment?: never;
         __isTeleport?: never;
         __isSuspense?: never;
-    } & vue.ComponentOptionsBase<Readonly<ReadonlyOptions & PlaceholderOptions & SelectBaseOptions<any> & {
-        modelValue?: SelectItem<any>[];
-    }> & Readonly<{
+    } & vue.ComponentOptionsBase<Readonly<SelectOptions<any>> & Readonly<{
         onChange?: (values: SelectItem<any>[]) => any;
-        "onUpdate:modelValue"?: (value: SelectItem<any>[]) => any;
     }>, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
         change: (values: SelectItem<any>[]) => any;
-        "update:modelValue": (value: SelectItem<any>[]) => any;
     }, string, {}, {}, string, {}, vue.GlobalComponents, vue.GlobalDirectives, string, vue.ComponentProvideOptions> & vue.VNodeProps & vue.AllowedComponentProps & vue.ComponentCustomProps & (new () => {
         $slots: {
             default?: (props: {
@@ -2321,4 +2363,4 @@ declare const components: {
 };
 
 export { components, getSvgDraw, mount, onAppCreated, triggerAppCreated, usePopup, useReactive, useTreeContext };
-export type { ButtonOptions, ChangeEvents, ChooseEvents, ChooseItem, ChooseOptions, ClickEvents, CloseEvents, ComponentBindOptions, ComponentOptions, ConfirmAreaOptions, ConfirmOptions, DeleteEvents, DialogHandle, DialogOptions, DisabledOptions, DragVerifyInfo, DragVerifyOptions, EmptyOptions, EventsType, FoldEvents, FoldOptions, FoldStatus, FollowElectResult, FollowExtend, FollowHandle, FollowOptions, FollowStrategy, FollowStrategyOptions, FooterEvents, FooterOptions, HeaderEvents, HeaderOptions, IPopupManager, IReactiveManager, ISelectContext, ITreeBaseContext, IconOptions, IconType, InputEvents, InputOptions, LayoutOptions, LoadingOptions, MessageOptions, MoveEvents, PlaceholderOptions, PopupDescriptor, PopupHandle, PopupOptions, PopupStatus, PopupStatusOptions, PropsType, ReactiveVar, ReadonlyOptions, ScrollEvents, ScrollOptions, ScrollStatus, SearchEvents, SearchOptions, SelectBaseEvents, SelectBaseOptions, SelectEvents, SelectItem, SelectNodeEvents, SelectNodeOptions, SelectOptions, SelectPopupExtend, SelectPopupOptions, SelectSlotOptions, SortEvents, SortOptions, SwitchEvents, SwitchOptions, TableColOptions, TableOptions, TableRowOptions, TitleOptions, ToastOptions, TreeEvents, TreeNode, TreeNodeEvents, TreeNodeExtend, TreeNodeModel, TreeNodeOptions, TreeNodeRenderOptions, TreeNodeSlotOptions, TreeOptions, TreeSearchResult, WrapperEvents, WrapperOptions };
+export type { ButtonOptions, ChangeEvents, ChooseEvents, ChooseItem, ChooseOptions, ClickEvents, CloseEvents, ComponentBindOptions, ComponentOptions, ConfirmAreaOptions, ConfirmOptions, DeleteEvents, DialogHandle, DialogOptions, DisabledOptions, DragVerifyInfo, DragVerifyOptions, EmptyOptions, EventsType, FoldEvents, FoldOptions, FoldStatus, FollowElectResult, FollowExtend, FollowHandle, FollowOptions, FollowStrategy, FollowStrategyOptions, FooterEvents, FooterOptions, HeaderEvents, HeaderOptions, IPopupManager, IReactiveManager, ISelectContext, ITreeBaseContext, IconOptions, IconType, InputEvents, InputOptions, LayoutOptions, LoadingOptions, MessageOptions, MoveEvents, PlaceholderOptions, PopupDescriptor, PopupHandle, PopupOptions, PopupStatus, PopupStatusOptions, PropsType, ReactiveVar, ReadonlyOptions, ScrollEvents, ScrollOptions, ScrollStatus, SearchEvents, SearchOptions, SelectBaseEvents, SelectBaseOptions, SelectEvents, SelectItem, SelectNodeEvents, SelectNodeOptions, SelectOptions, SelectPopupEvents, SelectPopupExtend, SelectPopupOptions, SelectSlotOptions, SortEvents, SortOptions, SwitchEvents, SwitchOptions, TableColOptions, TableOptions, TableRowOptions, TitleOptions, ToastOptions, TreeEvents, TreeNode, TreeNodeEvents, TreeNodeExtend, TreeNodeModel, TreeNodeOptions, TreeNodeRenderOptions, TreeNodeSlotOptions, TreeOptions, TreeSearchResult, ValueOptions, WrapperEvents, WrapperOptions };