SAP SE와 무관한 비공식 커뮤니티 도구입니다. This is an unofficial community tool. It is not affiliated with, sponsored by, or endorsed by SAP SE.
UI5 Docs KR
UI5 코드에 마우스를 올리면 OpenUI5 API 설명을 한국어로 보여 주는 VS Code / SAP Business Application Studio(BAS) 확장입니다. UI5를 처음 배우는 분(부트캠프 수강생, 신입 개발자)을 위해 만들었습니다.
기존 UI5 확장(UI5 Language Assistant, SAPUI5 Extension 등)을 대체하지 않는 보조 확장입니다. 함께 설치하면 기존 영어 hover 아래에 한국어 설명이 추가로 표시됩니다.
기능
- XML 뷰/프래그먼트:
<m:Button> 같은 control 태그, text·press 같은 속성(property)/이벤트(event)/association 이름, <content> 같은 aggregation 태그에 hover하면 한국어 설명을 표시합니다. 상속받은 멤버(예: visible, tooltip)는 상위 클래스를 따라가며 찾습니다.
- JavaScript / TypeScript:
sap.ui.define([...])나 import의 모듈 경로 문자열("sap/m/MessageToast")과 완전한 이름(sap.m.Button, sap.m.ButtonType.Accept)에 hover하면 한국어 설명을 표시합니다. sap.ui.define/import로 받은 이름(FilterOperator.BT, MessageToast.show)과, new Button()·: Button·as Button처럼 같은 파일에서 클래스를 알 수 있는 변수의 메서드(oButton.setText)도 지원합니다. setText·attachPress 같은 자동 생성 메서드는 해당 속성·이벤트 설명을 보여 줍니다. Controller.extend(...)나 class X extends Controller 안의 this.getView()도 지원하며(앱의 BaseController를 상속하는 *.controller.js/ts는 UI5 Controller로 간주), this.getView().byId(...), this.getOwnerComponent().getRouter().navTo(...)처럼 메서드의 반환 타입을 따라 이어지는 호출과 var oView = this.getView() 같은 변수도 따라갑니다. (그 밖의 타입 추론은 하지 않으므로 this.byId("x").setText처럼 클래스를 알 수 없는 경우는 표시되지 않습니다.)
- 설명에 나오는 UI5 용어(control, aggregation, binding, model 등)의 뜻을 hover 하단에 짧게 풀어 줍니다(최대 3개). 용어는 원문·검색과 맞추기 위해 영어로 둡니다.
- hover 맨 위에 생성자·메서드의 파라미터와 타입(시그니처)을 표시합니다.
- hover 하단에 원문 API Reference 텍스트 링크와 출처를 표시합니다.
- 프로젝트의
ui5.yaml(framework.version)과 manifest.json(minUI5Version)에서 UI5 버전을 읽어 가장 가까운 번역 데이터를 사용합니다.
- 네트워크 요청을 하지 않습니다. 번역 데이터가 확장에 포함되어 있어 오프라인·프록시 환경에서도 동작합니다.
hover 예시:
sap.m.Button › press · 이벤트(event) · OpenUI5 1.148
사용자가 control을 클릭하거나 탭하면 발생합니다.
용어
- control — 버튼, 입력 필드, 표처럼 화면에 그려지는 UI 부품입니다. ...
원문 API Reference
비공식 기계번역 · 원문 © SAP SE · Apache-2.0
지원 범위
- 번역 기준 버전: OpenUI5 1.148 (LTS)
- 포함 라이브러리:
sap.m, sap.ui.core
- 현재 번역된 API(시험 버전):
sap.m.Button, sap.m.Input, sap.m.Table, sap.m.MessageToast, sap.m.Text, sap.m.Label, sap.m.Page, sap.m.List, sap.m.ButtonType, sap.ui.core.Control. 그 밖의 API에는 "아직 한국어 번역이 없습니다"와 원문 링크가 표시됩니다.
- SAPUI5 전용 라이브러리(
sap.ui.comp, sap.suite, sap.fe 등)는 라이선스상 번역·재배포할 수 없어 "이 API는 SAPUI5 전용이라 한국어 설명을 제공하지 않습니다" 안내와 원문 링크만 표시합니다.
설정
| 설정 |
기본값 |
설명 |
hangulHover.enable |
true |
한국어 hover 사용 여부 |
hangulHover.showFirst |
true |
다른 UI5 확장(SAPUI5 Extension, UI5 Language Assistant)의 hover보다 한국어 설명을 위에 표시하도록 시도. 그 확장들이 켜진 뒤 hover를 다시 등록합니다. 바꾼 뒤에는 창을 다시 불러오세요. |
hangulHover.showOriginalLink |
true |
원문 API Reference 링크 표시 여부 (출처 표기 줄은 끌 수 없습니다) |
hangulHover.showGlossary |
true |
설명에 나오는 UI5 용어의 뜻 표시 여부 |
hangulHover.fallbackVersion |
"" |
프로젝트에서 UI5 버전을 찾지 못했을 때 사용할 버전 (예: 1.148) |
번역 품질
설명은 기계번역(AI 보조) 이며 아직 사람이 검수하지 않았습니다. 정확한 내용은 항상 원문 API Reference를 확인하세요. UI5 핵심 용어(control, aggregation, binding, model, view, controller 등)는 영어를 유지합니다.
출처와 라이선스
- 확장 코드와 용어 설명(
glossary/terms.ko.json, 이 프로젝트에서 직접 작성): Apache License 2.0 (LICENSE).
- 번역 데이터(
data/ko): OpenUI5의 API 설명(JSDoc에서 생성된 api.json)을 한국어로 번역한 2차적 저작물입니다. 원문 © SAP SE or an SAP affiliate company, Apache License 2.0. 각 데이터 파일에는 원본 api.json URL과 UI5 버전, 번역 사실(meta.modified)이 기록되어 있습니다. 자세한 내용은 확장에 포함된 data/LICENSE와 data/NOTICE를 참고하세요.
- 원문 링크는 SAP API Reference 페이지로 가는 일반 텍스트 링크이며 SAP 로고를 사용하지 않습니다.
- SAP, SAPUI5, SAP Fiori는 독일 및 기타 국가에서 SAP SE의 상표 또는 등록 상표입니다. 이 확장은 OpenUI5와 함께 쓰기 위한(for OpenUI5) 도구이며, SAP SE의 제품이 아닙니다.
| |