====== link_data 속성 가이드======
컴포넌트 link_data 기능에 대한 예시 화면이다.
단건 표시용 컴포넌트(필드, 체크박스 등등)는 link_data 속성을 통해 데이터셋의 특정 컬럼과 연결된다.
다건 표시용 컴포넌트(그리드)는 link_data 속성과 컬럼별 link_data 속성을 통해 데이터셋과 연결된다.
데이터셋은 UI 없이 데이터만을 처리하기 위한 기능성 컴포넌트이며, 데이터 셋과 UI 컴포넌트간은 1:N의 관계를 가진다.
데이터셋 값 또는 현재행(선택행) 변경시 링크된 모든 컴포넌트에 해당 내용이 반영된다.
단건 표시용 컴포넌트(필드, 체크박스 등등)는 데이터셋의 현재행의 값을 표시/설정한다.
단건 표시용 컴포넌트는 컴포넌트 특성에 맞추어 데이터셋과 연관된 값을 표시/처리한다.
관련 속성에는 link_data가 있다.
관련 API에는 getlinkxdataset, getlinkxdatasetid, getlinkxdatasetcolumnid가 있다.
===== 예시 =====
템플릿 위치: /HTML5/COMPONENT/COMMON/linkdata_basic
템플릿 파일
* [[xf5projecthome>template/screen/HTML5/COMPONENT/COMMON/linkdata_basic.xml|linkdata_basic.xml]]
* [[xf5projecthome>template/screen/HTML5/COMPONENT/COMMON/linkdata_basic.js|linkdata_basic.js]]
* [[xf5projecthome>template/template.html?xframe_screen_url=/HTML5/COMPONENT/COMMON/linkdata_basic|새창으로 실행]]
echo '';
echo '';
echo '';
==== 화면 스크립트 ====
// "getlinkxdataset" 버튼 이벤트
function btn_getlinkxdataset_on_click(objInst)
{
var xdataset_inst;
// 링크된 데이터셋 인스턴스를 구함
xdataset_inst = fld_linkdata.getlinkxdataset();
if (xdataset_inst == null) {
screen.alert("getlinkxdataset return null");
return;
}
// 링크된 데이터셋의 getid 함수를 호출하여 데이터셋 ID 표시
fld_getlinkxdataset.settext(xdataset_inst.getid());
}
// "getlinkxdatasetid" 버튼 이벤트
function btn_getlinkxdatasetid_on_click(objInst)
{
// 링크된 데이터셋 ID 표시
fld_getlinkxdatasetid.settext(fld_linkdata.getlinkxdatasetid());
}
// "getlinkxdatasetcolumnid" 버튼 이벤트
function btn_getlinkxdatasetcolumnid_on_click(objInst)
{
// 링크된 데이터셋 컬럼 ID 표시
fld_getlinkxdatasetcolumnid.settext(fld_linkdata.getlinkxdatasetcolumnid());
}