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

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

1. 개요#

라이믹스가 제공하는 JavaScript 전역 함수 중 현재 deprecated되지 않은 함수는 Rhymix 오브젝트 메서드의 호환용 별칭이다. 새 코드는 대응하는 메서드를 직접 사용하는 것이 권장된다. 앞으로 추가되는 메서드에는 같은 역할의 전역 함수가 없을 수도 있다.

2. 대응표#

왼쪽은 기존 함수의 인자이며, 오른쪽은 대응하는 메서드 이름이다. 인자는 같은 역할에 맞추어 전달한다.

전역 함수	권장 메서드
isMobile()	Rhymix.isMobile()
getColorScheme()	Rhymix.getColorScheme()
setColorScheme(color_scheme)	Rhymix.setColorScheme()
detectColorScheme()	Rhymix.detectColorScheme()
getLangType()	Rhymix.getLangType()
setLangType(lang_type)	Rhymix.setLangType()
getCSRFToken()	Rhymix.getCSRFToken()
setCSRFToken(token)	Rhymix.setCSRFToken()
isCurrentPageUrl(url)	Rhymix.isCurrentUrl()
isSameOrigin(url1, url2)	Rhymix.isSameOrigin()
redirect(url)	Rhymix.redirectToUrl()
openModal(id)	Rhymix.modal.open()
openModalIframe(url, target)	Rhymix.modal.openIframe()
closeModal(id)	Rhymix.modal.close()
winopen(url, target, features)	Rhymix.openWindow()
popopen(url, target)	Rhymix.openPopup()

3. 변경 예#

// 기존 코드
const mobile = isMobile();

// 새 코드
const mobile = Rhymix.isMobile();

같은 이름의 PHP 함수와 JavaScript 함수를 혼동하지 않는다. 서버에서 실행하는 PHP 전역 함수는 라이믹스/매뉴얼/전역 함수를 참고한다.

4. 적용 시 확인#

• 별칭의 존재와 권장 메서드의 도입 버전을 실제 지원 대상에서 확인한다.
• 기존 인자와 콜백을 그대로 적용할 수 있는지 메서드의 명세를 확인한다.
• 모달은 브라우저 히스토리와 연동되므로 표시 CSS만 바꾸지 말고 열기·닫기 API를 함께 사용한다.
• URL 비교·이동의 차이는 상위 문서의 URL 처리 부분을 참고한다.

5. 같이 보기#

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

6. 출처#

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