Minitalk.ui Defined : /scripts/widget.ui.js
미니톡 채팅위젯 UI 관련 변수 및 함수가 정의되어 있습니다.
- 이 기능은 문제의 소지가 있어 제거되었거나 제거될 예정입니다.
- 아직 안정적이라고 고려될만큼 충분한 테스트를 거치지 않았습니다.(합당하다면 하위호환성이 보장됩니다.)
- API가 충분히 검증되었지만, 기반이 되는 코드의 정리 때문에 마이너한 변경이 있을 수 있습니다.(하위호환성이 보장됩니다.)
- 심각한 버그가 발견되지 않는 한 이 코드는 절대 변경되지 않습니다.
METHODS
-
appendTool( tool [, position = null ]):
미니톡 채팅위젯 툴바에 툴버튼을 추가한다.
최종수정일 :미니톡 채팅위젯 스크립트를 정의할 때가 아닌 플러그인이나, 이벤트 리스너 등에서 툴버튼을 추가하는데 사용할 수 있습니다.
tool 에는 추가할 툴버튼 아래를 참고하여 정의합니다.
position 에는 툴버튼을 추가할 위치를 숫자 또는 툴버튼 명으로 입력하면 해당 툴버튼 뒤에 추가되며, position 값이 비어있는 경우, 툴바 제일 마지막에 툴버튼이 추가됩니다.
미리 정의된 문자열
- : 툴버튼 구분선
bold : 폰트설정 굵게 (채팅권한설정에 폰트설정권한이 없는경우 보이지 않음)
underline : 폰트설정 밑줄 (채팅권한설정에 폰트설정권한이 없는경우 보이지 않음)
italic : 폰트설정 기울임 (채팅권한설정에 폰트설정권한이 없는경우 보이지 않음)
color : 폰트설정 색상 (채팅권한설정에 폰트설정권한이 없는경우 보이지 않음)
emoticon : 이모티콘
mute : 음소거
push : 브라우저 푸시알림
scroll : 스크롤고정
clear : 화면비우기
사용자정의 툴버튼 추가
Object {
name:string : 고유값으로 영문 및 숫자로만 이루어져야합니다.
icon:string : 툴버튼 아이콘 이미지 경로
iconClass:string : 툴버튼 아이콘 스타일시트 (아이콘폰트 등의 스타일을 지정할 수 있습니다.)
visible:function(minitalk,me) : 툴버튼 보임여부 (minitalk : 미니톡객체, me : 접속자정보)
handler:function(minitalk,e) : 툴버튼 클릭시 실행될 함수 (minitalk : 미니톡객체, e : 클릭이벤트)
}
-
disable( inputmode):
미니톡 채팅위젯 UI 를 비활성화합니다.
최종수정일 :미니톡 UI 를 비활성화합니다.
함수의 매개변수 inputmode:boolean (기본값 : false) 에 true 를 전달할 경우, 채팅입력폼 및 전송버튼만 비활성화되며, false 를 전달할 경우 미니톡 채팅위젯 전체 UI 를 비활성화합니다.
참조 : Minitalk.ui.enable()
-
enable( inputmode):
미니톡 채팅위젯 UI 를 활성화합니다.
최종수정일 :미니톡 UI 를 활성화합니다.
함수의 매개변수 inputmode:boolean (기본값 : false) 에 true 를 전달할 경우, 채팅입력폼 및 전송버튼만 활성화되며, false 를 전달할 경우 미니톡 채팅위젯 전체 UI 를 활성화합니다.
참조 : Minitalk.ui.disable()
-
printError( code):
미니톡 채팅위젯에 에러메시지창을 출력한다.
최종수정일 :미니톡 채팅위젯에 에러메시지창을 출력합니다.
해당 메시지창은 미니톡 채팅위젯 전체를 비활성화 시키며 출력됩니다.
함수의 매개변수로 전달되는 code:string 에는 미니톡 언어팩(/languages/ko.json 등)의 error 에 정의된 에러코드를 전달하게 됩니다.
-
printSystemMessage( type, message):
채팅창에 시스템 메시지를 출력합니다.
최종수정일 :채팅창에 메시지를 출력합니다.
string type : 메시지 종류 (system, error, notice, info, plugin)
string message : 메시지 내용
-
printTitle( title):
미니톡 채팅위젯의 타이틀을 변경한다.
최종수정일 :미니톡 채팅위젯의 타이틀은 기본적으로 미니톡 클라이언트 관리자의 채널관리에서 설정한 채널명이 들어갑니다.
해당 타이틀을 변경하고자 하는 경우 사용할 수 있습니다.
-
printUserCount( count):
미니톡 채팅위젯의 타이틀바에 접속자수를 출력한다.
최종수정일 :미니톡 채팅위젯의 타이틀바에 접속자수를 출력한다.
해당 메소드를 통해 접속자수를 변경할 경우, 1회에 한하여 변경되며 실제 접속자수가 변경될때마다 실제 접속자수가 표시됩니다.
updateUserCount 이벤트를 활용하여, 실제 접속자에 일정 인원수를 변경하는 등으로도 사용이 가능합니다.