비헤이비어 함수
비헤이비어 함수를 사용하면 오브젝트에 비헤이비어를 추가하거나 오브젝트에서 비헤이비어를 제거하고, 오브젝트에 첨부된 비헤이비어를 찾고, 비헤이비어가 첨부된 오브젝트에 대한 정보를 가져오는 등의 작업을 수행할 수 있습니다. dreamweaver.behaviorInspector 오브젝트의 메서드는 현재 문서의 선택 영역이 아니라 [비헤이비어] 패널의 선택 영역을 제어하거나 선택 영역에 대해 작용합니다.
dom.addBehavior()
지원 버전
Dreamweaver 3
설명
선택한 요소에 새 이벤트/액션 쌍을 추가합니다. 이 함수는 활성 문서에만 사용할 수 있습니다.
인수
event, action, {eventBasedIndex}
event 인수는 비헤이비어를 요소에 첨부할 JavaScript 이벤트 핸들러입니다(예: onClick, onMouseOver 또는 onLoad).
action 인수는 [비헤이비어] 패널을 사용하여 액션이 추가되는 경우 applyBehavior()가 반환하는 함수 호출입니다(예: "MM_popupMsg('Hello World')").
선택적인 eventBasedIndex 인수는 이 액션이 추가될 위치입니다. eventBasedIndex 인수는 0부터 시작하는 인덱스입니다. 두 액션이 지정된 이벤트와 이미 연관되어 있는 경우 eventBasedIndex를 1로 지정하면 이 액션은 다른 두 액션 사이에 실행됩니다. 이 인수를 생략하면 액션은 지정된 이벤트의 모든 기존 액션 뒤에 추가됩니다.
반환값
없음
dom.getBehavior()
지원 버전
Dreamweaver 3
설명
지정된 이벤트 내의 지정된 위치에서 액션을 가져옵니다. 이 함수는 현재 선택 영역에 대해 작용하고 활성 문서에서만 유효합니다.
인수
event, {eventBasedIndex}
event 인수는 액션을 요소에 첨부하는 데 사용되는 JavaScript 이벤트 핸들러입니다(예: onClick, onMouseOver 또는 onLoad).
선택적인 eventBasedIndex 인수는 가져올 액션의 위치입니다. 예를 들어 두 액션이 지정된 이벤트와 연관되어 있으면 0이 첫 번째이고 1이 두 번째입니다. 이 인수를 생략하면 지정된 이벤트의 모든 액션이 반환됩니다.
반환값
함수 호출을 나타내는 문자열(예: "MM_swapImage('document.Image1','document.Image1','foo.gif','#933292969950')")을 반환하거나, eventBasedIndex가 생략된 경우에는 문자열 배열을 반환합니다.
dom.reapplyBehaviors()
지원 버전
Dreamweaver 3
설명
지정된 노드의 비헤이비어 호출과 연관된 함수가 문서의 HEAD 섹션에 있는지 확인하고 없으면 삽입합니다.
인수
elementNode
elementNode 인수는 현재 문서 내의 요소 노드입니다. 이 인수를 생략하면 문서의 모든 요소 노드에서 고립된 비헤이비어 호출이 있는지 여부가 확인됩니다.
반환값
없음
dom.removeBehavior()
지원 버전
Dreamweaver 3
설명
지정된 이벤트 내의 지정된 위치에서 액션을 제거합니다. 이 함수는 현재 선택 영역에 대해 작용하고 활성 문서에서만 유효합니다.
인수
event, {eventBasedIndex}
event 인수는 액션을 요소에 첨부하는 데 사용되는 이벤트 핸들러입니다(예: onClick, onMouseOver 또는 onLoad). 이 인수를 생략하면 요소에서 모든 액션이 제거됩니다.
선택적인 eventBasedIndex 인수는 제거할 액션의 위치입니다. 예를 들어 두 액션이 지정된 이벤트와 연관되어 있으면 0이 첫 번째이고 1이 두 번째입니다. 이 인수를 생략하면 지정된 이벤트의 모든 액션이 제거됩니다.
반환값
없음
dreamweaver.getBehaviorElement()
지원 버전
Dreamweaver 2, CS4에서 업데이트됨
설명
비헤이비어가 적용되는 태그에 해당하는 DOM 오브젝트를 가져옵니다. 이 함수는 비헤이비어 액션 파일에만 적용할 수 있습니다.
인수
없음
반환값
DOM 오브젝트 또는 null 값을 반환합니다. 이 함수는 다음과 같은 상황에서 null 값을 반환합니다.
현재 스크립트가 [비헤이비어] 패널의 컨텍스트 내에서 실행되지 않는 경우
dreamweaver.popupAction()에서 현재 실행 중인 스크립트를 시작하는 경우
[비헤이비어] 패널이 링크 래퍼에 이벤트를 첨부하려고 하지만 링크 래퍼가 없는 경우
이 함수가 액션 파일 외부에 나타나는 경우
예제
dreamweaver.getBehaviorTag()와 같은 방식으로 dreamweaver.getBehaviorElement() 함수를 사용하여 선택한 액션이 선택한 HTML 태그에 적합한지 여부를 확인할 수 있습니다. 차이점은 태그와 해당 속성에 대한 더 자세한 정보에 액세스할 수 있다는 것입니다. 또 다른 프레임이나 윈도우를 대상으로 하지 않는 하이퍼텍스트 링크(A HREF)에만 적용할 수 있는 액션을 작성하는 경우 getBehaviorElement() 함수를 사용할 수 있습니다. [매개 변수] 대화 상자의 사용자 인터페이스를 초기화하는 함수의 일부로 getBehaviorElement() 함수를 사용할 수 있습니다. 예를 들면 다음과 같습니다.
function initializeUI(){
var theTag = dreamweaver.getBehaviorElement();
var CANBEAPPLIED = (theTag.tagName == "A" && ¬
theTag.getAttribute("HREF") != null && ¬
theTag.getAttribute("TARGET") == null);
if (CANBEAPPLIED) {
// display the action user interface
} else{
// display a helpful message that tells the user
// that this action can only be applied to a
// link without an explicit target]
}
}
dreamweaver.getBehaviorTag()
지원 버전
Dreamweaver 1.2
설명
비헤이비어가 적용되는 태그의 소스를 가져옵니다. 이 함수는 액션 파일에만 적용할 수 있습니다.
인수
없음
반환값
태그의 소스를 나타내는 문자열을 반환합니다. 이 문자열은 canAcceptBehavior() 함수에 인수(HTMLelement)로 전달되는 문자열과 같은 문자열입니다. 이 함수가 액션 파일 외부에 나타나는 경우 반환값은 빈 문자열입니다.
예제
하이퍼텍스트 링크(A HREF)에만 적용할 수 있는 액션을 작성하는 경우 다음 예제와 같이 [매개 변수] 대화 상자의 사용자 인터페이스를 초기화하는 함수로 getBehaviorTag() 함수를 사용할 수 있습니다.
function initializeUI(){
var theTag = dreamweaver.getBehaviorTag().toUpperCase();
var CANBEAPPLIED = (theTag.indexOf('HREF') != -1));
if (CANBEAPPLIED) {
// display the action UI
} else{
// display a helpful message that tells the user
// that this action can only be applied to a
// hyperlink
}
}
dreamweaver.popupAction()
지원 버전
Dreamweaver 2, CS4에서 업데이트됨
설명
지정된 비헤이비어 액션에 대해 [매개 변수] 대화 상자를 시작합니다. 사용자 입장에서는 [비헤이비어] 패널의 [액션] 팝업 메뉴에서 액션을 선택하는 것과 같습니다. 이 함수를 사용하면 액션이 아닌 Extension 파일에서 사용자 문서의 오브젝트에 비헤이비어를 추가할 수 있습니다. 또한 이 함수는 사용자가 대화 상자를 종료할 때까지 다른 편집 작업을 차단합니다.
이 함수는 objectTag() 함수 내부, 명령 파일의 스크립트 또는 속성 관리자 파일에서 호출할 수 있습니다.
인수
actionName, {funcCall}
actionName 인수는 Configuration/Behaviors/Actions 폴더의 파일 이름을 포함하는 문자열입니다. 이 파일에는 JavaScript 비헤이비어 액션이 포함됩니다(예: "Swap Image.htm").
선택적인 funcCall 인수는 actionName에 지정된 액션에 대한 함수 호출을 포함하는 문자열입니다(예: "MM_SwapImage(...)"). 액션 파일의 applyBehavior() 함수는 지정된 경우 이 인수를 제공합니다.
반환값
비헤이비어 액션에 대한 함수 호출을 반환합니다. 사용자가 [매개 변수] 대화 상자에서 [확인]을 클릭하면 비헤이비어가 현재 문서에 추가됩니다. 해당 함수는 문서의 HEAD 섹션에 추가되고 HTML은 BODY 섹션의 맨 위에 추가되며 문서에서 다른 편집 작업을 수행할 수도 있습니다. 함수 호출(예: "MM_SwapImage(...)")은 문서에 추가되지는 않지만 이 함수의 반환값이 됩니다.
dreamweaver.behaviorInspector.getBehaviorAt()
지원 버전
Dreamweaver 3
설명
[비헤이비어] 패널의 지정된 위치에서 이벤트/액션 쌍을 가져옵니다.
인수
positionIndex
positionIndex 인수는 [비헤이비어] 패널에서 액션의 위치입니다. 목록에서 첫 번째 액션의 위치는 0입니다.
반환값
다음 두 항목의 배열을 반환합니다.
이벤트 핸들러
함수 호출 또는 JavaScript 명령문
예제
positionIndex는 0부터 시작하는 인덱스이므로 [비헤이비어] 패널에 목록이 표시되는 경우 dreamweaver.behaviorInspector.getBehaviorAt(2) 함수를 호출하면 "onMouseOver" 및 "MM_changeProp('document.moon','document.moon','src','sun.gif','MG')" 문자열이 포함된 배열이 반환됩니다.
dreamweaver.behaviorInspector.getBehaviorCount()
지원 버전
Dreamweaver 3
설명
이벤트 핸들러를 통해 현재 선택한 요소에 첨부된 액션 수를 셉니다.
인수
없음
반환값
요소에 첨부된 액션 수를 나타내는 정수를 반환합니다. 이 숫자는 [비헤이비어] 패널에 표시되는 액션 수와 같고 Dreamweaver 비헤이비어 액션과 사용자 정의 JavaScript를 포함합니다.
예제
선택한 링크 <A HREF="javascript:setCookie()" onClick="MM_popupMsg('A cookie has been set.');parent.rightframe.location.href='aftercookie.html'">에 대해 dreamweaver.behaviorInspector.getBehaviorCount()를 호출하면 2가 반환됩니다.
dreamweaver.behaviorInspector.getSelectedBehavior()
지원 버전
Dreamweaver 3
설명
[비헤이비어] 패널에서 선택한 액션의 위치를 가져옵니다.
인수
없음
반환값
[비헤이비어] 패널에서 선택한 액션의 위치를 나타내는 정수를 반환하거나, 선택된 액션이 없는 경우에는 -1을 반환합니다.
예제
[비헤이비어] 패널의 첫 번째 액션이 선택된 경우 dreamweaver.behaviorInspector.getSelectedBehavior() 함수를 호출하면 0이 반환됩니다.
dreamweaver.behaviorInspector.moveBehaviorDown()
지원 버전
Dreamweaver 3
설명
이벤트의 범위 내에서 실행 순서를 변경하여 비헤이비어 액션을 아래로 이동합니다.
인수
positionIndex
positionIndex 인수는 [비헤이비어] 패널에서 액션의 위치입니다. 목록에서 첫 번째 액션의 위치는 0입니다.
반환값
없음
예제
dreamweaver.behaviorInspector.moveBehaviorDown(2) 함수를 호출하면 onMouseDown 이벤트에서 [이미지 미리 로드하기] 및 [속성 바꾸기] 액션의 위치가 바뀝니다. onClick 및 onFocus 이벤트에는 각각 하나의 비헤이비어만 연관되어 있으며 onMouseDown 이벤트 그룹의 아래쪽에 위치 3의 비헤이비어가 이미 있으므로 다른 위치에 대해 dreamweaver.behaviorInspector.moveBehaviorDown() 함수를 호출해도 아무 효과가 없습니다.
dreamweaver.behaviorInspector.moveBehaviorUp()
지원 버전
Dreamweaver 3
설명
이벤트의 범위 내에서 실행 순서를 변경하여 비헤이비어를 위로 이동합니다.
인수
positionIndex
positionIndex 인수는 [비헤이비어] 패널에서 액션의 위치입니다. 목록에서 첫 번째 액션의 위치는 0입니다.
반환값
없음
예제
dreamweaver.behaviorInspector.moveBehaviorUp(3) 함수를 호출하면 onMouseOver 이벤트에서 [이미지 미리 로드하기] 및 [속성 바꾸기] 액션의 위치가 바뀝니다. onClick 및 onFocus 이벤트에는 각각 하나의 비헤이비어만 연관되어 있으며 onMouseDown 이벤트 그룹의 위쪽에 위치 2의 비헤이비어가 이미 있으므로 다른 위치에 대해 dreamweaver.behaviorInspector.moveBehaviorUp() 함수를 호출해도 아무 효과가 없습니다.
dreamweaver.behaviorInspector.setSelectedBehavior()
지원 버전
Dreamweaver 3
설명
[비헤이비어] 패널의 지정된 위치에서 액션을 선택합니다.
인수
positionIndex
positionIndex 인수는 [비헤이비어] 패널에서 액션의 위치입니다. 목록에서 첫 번째 액션의 위치는 0입니다. 모든 액션의 선택을 취소하려면 positionIndex를 -1로 지정합니다. 액션이 없는 위치를 지정하는 것은 -1을 지정하는 것과 같습니다.
반환값
없음
예제
dreamweaver.behaviorInspector.setSelection(2) 함수를 호출하면 onMouseDown 이벤트와 연관된 [속성 바꾸기] 액션이 선택됩니다.
