개요
XML 문자열을 해석하여 DOMDocument 오브젝트를 생성하기 위한 오브젝트입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
- 자바스크립트의 DOMParser 와 별도로 넥사크로에서 제공하는 오브젝트입니다.
생성자
new nexacro.DomParser();
// Create Object var objDom = new nexacro.DomParser(); // Create DOMDocument Object var objDomDoc = objDom.parseFromString( strXMLData ); |
속성
name
DomParser 의 이름을 설정하는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
속성 타입
☐ Enum | ☐ Expr | ☐ Control | ☑ Hidden | ☐ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법
DomParser.name[= strName]
문법 설정
strName | 컴포넌트의 이름을 설정합니다. | |
|---|---|---|
참고
- name 속성은 사용자가 지정한 컴포넌트의 이름으로 논리적으로 중복이 가능합니다. - 넥사크로 스튜디오에서 컴포넌트를 생성하거나 id 값을 설정하면 name 속성에 동일한 값이 설정됩니다.
메서드
addEvent
DomParser 에 특정 이벤트를 선언하여 추가하는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
문법
DomParser.addEvent( strEventID )
파라미터
Parameters | Type | Description | |
|---|---|---|---|
strEventID | String | DomParser 에 추가할 이벤트의 ID 를 문자열로 설정합니다. | |
var bResult = this.DomParser00.addEvent( "onmove" ); | |||
반환
Type | Description |
|---|---|
Boolean | 이벤트 추가에 성공하면 true 를 반환합니다. 이벤트 추가에 실패하거나 선언되어 있는 이벤트 ID 설정 시 false 를 반환합니다. |
참고
- Composite Component 와 같은 사용자 컴포넌트에 특정 이벤트를 추가할 때 사용하는 메소드입니다. - DomParser 에서 특정 이벤트를 제거하려면 removeEvent() 메소드를 사용하여야 합니다.
addEventHandler
DomParser 의 특정 이벤트에 핸들러 함수를 추가하는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
문법
DomParser.addEventHandler( strEventID, objFunc, objTarget )
파라미터
Parameters | Type | Description | |
|---|---|---|---|
strEventID | String | 핸들러 함수가 추가될 이벤트의 ID를 설정합니다. | |
objFunc | Object | 이벤트 발생 시 수행될 핸들러 함수를 설정합니다. | |
objTarget | Object | 핸들러 함수가 정의된 영역을 설정합니다. | |
this.DomParser00_onmove = function( obj:nexacro.DomParser, e:nexacro.MoveEventInfo) { // 수행할 스크립트 }; var nIndex = this.DomParser00.addEventHandler( "onmove", this.DomParser00_onmove, this); | |||
반환
Type | Description |
|---|---|
Number | 이벤트에 추가된 핸들러 함수의 인덱스를 반환합니다. 동일한 핸들러 함수가 이미 있다면 해당 핸들러 함수의 인덱스를 반환합니다. 정상적으로 추가되지 않은 경우에는 -1 을 반환합니다. |
addEventHandlerLookup
함수를 검색하여 DomParser 의 특정 이벤트에 핸들러 함수로 추가하는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
문법
DomParser.addEventHandlerLookup( strEventID, strFunc, objTarget )
파라미터
Parameters | Type | Description | |
|---|---|---|---|
strEventID | String | 핸들러 함수가 추가될 이벤트의 ID를 설정합니다. | |
strFunc | String | 이벤트 발생 시 수행될 핸들러 함수의 이름을 문자열로 설정합니다. | |
objTarget | Object | 핸들러 함수를 검색할 영역을 설정합니다. 해당 영역에 함수가 정의되지 않았다면 상위 영역으로 올라가며 검색을 합니다. | |
this.DomParser00_onmove = function( obj:nexacro.DomParser, e:nexacro.MoveEventInfo) { // 수행할 스크립트 }; var nIndex = this.DomParser00.addEventHandlerLookup( "onmove", "DomParser00_onmove", this); | |||
반환
Type | Description |
|---|---|
Number | 이벤트에 추가된 핸들러 함수의 인덱스를 반환합니다. 동일한 핸들러 함수가 이미 있다면 해당 핸들러 함수의 인덱스를 반환합니다. 정상적으로 추가되지 않은 경우에는 "-1"을 반환합니다. |
참고
- strFunc 이름의 함수를 objTarget 영역부터 상위로 올라가며 검색합니다. 검색된 함수가 있다면 이벤트에 핸들러 함수로 추가합니다.
clearEventHandler
특정 이벤트에 등록된 핸들러 함수를 모두 제거하는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
문법
DomParser.clearEventHandler( strEventID )
파라미터
Parameters | Type | Description | |
|---|---|---|---|
strEventID | String | 모든 핸들러 함수를 제거할 이벤트의 ID를 설정합니다. | |
var nCnt = this.DomParser00.clearEventHandler( "onmove" ); | |||
반환
Type | Description |
|---|---|
Number | 특정 이벤트에서 제거된 핸들러 함수의 갯수를 반환합니다. |
참고
- 특정 핸들러 함수만 제거하려면 removeEventHandler() 메소드를 사용하여야 합니다.
findEventHandler
DomParser 의 특정 이벤트에서 핸들러 함수를 찾아 인덱스를 반환하는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
문법
DomParser.findEventHandler( strEventID, objFunc, objTarget )
파라미터
Parameters | Type | Description | |
|---|---|---|---|
strEventID | String | 핸들러 함수를 찾을 이벤트의 ID를 설정합니다. | |
objFunc | Object | 찾으려고 하는 핸들러 함수를 설정합니다. | |
objTarget | Object | 찾으려고 하는 핸들러 함수가 정의된 영역을 설정합니다. | |
this.DomParser00_onmove = function( obj:nexacro.DomParser, e:nexacro.MoveEventInfo ) { //수행할 스크립트 }; var nIndex = this.DomParser00.findEventHandler( "onmove", this.DomParser00_onmove, this ); | |||
반환
Type | Description |
|---|---|
Number | 특정 이벤트에서 찾은 핸들러 함수의 인덱스를 반환합니다. 특정 이벤트에 찾으려는 핸들러 함수가 존재하지 않으면 -1 을 반환합니다. |
참고
- 핸들러 함수의 인덱스는 0 부터 시작합니다.
getEventHandler
DomParser 의 특정 이벤트에서 지정된 인덱스에 해당하는 핸들러 함수를 반환하는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
문법
DomParser.getEventHandler( strEventID, nIdx )
파라미터
Parameters | Type | Description | |
|---|---|---|---|
strEventID | String | 핸들러 함수를 얻을 이벤트의 ID를 설정합니다. | |
nIdx | Number | 얻으려고 하는 핸들러 함수의 인덱스를 설정합니다. 핸들러 함수의 인덱스는 0 부터 시작합니다. | |
var objFunc = DomParser00.getEventHandler( "onmove", 0 ); | |||
반환
Type | Description |
|---|---|
Object | 지정된 인덱스의 핸들러 함수 오브젝트를 반환합니다. 지정된 인덱스에 핸들러 함수가 존재하지 않는다면 null 을 반환합니다. |
insertEventHandler
DomParser 의 특정 이벤트에 핸들러 함수를 지정한 위치에 삽입하는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
문법
DomParser.insertEventHandler( strEventID, nIndex, objFunc, objTarget )
파라미터
Parameters | Type | Description | |
|---|---|---|---|
strEventID | String | 핸들러 함수가 삽입될 이벤트의 ID 를 설정합니다. | |
nIndex | Number | 핸들러 함수가 삽입될 위치를 인덱스로 설정합니다. -1 값 설정 시 마지막에 추가됩니다. 이벤트에 설정된 핸들러 함수의 갯수보다 큰 값을 설정한 경우 마지막에 추가됩니다. NaN 값을 입력하면 ECMA 의 정수 변환 규칙에 따라 0 이 설정됩니다. | |
objFunc | Object | 이벤트 발생 시 수행될 핸들러 함수를 설정합니다. | |
objTarget | Object | 핸들러 함수가 정의된 영역을 설정합니다. | |
this.DomParser00_onmove = function( obj:nexacro.DomParser, e:nexacro.MoveEventInfo) { // 수행할 스크립트 }; var nIndex = this.DomParser00.insertEventHandler( "onmove", 0, this.DomParser00_onmove, this); | |||
반환
Type | Description |
|---|---|
Number | 이벤트에 삽입된 핸들러 함수의 인덱스를 반환합니다. 동일한 핸들러 함수가 이미 있다면 해당 핸들러 함수의 인덱스를 반환합니다. 핸들러 함수가 정상적으로 삽입되지 않은 경우에는 -1 을 반환합니다. |
참고
- 첫번째 핸들러 함수의 인덱스는 0 입니다.
parseFromString
XML 문자열을 해석해 DOMDocument 오브젝트를 생성하고 반환하는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
문법
DomParser.parseFromString( strXML )
파라미터
Parameters | Type | Description | |
|---|---|---|---|
strXML | String | DOMDocument 오브젝트로 변환하려는 XML 문자열을 설정합니다. "text/xml" 형식의 문자열만 설정할 수 있습니다. | |
var objDom00 = new nexacro.DomParser(); var objDomDoc = objDom00.parseFromString( strXML ); | |||
반환
Type | Description |
|---|---|
Object | XML 문자열 해석에 성공하면 DOMDocumnet 오브젝트를 반환합니다. XML 문자열 해석에 실패하면 null 값을 반환합니다. |
활용 예제
removeEvent
DomParser 에 선언된 특정 이벤트를 삭제하는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
문법
DomParser.removeEvent( strEventID )
파라미터
Parameters | Type | Description | |
|---|---|---|---|
strEventID | String | DomParser 에서 삭제할 이벤트의 ID 를 문자열로 설정합니다. | |
var bResult = this.DomParser00.removeEvent( "onmove" ); | |||
반환
Type | Description |
|---|---|
Boolean | 이벤트 삭제에 성공하면 true 를 반환합니다. 이벤트 삭제에 실패하거나 선언되지 않은 이벤트 ID 설정 시 false 를 반환합니다. |
참고
- Composite Component 와 같은 사용자 컴포넌트에서 특정 이벤트를 삭제할 때 사용하는 메소드입니다. - 이벤트에 핸들러 함수가 정의되어 있을 경우 이벤트를 삭제할 수 없습니다. - DomParser 에 특정 이벤트를 추가하려면 addEvent() 메소드를 사용하여야 합니다. - DomParser 에 기본으로 선언되어 있는 이벤트 삭제 시 오동작 할 수 있으므로 주의하여야 합니다.
removeEventHandler
DomParser 의 특정 이벤트에서 핸들러 함수를 제거하는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
문법
DomParser.removeEventHandler( strEventID, objFunc, objTarget )
파라미터
Parameters | Type | Description | |
|---|---|---|---|
strEventID | String | 핸들러 함수를 제거할 이벤트의 ID를 설정합니다. | |
objFunc | Object | 제거할 핸들러 함수를 설정합니다. | |
objTarget | Object | 제거할 핸들러 함수가 정의된 영역을 설정합니다. | |
this.DomParser00_onmove = function( obj:nexacro.DomParser, e:nexacro.MoveEventInfo) { // 수행할 스크립트 }; var nIndex = this.DomParser00.removeEventHandler( "onmove", this.DomParser00_onmove, this); | |||
반환
Type | Description |
|---|---|
Number | 핸들러 함수 제거에 성공하면 1 을 반환합니다. 핸들러 함수 제거에 실패하면 0 을 반환합니다. |
참고
- 핸들러 함수가 제거되면 핸들러 함수의 인덱스가 0 번부터 재조정됩니다. - 이벤트에 등록된 핸들러 함수를 모두 제거하려면 clearEventHandler() 메소드를 사용하여야 합니다.
removeEventHandlerLookup
DomParser 의 특정 이벤트에서 검색된 함수와 동일한 핸들러 함수를 제거하는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
문법
DomParser.removeEventHandlerLookup( strEventID, strFunc, objTarget )
파라미터
Parameters | Type | Description | |
|---|---|---|---|
strEventID | String | 핸들러 함수를 제거할 이벤트의 ID를 설정합니다. | |
strFunc | String | 제거할 핸들러 함수의 이름을 문자열로 설정합니다. | |
objTarget | Object | 제거할 핸들러 함수가 정의된 영역을 설정합니다. 해당 영역에 함수가 정의되지 않았다면 상위 영역으로 올라가며 검색을 합니다. | |
this.DomParser00_onmove = function( obj:nexacro.DomParser, e:nexacro.MoveEventInfo) { // 수행할 스크립트 }; var nIndex = this.DomParser00.removeEventHandlerLookup( "onmove", "DomParser00_onmove", this); | |||
반환
Type | Description |
|---|---|
Number | 핸들러 함수 제거에 성공하면 1 을 반환합니다. 핸들러 함수 제거에 실패하면 0 을 반환합니다. |
참고
- 핸들러 함수가 제거되면 핸들러 함수의 인덱스가 0 번부터 재조정됩니다. - 이벤트에 등록된 핸들러 함수를 모두 제거하려면 clearEventHandler() 메소드를 사용하여야 합니다.
setEventHandler
DomParser 의 특정 이벤트에서 첫번째 핸들러 함수를 변경하는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
문법
DomParser.setEventHandler( strEventID, objFunc, objTarget )
파라미터
Parameters | Type | Description | |
|---|---|---|---|
strEventID | String | 핸들러 함수를 변경할 이벤트의 ID를 설정합니다. | |
objFunc | Object | 기존 핸들러 함수를 대체할 함수를 설정합니다. | |
objTarget | Object | 대체할 핸들러 함수가 정의된 영역을 설정합니다. | |
this.DomParser00_onmove = function( obj:nexacro.DomParser, e:nexacro.MoveEventInfo ) { //수행할 스크립트 }; var nIndex = this.DomParser00.setEventHandler( "onmove", this.DomParser00_onmove, this ); | |||
반환
Type | Description |
|---|---|
Number | 첫번째 핸들러 함수 변경에 성공하면 0 을 반환합니다. 첫번째 핸들러 함수 변경에 실패하면 -1 을 반환합니다. |
참고
- 인덱스가 0 번인 핸들러 함수를 새로운 함수로 대체합니다. - 인덱스가 0 번인 핸들러 함수가 없다면 0 번 인덱스에 새로운 함수를 핸들러 함수로 추가합니다.
setEventHandlerLookup
DomParser 의 특정 이벤트에서 첫번째 핸들러 함수를 검색된 함수로 변경하는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
문법
DomParser.setEventHandlerLookup( strEventID, strFunc, objTarget )
파라미터
Parameters | Type | Description | |
|---|---|---|---|
strEventID | String | 핸들러 함수를 변경할 이벤트의 ID를 설정합니다. | |
strFunc | Object | 기존 핸들러 함수를 대체할 함수의 이름을 문자열로 설정합니다. | |
objTarget | Object | 대체할 핸들러 함수를 검색할 영역을 설정합니다. 해당 영역에 함수가 정의되지 않았다면 상위 영역으로 올라가며 검색을 합니다. | |
this.DomParser00_onmove = function( obj:nexacro.DomParser, e:nexacro.MoveEventInfo) { // 수행할 스크립트 }; var nIndex = this.DomParser00.setEventHandlerLookup( "onmove", "DomParser00_onmove", this); | |||
반환
Type | Description |
|---|---|
Number | 첫번째 핸들러 함수 변경에 성공하면 0 을 반환합니다. 첫번째 핸들러 함수 변경에 실패하면 -1 을 반환합니다. |
참고
- 인덱스가 0 번인 핸들러 함수를 검색된 함수로 대체합니다. - 인덱스가 0 번인 핸들러 함수가 없다면 0 번 인덱스에 검색된 함수를 핸들러 함수로 추가합니다.
이벤트
onerror
XML 문자열 Parsing 중 오류가 생겼을 때 발생하는 이벤트입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
문법
onerror(obj:nexacro.DomParser,e:nexacro.DomParseErrorEventInfo);
파라미터
Parameters | Type | Description | |
|---|---|---|---|
obj | DomParser | Event가 발생한 Object. | |
e | Event Object. | ||