명령 - 단추

이 컴포넌트는 텍스트 레이블이나 이미지를 갖는 클릭 가능한 단추를 작성합니다. 이 단추를 사용하여 양식을 제출 또는 재설정할 수 있습니다. 또한 서버측 또는 클라이언트측 조치를 수행하거나 다른 페이지를 탐색하도록 프로그램할 수 있습니다.

디자인 시의 컴포넌트

명령 - 단추 컴포넌트를 페이지로 끌어서 놓으십시오.
명령 -
단추 컴포넌트 단추

명령 - 단추 컴포넌트는 디자인 시에 페이지에서 다음과 같이 보입니다.
디자인 시의 명령 - 단추

런타임 시의 컴포넌트

명령 - 단추 컴포넌트는 런타임 시에 다음과 같이 보입니다.
런타임 시의 명령 - 단추

특성 및 모든 속성 보기

컴포넌트의 특성 보기는 컴포넌트에 설정할 수 있는 가장 일반적인 속성 세트를 표시하며, 컴포넌트에 따라 제어, 조치 또는 기타 컴포넌트를 추가하기 위한 옵션이 표시될 수도 있습니다. 특성 보기를 열려면 창 > 보기 표시 > 특성을 클릭하십시오. 하지만 특성 보기는 기본적으로 열려 있습니다.

명령 - 단추 컴포넌트의 이러한 공통 속성은 특성 보기의 hx:commandExButton, 표시 옵션, 매개변수내게 필요한 옵션 탭에 표시됩니다. 전체 속성 목록은 모든 명령 - 단추 속성 테이블을 참조하십시오. 매개변수 및 조치를 추가하기 위한 추가 구성 옵션은 hx:commandExButtonhx:commandExButton>매개변수 탭에 있습니다.

구성 옵션

설명

조치에 전달되는 매개변수 추가

컴포넌트에 의해 조치에 전달되는 매개변수를 지정합니다.

이 단추가 수행하는 조치를 코드화하려면 클릭

명령 단추가 수행할 조치를 프로그램할 수 있도록 빠른 편집 보기로 전환합니다. 또한 조치 및 리턴되는 결과를 기초로 규칙을 정의할 수 있습니다.

모든 속성 보기는 컴포넌트에 설정할 수 있는 모든 속성 테이블을 표시하는데, 특성 보기에서 액세스할 수 있는 해당 속성을 포함합니다. 모든 속성 보기로 전환하려면 특성 보기의 오른쪽 상단 모서리에 있는 모든 속성 아이콘 모든 속성 아이콘을 클릭하십시오.

표 1. 모든 명령 - 단추 속성

속성 이름

특성 보기에 다음으로 표시됨

설명

accesskey

내게 필요한 옵션>액세스 키

하나의 키보드 키를 액세스 키로 지정합니다. 런타임 시에 지정된 액세스 키를 누르면 이 컴포넌트에 초점이 주어집니다.

action

표시되지 않음

컴포넌트를 클릭할 때 리턴되는 값을 지정합니다. 값은 기본값 NavigationHandler로 전달됩니다. NavigationHandler는 응용프로그램 구성 파일에 정의된 탐색 규칙 세트와 값을 대조합니다.

actionListener

표시되지 않음

조치에 응답하는 클래스의 이름을 지정합니다. 이 속성은 조치를 수반할 수 있는 컴포넌트(예: 단추 및 링크)에만 관련됩니다.

alt

내게 필요한 옵션>대체 텍스트

컴포넌트의 대체 텍스트를 지정합니다. 이는 요소를 정상적으로 렌더링할 수 없는 경우(예를 들어, 양식을 지원하지 않는 브라우저와 이미지를 표시하지 않도록 설정된 브라우저의 경우)에 표시됩니다.

binding

표시되지 않음

보통 지원 파일에서 이 컴포넌트를 표시하는 UIComponent를 지정합니다.

confirm

프롬프트 텍스트

commandExButton 단추를 누를 때 확인을 요청하도록 표시될 텍스트를 지정합니다. 이 속성에 값을 설정하지 않은 경우, 확인 대화 상자가 표시되지 않습니다.

converter

표시되지 않음

값을 변환할 데이터 유형을 지정합니다. JavaServer Faces 구현은 컴포넌트 데이터를 해당되는 렌더러에서 지원하지 않는 유형으로 변환하기 위해 사용할 수 있는 변환기 구현 세트를 제공합니다.

dimage

유형>이미지: 사용 불가능한 이미지

컴포넌트가 사용 불가능할 때 표시될 이미지를 지정합니다.

dir

표시되지 않음

런타임 시 렌더링될 때 컴포넌트 방향을 지정합니다. 값은 다음 중 하나가 될 수 있습니다.
  • ltr - 왼쪽에서 오른쪽으로
  • rtl - 오른쪽에서 왼쪽으로

disabled

표시되지 않음

disabled를 true로 설정할 경우, 컴포넌트는 런타임 시 표시되지만 작동하지 않습니다. 공백으로 남겨두면 기본값은 false입니다.

himage

유형>이미지: 마우스를 올려 놓았을 때의 이미지

사용자의 마우스 포인터가 컴포넌트 위를 지나갈 때 표시할 이미지를 지정합니다.

id

ID

컴포넌트에 이름을 지정합니다. JSP 내에서 고유한 이름이어야 합니다.

image

유형>이미지: 보통 이미지

컴포넌트에 표시될 이미지에 대한 URL/URI를 지정합니다.

immediate

표시되지 않음

true일 경우 라이프사이클의 렌더링 단계로 바로 건너뜁니다.

lang

표시되지 않음

컴포넌트의 속성 값과 텍스트 컨텐츠의 기본 언어를 지정합니다. ISO 표준 언어 약어 코드를 취합니다(예: 영어의 경우 "en", 미국 영어의 경우 "en-US", 프랑스어의 경우 "fr", 독일어의 경우 "de").

pimage

유형>이미지: 억압된 이미지

사용자가 컴포넌트를 클릭할 때 표시할 이미지를 지정합니다.

readonly

표시되지 않음

컴포넌트 값을 초기 값에서 변경할 수 없음을 지정합니다.

rendered

표시되지 않음

true 또는 false로 설정할 수 있습니다.
  • false - 컴포넌트는 런타임 시 브라우저에 렌더링되지 않습니다.
  • true - 컴포넌트가 렌더링됩니다.

size

표시되지 않음

컴포넌트의 초기 너비를 지정합니다. 너비는 해당 값이 문자 수를 언급하는 텍스트 입력 컴포넌트의 경우를 제외하고 픽셀 단위로 제공됩니다.

styleClass

스타일: 클래스

이 요소를 렌더링할 때 적용할 공백으로 구분되는 CSS 스타일 클래스 목록을 지정합니다. 이 값은 생성된 마크업에서 "class" 속성으로 전달해야 합니다. 선택한 컴포넌트의 클래스(예: 스타일시트)를 정의합니다. 수동으로 또는 단추를 클릭하고 창 안에서 원하는 클래스를 선택하여 완료할 수 있습니다.

style

스타일: 특성

컴포넌트에 대한 CSS 스타일 정보를 지정합니다(예: style="font-size : 8pt ; color : red").선택한 컴포넌트의 특성(예: 글꼴 및 색상)을 정의합니다. 수동으로 또는 단추를 클릭하고 창 안에서 원하는 특성을 선택하여 완료할 수 있습니다.

tabindex

내게 필요한 옵션>탭 순서 색인

JSP의 탭 순서에서 컴포넌트 위치를 지정합니다. 이 값은 0 - 32767 사이의 숫자여야 합니다.

title

내게 필요한 옵션>제목

런타임 시 도구 팁으로 브라우저에 표시되는 제목 텍스트를 지정합니다.

type

유형

연관된 양식으로 정보를 제출하거나 재설정하는 제출 또는 재설정 단추 유형을 지정합니다.

value

유형>텍스트: 단추 레이블

명령 단추 내에 표시될 텍스트를 지정합니다.

관련 개념
JavaServer Faces를 사용하여 데이터 액세스 웹 응용프로그램 작성
관련 태스크
Faces 응용프로그램 작성 - 개요
관련 참조
Faces 컴포넌트 참조
Faces 컴포넌트의 속성
명령 - 하이퍼링크
피드백
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.