@vuetify/nightly 3.10.4-dev.2025-10-01 → 3.10.4-dev.2025-10-06

package/lib/components/VDataTable/VDataTableVirtual.d.ts

@@ -32,8 +32,10 @@ export declare const makeVDataTableVirtualProps: <Defaults extends {
     expandOnClick?: unknown;
     showExpand?: unknown;
     expanded?: unknown;
+    initialSortOrder?: unknown;
     sortBy?: unknown;
     customKeySort?: unknown;
+    multiSort?: unknown;
     mustSort?: unknown;
     groupBy?: unknown;
     items?: unknown;
@@ -55,7 +57,6 @@ export declare const makeVDataTableVirtualProps: <Defaults extends {
     headers?: unknown;
     color?: unknown;
     disableSort?: unknown;
-    multiSort?: unknown;
     sortAscIcon?: unknown;
     sortDescIcon?: unknown;
     headerProps?: unknown;
@@ -152,6 +153,18 @@ export declare const makeVDataTableVirtualProps: <Defaults extends {
         type: import("vue").PropType<unknown extends Defaults["expanded"] ? readonly string[] : readonly string[] | Defaults["expanded"]>;
         default: unknown extends Defaults["expanded"] ? readonly string[] : readonly string[] | Defaults["expanded"];
     };
+    initialSortOrder: unknown extends Defaults["initialSortOrder"] ? {
+        type: import("vue").PropType<"asc" | "desc">;
+        default: string;
+        validator: (v: any) => boolean;
+    } : Omit<{
+        type: import("vue").PropType<"asc" | "desc">;
+        default: string;
+        validator: (v: any) => boolean;
+    }, "default" | "type"> & {
+        type: import("vue").PropType<unknown extends Defaults["initialSortOrder"] ? "asc" | "desc" : "asc" | "desc" | Defaults["initialSortOrder"]>;
+        default: unknown extends Defaults["initialSortOrder"] ? "asc" | "desc" : Defaults["initialSortOrder"] | NonNullable<"asc" | "desc">;
+    };
     sortBy: unknown extends Defaults["sortBy"] ? {
         type: import("vue").PropType<readonly import("../../types.js").DataTableSortItem[]>;
         default: () => never[];
@@ -166,6 +179,16 @@ export declare const makeVDataTableVirtualProps: <Defaults extends {
         type: import("vue").PropType<unknown extends Defaults["customKeySort"] ? Record<string, import("../../types.js").DataTableCompareFunction> : Record<string, import("../../types.js").DataTableCompareFunction> | Defaults["customKeySort"]>;
         default: unknown extends Defaults["customKeySort"] ? Record<string, import("../../types.js").DataTableCompareFunction> : Record<string, import("../../types.js").DataTableCompareFunction> | Defaults["customKeySort"];
     };
+    multiSort: unknown extends Defaults["multiSort"] ? {
+        type: import("vue").PropType<boolean | import("./composables/sort.js").MultiSortProps>;
+        default: boolean;
+    } : Omit<{
+        type: import("vue").PropType<boolean | import("./composables/sort.js").MultiSortProps>;
+        default: boolean;
+    }, "default" | "type"> & {
+        type: import("vue").PropType<unknown extends Defaults["multiSort"] ? boolean | import("./composables/sort.js").MultiSortProps : boolean | import("./composables/sort.js").MultiSortProps | Defaults["multiSort"]>;
+        default: unknown extends Defaults["multiSort"] ? boolean | import("./composables/sort.js").MultiSortProps : Defaults["multiSort"] | NonNullable<boolean | import("./composables/sort.js").MultiSortProps>;
+    };
     mustSort: unknown extends Defaults["mustSort"] ? BooleanConstructor : {
         type: import("vue").PropType<unknown extends Defaults["mustSort"] ? boolean : boolean | Defaults["mustSort"]>;
         default: unknown extends Defaults["mustSort"] ? boolean : boolean | Defaults["mustSort"];
@@ -538,10 +561,6 @@ export declare const makeVDataTableVirtualProps: <Defaults extends {
         type: import("vue").PropType<unknown extends Defaults["disableSort"] ? boolean : boolean | Defaults["disableSort"]>;
         default: unknown extends Defaults["disableSort"] ? boolean : boolean | Defaults["disableSort"];
     };
-    multiSort: unknown extends Defaults["multiSort"] ? BooleanConstructor : {
-        type: import("vue").PropType<unknown extends Defaults["multiSort"] ? boolean : boolean | Defaults["multiSort"]>;
-        default: unknown extends Defaults["multiSort"] ? boolean : boolean | Defaults["multiSort"];
-    };
     sortAscIcon: unknown extends Defaults["sortAscIcon"] ? {
         type: import("vue").PropType<import("../../composables/icons.js").IconValue>;
         default: string;
@@ -689,7 +708,9 @@ export declare const VDataTableVirtual: {
         expandOnClick: boolean;
         showExpand: boolean;
         expanded: readonly string[];
+        initialSortOrder: "asc" | "desc";
         sortBy: readonly import("../../types.js").DataTableSortItem[];
+        multiSort: boolean | import("./composables/sort.js").MultiSortProps;
         mustSort: boolean;
         groupBy: readonly import("../../types.js").DataTableSortItem[];
         returnObject: boolean;
@@ -701,7 +722,6 @@ export declare const VDataTableVirtual: {
         itemHeight: string | number;
         itemKey: string | boolean | readonly (string | number)[] | ((item: Record<string, any>, fallback?: any) => any) | null;
         disableSort: boolean;
-        multiSort: boolean;
         sortAscIcon: import("../../composables/icons.js").IconValue;
         sortDescIcon: import("../../composables/icons.js").IconValue;
         sticky: boolean;
@@ -754,7 +774,9 @@ export declare const VDataTableVirtual: {
         expandOnClick: boolean;
         showExpand: boolean;
         expanded: readonly string[];
+        initialSortOrder: "asc" | "desc";
         sortBy: readonly import("../../types.js").DataTableSortItem[];
+        multiSort: boolean | import("./composables/sort.js").MultiSortProps;
         mustSort: boolean;
         groupBy: readonly import("../../types.js").DataTableSortItem[];
         returnObject: boolean;
@@ -766,7 +788,6 @@ export declare const VDataTableVirtual: {
         itemHeight: string | number;
         itemKey: SelectItemKey;
         disableSort: boolean;
-        multiSort: boolean;
         sortAscIcon: import("../../composables/icons.js").IconValue;
         sortDescIcon: import("../../composables/icons.js").IconValue;
         sticky: boolean;
@@ -891,7 +912,9 @@ export declare const VDataTableVirtual: {
         expandOnClick: boolean;
         showExpand: boolean;
         expanded: readonly string[];
+        initialSortOrder: "asc" | "desc";
         sortBy: readonly import("../../types.js").DataTableSortItem[];
+        multiSort: boolean | import("./composables/sort.js").MultiSortProps;
         mustSort: boolean;
         groupBy: readonly import("../../types.js").DataTableSortItem[];
         returnObject: boolean;
@@ -903,7 +926,6 @@ export declare const VDataTableVirtual: {
         itemHeight: string | number;
         itemKey: string | boolean | readonly (string | number)[] | ((item: Record<string, any>, fallback?: any) => any) | null;
         disableSort: boolean;
-        multiSort: boolean;
         sortAscIcon: import("../../composables/icons.js").IconValue;
         sortDescIcon: import("../../composables/icons.js").IconValue;
         sticky: boolean;
@@ -950,7 +972,9 @@ export declare const VDataTableVirtual: {
         expandOnClick: boolean;
         showExpand: boolean;
         expanded: readonly string[];
+        initialSortOrder: "asc" | "desc";
         sortBy: readonly import("../../types.js").DataTableSortItem[];
+        multiSort: boolean | import("./composables/sort.js").MultiSortProps;
         mustSort: boolean;
         groupBy: readonly import("../../types.js").DataTableSortItem[];
         returnObject: boolean;
@@ -962,7 +986,6 @@ export declare const VDataTableVirtual: {
         itemHeight: string | number;
         itemKey: SelectItemKey;
         disableSort: boolean;
-        multiSort: boolean;
         sortAscIcon: import("../../composables/icons.js").IconValue;
         sortDescIcon: import("../../composables/icons.js").IconValue;
         sticky: boolean;
@@ -991,7 +1014,9 @@ export declare const VDataTableVirtual: {
     expandOnClick: boolean;
     showExpand: boolean;
     expanded: readonly string[];
+    initialSortOrder: "asc" | "desc";
     sortBy: readonly import("../../types.js").DataTableSortItem[];
+    multiSort: boolean | import("./composables/sort.js").MultiSortProps;
     mustSort: boolean;
     groupBy: readonly import("../../types.js").DataTableSortItem[];
     returnObject: boolean;
@@ -1003,7 +1028,6 @@ export declare const VDataTableVirtual: {
     itemHeight: string | number;
     itemKey: string | boolean | readonly (string | number)[] | ((item: Record<string, any>, fallback?: any) => any) | null;
     disableSort: boolean;
-    multiSort: boolean;
     sortAscIcon: import("../../composables/icons.js").IconValue;
     sortDescIcon: import("../../composables/icons.js").IconValue;
     sticky: boolean;
@@ -1056,7 +1080,9 @@ export declare const VDataTableVirtual: {
     expandOnClick: boolean;
     showExpand: boolean;
     expanded: readonly string[];
+    initialSortOrder: "asc" | "desc";
     sortBy: readonly import("../../types.js").DataTableSortItem[];
+    multiSort: boolean | import("./composables/sort.js").MultiSortProps;
     mustSort: boolean;
     groupBy: readonly import("../../types.js").DataTableSortItem[];
     returnObject: boolean;
@@ -1068,7 +1094,6 @@ export declare const VDataTableVirtual: {
     itemHeight: string | number;
     itemKey: SelectItemKey;
     disableSort: boolean;
-    multiSort: boolean;
     sortAscIcon: import("../../composables/icons.js").IconValue;
     sortDescIcon: import("../../composables/icons.js").IconValue;
     sticky: boolean;
@@ -1266,11 +1291,20 @@ export declare const VDataTableVirtual: {
         type: import("vue").PropType<readonly string[]>;
         default: () => never[];
     };
+    initialSortOrder: {
+        type: import("vue").PropType<"asc" | "desc">;
+        default: string;
+        validator: (v: any) => boolean;
+    };
     sortBy: {
         type: import("vue").PropType<readonly import("../../types.js").DataTableSortItem[]>;
         default: () => never[];
     };
     customKeySort: import("vue").PropType<Record<string, import("../../types.js").DataTableCompareFunction>>;
+    multiSort: {
+        type: import("vue").PropType<boolean | import("./composables/sort.js").MultiSortProps>;
+        default: boolean;
+    };
     mustSort: BooleanConstructor;
     groupBy: {
         type: import("vue").PropType<readonly import("../../types.js").DataTableSortItem[]>;
@@ -1370,7 +1404,6 @@ export declare const VDataTableVirtual: {
     }[]>;
     color: StringConstructor;
     disableSort: BooleanConstructor;
-    multiSort: BooleanConstructor;
     sortAscIcon: {
         type: import("vue").PropType<import("../../composables/icons.js").IconValue>;
         default: string;
@@ -1446,11 +1479,20 @@ export declare const VDataTableVirtual: {
         type: import("vue").PropType<readonly string[]>;
         default: () => never[];
     };
+    initialSortOrder: {
+        type: import("vue").PropType<"asc" | "desc">;
+        default: string;
+        validator: (v: any) => boolean;
+    };
     sortBy: {
         type: import("vue").PropType<readonly import("../../types.js").DataTableSortItem[]>;
         default: () => never[];
     };
     customKeySort: import("vue").PropType<Record<string, import("../../types.js").DataTableCompareFunction>>;
+    multiSort: {
+        type: import("vue").PropType<boolean | import("./composables/sort.js").MultiSortProps>;
+        default: boolean;
+    };
     mustSort: BooleanConstructor;
     groupBy: {
         type: import("vue").PropType<readonly import("../../types.js").DataTableSortItem[]>;
@@ -1550,7 +1592,6 @@ export declare const VDataTableVirtual: {
     }[]>;
     color: StringConstructor;
     disableSort: BooleanConstructor;
-    multiSort: BooleanConstructor;
     sortAscIcon: {
         type: import("vue").PropType<import("../../composables/icons.js").IconValue>;
         default: string;

package/lib/components/VDataTable/VDataTableVirtual.js

@@ -1,4 +1,4 @@
-import { createVNode as _createVNode, createElementVNode as _createElementVNode, mergeProps as _mergeProps } from "vue";
+import { mergeProps as _mergeProps, createVNode as _createVNode, createElementVNode as _createElementVNode } from "vue";
 // Components
 import { makeDataTableProps } from "./VDataTable.js";
 import { VDataTableHeaders } from "./VDataTableHeaders.js";
@@ -43,6 +43,7 @@ export const VDataTableVirtual = genericComponent()({
       groupBy
     } = createGroupBy(props);
     const {
+      initialSortOrder,
       sortBy,
       multiSort,
       mustSort
@@ -74,6 +75,7 @@ export const VDataTableVirtual = genericComponent()({
     const {
       toggleSort
     } = provideSort({
+      initialSortOrder,
       sortBy,
       multiSort,
       mustSort
@@ -166,7 +168,7 @@ export const VDataTableVirtual = genericComponent()({
       headers: headers.value
     }));
     useRender(() => {
-      const dataTableHeadersProps = VDataTableHeaders.filterProps(props);
+      const dataTableHeadersProps = VDataTableHeaders.filterProps(omit(props, ['multiSort']));
       const dataTableRowsProps = VDataTableRows.filterProps(props);
       const tableProps = VTable.filterProps(props);
       return _createVNode(VTable, _mergeProps({
@@ -188,7 +190,9 @@ export const VDataTableVirtual = genericComponent()({
           }
         }, [_createElementVNode("table", null, [slots.colgroup?.(slotProps.value), !props.hideDefaultHeader && _createElementVNode("thead", {
           "key": "thead"
-        }, [_createVNode(VDataTableHeaders, dataTableHeadersProps, slots)]), slots.thead?.(slotProps.value), !props.hideDefaultBody && _createElementVNode("tbody", {
+        }, [_createVNode(VDataTableHeaders, _mergeProps(dataTableHeadersProps, {
+          "multiSort": !!props.multiSort
+        }), slots)]), slots.thead?.(slotProps.value), !props.hideDefaultBody && _createElementVNode("tbody", {
           "key": "tbody"
         }, [_createElementVNode("tr", {
           "ref": markerRef,

package/lib/components/VDataTable/VDataTableVirtual.js.map

@@ -1 +1 @@
-{"version":3,"file":"VDataTableVirtual.js","names":["makeDataTableProps","VDataTableHeaders","VDataTableRow","VDataTableRows","VTable","VVirtualScrollItem","provideExpanded","createGroupBy","makeDataTableGroupProps","provideGroupBy","useGroupedItems","createHeaders","useDataTableItems","useOptions","provideSelection","createSort","provideSort","useSortedItems","provideDefaults","makeFilterProps","useFilter","makeVirtualProps","useVirtual","computed","shallowRef","toRef","toRefs","convertToUnit","genericComponent","omit","propsFactory","useRender","makeVDataTableVirtualProps","VDataTableVirtual","name","props","emits","value","setup","_ref","attrs","slots","groupBy","sortBy","multiSort","mustSort","disableSort","columns","headers","filterFunctions","sortFunctions","sortRawFunctions","showSelect","showExpand","items","search","filteredItems","transform","item","customKeyFilter","toggleSort","sortByWithGroups","opened","extractRows","isGroupOpen","toggleGroup","sortedItems","raw","flatItems","allItems","isSelected","select","selectAll","toggleSelect","someSelected","allSelected","currentPage","isExpanded","toggleExpand","containerRef","markerRef","paddingTop","paddingBottom","computedItems","handleItemResize","handleScroll","handleScrollend","calculateVisibleItems","scrollToIndex","displayItems","map","page","itemsPerPage","hideNoData","noDataText","loading","loadingText","slotProps","internalItems","groupedItems","dataTableHeadersProps","filterProps","dataTableRowsProps","tableProps","_createVNode","_mergeProps","class","style","fixedHeader","sticky","top","wrapper","_createElementVNode","height","colgroup","hideDefaultHeader","thead","hideDefaultBody","border","length","itemSlotProps","internalItem","index","default","_ref2","itemRef","tbody","tfoot","bottom"],"sources":["../../../src/components/VDataTable/VDataTableVirtual.tsx"],"sourcesContent":["// Components\nimport { makeDataTableProps } from './VDataTable'\nimport { VDataTableHeaders } from './VDataTableHeaders'\nimport { VDataTableRow } from './VDataTableRow'\nimport { VDataTableRows } from './VDataTableRows'\nimport { VTable } from '@/components/VTable'\nimport { VVirtualScrollItem } from '@/components/VVirtualScroll/VVirtualScrollItem'\n\n// Composables\nimport { provideExpanded } from './composables/expand'\nimport { createGroupBy, makeDataTableGroupProps, provideGroupBy, useGroupedItems } from './composables/group'\nimport { createHeaders } from './composables/headers'\nimport { useDataTableItems } from './composables/items'\nimport { useOptions } from './composables/options'\nimport { provideSelection } from './composables/select'\nimport { createSort, provideSort, useSortedItems } from './composables/sort'\nimport { provideDefaults } from '@/composables/defaults'\nimport { makeFilterProps, useFilter } from '@/composables/filter'\nimport { makeVirtualProps, useVirtual } from '@/composables/virtual'\n\n// Utilities\nimport { computed, shallowRef, toRef, toRefs } from 'vue'\nimport { convertToUnit, genericComponent, omit, propsFactory, useRender } from '@/util'\n\n// Types\nimport type { DeepReadonly } from 'vue'\nimport type { VDataTableSlotProps } from './VDataTable'\nimport type { VDataTableHeadersSlots } from './VDataTableHeaders'\nimport type { VDataTableRowsSlots } from './VDataTableRows'\nimport type { CellProps, DataTableHeader, RowProps } from '@/components/VDataTable/types'\nimport type { GenericProps, SelectItemKey, TemplateRef } from '@/util'\n\ntype VDataTableVirtualSlotProps<T> = Omit<\n  VDataTableSlotProps<T>,\n  | 'setItemsPerPage'\n  | 'page'\n  | 'pageCount'\n  | 'itemsPerPage'\n>\n\nexport type VDataTableVirtualSlots<T> = VDataTableRowsSlots<T> & VDataTableHeadersSlots & {\n  colgroup: VDataTableVirtualSlotProps<T>\n  top: VDataTableVirtualSlotProps<T>\n  headers: VDataTableHeadersSlots['headers']\n  tbody: VDataTableVirtualSlotProps<T>\n  thead: VDataTableVirtualSlotProps<T>\n  tfoot: VDataTableVirtualSlotProps<T>\n  bottom: VDataTableVirtualSlotProps<T>\n  'body.prepend': VDataTableVirtualSlotProps<T>\n  'body.append': VDataTableVirtualSlotProps<T>\n  item: {\n    itemRef: TemplateRef\n  }\n}\n\nexport const makeVDataTableVirtualProps = propsFactory({\n  ...omit(makeDataTableProps(), ['hideDefaultFooter']),\n  ...makeDataTableGroupProps(),\n  ...makeVirtualProps(),\n  ...makeFilterProps(),\n}, 'VDataTableVirtual')\n\ntype ItemType<T> = T extends readonly (infer U)[] ? U : never\n\nexport const VDataTableVirtual = genericComponent<new <T extends readonly any[], V>(\n  props: {\n    items?: T\n    itemValue?: SelectItemKey<ItemType<T>>\n    rowProps?: RowProps<ItemType<T>>\n    cellProps?: CellProps<ItemType<T>>\n    itemSelectable?: SelectItemKey<ItemType<T>>\n    headers?: DeepReadonly<DataTableHeader<ItemType<T>>[]>\n    modelValue?: V\n    'onUpdate:modelValue'?: (value: V) => void\n  },\n  slots: VDataTableVirtualSlots<ItemType<T>>,\n) => GenericProps<typeof props, typeof slots>>()({\n  name: 'VDataTableVirtual',\n\n  props: makeVDataTableVirtualProps(),\n\n  emits: {\n    'update:modelValue': (value: any[]) => true,\n    'update:sortBy': (value: any) => true,\n    'update:options': (value: any) => true,\n    'update:groupBy': (value: any) => true,\n    'update:expanded': (value: any) => true,\n  },\n\n  setup (props, { attrs, slots }) {\n    const { groupBy } = createGroupBy(props)\n    const { sortBy, multiSort, mustSort } = createSort(props)\n    const { disableSort } = toRefs(props)\n\n    const {\n      columns,\n      headers,\n      filterFunctions,\n      sortFunctions,\n      sortRawFunctions,\n    } = createHeaders(props, {\n      groupBy,\n      showSelect: toRef(() => props.showSelect),\n      showExpand: toRef(() => props.showExpand),\n    })\n    const { items } = useDataTableItems(props, columns)\n\n    const search = toRef(() => props.search)\n    const { filteredItems } = useFilter(props, items, search, {\n      transform: item => item.columns,\n      customKeyFilter: filterFunctions,\n    })\n\n    const { toggleSort } = provideSort({ sortBy, multiSort, mustSort })\n    const { sortByWithGroups, opened, extractRows, isGroupOpen, toggleGroup } = provideGroupBy({ groupBy, sortBy, disableSort })\n\n    const { sortedItems } = useSortedItems(props, filteredItems, sortByWithGroups, {\n      transform: item => ({ ...item.raw, ...item.columns }),\n      sortFunctions,\n      sortRawFunctions,\n    })\n    const { flatItems } = useGroupedItems(sortedItems, groupBy, opened, () => !!slots['group-summary'])\n\n    const allItems = computed(() => extractRows(flatItems.value))\n\n    const { isSelected, select, selectAll, toggleSelect, someSelected, allSelected } = provideSelection(props, {\n      allItems,\n      currentPage: allItems,\n    })\n    const { isExpanded, toggleExpand } = provideExpanded(props)\n\n    const {\n      containerRef,\n      markerRef,\n      paddingTop,\n      paddingBottom,\n      computedItems,\n      handleItemResize,\n      handleScroll,\n      handleScrollend,\n      calculateVisibleItems,\n      scrollToIndex,\n    } = useVirtual(props, flatItems)\n    const displayItems = computed(() => computedItems.value.map(item => item.raw))\n\n    useOptions({\n      sortBy,\n      page: shallowRef(1),\n      itemsPerPage: shallowRef(-1),\n      groupBy,\n      search,\n    })\n\n    provideDefaults({\n      VDataTableRows: {\n        hideNoData: toRef(() => props.hideNoData),\n        noDataText: toRef(() => props.noDataText),\n        loading: toRef(() => props.loading),\n        loadingText: toRef(() => props.loadingText),\n      },\n    })\n\n    const slotProps = computed<VDataTableVirtualSlotProps<any>>(() => ({\n      sortBy: sortBy.value,\n      toggleSort,\n      someSelected: someSelected.value,\n      allSelected: allSelected.value,\n      isSelected,\n      select,\n      selectAll,\n      toggleSelect,\n      isExpanded,\n      toggleExpand,\n      isGroupOpen,\n      toggleGroup,\n      items: allItems.value.map(item => item.raw),\n      internalItems: allItems.value,\n      groupedItems: flatItems.value,\n      columns: columns.value,\n      headers: headers.value,\n    }))\n\n    useRender(() => {\n      const dataTableHeadersProps = VDataTableHeaders.filterProps(props)\n      const dataTableRowsProps = VDataTableRows.filterProps(props)\n      const tableProps = VTable.filterProps(props)\n\n      return (\n        <VTable\n          class={[\n            'v-data-table',\n            {\n              'v-data-table--loading': props.loading,\n            },\n            props.class,\n          ]}\n          style={ props.style }\n          { ...tableProps }\n          fixedHeader={ props.fixedHeader || props.sticky }\n        >\n          {{\n            top: () => slots.top?.(slotProps.value),\n            wrapper: () => (\n              <div\n                ref={ containerRef }\n                onScrollPassive={ handleScroll }\n                onScrollend={ handleScrollend }\n                class=\"v-table__wrapper\"\n                style={{\n                  height: convertToUnit(props.height),\n                }}\n              >\n                <table>\n                  { slots.colgroup?.(slotProps.value) }\n                  { !props.hideDefaultHeader && (\n                    <thead key=\"thead\">\n                      <VDataTableHeaders\n                        { ...dataTableHeadersProps }\n                        v-slots={ slots }\n                      />\n                    </thead>\n                  )}\n                  { slots.thead?.(slotProps.value) }\n                  { !props.hideDefaultBody && (\n                    <tbody key=\"tbody\">\n                      <tr ref={ markerRef } style={{ height: convertToUnit(paddingTop.value), border: 0 }}>\n                        <td colspan={ columns.value.length } style={{ height: 0, border: 0 }}></td>\n                      </tr>\n\n                      { slots['body.prepend']?.(slotProps.value) }\n\n                      <VDataTableRows\n                        { ...attrs }\n                        { ...dataTableRowsProps }\n                        items={ displayItems.value }\n                      >\n                        {{\n                          ...slots,\n                          item: itemSlotProps => (\n                            <VVirtualScrollItem\n                              key={ itemSlotProps.internalItem.index }\n                              renderless\n                              onUpdate:height={ height => handleItemResize(itemSlotProps.internalItem.index, height) }\n                            >\n                              { ({ itemRef }) => (\n                                slots.item?.({ ...itemSlotProps, itemRef }) ?? (\n                                  <VDataTableRow\n                                    { ...itemSlotProps.props }\n                                    ref={ itemRef }\n                                    key={ itemSlotProps.internalItem.index }\n                                    index={ itemSlotProps.internalItem.index }\n                                    v-slots={ slots }\n                                  />\n                                )\n                              )}\n                            </VVirtualScrollItem>\n                          ),\n                        }}\n                      </VDataTableRows>\n\n                      { slots['body.append']?.(slotProps.value) }\n\n                      <tr style={{ height: convertToUnit(paddingBottom.value), border: 0 }}>\n                        <td colspan={ columns.value.length } style={{ height: 0, border: 0 }}></td>\n                      </tr>\n                    </tbody>\n                  )}\n                  { slots.tbody?.(slotProps.value) }\n                  { slots.tfoot?.(slotProps.value) }\n                </table>\n              </div>\n            ),\n            bottom: () => slots.bottom?.(slotProps.value),\n          }}\n        </VTable>\n      )\n    })\n\n    return {\n      calculateVisibleItems,\n      scrollToIndex,\n    }\n  },\n})\n\nexport type VDataTableVirtual = InstanceType<typeof VDataTableVirtual>\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"VDataTableVirtual.js","names":["makeDataTableProps","VDataTableHeaders","VDataTableRow","VDataTableRows","VTable","VVirtualScrollItem","provideExpanded","createGroupBy","makeDataTableGroupProps","provideGroupBy","useGroupedItems","createHeaders","useDataTableItems","useOptions","provideSelection","createSort","provideSort","useSortedItems","provideDefaults","makeFilterProps","useFilter","makeVirtualProps","useVirtual","computed","shallowRef","toRef","toRefs","convertToUnit","genericComponent","omit","propsFactory","useRender","makeVDataTableVirtualProps","VDataTableVirtual","name","props","emits","value","setup","_ref","attrs","slots","groupBy","initialSortOrder","sortBy","multiSort","mustSort","disableSort","columns","headers","filterFunctions","sortFunctions","sortRawFunctions","showSelect","showExpand","items","search","filteredItems","transform","item","customKeyFilter","toggleSort","sortByWithGroups","opened","extractRows","isGroupOpen","toggleGroup","sortedItems","raw","flatItems","allItems","isSelected","select","selectAll","toggleSelect","someSelected","allSelected","currentPage","isExpanded","toggleExpand","containerRef","markerRef","paddingTop","paddingBottom","computedItems","handleItemResize","handleScroll","handleScrollend","calculateVisibleItems","scrollToIndex","displayItems","map","page","itemsPerPage","hideNoData","noDataText","loading","loadingText","slotProps","internalItems","groupedItems","dataTableHeadersProps","filterProps","dataTableRowsProps","tableProps","_createVNode","_mergeProps","class","style","fixedHeader","sticky","top","wrapper","_createElementVNode","height","colgroup","hideDefaultHeader","thead","hideDefaultBody","border","length","itemSlotProps","internalItem","index","default","_ref2","itemRef","tbody","tfoot","bottom"],"sources":["../../../src/components/VDataTable/VDataTableVirtual.tsx"],"sourcesContent":["// Components\nimport { makeDataTableProps } from './VDataTable'\nimport { VDataTableHeaders } from './VDataTableHeaders'\nimport { VDataTableRow } from './VDataTableRow'\nimport { VDataTableRows } from './VDataTableRows'\nimport { VTable } from '@/components/VTable'\nimport { VVirtualScrollItem } from '@/components/VVirtualScroll/VVirtualScrollItem'\n\n// Composables\nimport { provideExpanded } from './composables/expand'\nimport { createGroupBy, makeDataTableGroupProps, provideGroupBy, useGroupedItems } from './composables/group'\nimport { createHeaders } from './composables/headers'\nimport { useDataTableItems } from './composables/items'\nimport { useOptions } from './composables/options'\nimport { provideSelection } from './composables/select'\nimport { createSort, provideSort, useSortedItems } from './composables/sort'\nimport { provideDefaults } from '@/composables/defaults'\nimport { makeFilterProps, useFilter } from '@/composables/filter'\nimport { makeVirtualProps, useVirtual } from '@/composables/virtual'\n\n// Utilities\nimport { computed, shallowRef, toRef, toRefs } from 'vue'\nimport { convertToUnit, genericComponent, omit, propsFactory, useRender } from '@/util'\n\n// Types\nimport type { DeepReadonly } from 'vue'\nimport type { VDataTableSlotProps } from './VDataTable'\nimport type { VDataTableHeadersSlots } from './VDataTableHeaders'\nimport type { VDataTableRowsSlots } from './VDataTableRows'\nimport type { CellProps, DataTableHeader, RowProps } from '@/components/VDataTable/types'\nimport type { GenericProps, SelectItemKey, TemplateRef } from '@/util'\n\ntype VDataTableVirtualSlotProps<T> = Omit<\n  VDataTableSlotProps<T>,\n  | 'setItemsPerPage'\n  | 'page'\n  | 'pageCount'\n  | 'itemsPerPage'\n>\n\nexport type VDataTableVirtualSlots<T> = VDataTableRowsSlots<T> & VDataTableHeadersSlots & {\n  colgroup: VDataTableVirtualSlotProps<T>\n  top: VDataTableVirtualSlotProps<T>\n  headers: VDataTableHeadersSlots['headers']\n  tbody: VDataTableVirtualSlotProps<T>\n  thead: VDataTableVirtualSlotProps<T>\n  tfoot: VDataTableVirtualSlotProps<T>\n  bottom: VDataTableVirtualSlotProps<T>\n  'body.prepend': VDataTableVirtualSlotProps<T>\n  'body.append': VDataTableVirtualSlotProps<T>\n  item: {\n    itemRef: TemplateRef\n  }\n}\n\nexport const makeVDataTableVirtualProps = propsFactory({\n  ...omit(makeDataTableProps(), ['hideDefaultFooter']),\n  ...makeDataTableGroupProps(),\n  ...makeVirtualProps(),\n  ...makeFilterProps(),\n}, 'VDataTableVirtual')\n\ntype ItemType<T> = T extends readonly (infer U)[] ? U : never\n\nexport const VDataTableVirtual = genericComponent<new <T extends readonly any[], V>(\n  props: {\n    items?: T\n    itemValue?: SelectItemKey<ItemType<T>>\n    rowProps?: RowProps<ItemType<T>>\n    cellProps?: CellProps<ItemType<T>>\n    itemSelectable?: SelectItemKey<ItemType<T>>\n    headers?: DeepReadonly<DataTableHeader<ItemType<T>>[]>\n    modelValue?: V\n    'onUpdate:modelValue'?: (value: V) => void\n  },\n  slots: VDataTableVirtualSlots<ItemType<T>>,\n) => GenericProps<typeof props, typeof slots>>()({\n  name: 'VDataTableVirtual',\n\n  props: makeVDataTableVirtualProps(),\n\n  emits: {\n    'update:modelValue': (value: any[]) => true,\n    'update:sortBy': (value: any) => true,\n    'update:options': (value: any) => true,\n    'update:groupBy': (value: any) => true,\n    'update:expanded': (value: any) => true,\n  },\n\n  setup (props, { attrs, slots }) {\n    const { groupBy } = createGroupBy(props)\n    const { initialSortOrder, sortBy, multiSort, mustSort } = createSort(props)\n    const { disableSort } = toRefs(props)\n\n    const {\n      columns,\n      headers,\n      filterFunctions,\n      sortFunctions,\n      sortRawFunctions,\n    } = createHeaders(props, {\n      groupBy,\n      showSelect: toRef(() => props.showSelect),\n      showExpand: toRef(() => props.showExpand),\n    })\n    const { items } = useDataTableItems(props, columns)\n\n    const search = toRef(() => props.search)\n    const { filteredItems } = useFilter(props, items, search, {\n      transform: item => item.columns,\n      customKeyFilter: filterFunctions,\n    })\n\n    const { toggleSort } = provideSort({ initialSortOrder, sortBy, multiSort, mustSort })\n    const { sortByWithGroups, opened, extractRows, isGroupOpen, toggleGroup } = provideGroupBy({ groupBy, sortBy, disableSort })\n\n    const { sortedItems } = useSortedItems(props, filteredItems, sortByWithGroups, {\n      transform: item => ({ ...item.raw, ...item.columns }),\n      sortFunctions,\n      sortRawFunctions,\n    })\n    const { flatItems } = useGroupedItems(sortedItems, groupBy, opened, () => !!slots['group-summary'])\n\n    const allItems = computed(() => extractRows(flatItems.value))\n\n    const { isSelected, select, selectAll, toggleSelect, someSelected, allSelected } = provideSelection(props, {\n      allItems,\n      currentPage: allItems,\n    })\n    const { isExpanded, toggleExpand } = provideExpanded(props)\n\n    const {\n      containerRef,\n      markerRef,\n      paddingTop,\n      paddingBottom,\n      computedItems,\n      handleItemResize,\n      handleScroll,\n      handleScrollend,\n      calculateVisibleItems,\n      scrollToIndex,\n    } = useVirtual(props, flatItems)\n    const displayItems = computed(() => computedItems.value.map(item => item.raw))\n\n    useOptions({\n      sortBy,\n      page: shallowRef(1),\n      itemsPerPage: shallowRef(-1),\n      groupBy,\n      search,\n    })\n\n    provideDefaults({\n      VDataTableRows: {\n        hideNoData: toRef(() => props.hideNoData),\n        noDataText: toRef(() => props.noDataText),\n        loading: toRef(() => props.loading),\n        loadingText: toRef(() => props.loadingText),\n      },\n    })\n\n    const slotProps = computed<VDataTableVirtualSlotProps<any>>(() => ({\n      sortBy: sortBy.value,\n      toggleSort,\n      someSelected: someSelected.value,\n      allSelected: allSelected.value,\n      isSelected,\n      select,\n      selectAll,\n      toggleSelect,\n      isExpanded,\n      toggleExpand,\n      isGroupOpen,\n      toggleGroup,\n      items: allItems.value.map(item => item.raw),\n      internalItems: allItems.value,\n      groupedItems: flatItems.value,\n      columns: columns.value,\n      headers: headers.value,\n    }))\n\n    useRender(() => {\n      const dataTableHeadersProps = VDataTableHeaders.filterProps(omit(props, ['multiSort']))\n      const dataTableRowsProps = VDataTableRows.filterProps(props)\n      const tableProps = VTable.filterProps(props)\n\n      return (\n        <VTable\n          class={[\n            'v-data-table',\n            {\n              'v-data-table--loading': props.loading,\n            },\n            props.class,\n          ]}\n          style={ props.style }\n          { ...tableProps }\n          fixedHeader={ props.fixedHeader || props.sticky }\n        >\n          {{\n            top: () => slots.top?.(slotProps.value),\n            wrapper: () => (\n              <div\n                ref={ containerRef }\n                onScrollPassive={ handleScroll }\n                onScrollend={ handleScrollend }\n                class=\"v-table__wrapper\"\n                style={{\n                  height: convertToUnit(props.height),\n                }}\n              >\n                <table>\n                  { slots.colgroup?.(slotProps.value) }\n                  { !props.hideDefaultHeader && (\n                    <thead key=\"thead\">\n                      <VDataTableHeaders\n                        { ...dataTableHeadersProps }\n                        multiSort={ !!props.multiSort }\n                        v-slots={ slots }\n                      />\n                    </thead>\n                  )}\n                  { slots.thead?.(slotProps.value) }\n                  { !props.hideDefaultBody && (\n                    <tbody key=\"tbody\">\n                      <tr ref={ markerRef } style={{ height: convertToUnit(paddingTop.value), border: 0 }}>\n                        <td colspan={ columns.value.length } style={{ height: 0, border: 0 }}></td>\n                      </tr>\n\n                      { slots['body.prepend']?.(slotProps.value) }\n\n                      <VDataTableRows\n                        { ...attrs }\n                        { ...dataTableRowsProps }\n                        items={ displayItems.value }\n                      >\n                        {{\n                          ...slots,\n                          item: itemSlotProps => (\n                            <VVirtualScrollItem\n                              key={ itemSlotProps.internalItem.index }\n                              renderless\n                              onUpdate:height={ height => handleItemResize(itemSlotProps.internalItem.index, height) }\n                            >\n                              { ({ itemRef }) => (\n                                slots.item?.({ ...itemSlotProps, itemRef }) ?? (\n                                  <VDataTableRow\n                                    { ...itemSlotProps.props }\n                                    ref={ itemRef }\n                                    key={ itemSlotProps.internalItem.index }\n                                    index={ itemSlotProps.internalItem.index }\n                                    v-slots={ slots }\n                                  />\n                                )\n                              )}\n                            </VVirtualScrollItem>\n                          ),\n                        }}\n                      </VDataTableRows>\n\n                      { slots['body.append']?.(slotProps.value) }\n\n                      <tr style={{ height: convertToUnit(paddingBottom.value), border: 0 }}>\n                        <td colspan={ columns.value.length } style={{ height: 0, border: 0 }}></td>\n                      </tr>\n                    </tbody>\n                  )}\n                  { slots.tbody?.(slotProps.value) }\n                  { slots.tfoot?.(slotProps.value) }\n                </table>\n              </div>\n            ),\n            bottom: () => slots.bottom?.(slotProps.value),\n          }}\n        </VTable>\n      )\n    })\n\n    return {\n      calculateVisibleItems,\n      scrollToIndex,\n    }\n  },\n})\n\nexport type VDataTableVirtual = InstanceType<typeof VDataTableVirtual>\n"],"mappings":"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","ignoreList":[]}

package/lib/components/VDataTable/composables/sort.d.ts

@@ -3,11 +3,24 @@ import type { PropType, Ref } from 'vue';
 import type { DataTableCompareFunction, InternalDataTableHeader } from '../types.js';
 import type { InternalItem } from '../../../composables/filter.js';
 export declare const makeDataTableSortProps: <Defaults extends {
+    initialSortOrder?: unknown;
     sortBy?: unknown;
     customKeySort?: unknown;
     multiSort?: unknown;
     mustSort?: unknown;
 } = {}>(defaults?: Defaults | undefined) => {
+    initialSortOrder: unknown extends Defaults["initialSortOrder"] ? {
+        type: PropType<"asc" | "desc">;
+        default: string;
+        validator: (v: any) => boolean;
+    } : Omit<{
+        type: PropType<"asc" | "desc">;
+        default: string;
+        validator: (v: any) => boolean;
+    }, "default" | "type"> & {
+        type: PropType<unknown extends Defaults["initialSortOrder"] ? "asc" | "desc" : "asc" | "desc" | Defaults["initialSortOrder"]>;
+        default: unknown extends Defaults["initialSortOrder"] ? "asc" | "desc" : Defaults["initialSortOrder"] | NonNullable<"asc" | "desc">;
+    };
     sortBy: unknown extends Defaults["sortBy"] ? {
         type: PropType<readonly SortItem[]>;
         default: () => never[];
@@ -22,9 +35,15 @@ export declare const makeDataTableSortProps: <Defaults extends {
         type: PropType<unknown extends Defaults["customKeySort"] ? Record<string, DataTableCompareFunction> : Record<string, DataTableCompareFunction> | Defaults["customKeySort"]>;
         default: unknown extends Defaults["customKeySort"] ? Record<string, DataTableCompareFunction> : Record<string, DataTableCompareFunction> | Defaults["customKeySort"];
     };
-    multiSort: unknown extends Defaults["multiSort"] ? BooleanConstructor : {
-        type: PropType<unknown extends Defaults["multiSort"] ? boolean : boolean | Defaults["multiSort"]>;
-        default: unknown extends Defaults["multiSort"] ? boolean : boolean | Defaults["multiSort"];
+    multiSort: unknown extends Defaults["multiSort"] ? {
+        type: PropType<boolean | MultiSortProps>;
+        default: boolean;
+    } : Omit<{
+        type: PropType<boolean | MultiSortProps>;
+        default: boolean;
+    }, "default" | "type"> & {
+        type: PropType<unknown extends Defaults["multiSort"] ? boolean | MultiSortProps : boolean | MultiSortProps | Defaults["multiSort"]>;
+        default: unknown extends Defaults["multiSort"] ? boolean | MultiSortProps : Defaults["multiSort"] | NonNullable<boolean | MultiSortProps>;
     };
     mustSort: unknown extends Defaults["mustSort"] ? BooleanConstructor : {
         type: PropType<unknown extends Defaults["mustSort"] ? boolean : boolean | Defaults["mustSort"]>;
@@ -35,32 +54,41 @@ export type SortItem = {
     key: string;
     order?: boolean | 'asc' | 'desc';
 };
+export type MultiSortProps = {
+    key?: 'ctrl';
+    mode?: MultiSortMode;
+    modifier?: 'alt' | 'shift';
+};
+export type MultiSortMode = 'append' | 'prepend';
 type SortProps = {
+    initialSortOrder: 'asc' | 'desc';
     sortBy: readonly SortItem[];
     'onUpdate:sortBy': ((value: any) => void) | undefined;
+    multiSort: boolean | MultiSortProps;
     mustSort: boolean;
-    multiSort: boolean;
 };
 export declare function createSort(props: SortProps): {
+    initialSortOrder: Readonly<Ref<"asc" | "desc", "asc" | "desc">>;
     sortBy: Ref<readonly SortItem[], readonly SortItem[]> & {
         readonly externalValue: readonly SortItem[];
     };
+    multiSort: Readonly<Ref<boolean | MultiSortProps, boolean | MultiSortProps>>;
     mustSort: Readonly<Ref<boolean, boolean>>;
-    multiSort: Readonly<Ref<boolean, boolean>>;
 };
 export declare function provideSort(options: {
+    initialSortOrder: Ref<'asc' | 'desc'>;
     sortBy: Ref<readonly SortItem[]>;
+    multiSort: Ref<boolean | MultiSortProps>;
     mustSort: Ref<boolean>;
-    multiSort: Ref<boolean>;
     page?: Ref<number>;
 }): {
     sortBy: Ref<readonly SortItem[], readonly SortItem[]>;
-    toggleSort: (column: InternalDataTableHeader) => void;
+    toggleSort: (column: InternalDataTableHeader, event?: KeyboardEvent | PointerEvent | undefined) => void;
     isSorted: (column: InternalDataTableHeader) => boolean;
 };
 export declare function useSort(): {
     sortBy: Ref<readonly SortItem[], readonly SortItem[]>;
-    toggleSort: (column: InternalDataTableHeader) => void;
+    toggleSort: (column: InternalDataTableHeader, event?: KeyboardEvent | PointerEvent | undefined) => void;
     isSorted: (column: InternalDataTableHeader) => boolean;
 };
 // TODO: abstract into project composable

package/lib/components/VDataTable/composables/sort.js

@@ -2,60 +2,101 @@
 import { useLocale } from "../../../composables/locale.js";
 import { useProxiedModel } from "../../../composables/proxiedModel.js"; // Utilities
 import { computed, inject, provide, toRef } from 'vue';
-import { getObjectValueByPath, isEmpty, propsFactory } from "../../../util/index.js"; // Types
+import { getObjectValueByPath, isEmpty, isObject, propsFactory } from "../../../util/index.js"; // Types
 export const makeDataTableSortProps = propsFactory({
+  initialSortOrder: {
+    type: String,
+    default: 'asc',
+    validator: v => !v || ['asc', 'desc'].includes(v)
+  },
   sortBy: {
     type: Array,
     default: () => []
   },
   customKeySort: Object,
-  multiSort: Boolean,
+  multiSort: {
+    type: [Boolean, Object],
+    default: false
+  },
   mustSort: Boolean
 }, 'DataTable-sort');
 const VDataTableSortSymbol = Symbol.for('vuetify:data-table-sort');
 export function createSort(props) {
+  const initialSortOrder = toRef(() => props.initialSortOrder);
   const sortBy = useProxiedModel(props, 'sortBy');
   const mustSort = toRef(() => props.mustSort);
   const multiSort = toRef(() => props.multiSort);
   return {
+    initialSortOrder,
     sortBy,
-    mustSort,
-    multiSort
+    multiSort,
+    mustSort
+  };
+}
+function resolveMultiSort(multiSort, event) {
+  if (!isObject(multiSort)) {
+    return {
+      active: !!multiSort
+    };
+  }
+  const {
+    key,
+    mode,
+    modifier
+  } = multiSort;
+  const reverseMode = modifier === 'alt' && event?.altKey || modifier === 'shift' && event?.shiftKey;
+  return {
+    active: !key || event?.ctrlKey || event?.metaKey || false,
+    mode: reverseMode ? mode === 'append' ? 'prepend' : 'append' : mode
   };
 }
 export function provideSort(options) {
   const {
+    initialSortOrder,
     sortBy,
     mustSort,
     multiSort,
     page
   } = options;
-  const toggleSort = column => {
+  const toggleSort = (column, event) => {
     if (column.key == null) return;
     let newSortBy = sortBy.value.map(x => ({
       ...x
     })) ?? [];
     const item = newSortBy.find(x => x.key === column.key);
+    const initialOrder = initialSortOrder.value;
+    const secondaryOrder = initialSortOrder.value === 'desc' ? 'asc' : 'desc';
     if (!item) {
-      if (multiSort.value) {
-        newSortBy.push({
-          key: column.key,
-          order: 'asc'
-        });
+      const {
+        active,
+        mode
+      } = resolveMultiSort(multiSort.value, event);
+      if (active) {
+        if (mode === 'prepend') {
+          newSortBy.unshift({
+            key: column.key,
+            order: initialOrder
+          });
+        } else {
+          newSortBy.push({
+            key: column.key,
+            order: initialOrder
+          });
+        }
       } else {
         newSortBy = [{
           key: column.key,
-          order: 'asc'
+          order: initialOrder
         }];
       }
-    } else if (item.order === 'desc') {
+    } else if (item.order === secondaryOrder) {
       if (mustSort.value && newSortBy.length === 1) {
-        item.order = 'asc';
+        item.order = initialSortOrder.value;
       } else {
         newSortBy = newSortBy.filter(x => x.key !== column.key);
       }
     } else {
-      item.order = 'desc';
+      item.order = secondaryOrder;
     }
     sortBy.value = newSortBy;
     if (page) page.value = 1;