AUIGrid Documentation

LinkRenderer

링크 렌더러는 a 태그의 하이퍼 링크를 출력하는 칼럼 렌더러입니다.

링크 렌더러는 칼럼 레이아웃을 정의할 때 개별 칼럼의 renderer 속성 값인 Object 형태로 선언되어야 합니다.

칼럼의 renderer 속성의 type 으로만 설정 가능합니다.

아래는 설정 예제 입니다.

var columnLayout = [ {
     dataField : "name",
     headerText : "Name",
     width : 140
}, {
     dataField : "country",
     headerText : "Country",
     width : 160,
     renderer : {
            type : "LinkRenderer",
            linkField : "country",
            baseUrl : "http://en.wikipedia.org/wiki/" // 기본 URL
     }
}];

Name Description

Name	Description
baseUrl	Type : String linkField 의 값이 부분 URL 에 해당될 때 기본이 되는 URL 을 지정합니다. 예를 들어 linkField 의 값들이 개별적으로 "A", "B", "C" 라면, 이 값들은 일종의 파라메터 역할을 할 것입니다. 따라서 하이퍼 링크로 연결될 기본 URL(http:// 로 시작하는 절대 경로)를 baseUrl 에서 설정합니다. 만약 baseUrl 을 "http://mydomain.com/param=" 으로 설정한다면 하이퍼 링크는 데이터에 따라 "http://mydomain.com/param=A", "http://mydomain.com/param=B" 와 같이 구성됩니다. 만약 baseUrl 을 설정하지 않으면 linkField 의 값은 전체(Full) URL 이여야 합니다. 더 나아가 baseUrl 을 "javascript" 로 설정하면, 자바스크립트 함수를 실행 시키는 역할로 LinkRenderer 를 사용할 수 있습니다. 만약 baseUrl 을 "javascript" 로 설정했다면, jsCallback 을 반드시 정의해야 합니다. 기본값(default) : `""`.
jsCallback	Type : Function baseUrl 을 "javascript"로 설정한 경우, 호출될 자바스크립트 콜백 함수를 설정합니다. jsCallback 은 함수를 지정해야 하며 함수 형태는 다음과 같습니다. rowIndex : 행 인덱스 columnIndex : 칼럼 인덱스 value : 원래 데이터의 해당 셀 값(value) item : 해당 행에 출력되고 있는 행 아이템 객체 (Object) jsCallback : function(rowIndex, columnIndex, value, item) { alert("( " + rowIndex + ", " + columnIndex + " ) " + item.color + " Link 클릭\r\n자바스크립트 함수 호출하고자 하는 경우로 사용하세요!"); } 기본값(default) : `null`.
linkField	Type : String 하이퍼 링크에 적용될 URL 이 있는 필드명를 지정합니다. 이 필드명은 데이터에 존재하는 필드명이여야 합니다.( dataField 와 같은 이치) linkField 의 값은 전체(Full) URL 일 수 도 있고, 부분 URL 일 수 도 있습니다. 만약 linkField 의 값이 전체 URL 이라면(http:// 로 시작하는 절대 경로) baseUrl 속성을 설정할 필요는 없습니다. 기본값(default) : `null`.

baseUrl

Type : String

linkField 의 값이 부분 URL 에 해당될 때 기본이 되는 URL 을 지정합니다.

예를 들어 linkField 의 값들이 개별적으로 "A", "B", "C" 라면, 이 값들은 일종의 파라메터 역할을 할 것입니다.

따라서 하이퍼 링크로 연결될 기본 URL(http:// 로 시작하는 절대 경로)를 baseUrl 에서 설정합니다.

만약 baseUrl 을 "http://mydomain.com/param=" 으로 설정한다면 하이퍼 링크는 데이터에 따라 "http://mydomain.com/param=A", "http://mydomain.com/param=B" 와 같이 구성됩니다.

만약 baseUrl 을 설정하지 않으면 linkField 의 값은 전체(Full) URL 이여야 합니다.

더 나아가 baseUrl 을 "javascript" 로 설정하면, 자바스크립트 함수를 실행 시키는 역할로 LinkRenderer 를 사용할 수 있습니다.

만약 baseUrl 을 "javascript" 로 설정했다면, jsCallback 을 반드시 정의해야 합니다.

기본값(default) : "".

jsCallback

Type : Function

baseUrl 을 "javascript"로 설정한 경우, 호출될 자바스크립트 콜백 함수를 설정합니다.

jsCallback 은 함수를 지정해야 하며 함수 형태는 다음과 같습니다.

rowIndex : 행 인덱스
columnIndex : 칼럼 인덱스
value : 원래 데이터의 해당 셀 값(value)
item : 해당 행에 출력되고 있는 행 아이템 객체 (Object)

 jsCallback : function(rowIndex, columnIndex, value, item) {
    alert("( " + rowIndex + ", " + columnIndex + " ) " + item.color + "  Link 클릭\r\n자바스크립트 함수 호출하고자 하는 경우로 사용하세요!");
 }

기본값(default) : null.

linkField

Type : String

하이퍼 링크에 적용될 URL 이 있는 필드명를 지정합니다. 이 필드명은 데이터에 존재하는 필드명이여야 합니다.( dataField 와 같은 이치)

linkField 의 값은 전체(Full) URL 일 수 도 있고, 부분 URL 일 수 도 있습니다.

만약 linkField 의 값이 전체 URL 이라면(http:// 로 시작하는 절대 경로) baseUrl 속성을 설정할 필요는 없습니다.

기본값(default) : null.