라이믹스/매뉴얼/프론트엔드 라이브러리/레거시 전역 함수

상위 문서: 라이믹스/매뉴얼/프론트엔드 라이브러리

1. 개요#

XE 1.x 및 초기 라이믹스에서 이어진 JavaScript 함수들이다. 오래된 코어 모듈과 서드파티 자료의 호환성을 위해 남아 있으나, 공식 매뉴얼은 대체할 수 있다면 새 코드에서 사용하지 않도록 권장한다.

현재 권장 메서드의 단순 별칭인 전역 함수와 이 문서의 레거시 함수 목록은 구분한다.

2. 주요 대체 방향#

기존 기능	새 코드에서 검토할 방법
doCallModuleAction, exec_xml, exec_json, exec_html, send_by_form	Rhymix.ajax(), 폼은 Rhymix.ajaxForm()
getCookie, setCookie	코어가 제공하는 js-cookie(Cookies 또는 Rhymix.cookie)
doChangeLangType	Rhymix.setLangType()
프론트엔드 XE App의 이벤트 처리	일반 JavaScript 또는 jQuery 이벤트 처리

함수명만 치환하면 같은 동작이 되는 것은 아니다. 특히 AJAX는 응답 형식·오류 판단·콜백 인자·리다이렉트 처리 차이를 확인한다. 필요한 최소 라이믹스 버전도 함께 정한다.

3. 함수 목록#

아래는 공식 매뉴얼에 열거된 함수의 호출 형태이다. 상세 동작이 설명되지 않은 항목의 인자 의미나 반환값은 실제 사용하는 버전의 코드를 확인한다.

3.1. 문서 관리 관련 함수#

• doAddDocumentCart(obj)
• doDocumentPreview(obj)
• doDocumentSave(obj)
• doDocumentLoad(obj)
• doDocumentSelect(document_srl, module)

3.2. AJAX 관련 레거시 함수#

• doCallModuleAction(module, action, target_srl)
• exec_xml(module, act, params, callback_success, return_fields, callback_success_arg, fo_obj)
• exec_json(action, params, callback_success, callback_error)
• exec_html()
• send_by_form(url, params)
• arr2obj(url, params)

3.3. 쿠키 관련 함수#

• getCookie(name)
• setCookie(name, value, expires, path)

3.4. 기타 레거시 함수#

• doChangeLangType(obj)
• rhymix_alert_close()
• rhymix_alert(message, redirect_url, delay)
• move_url(url, open_window)
• setFixedPopupSize()
• displayMultimedia(src, width, height, options)
• transRGB2Hex(value)
• sendMailTo(email_address)
• viewSkinInfo(module, skin)
• xSleep(sec)
• isDef()
• is_def(v)
• ucfirst(str)
• get_by_id(id)
• GetObjLeft(obj)
• GetObjTop(obj)
• getOuterHTML(obj)
• replaceOuterHTML(obj, html)
• toggleDisplay(id)
• toggleSecuritySignIn()
• completeMessage(ret_obj)
• reloadDocument()
• open_calendar(fo_id, day_str, callback_func)
• displayPopupMenu(ret_obj, response_tags, params)
• createPopupMenu()
• chkPopupMenu()
• Base64.encode(input)
• Base64.decode(input)

4. 레거시 라이브러리#

modernizr, x.js, xml2json은 함께 배포되거나 일부 환경에서 로딩될 수 있지만 신규 사용을 권장하지 않는다. 라이브러리가 사이트에 있다고 가정하여 임의의 페이지에서 의존하지 말고 실제 로딩 여부를 확인한다.

5. 기존 코드 이전#

1. 현재 사용하는 함수를 검색하고 호출 화면과 데이터 흐름을 확인한다.
2. 공개된 권장 API가 같은 역할을 제공하는지 확인한다.
3. 콜백·반환값·오류 표시가 바뀌는 부분을 수정한다.
4. 로그인·권한별 동작과 PC·모바일 화면을 검증한다.

6. 같이 보기#

• 라이믹스/매뉴얼/프론트엔드 라이브러리
• 라이믹스/매뉴얼/프론트엔드 라이브러리/전역 함수

7. 출처#

이 문서는 라이믹스 공식 매뉴얼을 바탕으로 설명과 예제를 정리하였다. 공식 매뉴얼은 CC BY-SA 4.0으로 배포된다. 원문의 기여 이력은 rhymix-docs 저장소에서 확인할 수 있다.