Animation > AnimationItem

개요

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() 메소드를 호출해야 합니다.