Clasificación

La funcionalidad de clasificación permite a los usuarios ordenar datos en hojas de cálculo para una mejor organización y análisis. Admite varios métodos de clasificación, incluida la clasificación ascendente, descendente y personalizada, lo que ayuda a los usuarios a encontrar rápidamente los datos que necesitan.

Filtrar y ordenar un plan de estudio

Filtra los cursos y ordénalos por progreso. Sigue cada registro mediante su ID.

ID del registroCursoProgreso
1Sheets
86%
2Docs
100%
3Slides
64%
4Bases
92%
5Boards
48%
6PDFs
78%

Registros visibles: 6 / 6

El filtro oculta registros; la ordenación cambia su posición. Quita el filtro para verlos todos.

Modo de complemento

Instalación

Shell
pnpm add @univerjs/sheets-sort @univerjs/sheets-sort-ui

Uso

TypeScript
import { LocaleType, mergeLocales, Univer } from '@univerjs/core'import { UniverSheetsSortPlugin } from '@univerjs/sheets-sort'import { UniverSheetsSortUIPlugin } from '@univerjs/sheets-sort-ui'import SheetsSortUIEnUS from '@univerjs/sheets-sort-ui/locale/en-US'import '@univerjs/sheets-sort-ui/lib/index.css'import '@univerjs/sheets-sort/facade'const univer = new Univer({  locale: LocaleType.EN_US,  locales: {    [LocaleType.EN_US]: mergeLocales(      SheetsSortUIEnUS,     ),  },})univer.registerPlugin(UniverSheetsSortPlugin)univer.registerPlugin(UniverSheetsSortUIPlugin)

Compatibilidad móvil

Configure primero el editor móvil. En la inicialización en modo plugin de esta página, sustituya los registros de escritorio siguientes por las exportaciones móviles de los mismos paquetes antes de abrir un documento. Conserve modelos, estilos, traducciones e importaciones Facade; no registre ambas variantes.

PaqueteRegistro de escritorioRegistro móvil
@univerjs/sheets-sort-uiUniverSheetsSortUIPluginUniverSheetsSortMobileUIPlugin

Modo preestablecido

Instalación

Shell
pnpm add @univerjs/preset-sheets-sort

Uso

TypeScript
import { UniverSheetsCorePreset } from '@univerjs/preset-sheets-core'import UniverPresetSheetsCoreEnUS from '@univerjs/preset-sheets-core/locales/en-US'import { UniverSheetsSortPreset } from '@univerjs/preset-sheets-sort'import UniverPresetSheetsSortEnUS from '@univerjs/preset-sheets-sort/locales/en-US'import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'import '@univerjs/preset-sheets-core/lib/index.css'import '@univerjs/preset-sheets-sort/lib/index.css'const { univerAPI } = createUniver({  locale: LocaleType.EN_US,  locales: {    [LocaleType.EN_US]: mergeLocales(      UniverPresetSheetsCoreEnUS,      UniverPresetSheetsSortEnUS,     ),  },  presets: [    UniverSheetsCorePreset(),    UniverSheetsSortPreset(),   ],})

API de Facade

Las definiciones completas del tipo de API de Facade se pueden encontrar en la FacadeAPI.

Importar

Plugin mode note

Solo el modo complemento requiere importar manualmente el paquete Facade. El modo Preestablecido ya incluye el paquete Facade correspondiente, por lo que no se necesita ninguna importación adicional.

TypeScript
import '@univerjs/sheets-sort/facade'

Clasificación de hojas de trabajo

El método FWorksheet.sort(colIndex, asc) puede ordenar la hoja de trabajo por la columna especificada.

TypeScript
const fWorkbook = univerAPI.getActiveWorkbook()const fWorksheet = fWorkbook.getActiveSheet()// Sorts the worksheet in ascending order based on the first columnfWorksheet.sort(0)// Sorts the worksheet in descending order based on the first columnfWorksheet.sort(0, false)

Clasificación de rangos

El método FRange.sort(column) puede ordenar las celdas en un rango específico por la columna y el orden dados.

TypeScript
const fWorkbook = univerAPI.getActiveWorkbook()const fWorksheet = fWorkbook.getActiveSheet()const fRange = fWorksheet.getRange('D1:G10')// Sorts the range in ascending order based on the first columnfRange.sort(0)// Sorts the range in descending order based on the first columnfRange.sort({ column: 0, ascending: false })// Sorts the range in descending order based on the first column and ascending order based on the second columnfRange.sort([{ column: 0, ascending: false }, 1])

Escuchas de eventos

Las definiciones completas de tipos de eventos se pueden encontrar en Eventos.

El evento SheetRangeSorted se activa después de que se completa la ordenación del rango de celdas.

TypeScript
const disposable = univerAPI.addEvent(univerAPI.Event.SheetRangeSorted, (params) => {  const { workbook, worksheet, range, sortColumn } = params})// Remove event listener using `disposable.dispose()`

El evento SheetBeforeRangeSort se activa antes de la ordenación del rango de celdas.

TypeScript
const disposable = univerAPI.addEvent(univerAPI.Event.SheetBeforeRangeSort, (params) => {  const { workbook, worksheet, range, sortColumn } = params  // Cancel the sorting operation  params.cancel = true})// Remove event listener using `disposable.dispose()`

¿Cómo es esta guía?

© 2026 DreamNum Co., Ltd.