수식

베이스 수식 필드는 테이블 데이터에서 레코드 값을 계산합니다. UniverBasesPlugin은 수식 엔진 종속성을 자동으로 등록합니다.

수식 지원 등록

TypeScript
import { UniverBasesPlugin } from '@univerjs-pro/bases'import { UniverBasesUIPlugin } from '@univerjs-pro/bases-ui'univer.registerPlugin(UniverBasesPlugin)univer.registerPlugin(UniverBasesUIPlugin)

수식 필드 만들기

TypeScript
const formulaTableName = table.getFormulaName()const total = table.addField('Total', univerAPI.Enum.BaseFieldType.Formula, {  field: {    config: {      formula: `=SUM(${formulaTableName}[[#This Row],[Price]],${formulaTableName}[[#This Row],[Tax]])`,    },  },  externalReferences: [],})

모든 수식 필드 쓰기에는 externalReferences가 필요합니다. 호스트 베이스의 필드만 참조하는 수식에는 []를 사용하세요. 유닛 간 수식은 buildReference를 사용하고 모든 안정적인 소스 바인딩을 이 배열에 전달해야 합니다.

참고 사항

  • 수식 필드는 계산으로 얻는 값이므로 애플리케이션 코드에서 수식 셀에 직접 값을 쓰지 마세요.
  • 수식 표현식은 Table[[#This Row],[Price]]와 같은 구조화된 필드 참조를 사용합니다.
  • 대용량 스냅샷을 가져온 뒤에는 사용자에게 결과를 표시하기 전에 수식을 다시 계산하세요.

이 가이드는 어떠셨나요?

© 2026 DreamNum Co., Ltd.