chrome.input.ime

중요: 이 API는 ChromeOS에서만 작동합니다.

설명

chrome.input.ime API를 사용하여 Chrome OS용 맞춤 IME를 구현합니다. 이렇게 하면 확장 프로그램에서 키 입력을 처리하고, 구성을 설정하며, 후보 창을 관리할 수 있습니다.

권한

input

'input' 라벨을 선언해야 함 input.ime API를 사용할 수 있는 확장 프로그램 매니페스트의 권한이 필요합니다. 예를 들면 다음과 같습니다.

{
  "name": "My extension",
  ...
  "permissions": [
    "input"
  ],
  ...
}

가용성

<ph type="x-smartling-placeholder"></ph> ChromeOS만 해당 를 통해 개인정보처리방침을 정의할 수 있습니다.

예

다음 코드는 입력된 문자를 대문자로 변환하는 IME를 만듭니다.

var context_id = -1;

chrome.input.ime.onFocus.addListener(function(context) {
  context_id = context.contextID;
});

chrome.input.ime.onKeyEvent.addListener(
  function(engineID, keyData) {
    if (keyData.type == "keydown" && keyData.key.match(/^[a-z]$/)) {
      chrome.input.ime.commitText({"contextID": context_id,
                                    "text": keyData.key.toUpperCase()});
      return true;
    } else {
      return false;
    }
  }
);

유형

AssistiveWindowButton

Chrome 85 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

보조 창의 버튼 ID입니다.

열거형

"실행취소"

"addToDictionary"

AssistiveWindowProperties

Chrome 85 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

보조 창의 속성입니다.

속성

• announceString

  문자열(선택사항)

  ChromeVox에서 음성으로 안내할 문자열입니다.

• 유형

  "실행취소"
  

• 표시

  부울

  AssistiveWindow를 표시하려면 true를 설정하고 숨기려면 false를 설정합니다.

AssistiveWindowType

Chrome 85 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

보조 창의 유형입니다.

값

"실행취소"

AutoCapitalizeType

Chrome 69 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

텍스트 필드의 자동 대문자 유형입니다.

열거형

"문자"

"단어"

"sentences"

InputContext

입력 컨텍스트를 설명합니다.

속성

• autoCapitalize

  AutoCapitalizeType

  Chrome 69 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  텍스트 필드의 자동 대문자 유형입니다.

• autoComplete

  부울

  텍스트 필드의 자동 완성 여부입니다.

• autoCorrect

  부울

  텍스트 필드의 자동 수정 여부입니다.

• contextID

  숫자

  텍스트 필드 작업의 대상을 지정하는 데 사용됩니다. 이 ID는 onBlur가 호출되는 즉시 무효화됩니다.

• shouldDoLearning

  부울

  Chrome 68 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  사용자에게 더 나은 입력 제안 기능을 제공하는 데 텍스트 필드에 입력된 텍스트를 사용할지 여부입니다.

• spellCheck

  부울

  텍스트 필드에 맞춤법 검사가 필요한지 여부입니다.

• 유형

  InputContextType

  이 텍스트 입력란에서 수정하는 값의 유형(텍스트, 숫자, URL 등)

InputContextType

Chrome 44 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

이 텍스트 입력란에서 수정하는 값의 유형(텍스트, 숫자, URL 등)

열거형

"텍스트"

"검색"

"tel"

"URL"

"이메일"

"숫자"

"password"

"null"

KeyboardEvent

http://www.w3.org/TR/DOM-Level-3-Events/#events-KeyboardEvent를 참조하세요.

속성

• altKey

  불리언 선택사항

  ALT 키를 눌렀는지 여부입니다.

• altgrKey

  불리언 선택사항

  Chrome 79 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  ALTGR 키를 눌렀는지 여부입니다.

• capsLock

  불리언 선택사항

  CAPS_LOCK의 사용 설정 여부입니다.

• 코드

  문자열

  누르는 실제 키의 값입니다. 이 값은 현재 키보드 레이아웃이나 특수키 상태의 영향을 받지 않습니다.

• ctrlKey

  불리언 선택사항

  Ctrl 키를 눌렀는지 여부입니다.

• extensionId

  문자열(선택사항)

  이 키 이벤트 발신자의 확장 프로그램 ID입니다.

• 키

  문자열

  누르는 키 값

• keyCode

  숫자 선택사항

  지원 중단된 HTML keyCode. 누르는 키와 연결된 수정되지 않은 식별자를 나타내는 시스템 및 구현에 종속된 숫자 코드입니다.

• requestId

  문자열(선택사항)

  (지원 중단됨) 요청의 ID입니다. 대신 onKeyEvent 이벤트의 requestId 매개변수를 사용하세요.

• shiftKey

  불리언 선택사항

  Shift 키를 눌렀는지 여부입니다.

• 유형

  KeyboardEventType

  keyup 또는 keydown 중 하나입니다.

KeyboardEventType

Chrome 44 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

열거형

"keyup"

"키 다운"

MenuItem

언어 메뉴에서 사용자와 상호작용하기 위해 입력 방법에서 사용하는 메뉴 항목입니다.

속성

• 선택됨

  불리언 선택사항

  이 항목을 체크표시로 그려야 함을 나타냅니다.

• 사용 설정됨

  불리언 선택사항

  이 항목이 사용 설정되어 있음을 나타냅니다.

• id

  문자열

  이 MenuItem을 참조하는 콜백에 전달되는 문자열입니다.

• 라벨

  문자열(선택사항)

  이 항목의 메뉴에 표시되는 텍스트입니다.

• 스타일

  MenuItemStyle 선택사항

  메뉴 항목의 유형입니다.

• 표시

  불리언 선택사항

  이 항목을 표시할 수 있음을 나타냅니다.

MenuItemStyle

Chrome 44 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

메뉴 항목의 유형입니다. 구분자 사이의 라디오 버튼은 그룹화된 것으로 간주됩니다.

열거형

"확인"

'라디오'

"구분자"

MenuParameters

Chrome 88 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

속성

• engineID

  문자열

  사용할 엔진의 ID입니다.

• 항목

  MenuItem[]

  추가하거나 업데이트할 MenuItems입니다. 배열에 있는 순서대로 추가됩니다.

MouseButton

Chrome 44 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

클릭된 마우스 버튼

열거형

"왼쪽"

"중간"

"오른쪽"

ScreenType

Chrome 44 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

IME가 활성화되는 화면 유형입니다.

열거형

"normal"

"로그인"

"잠금"

"secondary-login"

UnderlineStyle

Chrome 44 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

이 구간을 수정하기 위한 밑줄의 유형입니다.

열거형

"밑줄"

"double밑줄"

"nounderline"

WindowPosition

Chrome 44 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

후보 창을 표시할 위치입니다. 'cursor'로 설정하면 창이 커서를 따라갑니다. 'composition'으로 설정하면 창이 음악작품의 시작 부분으로 고정됩니다.

열거형

"cursor"

"composition"

메서드

clearComposition()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

chrome.input.ime.clearComposition(
  parameters: object,
  callback?: function,
)

현재 구성을 지웁니다. 이 확장 프로그램이 활성 IME를 소유하지 않으면 실패합니다.

매개변수

• 매개변수

  객체

  • contextID

    숫자

    음악작품이 삭제될 컨텍스트의 ID입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (success: boolean) => void

  • 성공

    부울

반환 값

• Promise&lt;boolean&gt;

  Chrome 111 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

commitText()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

chrome.input.ime.commitText(
  parameters: object,
  callback?: function,
)

제공된 텍스트를 현재 입력에 커밋합니다.

매개변수

• 매개변수

  객체

  • contextID

    숫자

    텍스트가 커밋될 컨텍스트의 ID입니다.

  • 텍스트

    문자열

    커밋할 텍스트

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (success: boolean) => void

  • 성공

    부울

반환 값

• Promise&lt;boolean&gt;

  Chrome 111 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

deleteSurroundingText()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

chrome.input.ime.deleteSurroundingText(
  parameters: object,
  callback?: function,
)

캐럿 주위의 텍스트를 삭제합니다.

매개변수

• 매개변수

  객체

  • contextID

    숫자

    주변 텍스트가 삭제될 컨텍스트의 ID입니다.

  • engineID

    문자열

    이벤트를 수신하는 엔진의 ID입니다.

  • 길이

    숫자

    삭제할 문자 수

  • 오프셋

    숫자

    삭제가 시작되는 캐럿 위치로부터의 오프셋입니다. 이 값은 음수일 수 있습니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• 프로미스<void>

  Chrome 111 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

hideInputView()

chrome.input.ime.hideInputView()

시스템에 의해 자동으로 팝업되는 입력 뷰 창을 숨깁니다. 입력 뷰 창이 이미 숨겨져 있으면 이 함수는 아무것도 하지 않습니다.

keyEventHandled()

chrome.input.ime.keyEventHandled(
  requestId: string,
  response: boolean,
)

onKeyEvent에서 수신한 키 이벤트가 처리됨을 나타냅니다. onKeyEvent 리스너가 비동기식인 경우에만 호출해야 합니다.

매개변수

• requestId

  문자열

  처리된 이벤트의 요청 ID입니다. keyEvent.requestId에서 가져와야 합니다.

• 응답

  부울

  키 입력이 처리된 경우 true, 처리되지 않은 경우 false

sendKeyEvents()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

chrome.input.ime.sendKeyEvents(
  parameters: object,
  callback?: function,
)

주요 이벤트를 전송합니다. 이 함수는 가상 키보드에서 사용됩니다. 사용자가 가상 키보드의 키를 누르면 이 함수가 해당 이벤트를 시스템에 전파하는 데 사용됩니다.

매개변수

• 매개변수

  객체

  • contextID

    숫자

    키 이벤트가 전송될 컨텍스트의 ID입니다. 입력이 아닌 필드로 키 이벤트를 전송하려면 0입니다.

  • keyData

    KeyboardEvent[]

    키 이벤트의 데이터입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• 프로미스<void>

  Chrome 111 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

setAssistiveWindowButtonHighlighted()

<ph type="x-smartling-placeholder"></ph> 프로미스 Chrome 86 이상

chrome.input.ime.setAssistiveWindowButtonHighlighted(
  parameters: object,
  callback?: function,
)

보조 창의 버튼을 강조 표시하거나 강조 표시합니다.

매개변수

• 매개변수

  객체

  • announceString

    문자열(선택사항)

    스크린 리더에서 알릴 텍스트입니다.

  • buttonID

    AssistiveWindowButton

    버튼의 ID입니다.

  • contextID

    숫자

    보조 창을 소유하는 컨텍스트의 ID입니다.

  • 눈에 띄는 채팅 메시지

    부울

    버튼을 강조 표시해야 하는지 여부입니다.

  • windowType

    "실행취소"
    

    버튼이 속한 창 유형입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• 프로미스<void>

  Chrome 111 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

setAssistiveWindowProperties()

<ph type="x-smartling-placeholder"></ph> 프로미스 Chrome 85 이상

chrome.input.ime.setAssistiveWindowProperties(
  parameters: object,
  callback?: function,
)

지정된 속성이 있는 보조 창을 표시하거나 숨깁니다.

매개변수

• 매개변수

  객체

  • contextID

    숫자

    보조 창을 소유하는 컨텍스트의 ID입니다.

  • 속성

    AssistiveWindowProperties

    보조 창의 속성입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (success: boolean) => void

  • 성공

    부울

반환 값

• Promise&lt;boolean&gt;

  Chrome 111 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

setCandidates()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

chrome.input.ime.setCandidates(
  parameters: object,
  callback?: function,
)

현재 후보 목록을 설정합니다. 이 확장 프로그램이 활성 IME를 소유하지 않으면 실패합니다.

매개변수

• 매개변수

  객체

  • 후보

    object[]

    후보 창에 표시할 후보자 목록

    • annotation

      문자열(선택사항)

      후보를 설명하는 추가 텍스트

    • 조합

      문자열

      후보

    • id

      숫자

      후보자 ID

    • 라벨

      문자열(선택사항)

      후보 단어 옆에 표시되는 짧은 문자열(종종 단축키 또는 색인)

    • parentId

      숫자 선택사항

      이러한 후보를 추가할 ID입니다.

    • 사용량

      객체(선택사항)

      단어의 용법 또는 자세한 설명입니다.

      • 본문

        문자열

        세부정보 설명의 본문 문자열입니다.

      • 제목

        문자열

        세부정보 설명의 제목 문자열입니다.

  • contextID

    숫자

    후보 창을 소유하는 컨텍스트의 ID입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (success: boolean) => void

  • 성공

    부울

반환 값

• Promise&lt;boolean&gt;

  Chrome 111 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

setCandidateWindowProperties()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

chrome.input.ime.setCandidateWindowProperties(
  parameters: object,
  callback?: function,
)

후보 창의 속성을 설정합니다. 확장 프로그램에서 활성 IME를 소유하지 않으면 실패합니다.

매개변수

• 매개변수

  객체

  • engineID

    문자열

    속성을 설정할 엔진의 ID입니다.

  • 속성

    객체

    • auxiliaryText

      문자열(선택사항)

      후보 창 하단에 표시되는 텍스트입니다.

    • auxiliaryTextVisible

      불리언 선택사항

      보조 텍스트를 표시하려면 true, 숨기려면 false입니다.

    • currentCandidateIndex

      숫자 선택사항

      Chrome 84 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

      전체 후보 중에서 현재 선택된 후보의 색인입니다.

    • cursorVisible

      불리언 선택사항

      커서를 표시하려면 True, 숨기려면 false입니다.

    • pageSize

      숫자 선택사항

      페이지당 표시할 후보자 수입니다.

    • totalCandidates

      숫자 선택사항

      Chrome 84 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

      후보 기간의 총 후보자 수입니다.

    • 카테고리

      불리언 선택사항

      후보 창을 세로로 렌더링해야 하는 경우 true, 가로로 렌더링하려면 false입니다.

    • 표시

      불리언 선택사항

      Candidate 창을 표시하려면 true, 숨기려면 false입니다.

    • windowPosition

      WindowPosition (선택사항)

      후보 창을 표시할 위치입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (success: boolean) => void

  • 성공

    부울

반환 값

• Promise&lt;boolean&gt;

  Chrome 111 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

setComposition()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

chrome.input.ime.setComposition(
  parameters: object,
  callback?: function,
)

현재 구성을 설정합니다. 이 확장 프로그램이 활성 IME를 소유하지 않으면 실패합니다.

매개변수

• 매개변수

  객체

  • contextID

    숫자

    음악작품 텍스트가 설정될 컨텍스트의 ID입니다.

  • cursor

    숫자

    커서 텍스트 내 위치입니다.

  • 세그먼트

    Object[] 선택사항

    세그먼트 및 관련 유형 목록

    • end

      숫자

      이 세그먼트를 종료할 문자의 색인입니다.

    • 시작

      숫자

      이 세그먼트를 시작할 문자의 색인입니다.

    • 스타일

      UnderlineStyle

      이 구간을 수정하기 위한 밑줄의 유형입니다.

  • selectionEnd

    숫자 선택사항

    텍스트에서 선택이 끝나는 위치입니다.

  • selectionStart

    숫자 선택사항

    텍스트 내에서 선택이 시작되는 위치입니다.

  • 텍스트

    문자열

    설정할 텍스트

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (success: boolean) => void

  • 성공

    부울

반환 값

• Promise&lt;boolean&gt;

  Chrome 111 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

setCursorPosition()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

chrome.input.ime.setCursorPosition(
  parameters: object,
  callback?: function,
)

후보 창에서 커서 위치를 설정합니다. 이 확장 프로그램이 활성 IME를 소유하지 않으면 작동하지 않습니다.

매개변수

• 매개변수

  객체

  • candidateID

    숫자

    선택할 후보자의 ID입니다.

  • contextID

    숫자

    후보 창을 소유하는 컨텍스트의 ID입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (success: boolean) => void

  • 성공

    부울

반환 값

• Promise&lt;boolean&gt;

  Chrome 111 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

setMenuItems()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

chrome.input.ime.setMenuItems(
  parameters: MenuParameters,
  callback?: function,
)

이 IME가 활성화되면 제공된 메뉴 항목을 언어 메뉴에 추가합니다.

매개변수

• 매개변수

  MenuParameters

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• 프로미스<void>

  Chrome 111 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

updateMenuItems()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

chrome.input.ime.updateMenuItems(
  parameters: MenuParameters,
  callback?: function,
)

지정된 MenuItems의 상태를 업데이트합니다.

매개변수

• 매개변수

  MenuParameters

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• 프로미스<void>

  Chrome 111 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

이벤트

onActivate

chrome.input.ime.onActivate.addListener(
  callback: function,
)

이 이벤트는 IME가 활성화될 때 전송됩니다. IME가 onKeyPress 이벤트를 수신할 것임을 알립니다.

매개변수

• 콜백

  함수

  callback 매개변수는 다음과 같습니다.

  (engineID: string, screen: ScreenType) => void

  • engineID

    문자열

  • 화면

    ScreenType

onAssistiveWindowButtonClicked

Chrome 85 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

chrome.input.ime.onAssistiveWindowButtonClicked.addListener(
  callback: function,
)

이 이벤트는 보조 창의 버튼을 클릭하면 전송됩니다.

매개변수

• 콜백

  함수

  callback 매개변수는 다음과 같습니다.

  (details: object) => void

  • 세부정보

    객체

    • buttonID

      AssistiveWindowButton

      클릭한 버튼의 ID입니다.

    • windowType

      AssistiveWindowType

      보조 창의 유형입니다.

onBlur

chrome.input.ime.onBlur.addListener(
  callback: function,
)

이 이벤트는 포커스가 텍스트 상자를 벗어나면 전송됩니다. 이 이벤트를 수신 대기하고 사용자가 사용 설정한 모든 확장 프로그램으로 전송됩니다.

매개변수

• 콜백

  함수

  callback 매개변수는 다음과 같습니다.

  (contextID: number) => void

  • contextID

    숫자

onCandidateClicked

chrome.input.ime.onCandidateClicked.addListener(
  callback: function,
)

이 이벤트는 이 확장 프로그램이 활성 IME를 소유한 경우 전송됩니다.

매개변수

• 콜백

  함수

  callback 매개변수는 다음과 같습니다.

  (engineID: string, candidateID: number, button: MouseButton) => void

  • engineID

    문자열

  • candidateID

    숫자

  • 버튼

    MouseButton

onDeactivated

chrome.input.ime.onDeactivated.addListener(
  callback: function,
)

이 이벤트는 IME가 비활성화되면 전송됩니다. IME가 더 이상 onKeyPress 이벤트를 수신하지 않을 것임을 알립니다.

매개변수

• 콜백

  함수

  callback 매개변수는 다음과 같습니다.

  (engineID: string) => void

  • engineID

    문자열

onFocus

chrome.input.ime.onFocus.addListener(
  callback: function,
)

이 이벤트는 포커스가 텍스트 상자에 들어가면 전송됩니다. 이 이벤트를 수신 대기하고 사용자가 사용 설정한 모든 확장 프로그램으로 전송됩니다.

매개변수

• 콜백

  함수

  callback 매개변수는 다음과 같습니다.

  (context: InputContext) => void

  • context

    InputContext

onInputContextUpdate

chrome.input.ime.onInputContextUpdate.addListener(
  callback: function,
)

이 이벤트는 현재 InputContext의 속성(예: 유형)이 변경되면 전송됩니다. 이 이벤트를 수신 대기하고 사용자가 사용 설정한 모든 확장 프로그램으로 전송됩니다.

매개변수

• 콜백

  함수

  callback 매개변수는 다음과 같습니다.

  (context: InputContext) => void

  • context

    InputContext

onKeyEvent

chrome.input.ime.onKeyEvent.addListener(
  callback: function,
)

운영체제에서 키 이벤트가 전송될 때 실행됩니다. 이 확장 프로그램이 활성 IME를 소유한 경우 이벤트가 확장 프로그램으로 전송됩니다. 이벤트가 처리되지 않은 경우 false로 처리되면 리스너 함수는 true를 반환해야 합니다. 이벤트가 비동기식으로 평가되는 경우 이 함수는 정의되지 않은 항목을 반환해야 하며 IME는 나중에 그 결과로 keyEventHandled()를 호출해야 합니다.

매개변수

• 콜백

  함수

  callback 매개변수는 다음과 같습니다.

  (engineID: string, keyData: KeyboardEvent, requestId: string) => boolean | undefined

  • engineID

    문자열

  • keyData

    KeyboardEvent

  • requestId

    문자열

  • returns

    boolean | 정의되지 않음

onMenuItemActivated

chrome.input.ime.onMenuItemActivated.addListener(
  callback: function,
)

사용자가 메뉴 항목을 선택할 때 호출됩니다.

매개변수

• 콜백

  함수

  callback 매개변수는 다음과 같습니다.

  (engineID: string, name: string) => void

  • engineID

    문자열

  • 이름

    문자열

onReset

chrome.input.ime.onReset.addListener(
  callback: function,
)

이 이벤트는 Chrome이 진행 중인 텍스트 입력 세션을 종료할 때 전송됩니다.

매개변수

• 콜백

  함수

  callback 매개변수는 다음과 같습니다.

  (engineID: string) => void

  • engineID

    문자열

onSurroundingTextChanged

chrome.input.ime.onSurroundingTextChanged.addListener(
  callback: function,
)

캐럿 주위의 수정 가능한 문자열이 변경되거나 캐럿 위치가 이동될 때 호출됩니다. 텍스트 길이는 앞뒤로 100자(영문 기준)로 제한됩니다.

매개변수

• 콜백

  함수

  callback 매개변수는 다음과 같습니다.

  (engineID: string, surroundingInfo: object) => void

  • engineID

    문자열

  • surroundingInfo

    객체

    • 앵커

      숫자

      선택 영역의 시작 위치입니다. 이 값은 선택 항목이 없는 경우 캐럿 위치를 나타냅니다.

    • 초점

      숫자

      선택 항목의 종료 위치입니다. 이 값은 선택 항목이 없는 경우 캐럿 위치를 나타냅니다.

    • 오프셋

      숫자

      Chrome 46 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

      text의 오프셋 위치입니다. text는 커서 주위에 텍스트 하위 집합만 포함하므로 오프셋은 text 첫 문자의 절대 위치를 나타냅니다.

    • 텍스트

      문자열

      커서 주변의 텍스트입니다. 이는 입력란에 있는 모든 텍스트의 하위 집합입니다.