PROPERTY
PROPERTY 함수는 객체를 속성별로 파싱합니다. 사용자는 객체의 값을 반환하기 위해 속성 경로를 지정할 수 있습니다. PROPERTY 함수는 반환된 객체를 유효한 속성 값으로 파싱하는 기능을 제공합니다. 예를 들어, 이 함수는 다중 열 선택기에서 유용하게 사용됩니다.
구문
PROPERTY(data_expression, property_path)
인수
이 함수는 다음 인수를 가집니다:
인수 | 설명 |
|---|---|
data_expression | 객체 데이터를 나타내며, 셀 참조를 받아들이고, 참조된 값은 객체이거나 객체 함수의 결과여야 합니다. |
property_path | 객체 내의 속성 경로를 나타냅니다. |
참고
data_expression이 객체가 아닐 경우 PROPERTY 함수는 #N/A 오류를 발생시킵니다. 또한 property_path가 객체 내에서 발견되지 않으면 #N/A 오류가 발생합니다.
데이터 유형
문자열 데이터를 받습니다.
예제
$(document).ready(function () {
// Spread 초기화
var spread = new GC.Spread.Sheets.Workbook(document.getElementById('ss'), { sheetCount: 1 });
// 현재 시트 가져오기
var sheet = spread.getActiveSheet();
// 데이터 소스는 배열
let dataSource = [
{
"NAME": "James Smith",
"POSITION": "AVP",
"OFFICE": "Fox Studios",
"EXTN": 71,
"START_DATE": '3/08/2008',
"JOINING_YEAR": 2008
}
];
let colInfos = [
{ name: "NAME", displayName: "NAME", size: "2*" },
{ name: "POSITION", displayName: "POSITION", size: "*" },
{ name: "OFFICE", size: "*" },
{ name: "EXTN", size: "*" },
{ name: "START_DATE", size: 100 },
{ name: "JOINING_YEAR", size: 100 }
];
// 스타일 생성
var style = new GC.Spread.Sheets.Style();
style.cellButtons = [
{
imageType: GC.Spread.Sheets.ButtonImageType.dropdown,
command: "openMultiColumn",
useButtonStyle: true,
}
];
style.dropDowns = [
{
type: GC.Spread.Sheets.DropDownType.multiColumn,
option: {
width: 600,
height: 150,
dataSource: dataSource,
bindingInfos: colInfos
}
}
];
// 스타일 포매터 설정
style.formatter = '=PROPERTY(@, "OFFICE")';
// 스타일 설정
sheet.setStyle(0, 1, style);
// 텍스트 설정
sheet.setText(0, 0, "DataSource는 배열이며, 'OFFICE' 속성 값으로 파싱된 데이터를 반환합니다.");
// 줄 바꿈 설정
sheet.getCell(0, 0).wordWrap(true);
sheet.getCell(0, 1).wordWrap(true);
// 열 너비 설정
sheet.setColumnWidth(0, 200);
sheet.setColumnWidth(1, 400);
// 행 높이 설정
sheet.setRowHeight(0, 70);
});점(.) 연산자
SpreadJS는 PROPERTY 수식 함수의 축약형으로 점 연산자 “.”를 제공합니다. 이는 PROPERTY 함수를 단순화하여 코드를 더 읽기 쉽게 만듭니다. 점 연산자는 왼쪽 값으로 객체를, 오른쪽 값으로 객체의 필드를 받습니다. 오른쪽 값에 불법 문자가 있을 경우 따옴표로 감쌀 수도 있습니다.
참고: 점 “.” 연산자는 PROPERTY 함수와 마찬가지로 대소문자를 구분합니다.
예제
PROPERTY 수식과 점 연산자의 사용 비교:
PROPERTY 수식 함수:
=PROPERTY(G10,"User.Address.Home")점 연산자:
=G10.User.Address.Home
점 연산자에서 왼쪽 값은 객체 또는 객체 참조이며, 오른쪽 값은 객체의 필드입니다.