개요
Animation 오브젝트에서 addTarget() 메소드 실행 시 파라미터 값을 기준으로 생성되는 아이템 오브젝트입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
- addTarget() 메소드 실행 시 AnimationItem 오브젝트가 생성되어 Animation 오브젝트에 아이템으로 등록됩니다. - Animation 오브젝트에 addTarget() 메소드로 AnimationItem 오브젝트를 여러개 등록할 수 있습니다. - Animation 오브젝트 실행 시 아이템으로 등록된 컴포넌트에 애니메이션 효과를 동시에 적용합니다.
속성
componentid
애니메이션 효과가 적용될 대상 컴포넌트를 설정하는 속성입니다.
지원 환경
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 |
문법
AnimationItem.componentid
문법 설정
var objAni = new nexacro.Animation("Animation00", this); objAni.addTarget( "AniItem00", this.Button00, "left:600" ); | ||
componentid | 애니메이션 효과가 적용될 대상 컴포넌트를 addTarget() 메소드를 사용하여 등록합니다. addTarget() 메소드에 설정한 두번째 파라미터가 AnimationItem 오브젝트의 componentid 값으로 설정됩니다. | |
|---|---|---|
참고
- AnimationItem 오브젝트에 컴포넌트를 한개만 설정할 수 있습니다. 애니메이션 효과가 적용될 컴포넌트를 추가하려면 AnimationItem 오브젝트를 추가하여야 합니다.
id
AnimationItem 오브젝트의 고유 식별자가 설정되는 속성입니다.
지원 환경
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 |
문법
AnimationItem.id
문법 설정
var iItemIdx = this.Animation00.addTarget( "AnimationItem00", this.Button00, "left:600" ); | ||
id | Animation 오브젝트의 addTarget() 메소드 실행 시 첫번째 파라미터가 id 값으로 설정됩니다. | |
|---|---|---|
props
애니메이션 효과가 적용될 속성과 속성값을 설정하는 속성입니다.
지원 환경
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 |
문법
AnimationItem.props
문법 설정
strProps ::= <propName> ':' <propValue> [ ',' <propName> ':' <propValues> ]* <propValues> ::= '[' <strValue> [ ',' <strValue> ]* ']' | ||
var objAni = new nexacro.Animation("Animation00", this); objAni.addTarget( "AniItem00", this.Button00, "left:600" ); objAni.addTarget( "AniItem01", this.Button01, "left:[100,600]" ); objAni.addTarget( "AniItem02", this.Button02, "left:[100,600], background:['white','blue']" ); | ||
strProps | 애니메이션 효과가 적용될 속성명과 속성값을 addTarget() 메소드를 사용하여 등록합니다. addTarget() 메소드에 설정한 세번째 파라미터가 AnimationItem 오브젝트의 props 값으로 설정됩니다. 속성명과 속성값은 ":" 문자로 구분하여 한 개 이상 설정할 수 있습니다. 각 속성은 "," 문자로 구분하여 설정합니다. | |
|---|---|---|
<propName> | 애니메이션 효과가 적용될 속성명을 설정합니다. 읽기전용 속성은 설정할 수 없습니다. | |
<propValues> | 애니메이션 효과가 수행되면서 변경시킬 속성값을 설정합니다. 속성값을 여러개 설정할 경우 "[","]" 문자를 사용하여 배열 형태로 설정하며 각 값은 "," 문자로 구분합니다. | |
참고
- 애니메이션 효과는 props 에 설정된 속성의 값을 duration 에 설정된 시간 동안 props 에 설정된 속성값으로 변경시키며 적용됩니다. - props 에 설정된 속성값은 애니메이션 효과가 실행되는 동안 균등 분할되어 적용됩니다. 예를 들어 "left:[30,50,100]" 을 설정하면 애니메이션 효과 실행 시 대상 컴포넌트의 left 값이 30 으로 변경된 후 애니메이션 효과가 50% 진행되는 동안 left 속성값이 30 -> 50 으로 변경되고, 나머지 100% 까지 진행되는 동안 50 -> 100으로 변경됩니다. - props 에 설정된 속성에 변경시킬 속성값이 하나만 정의되어 있고, 대상 컴포넌트의 현재 속성값과 같다면 애니메이션 효과가 실행되지 않는 것처럼 보일 수 있습니다. 예를 들어 props 속성값이 "left:100" 이고 대상 컴포넌트의 left 속성값이 100 이면, 속성값이 100 -> 100 으로 변경되므로 애니메이션 효과는 실행되고 있지만 화면에 변화는 없습니다. - 애니메이션 효과가 적용된 속성은 최종적으로 props 에 설정된 마지막 값을 갖습니다.
메서드
destroy
스크립트에서 동적으로 생성한 AnimationItem 을(를) 삭제하는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
문법
AnimationItem.destroy()
반환
Type | Description |
|---|---|
Boolean | AnimationItem 이(가) 정상적으로 삭제되면 true 를 반환합니다. AnimationItem 이(가) 정상적으로 삭제되지 않으면 false 를 반환합니다. |
참고
- 동적으로 생성한 AnimationItem 을(를) 완전히 삭제하기 위해서는 destroy() 메소드를 호출해야 합니다.