번역 작업 진행중입니다.

페이지 액션은 브라우저의 주소창에 있는 아이콘이다.

아이콘 클릭에 대한 대응은 리스너를 등록하고 클릭 이벤트를 기다리는 것이나, 팝업창이 열리게 하는 것일 수 있다.

팝업창은 보통의 웹페이지처럼 HTML, CSS, 그리고 자바스크립트로 내용과 동작을 작성할 수 있다. 팝업창에서 실행되는 자바스크립트는 백그라운드 스크립트와 마찬가지로 모든 확장앱 API를 사용할 수 있다.

manifest.jsonpage_action 키에 페이지 액션의 대부분의 속성들을 정의할 수 있지만, 이것들은 확정되는 것이라 이후에 바꿀 수 없다. 하지만 이 API는 그것들을 프로그램적으로 재정의하는 것도 가능하다. 그러나 API는 manifest.jsonpage_action 키가 있어야만 사용할 수 있게 되므로 설사 모든 것을 프로그램적으로 할 계획이더라도 page_action 키는 있어야 한다.

페이지 액션은 특정 페이지에만 적절한 동작들을 위한 것이다(이럴테면 "현재 탭을 북마크하기" 같은). 그렇지 않고, 브라우저가 전반적으로 관련되는 동작이라면(가령은 "모든 북마크 보기" 라면) 브라우저 액션을 대신 사용하라.

자료형

pageAction.ImageDataType
이미지에 대한 픽셀 자료.

함수

pageAction.show()
지정한 탭에 페이지 액션을 보인다.
pageAction.hide()
지정한 탭의 페이지 액션을 숨긴다.
pageAction.isShown()
페이지 액션이 보이는지 아닌지 검사한다.
pageAction.setTitle()
페이지 액션의 제목을 설정한다. 이것은 페이지 액션위에 툴팁으로 표시된다.
pageAction.getTitle()
페이지 액션의 제목을 얻는다.
pageAction.setIcon()
페이지 액션의 아이콘을 설정한다.
pageAction.setPopup()
페이지 액션의 팝업 URL을 설정한다.
pageAction.getPopup()
페이지 액션의 팝업 URL을 얻는다.
pageAction.openPopup()
페이지 액션의 팝업을 연다.

이벤트

pageAction.onClicked
페이지 액션의 아이콘이 클릭되면 발생한다. 페이지 액션이 팝업이 설정되어 있으면 발생하지 않는다.

브라우저 호환성

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxOperaFirefox for Android
ImageDataTypeChrome Full support YesEdge No support NoFirefox Full support 45Opera Full support YesFirefox Android No support No
getPopupChrome Full support YesEdge Full support 14Firefox Full support 45Opera Full support YesFirefox Android Full support 50
Notes
Full support 50
Notes
Notes The 'tabId' parameter is ignored: the page action popup is the same for all tabs.
getTitleChrome Full support YesEdge Full support 14Firefox Full support 45Opera Full support YesFirefox Android No support No
hideChrome Full support YesEdge Full support 14Firefox Full support 45Opera Full support YesFirefox Android Full support 50
Notes
Full support 50
Notes
Notes Before version 56, the 'tabId' parameter was ignored, and the page action was hidden for all tabs.
isShownChrome No support NoEdge No support NoFirefox Full support 59Opera No support NoFirefox Android No support No
onClickedChrome Full support YesEdge Full support 14Firefox Full support 45Opera Full support YesFirefox Android Full support 50
openPopupChrome No support NoEdge No support NoFirefox Full support 57Opera No support NoFirefox Android No support No
setIconChrome Full support Yes
Notes
Full support Yes
Notes
Notes Before Chrome 23, `path` couldn't specify multiple icon files, but had to be a string specifying a single icon path.
Edge Full support 14Firefox Full support 45Opera Full support 15Firefox Android No support No
setPopupChrome Full support YesEdge Full support 14Firefox Full support 45Opera Full support YesFirefox Android Full support 50
Notes
Full support 50
Notes
Notes The 'tabId' parameter is ignored, and the popup is set for all tabs.
setTitleChrome Full support YesEdge Full support 14Firefox Full support 45Opera Full support YesFirefox Android No support No
showChrome Full support YesEdge Full support 14Firefox Full support 45Opera Full support YesFirefox Android Full support 50
Notes
Full support 50
Notes
Notes Before version 56, the 'tabId' parameter was ignored, and the page action was shown for all tabs.

Legend

Full support  
Full support
No support  
No support
See implementation notes.
See implementation notes.

Example extensions

Acknowledgements

This API is based on Chromium's chrome.pageAction API. This documentation is derived from page_action.json in the Chromium code.

Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.

문서 태그 및 공헌자

이 페이지의 공헌자: grizlupo
최종 변경자: grizlupo,