올챙이 UI 가이드라인 

Tadpole User Interface Guidelines

Introduce

올챙이는 Eclipse RAP Platform 기반으로 개발되었기 때문에 Eclipse UI Guidelines를 기본적으로 채용하고 있으며, 본 문서에서는 추가적으로 필요한 UI 가이드라인에 대한 사항을 기술합니다. 올챙이 기여시 본 문서를 참고해 개발하여야 합니다. 

Layout

올챙이의 Layout은 GridLayout을 기본으로 사용합니다. GridLayout은 자식 위젯들을 여러 열과 행으로 구성된 격자에 배치할 수 있습니다. 격자의 구성은 자유롭게 설정할 수 있으며 각 자식 요소의 크기를 제어할 수 있도록 다양한 옵션을 제공하고 있습니다. 기본 배치는 GridLayout을 사용하되, 구성 요소에 따라 다른 Layout을 사용할 수 있습니다. 하지만 다음 규칙에 대해서는 동일하게 적용하여야 합니다. 

기본적으로 다음과 같이 각 위젯 별 마진을 5 pixel 크기로 설정합니다. 레이블을 사용할 때 왼쪽 정렬을 기본으로 사용합니다. 

Button

버튼 사이즈는 특별한 경우를 제외하고, 대(Large)/중(Middle)/소(Small) 사이즈를 선택해 일관된 버튼 크기를 유지합니다.  

사용하는 버튼이 주기능을 동작하는 역할을 한다면 아이콘을 사용해 버튼의 목적을 명확히 표시한다.

Text Filter

텍스트 필터는 특정 컨텐츠에서 제공하는 요소의 일부만을 출력하는 데 사용한다. 예를 들어 아래 그림의 테이블에서 특정 문자열을 포함하는 내용만 출력하는데 사용할 수 있다. 텍스트 필터를 사용하기 위해서 다음을 규칙을 따른다.

• 텍스트 필터가 사용되는 Widget의 상단에 위치한다.

• 텍스트 필터에는 Text.setMessage() 메소드를 사용해 비활성화시 ‘Filter’가 나타나도록 설정한다.

text.setMessage("Filter");

• 텍스트 필터가 수행하는 역할에 대해 Tool Tip을 명시한다.

• 텍스트 필터 생성시 SWT.SEARCH, SWT.CANCEL 옵션을 사용한다.

Text text = new Text(parent, SWT.H_SCROLL | SWT.V_SCROLL | SWT.SEARCH | SWT.CANCEL);

Error 출력

에러 출력시 다음 클랙스를 사용해 통일된 에러 출력 화면을 제공합니다. 

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 클래스를 이용해 위와 같이 에러를 출력한다.