Sys.Component.create 메서드
업데이트: 2007년 11월
지정된 형식의 구성 요소를 만들고 초기화합니다. 이 메서드는 정적 메서드이며 클래스의 인스턴스를 만들지 않고 호출할 수 있습니다.
aComponent.create(type, properties, events, references, element);
매개 변수
매개 변수 |
설명 |
|---|---|
type |
만들 구성 요소의 형식입니다. |
properties |
(선택적 요소) 속성 및 속성 값을 기술하는 JSON 개체입니다. |
events |
(선택적 요소) 이벤트 및 이벤트 처리기를 기술하는 JSON 개체입니다. |
references |
(선택적 요소) 다른 구성 요소에 대한 참조로 사용되는 속성을 기술하는 JSON 개체입니다. |
element |
(선택적 요소) 구성 요소가 연결되어야 하는 DOM 요소입니다. |
반환 값
지정된 매개 변수를 사용하는 구성 요소의 새 인스턴스입니다.
설명
create 메서드는 지정된 형식의 구성 요소를 인스턴스화합니다. 구성 요소가 컨트롤 또는 동작인 경우 create 메서드는 지정된 요소에 구성 요소를 연결합니다. 이 메서드는 매개 변수로 전달되는 모든 속성 또는 이벤트를 설정한 후 initialize 메서드를 호출합니다.
새로 만드는 구성 요소는 직접 또는 Sys.UI.Control이나 Sys.UI.Behavior에서 파생되는 형식으로 Sys.Component 클래스에서 파생되어야 합니다. Sys.Application.init 이벤트가 실행되는 동안 create 메서드를 호출하여 만들고 있는 구성 요소를 페이지 로드 중에 사용할 수 있도록 해야 합니다.
$create 바로 가기 메서드를 사용하여 create 메서드를 호출할 수도 있습니다.
이 메서드에 사용되는 대부분의 매개 변수는 선택적 요소이지만 create 메서드를 호출할 때 전달하지 않는 매개 변수의 자리 표시자로 null을 포함해야 합니다. properties, events 및 references 매개 변수에 사용되는 값은 중괄호({})로 묶어야 하고 다음과 같은 표준 JSON 형식을 따라야 합니다.
{argument: value, argument2: value, ...}
다음 예제에서는 대부분의 매개 변수에 대한 값을 전달하는 create 메서드를 보여 줍니다.
$create(MyControl, {id: 'c1', visible: true}, {click: showValue}, null, $get('button1'));
이 메서드는 MyControl 클래스의 인스턴스를 만들고 id 속성을 "c1"으로, visible 속성을 true로 각각 설정합니다. 이 클래스에는 페이지에서 showValue() 함수에 바인딩되는 click 이벤트가 있습니다. 이 인스턴스는 ID가 "button1"인 HTML DOM 요소에 바인딩됩니다. 클래스에는 다른 구성 요소를 참조하는 속성이 없으므로 references 매개 변수가 null로 설정됩니다.
참고
다른 구성 요소의 initialize 메서드에서 create 메서드 또는 $create 바로 가기 메서드를 호출하지 마십시오. 호출할 경우 새 구성 요소가 올바르게 초기화되지 않습니다. 대신 새 구성 요소를 만들어 최상위 구성 요소에 참조로 전달합니다.
참고 항목
작업
개념
프로토타입 모델을 사용하여 클라이언트 구성 요소 클래스 만들기