본 문서는 올챙이 개발시 일관된 User Interface를 유지하기위해 작성되었습니다. 또한 Eclipse UI Guidelines 문서를 기준으로 사용합니다. |
올챙이는 Eclipse RAP Platform 기반으로 개발되었기 때문에 Eclipse UI Guidelines를 기본적으로 채용하고 있으며, 본 문서에서는 추가적으로 필요한 UI 가이드라인에 대한 사항을 기술합니다. 올챙이 기여시 본 문서를 참고해 개발하여야 합니다.
올챙이의 Layout은 GridLayout을 기본으로 사용합니다. GridLayout은 자식 위젯들을 여러 열과 행으로 구성된 격자에 배치할 수 있습니다. 격자의 구성은 자유롭게 설정할 수 있으며 각 자식 요소의 크기를 제어할 수 있도록 다양한 옵션을 제공하고 있습니다. 기본 배치는 GridLayout을 사용하되, 구성 요소에 따라 다른 Layout을 사용할 수 있습니다. 하지만 다음 규칙에 대해서는 동일하게 적용하여야 합니다.
기본적으로 다음과 같이 각 위젯 별 마진을 5 pixel 크기로 설정합니다. 레이블을 사용할 때 왼쪽 정렬을 기본으로 사용합니다.
버튼 사이즈는 특별한 경우를 제외하고, 대(Large)/중(Middle)/소(Small) 사이즈를 선택해 일관된 버튼 크기를 유지합니다.
분 류 | 크기(Pixel) |
---|---|
대(Large) | 120 px |
중(Middle) | 100 px |
소(Small) | 80 px |
사용하는 버튼이 주기능을 동작하는 역할을 한다면 아이콘을 사용해 버튼의 목적을 명확히 표시한다.
버튼에 포함될 문자가 120px 너비로 충분하지 않다면, 그 이상의 크기로 사용한다. 그리고 가능한한 의미를 훼손하지 않는 방향에서 문구는 동작의 함축적인 의미를 가질 수 있는 문구를 사용한다. |
텍스트 필터는 특정 컨텐츠에서 제공하는 요소의 일부만을 출력하는 데 사용한다. 예를 들어 아래 그림의 테이블에서 특정 문자열을 포함하는 내용만 출력하는데 사용할 수 있다. 텍스트 필터를 사용하기 위해서 다음을 규칙을 따른다.
text.setMessage("Filter");
Text text = new Text(parent, SWT.H_SCROLL | SWT.V_SCROLL | SWT.SEARCH | SWT.CANCEL);
에러 출력시 다음 클랙스를 사용해 통일된 에러 출력 화면을 제공합니다.
org.eclipse.jface.dialogs.MessageDialog
예외 발생시 에러 출력 화면을 작성한다면, 다음과 같이 작성할 수 있습니다.
try {
// Something
} catch (Exception e) {
logger.error("Login exception", e);
MessageDialog.openError(getParentShell(), "Confirm", e.getMessage());
return;
}
에러가 발생하면 org.apache.log4j.Logger 클래스를 이용해 에러 내용을 기록한 후 MessageDialog 클래스를 이용해 위와 같이 에러를 출력한다.