guide:component:common:linkdata_basic [xFrame5 TechNet]

이 문서는 읽기 전용입니다. 원본을 볼 수는 있지만 바꿀 수는 없습니다. 문제가 있다고 생각하면 관리자에게 문의하세요.
====== 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|새창으로 실행]]

<php>
echo '<html>';
echo '<iframe src="';
echo $conf['plugin']['xf5']['xf5projecthome'], 'template/template.html?';
echo 'xframe_screen_url=/HTML5/COMPONENT/COMMON/linkdata_basic"';
echo ' class="_xf5_iframe"';
echo ' style="';
echo $conf['plugin']['xf5']['xf5iframestyle'];
echo '">';
echo '</iframe>';
echo '</html>';
</php>

==== 화면 스크립트 ====

<sxh javascript>
// "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());
}
</sxh>