@element-plus/nightly 0.0.20240228 → 0.0.20240301

package/es/components/switch/src/switch2.mjs

@@ -1,90 +1,242 @@
+import { defineComponent, computed, ref, watch, nextTick, onMounted, openBlock, createElementBlock, normalizeClass, unref, withModifiers, createElementVNode, withKeys, createBlock, withCtx, resolveDynamicComponent, createCommentVNode, toDisplayString, normalizeStyle, createVNode, renderSlot } from 'vue';
+import { isPromise } from '@vue/shared';
 import '../../../utils/index.mjs';
+import { ElIcon } from '../../icon/index.mjs';
+import '../../form/index.mjs';
+import { Loading } from '@element-plus/icons-vue';
 import '../../../constants/index.mjs';
-import { buildProps, definePropType } from '../../../utils/vue/props/runtime.mjs';
-import { isValidComponentSize } from '../../../utils/vue/validator.mjs';
-import { iconPropType } from '../../../utils/vue/icon.mjs';
+import '../../../hooks/index.mjs';
+import { switchProps, switchEmits } from './switch.mjs';
+import _export_sfc from '../../../_virtual/plugin-vue_export-helper.mjs';
+import { useFormItem, useFormItemInputId } from '../../form/src/hooks/use-form-item.mjs';
+import { useFormSize, useFormDisabled } from '../../form/src/hooks/use-form-common-props.mjs';
+import { useNamespace } from '../../../hooks/use-namespace/index.mjs';
+import { addUnit } from '../../../utils/dom/style.mjs';
 import { UPDATE_MODEL_EVENT, CHANGE_EVENT, INPUT_EVENT } from '../../../constants/event.mjs';
-import { isBoolean, isNumber } from '../../../utils/types.mjs';
-import { isString } from '@vue/shared';
+import { debugWarn, throwError } from '../../../utils/error.mjs';
+import { isBoolean } from '../../../utils/types.mjs';
 
-const switchProps = buildProps({
-  modelValue: {
-    type: [Boolean, String, Number],
-    default: false
-  },
-  disabled: {
-    type: Boolean,
-    default: false
-  },
-  loading: {
-    type: Boolean,
-    default: false
-  },
-  size: {
-    type: String,
-    validator: isValidComponentSize
-  },
-  width: {
-    type: [String, Number],
-    default: ""
-  },
-  inlinePrompt: {
-    type: Boolean,
-    default: false
-  },
-  inactiveActionIcon: {
-    type: iconPropType
-  },
-  activeActionIcon: {
-    type: iconPropType
-  },
-  activeIcon: {
-    type: iconPropType
-  },
-  inactiveIcon: {
-    type: iconPropType
-  },
-  activeText: {
-    type: String,
-    default: ""
-  },
-  inactiveText: {
-    type: String,
-    default: ""
-  },
-  activeValue: {
-    type: [Boolean, String, Number],
-    default: true
-  },
-  inactiveValue: {
-    type: [Boolean, String, Number],
-    default: false
-  },
-  name: {
-    type: String,
-    default: ""
-  },
-  validateEvent: {
-    type: Boolean,
-    default: true
-  },
-  beforeChange: {
-    type: definePropType(Function)
-  },
-  id: String,
-  tabindex: {
-    type: [String, Number]
-  },
-  label: {
-    type: String,
-    default: void 0
+const _hoisted_1 = ["onClick"];
+const _hoisted_2 = ["id", "aria-checked", "aria-disabled", "aria-label", "name", "true-value", "false-value", "disabled", "tabindex", "onKeydown"];
+const _hoisted_3 = ["aria-hidden"];
+const _hoisted_4 = ["aria-hidden"];
+const _hoisted_5 = ["aria-hidden"];
+const COMPONENT_NAME = "ElSwitch";
+const __default__ = defineComponent({
+  name: COMPONENT_NAME
+});
+const _sfc_main = /* @__PURE__ */ defineComponent({
+  ...__default__,
+  props: switchProps,
+  emits: switchEmits,
+  setup(__props, { expose, emit }) {
+    const props = __props;
+    const { formItem } = useFormItem();
+    const switchSize = useFormSize();
+    const ns = useNamespace("switch");
+    const { inputId } = useFormItemInputId(props, {
+      formItemContext: formItem
+    });
+    const switchDisabled = useFormDisabled(computed(() => props.loading));
+    const isControlled = ref(props.modelValue !== false);
+    const input = ref();
+    const core = ref();
+    const switchKls = computed(() => [
+      ns.b(),
+      ns.m(switchSize.value),
+      ns.is("disabled", switchDisabled.value),
+      ns.is("checked", checked.value)
+    ]);
+    const labelLeftKls = computed(() => [
+      ns.e("label"),
+      ns.em("label", "left"),
+      ns.is("active", !checked.value)
+    ]);
+    const labelRightKls = computed(() => [
+      ns.e("label"),
+      ns.em("label", "right"),
+      ns.is("active", checked.value)
+    ]);
+    const coreStyle = computed(() => ({
+      width: addUnit(props.width)
+    }));
+    watch(() => props.modelValue, () => {
+      isControlled.value = true;
+    });
+    const actualValue = computed(() => {
+      return isControlled.value ? props.modelValue : false;
+    });
+    const checked = computed(() => actualValue.value === props.activeValue);
+    if (![props.activeValue, props.inactiveValue].includes(actualValue.value)) {
+      emit(UPDATE_MODEL_EVENT, props.inactiveValue);
+      emit(CHANGE_EVENT, props.inactiveValue);
+      emit(INPUT_EVENT, props.inactiveValue);
+    }
+    watch(checked, (val) => {
+      var _a;
+      input.value.checked = val;
+      if (props.validateEvent) {
+        (_a = formItem == null ? void 0 : formItem.validate) == null ? void 0 : _a.call(formItem, "change").catch((err) => debugWarn(err));
+      }
+    });
+    const handleChange = () => {
+      const val = checked.value ? props.inactiveValue : props.activeValue;
+      emit(UPDATE_MODEL_EVENT, val);
+      emit(CHANGE_EVENT, val);
+      emit(INPUT_EVENT, val);
+      nextTick(() => {
+        input.value.checked = checked.value;
+      });
+    };
+    const switchValue = () => {
+      if (switchDisabled.value)
+        return;
+      const { beforeChange } = props;
+      if (!beforeChange) {
+        handleChange();
+        return;
+      }
+      const shouldChange = beforeChange();
+      const isPromiseOrBool = [
+        isPromise(shouldChange),
+        isBoolean(shouldChange)
+      ].includes(true);
+      if (!isPromiseOrBool) {
+        throwError(COMPONENT_NAME, "beforeChange must return type `Promise<boolean>` or `boolean`");
+      }
+      if (isPromise(shouldChange)) {
+        shouldChange.then((result) => {
+          if (result) {
+            handleChange();
+          }
+        }).catch((e) => {
+          debugWarn(COMPONENT_NAME, `some error occurred: ${e}`);
+        });
+      } else if (shouldChange) {
+        handleChange();
+      }
+    };
+    const focus = () => {
+      var _a, _b;
+      (_b = (_a = input.value) == null ? void 0 : _a.focus) == null ? void 0 : _b.call(_a);
+    };
+    onMounted(() => {
+      input.value.checked = checked.value;
+    });
+    expose({
+      focus,
+      checked
+    });
+    return (_ctx, _cache) => {
+      return openBlock(), createElementBlock("div", {
+        class: normalizeClass(unref(switchKls)),
+        onClick: withModifiers(switchValue, ["prevent"])
+      }, [
+        createElementVNode("input", {
+          id: unref(inputId),
+          ref_key: "input",
+          ref: input,
+          class: normalizeClass(unref(ns).e("input")),
+          type: "checkbox",
+          role: "switch",
+          "aria-checked": unref(checked),
+          "aria-disabled": unref(switchDisabled),
+          "aria-label": _ctx.label,
+          name: _ctx.name,
+          "true-value": _ctx.activeValue,
+          "false-value": _ctx.inactiveValue,
+          disabled: unref(switchDisabled),
+          tabindex: _ctx.tabindex,
+          onChange: handleChange,
+          onKeydown: withKeys(switchValue, ["enter"])
+        }, null, 42, _hoisted_2),
+        !_ctx.inlinePrompt && (_ctx.inactiveIcon || _ctx.inactiveText) ? (openBlock(), createElementBlock("span", {
+          key: 0,
+          class: normalizeClass(unref(labelLeftKls))
+        }, [
+          _ctx.inactiveIcon ? (openBlock(), createBlock(unref(ElIcon), { key: 0 }, {
+            default: withCtx(() => [
+              (openBlock(), createBlock(resolveDynamicComponent(_ctx.inactiveIcon)))
+            ]),
+            _: 1
+          })) : createCommentVNode("v-if", true),
+          !_ctx.inactiveIcon && _ctx.inactiveText ? (openBlock(), createElementBlock("span", {
+            key: 1,
+            "aria-hidden": unref(checked)
+          }, toDisplayString(_ctx.inactiveText), 9, _hoisted_3)) : createCommentVNode("v-if", true)
+        ], 2)) : createCommentVNode("v-if", true),
+        createElementVNode("span", {
+          ref_key: "core",
+          ref: core,
+          class: normalizeClass(unref(ns).e("core")),
+          style: normalizeStyle(unref(coreStyle))
+        }, [
+          _ctx.inlinePrompt ? (openBlock(), createElementBlock("div", {
+            key: 0,
+            class: normalizeClass(unref(ns).e("inner"))
+          }, [
+            _ctx.activeIcon || _ctx.inactiveIcon ? (openBlock(), createBlock(unref(ElIcon), {
+              key: 0,
+              class: normalizeClass(unref(ns).is("icon"))
+            }, {
+              default: withCtx(() => [
+                (openBlock(), createBlock(resolveDynamicComponent(unref(checked) ? _ctx.activeIcon : _ctx.inactiveIcon)))
+              ]),
+              _: 1
+            }, 8, ["class"])) : _ctx.activeText || _ctx.inactiveText ? (openBlock(), createElementBlock("span", {
+              key: 1,
+              class: normalizeClass(unref(ns).is("text")),
+              "aria-hidden": !unref(checked)
+            }, toDisplayString(unref(checked) ? _ctx.activeText : _ctx.inactiveText), 11, _hoisted_4)) : createCommentVNode("v-if", true)
+          ], 2)) : createCommentVNode("v-if", true),
+          createElementVNode("div", {
+            class: normalizeClass(unref(ns).e("action"))
+          }, [
+            _ctx.loading ? (openBlock(), createBlock(unref(ElIcon), {
+              key: 0,
+              class: normalizeClass(unref(ns).is("loading"))
+            }, {
+              default: withCtx(() => [
+                createVNode(unref(Loading))
+              ]),
+              _: 1
+            }, 8, ["class"])) : unref(checked) ? renderSlot(_ctx.$slots, "active-action", { key: 1 }, () => [
+              _ctx.activeActionIcon ? (openBlock(), createBlock(unref(ElIcon), { key: 0 }, {
+                default: withCtx(() => [
+                  (openBlock(), createBlock(resolveDynamicComponent(_ctx.activeActionIcon)))
+                ]),
+                _: 1
+              })) : createCommentVNode("v-if", true)
+            ]) : !unref(checked) ? renderSlot(_ctx.$slots, "inactive-action", { key: 2 }, () => [
+              _ctx.inactiveActionIcon ? (openBlock(), createBlock(unref(ElIcon), { key: 0 }, {
+                default: withCtx(() => [
+                  (openBlock(), createBlock(resolveDynamicComponent(_ctx.inactiveActionIcon)))
+                ]),
+                _: 1
+              })) : createCommentVNode("v-if", true)
+            ]) : createCommentVNode("v-if", true)
+          ], 2)
+        ], 6),
+        !_ctx.inlinePrompt && (_ctx.activeIcon || _ctx.activeText) ? (openBlock(), createElementBlock("span", {
+          key: 1,
+          class: normalizeClass(unref(labelRightKls))
+        }, [
+          _ctx.activeIcon ? (openBlock(), createBlock(unref(ElIcon), { key: 0 }, {
+            default: withCtx(() => [
+              (openBlock(), createBlock(resolveDynamicComponent(_ctx.activeIcon)))
+            ]),
+            _: 1
+          })) : createCommentVNode("v-if", true),
+          !_ctx.activeIcon && _ctx.activeText ? (openBlock(), createElementBlock("span", {
+            key: 1,
+            "aria-hidden": !unref(checked)
+          }, toDisplayString(_ctx.activeText), 9, _hoisted_5)) : createCommentVNode("v-if", true)
+        ], 2)) : createCommentVNode("v-if", true)
+      ], 10, _hoisted_1);
+    };
   }
 });
-const switchEmits = {
-  [UPDATE_MODEL_EVENT]: (val) => isBoolean(val) || isString(val) || isNumber(val),
-  [CHANGE_EVENT]: (val) => isBoolean(val) || isString(val) || isNumber(val),
-  [INPUT_EVENT]: (val) => isBoolean(val) || isString(val) || isNumber(val)
-};
+var Switch = /* @__PURE__ */ _export_sfc(_sfc_main, [["__file", "switch.vue"]]);
 
-export { switchEmits, switchProps };
+export { Switch as default };
 //# sourceMappingURL=switch2.mjs.map

package/es/components/switch/src/switch2.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"switch2.mjs","sources":["../../../../../../packages/components/switch/src/switch.ts"],"sourcesContent":["import {\n  buildProps,\n  definePropType,\n  iconPropType,\n  isBoolean,\n  isNumber,\n  isString,\n  isValidComponentSize,\n} from '@element-plus/utils'\nimport {\n  CHANGE_EVENT,\n  INPUT_EVENT,\n  UPDATE_MODEL_EVENT,\n} from '@element-plus/constants'\nimport type { ComponentSize } from '@element-plus/constants'\nimport type Switch from './switch.vue'\nimport type { ExtractPropTypes, PropType } from 'vue'\n\nexport const switchProps = buildProps({\n  /**\n   * @description binding value, it should be equivalent to either `active-value` or `inactive-value`, by default it's `boolean` type\n   */\n  modelValue: {\n    type: [Boolean, String, Number],\n    default: false,\n  },\n  /**\n   * @description whether Switch is disabled\n   */\n  disabled: {\n    type: Boolean,\n    default: false,\n  },\n  /**\n   * @description whether Switch is in loading state\n   */\n  loading: {\n    type: Boolean,\n    default: false,\n  },\n  /**\n   * @description size of Switch\n   */\n  size: {\n    type: String as PropType<ComponentSize>,\n    validator: isValidComponentSize,\n  },\n  /**\n   * @description width of Switch\n   */\n  width: {\n    type: [String, Number],\n    default: '',\n  },\n  /**\n   * @description whether icon or text is displayed inside dot, only the first character will be rendered for text\n   */\n  inlinePrompt: {\n    type: Boolean,\n    default: false,\n  },\n  /**\n   * @description component of the icon displayed in action when in `off` state\n   */\n  inactiveActionIcon: {\n    type: iconPropType,\n  },\n  /**\n   * @description component of the icon displayed in action when in `on` state\n   */\n  activeActionIcon: {\n    type: iconPropType,\n  },\n  /**\n   * @description component of the icon displayed when in `on` state, overrides `active-text`\n   */\n  activeIcon: {\n    type: iconPropType,\n  },\n  /**\n   * @description component of the icon displayed when in `off` state, overrides `inactive-text`\n   */\n  inactiveIcon: {\n    type: iconPropType,\n  },\n  /**\n   * @description text displayed when in `on` state\n   */\n  activeText: {\n    type: String,\n    default: '',\n  },\n  /**\n   * @description text displayed when in `off` state\n   */\n  inactiveText: {\n    type: String,\n    default: '',\n  },\n  /**\n   * @description switch value when in `on` state\n   */\n  activeValue: {\n    type: [Boolean, String, Number],\n    default: true,\n  },\n  /**\n   * @description switch value when in `off` state\n   */\n  inactiveValue: {\n    type: [Boolean, String, Number],\n    default: false,\n  },\n  /**\n   * @description input name of Switch\n   */\n  name: {\n    type: String,\n    default: '',\n  },\n  /**\n   * @description whether to trigger form validation\n   */\n  validateEvent: {\n    type: Boolean,\n    default: true,\n  },\n  /**\n   * @description before-change hook before the switch state changes. If `false` is returned or a `Promise` is returned and then is rejected, will stop switching\n   */\n  beforeChange: {\n    type: definePropType<() => Promise<boolean> | boolean>(Function),\n  },\n  /**\n   * @description id for input\n   */\n  id: String,\n  /**\n   * @description tabindex for input\n   */\n  tabindex: {\n    type: [String, Number],\n  },\n  /**\n   * @description native input aria-label\n   */\n  label: {\n    type: String,\n    default: undefined,\n  },\n} as const)\n\nexport type SwitchProps = ExtractPropTypes<typeof switchProps>\n\nexport const switchEmits = {\n  [UPDATE_MODEL_EVENT]: (val: boolean | string | number) =>\n    isBoolean(val) || isString(val) || isNumber(val),\n  [CHANGE_EVENT]: (val: boolean | string | number) =>\n    isBoolean(val) || isString(val) || isNumber(val),\n  [INPUT_EVENT]: (val: boolean | string | number) =>\n    isBoolean(val) || isString(val) || isNumber(val),\n}\nexport type SwitchEmits = typeof switchEmits\n\nexport type SwitchInstance = InstanceType<typeof Switch>\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"switch2.mjs","sources":["../../../../../../packages/components/switch/src/switch.vue"],"sourcesContent":["<template>\n  <div :class=\"switchKls\" @click.prevent=\"switchValue\">\n    <input\n      :id=\"inputId\"\n      ref=\"input\"\n      :class=\"ns.e('input')\"\n      type=\"checkbox\"\n      role=\"switch\"\n      :aria-checked=\"checked\"\n      :aria-disabled=\"switchDisabled\"\n      :aria-label=\"label\"\n      :name=\"name\"\n      :true-value=\"activeValue\"\n      :false-value=\"inactiveValue\"\n      :disabled=\"switchDisabled\"\n      :tabindex=\"tabindex\"\n      @change=\"handleChange\"\n      @keydown.enter=\"switchValue\"\n    />\n    <span\n      v-if=\"!inlinePrompt && (inactiveIcon || inactiveText)\"\n      :class=\"labelLeftKls\"\n    >\n      <el-icon v-if=\"inactiveIcon\">\n        <component :is=\"inactiveIcon\" />\n      </el-icon>\n      <span v-if=\"!inactiveIcon && inactiveText\" :aria-hidden=\"checked\">{{\n        inactiveText\n      }}</span>\n    </span>\n    <span ref=\"core\" :class=\"ns.e('core')\" :style=\"coreStyle\">\n      <div v-if=\"inlinePrompt\" :class=\"ns.e('inner')\">\n        <template v-if=\"activeIcon || inactiveIcon\">\n          <el-icon :class=\"ns.is('icon')\">\n            <component :is=\"checked ? activeIcon : inactiveIcon\" />\n          </el-icon>\n        </template>\n        <template v-else-if=\"activeText || inactiveText\">\n          <span :class=\"ns.is('text')\" :aria-hidden=\"!checked\">\n            {{ checked ? activeText : inactiveText }}\n          </span>\n        </template>\n      </div>\n      <div :class=\"ns.e('action')\">\n        <el-icon v-if=\"loading\" :class=\"ns.is('loading')\">\n          <loading />\n        </el-icon>\n        <slot v-else-if=\"checked\" name=\"active-action\">\n          <el-icon v-if=\"activeActionIcon\">\n            <component :is=\"activeActionIcon\" />\n          </el-icon>\n        </slot>\n        <slot v-else-if=\"!checked\" name=\"inactive-action\">\n          <el-icon v-if=\"inactiveActionIcon\">\n            <component :is=\"inactiveActionIcon\" />\n          </el-icon>\n        </slot>\n      </div>\n    </span>\n    <span\n      v-if=\"!inlinePrompt && (activeIcon || activeText)\"\n      :class=\"labelRightKls\"\n    >\n      <el-icon v-if=\"activeIcon\">\n        <component :is=\"activeIcon\" />\n      </el-icon>\n      <span v-if=\"!activeIcon && activeText\" :aria-hidden=\"!checked\">{{\n        activeText\n      }}</span>\n    </span>\n  </div>\n</template>\n\n<script lang=\"ts\" setup>\nimport { computed, nextTick, onMounted, ref, watch } from 'vue'\nimport { isPromise } from '@vue/shared'\nimport { addUnit, debugWarn, isBoolean, throwError } from '@element-plus/utils'\nimport ElIcon from '@element-plus/components/icon'\nimport {\n  useFormDisabled,\n  useFormItem,\n  useFormItemInputId,\n  useFormSize,\n} from '@element-plus/components/form'\nimport { Loading } from '@element-plus/icons-vue'\nimport {\n  CHANGE_EVENT,\n  INPUT_EVENT,\n  UPDATE_MODEL_EVENT,\n} from '@element-plus/constants'\nimport { useNamespace } from '@element-plus/hooks'\nimport { switchEmits, switchProps } from './switch'\nimport type { CSSProperties } from 'vue'\n\nconst COMPONENT_NAME = 'ElSwitch'\ndefineOptions({\n  name: COMPONENT_NAME,\n})\n\nconst props = defineProps(switchProps)\nconst emit = defineEmits(switchEmits)\n\nconst { formItem } = useFormItem()\nconst switchSize = useFormSize()\nconst ns = useNamespace('switch')\n\nconst { inputId } = useFormItemInputId(props, {\n  formItemContext: formItem,\n})\n\nconst switchDisabled = useFormDisabled(computed(() => props.loading))\nconst isControlled = ref(props.modelValue !== false)\nconst input = ref<HTMLInputElement>()\nconst core = ref<HTMLSpanElement>()\n\nconst switchKls = computed(() => [\n  ns.b(),\n  ns.m(switchSize.value),\n  ns.is('disabled', switchDisabled.value),\n  ns.is('checked', checked.value),\n])\n\nconst labelLeftKls = computed(() => [\n  ns.e('label'),\n  ns.em('label', 'left'),\n  ns.is('active', !checked.value),\n])\n\nconst labelRightKls = computed(() => [\n  ns.e('label'),\n  ns.em('label', 'right'),\n  ns.is('active', checked.value),\n])\n\nconst coreStyle = computed<CSSProperties>(() => ({\n  width: addUnit(props.width),\n}))\n\nwatch(\n  () => props.modelValue,\n  () => {\n    isControlled.value = true\n  }\n)\n\nconst actualValue = computed(() => {\n  return isControlled.value ? props.modelValue : false\n})\n\nconst checked = computed(() => actualValue.value === props.activeValue)\n\nif (![props.activeValue, props.inactiveValue].includes(actualValue.value)) {\n  emit(UPDATE_MODEL_EVENT, props.inactiveValue)\n  emit(CHANGE_EVENT, props.inactiveValue)\n  emit(INPUT_EVENT, props.inactiveValue)\n}\n\nwatch(checked, (val) => {\n  input.value!.checked = val\n\n  if (props.validateEvent) {\n    formItem?.validate?.('change').catch((err) => debugWarn(err))\n  }\n})\n\nconst handleChange = () => {\n  const val = checked.value ? props.inactiveValue : props.activeValue\n  emit(UPDATE_MODEL_EVENT, val)\n  emit(CHANGE_EVENT, val)\n  emit(INPUT_EVENT, val)\n  nextTick(() => {\n    input.value!.checked = checked.value\n  })\n}\n\nconst switchValue = () => {\n  if (switchDisabled.value) return\n\n  const { beforeChange } = props\n  if (!beforeChange) {\n    handleChange()\n    return\n  }\n\n  const shouldChange = beforeChange()\n\n  const isPromiseOrBool = [\n    isPromise(shouldChange),\n    isBoolean(shouldChange),\n  ].includes(true)\n  if (!isPromiseOrBool) {\n    throwError(\n      COMPONENT_NAME,\n      'beforeChange must return type `Promise<boolean>` or `boolean`'\n    )\n  }\n\n  if (isPromise(shouldChange)) {\n    shouldChange\n      .then((result) => {\n        if (result) {\n          handleChange()\n        }\n      })\n      .catch((e) => {\n        debugWarn(COMPONENT_NAME, `some error occurred: ${e}`)\n      })\n  } else if (shouldChange) {\n    handleChange()\n  }\n}\n\nconst focus = (): void => {\n  input.value?.focus?.()\n}\n\nonMounted(() => {\n  input.value!.checked = checked.value\n})\n\ndefineExpose({\n  /**\n   *  @description manual focus to the switch component\n   **/\n  focus,\n  /**\n   * @description whether Switch is checked\n   */\n  checked,\n})\n</script>\n"],"names":[],"mappings":"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"}

package/es/components/table/index.d.ts

@@ -85,10 +85,7 @@ export declare const ElTable: import("@element-plus/nightly/es/utils").SFCWithIn
         type: import("vue").PropType<"auto" | "fixed">;
         default: string;
     };
-    scrollbarAlwaysOn: {
-        type: BooleanConstructor;
-        default: boolean;
-    };
+    scrollbarAlwaysOn: BooleanConstructor;
     flexible: BooleanConstructor;
     showOverflowTooltip: import("vue").PropType<boolean | Partial<Pick<import("..").ElTooltipProps, "offset" | "effect" | "placement" | "popperClass" | "showAfter" | "hideAfter" | "popperOptions" | "enterable" | "appendTo" | "transition" | "showArrow">> | undefined>;
 }, {
@@ -265,10 +262,7 @@ export declare const ElTable: import("@element-plus/nightly/es/utils").SFCWithIn
         type: import("vue").PropType<"auto" | "fixed">;
         default: string;
     };
-    scrollbarAlwaysOn: {
-        type: BooleanConstructor;
-        default: boolean;
-    };
+    scrollbarAlwaysOn: BooleanConstructor;
     flexible: BooleanConstructor;
     showOverflowTooltip: import("vue").PropType<boolean | Partial<Pick<import("..").ElTooltipProps, "offset" | "effect" | "placement" | "popperClass" | "showAfter" | "hideAfter" | "popperOptions" | "enterable" | "appendTo" | "transition" | "showArrow">> | undefined>;
 }>> & {

package/es/components/table/src/table/defaults.d.ts

@@ -156,10 +156,16 @@ interface RenderRowData<T> {
     expanded: boolean;
 }
 declare const _default: {
+    /**
+     * @description table data
+     */
     data: {
         type: PropType<any[]>;
         default: () => never[];
     };
+    /**
+     * @description size of Table
+     */
     size: {
         readonly type: PropType<import("@element-plus/nightly/es/utils").EpPropMergeType<StringConstructor, "" | "default" | "small" | "large", never>>;
         readonly required: false;
@@ -167,38 +173,119 @@ declare const _default: {
         __epPropKey: true;
     };
     width: (NumberConstructor | StringConstructor)[];
+    /**
+     * @description table's height. By default it has an `auto` height. If its value is a number, the height is measured in pixels; if its value is a string, the value will be assigned to element's style.height, the height is affected by external styles
+     */
     height: (NumberConstructor | StringConstructor)[];
+    /**
+     * @description table's max-height. The legal value is a number or the height in px
+     */
     maxHeight: (NumberConstructor | StringConstructor)[];
+    /**
+     * @description whether width of column automatically fits its container
+     */
     fit: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * @description whether Table is striped
+     */
     stripe: BooleanConstructor;
+    /**
+     * @description whether Table has vertical border
+     */
     border: BooleanConstructor;
+    /**
+     * @description key of row data, used for optimizing rendering. Required if `reserve-selection` is on or display tree data. When its type is String, multi-level access is supported, e.g. `user.info.id`, but `user.info[0].id` is not supported, in which case `Function` should be used
+     */
     rowKey: PropType<string | ((row: any) => string) | undefined>;
+    /**
+     * @description whether Table header is visible
+     */
     showHeader: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * @description whether to display a summary row
+     */
     showSummary: BooleanConstructor;
+    /**
+     * @description displayed text for the first column of summary row
+     */
     sumText: StringConstructor;
+    /**
+     * @description custom summary method
+     */
     summaryMethod: PropType<SummaryMethod<any> | undefined>;
+    /**
+     * @description function that returns custom class names for a row, or a string assigning class names for every row
+     */
     rowClassName: PropType<ColumnCls<any> | undefined>;
+    /**
+     * @description function that returns custom style for a row, or an object assigning custom style for every row
+     */
     rowStyle: PropType<ColumnStyle<any> | undefined>;
+    /**
+     * @description function that returns custom class names for a cell, or a string assigning class names for every cell
+     */
     cellClassName: PropType<CellCls<any> | undefined>;
+    /**
+     * @description function that returns custom style for a cell, or an object assigning custom style for every cell
+     */
     cellStyle: PropType<CellStyle<any> | undefined>;
+    /**
+     * @description function that returns custom class names for a row in table header, or a string assigning class names for every row in table header
+     */
     headerRowClassName: PropType<ColumnCls<any> | undefined>;
+    /**
+     * @description function that returns custom style for a row in table header, or an object assigning custom style for every row in table header
+     */
     headerRowStyle: PropType<ColumnStyle<any> | undefined>;
+    /**
+     * @description function that returns custom class names for a cell in table header, or a string assigning class names for every cell in table header
+     */
     headerCellClassName: PropType<CellCls<any> | undefined>;
+    /**
+     * @description function that returns custom style for a cell in table header, or an object assigning custom style for every cell in table header
+     */
     headerCellStyle: PropType<CellStyle<any> | undefined>;
+    /**
+     * @description whether current row is highlighted
+     */
     highlightCurrentRow: BooleanConstructor;
+    /**
+     * @description key of current row, a set only prop
+     */
     currentRowKey: (NumberConstructor | StringConstructor)[];
+    /**
+     * @description displayed text when data is empty. You can customize this area with `#empty`
+     */
     emptyText: StringConstructor;
+    /**
+     * @description set expanded rows by this prop, prop's value is the keys of expand rows, you should set row-key before using this prop
+     */
     expandRowKeys: PropType<any[] | undefined>;
+    /**
+     * @description whether expand all rows by default, works when the table has a column type="expand" or contains tree structure data
+     */
     defaultExpandAll: BooleanConstructor;
+    /**
+     * @description set the default sort column and order. property `prop` is used to set default sort column, property `order` is used to set default sort order
+     */
     defaultSort: PropType<Sort | undefined>;
+    /**
+     * @description the `effect` of the overflow tooltip
+     */
     tooltipEffect: StringConstructor;
+    /**
+     * @description the options for the overflow tooltip, [see the following tooltip component](tooltip.html#attributes)
+     */
     tooltipOptions: PropType<Partial<Pick<import("../../..").ElTooltipProps, "offset" | "effect" | "placement" | "popperClass" | "showAfter" | "hideAfter" | "popperOptions" | "enterable" | "appendTo" | "transition" | "showArrow">> | undefined>;
+    /**
+     * @description method that returns rowspan and colspan
+     */
     spanMethod: PropType<((data: {
         row: any;
         rowIndex: number;
@@ -208,14 +295,23 @@ declare const _default: {
         rowspan: number;
         colspan: number;
     } | undefined) | undefined>;
+    /**
+     * @description controls the behavior of master checkbox in multi-select tables when only some rows are selected (but not all). If true, all rows will be selected, else deselected
+     */
     selectOnIndeterminate: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * @description horizontal indentation of tree data
+     */
     indent: {
         type: NumberConstructor;
         default: number;
     };
+    /**
+     * @description configuration for rendering nested data
+     */
     treeProps: {
         type: PropType<{
             hasChildren?: string | undefined;
@@ -226,7 +322,13 @@ declare const _default: {
             children: string;
         };
     };
+    /**
+     * @description whether to lazy loading data
+     */
     lazy: BooleanConstructor;
+    /**
+     * @description method for loading child row data, only works when `lazy` is true
+     */
     load: PropType<((row: any, treeNode: TreeNode, resolve: (data: any[]) => void) => void) | undefined>;
     style: {
         type: PropType<CSSProperties>;
@@ -236,15 +338,24 @@ declare const _default: {
         type: StringConstructor;
         default: string;
     };
+    /**
+     * @description sets the algorithm used to lay out table cells, rows, and columns
+     */
     tableLayout: {
         type: PropType<Layout>;
         default: string;
     };
-    scrollbarAlwaysOn: {
-        type: BooleanConstructor;
-        default: boolean;
-    };
+    /**
+     * @description always show scrollbar
+     */
+    scrollbarAlwaysOn: BooleanConstructor;
+    /**
+     * @description ensure main axis minimum-size doesn't follow the content
+     */
     flexible: BooleanConstructor;
+    /**
+     * @description whether to hide extra content and show them in a tooltip when hovering on the cell.It will affect all the table columns
+     */
     showOverflowTooltip: PropType<boolean | Partial<Pick<import("../../..").ElTooltipProps, "offset" | "effect" | "placement" | "popperClass" | "showAfter" | "hideAfter" | "popperOptions" | "enterable" | "appendTo" | "transition" | "showArrow">> | undefined>;
 };
 export default _default;

package/es/components/table/src/table/defaults.mjs

@@ -72,10 +72,7 @@ var defaultProps = {
     type: String,
     default: "fixed"
   },
-  scrollbarAlwaysOn: {
-    type: Boolean,
-    default: false
-  },
+  scrollbarAlwaysOn: Boolean,
   flexible: Boolean,
   showOverflowTooltip: [Boolean, Object]
 };