Trang này được dịch bởi Cloud Translation API.

chrome.input.ime

Nội dung mô tả

Sử dụng API chrome.input.ime để triển khai IME tuỳ chỉnh cho Chrome OS. Điều này cho phép tiện ích của bạn xử lý các thao tác nhấn phím, đặt bố cục và quản lý cửa sổ đề xuất.

Quyền

input

Bạn phải khai báo quyền "input" trong tệp kê khai tiện ích để sử dụng API input.ime. Ví dụ:

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

Ví dụ

Mã sau đây sẽ tạo một IME chuyển đổi các chữ cái đã nhập thành chữ hoa.

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;
    }
  }
);

Loại

AssistiveWindowButton

Chrome 85 trở lên

Mã nhận dạng của các nút trong cửa sổ hỗ trợ.

Liệt kê

AssistiveWindowProperties

Chrome 85 trở lên

Thuộc tính của cửa sổ hỗ trợ.

Thuộc tính

announceString

chuỗi không bắt buộc

Các chuỗi để ChromeVox thông báo.
loại
hiển thị

boolean

Đặt giá trị true để hiện AsupportedWindow, đặt false để ẩn.

AssistiveWindowType

Chrome 85 trở lên

Loại cửa sổ hỗ trợ.

Giá trị

AutoCapitalizeType

Chrome 69 trở lên

Kiểu viết hoa tự động của trường văn bản.

Liệt kê

"words"

"sentences"

InputContext

Mô tả Ngữ cảnh đầu vào

Thuộc tính

autoCapitalize

AutoCapitalizeType

Chrome 69 trở lên

Kiểu viết hoa tự động của trường văn bản.
autoComplete

boolean

Liệu trường văn bản có muốn tự động hoàn tất hay không.
autoCorrect

boolean

Liệu trường văn bản có muốn tự động sửa lỗi hay không.
contextID

number

Hàm này dùng để chỉ định mục tiêu của các thao tác với trường văn bản. Mã nhận dạng này không còn hợp lệ ngay sau khi hệ thống gọi onBlur.
shouldDoLearning

boolean

Chrome 68 trở lên

Liệu có cần sử dụng văn bản đã nhập vào trường văn bản để cải thiện nội dung đề xuất nhập cho người dùng hay không.
spellCheck

boolean

Liệu trường văn bản có muốn kiểm tra lỗi chính tả hay không.
loại

InputContextType

Loại giá trị mà trường văn bản này chỉnh sửa (Văn bản, Số, URL, v.v.)

InputContextType

Chrome 44 trở lên

Loại giá trị mà trường văn bản này chỉnh sửa (Văn bản, Số, URL, v.v.)

Liệt kê

"text"

"tel"

"url"

"email"

"null"

KeyboardEvent

Xem http://www.w3.org/TR/DOM-Level-3-Events/#events-KeyboardEvent

Thuộc tính

altKey

boolean không bắt buộc

Liệu có nhấn phím ALT hay không.
altgrKey

boolean không bắt buộc

Chrome 79 trở lên

Liệu có nhấn phím ALTGR hay không.
capsLock

boolean không bắt buộc

Liệu bạn có bật CAPS_LOCK hay không.
mã

string

Giá trị của phím vật lý đang được nhấn. Giá trị này không chịu ảnh hưởng của trạng thái đối tượng sửa đổi hoặc bố cục bàn phím hiện tại.
ctrlKey

boolean không bắt buộc

Liệu có nhấn phím CTRL hay không.
extensionId

chuỗi không bắt buộc

Mã tiện ích của người gửi sự kiện chính này.
phím

string

Giá trị của phím đang được nhấn
keyCode

số không bắt buộc

Mã khoá HTML không được dùng nữa. Mã này là mã số phụ thuộc vào hệ thống và phương thức triển khai biểu thị mã nhận dạng chưa sửa đổi được liên kết với khoá đã nhấn.
requestId

chuỗi không bắt buộc

(Không dùng nữa) Mã của yêu cầu. Thay vào đó, hãy sử dụng tham số requestId từ sự kiện onKeyEvent.
shiftKey

boolean không bắt buộc

Liệu có nhấn phím SHIFT hay không.
loại

KeyboardEventType

Một trong hai phím tắt hoặc nhấn phím.

KeyboardEventType

Chrome 44 trở lên

Liệt kê

"keyup"

"keydown"

MenuItem

Một mục trong trình đơn được phương thức nhập sử dụng để tương tác với người dùng từ trình đơn ngôn ngữ.

Thuộc tính

đã đánh dấu

boolean không bắt buộc

Cho biết mục này sẽ được vẽ bằng dấu kiểm.
đang bật

boolean không bắt buộc

Cho biết rằng mục này đã được bật.
id

string

Chuỗi sẽ được chuyển đến các lệnh gọi lại tham chiếu đến Mục trình đơn này.
label

chuỗi không bắt buộc

Văn bản xuất hiện trong trình đơn cho mục này.
kiểu

MenuItemStyle không bắt buộc

Loại mục trong trình đơn.
hiển thị

boolean không bắt buộc

Cho biết mục này có hiển thị hay không.

MenuItemStyle

Chrome 44 trở lên

Loại mục trong trình đơn. Các nút chọn giữa các dòng phân cách được xem là nhóm lại.

Liệt kê

"check"

"radio"

MenuParameters

Chrome 88 trở lên

Thuộc tính

engineID

string

Mã của công cụ sẽ sử dụng.
items

MenuItem[]

Mục trong Trình đơn cần thêm hoặc cập nhật. Các giá trị này sẽ được thêm vào theo thứ tự tồn tại trong mảng.

MouseButton

Chrome 44 trở lên

Nút trên chuột đã được nhấp.

Liệt kê

ScreenType

Chrome 44 trở lên

Loại màn hình mà IME được kích hoạt.

Liệt kê

"login"

UnderlineStyle

Chrome 44 trở lên

Loại dấu gạch chân để sửa đổi đoạn này.

Liệt kê

WindowPosition

Chrome 44 trở lên

Vị trí hiển thị cửa sổ đề xuất. Nếu bạn đặt chính sách này thành 'cursor', cửa sổ sẽ đi theo con trỏ. Nếu bạn đặt chính sách này thành "composition", cửa sổ sẽ bị khoá phần đầu của cấu trúc.

Liệt kê

Phương thức

clearComposition()

Cam kết

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

Xóa bố cục hiện tại. Nếu tiện ích này không sở hữu IME đang hoạt động, thì thao tác này sẽ không thành công.

Tham số

tham số

đối tượng
- contextID
  
  number
  
  Mã nhận dạng bối cảnh mà bố cục sẽ bị xoá
số gọi lại

hàm không bắt buộc

Tham số callback sẽ có dạng như sau:
```
(success: boolean)=>void
```
- thành công
  
  boolean

Giá trị trả về

Promise<boolean>

Chrome 111 trở lên

Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

commitText()

Cam kết

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

Xác nhận văn bản đã cung cấp với dữ liệu đầu vào hiện tại.

Tham số

tham số

đối tượng
- contextID
  
  number
  
  Mã nhận dạng của ngữ cảnh sẽ nhận văn bản
- văn bản
  
  string
  
  Văn bản cần cam kết
số gọi lại

hàm không bắt buộc

Tham số callback sẽ có dạng như sau:
```
(success: boolean)=>void
```
- thành công
  
  boolean

Giá trị trả về

Promise<boolean>

Chrome 111 trở lên

Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

deleteSurroundingText()

Cam kết

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

Xoá văn bản xung quanh con nháy.

Tham số

tham số

đối tượng
- contextID
  
  number
  
  Mã nhận dạng của ngữ cảnh mà văn bản xung quanh sẽ bị xoá.
- engineID
  
  string
  
  Mã của công cụ nhận sự kiện.
- chiều dài
  
  number
  
  Số ký tự cần xoá
- bù trừ
  
  number
  
  Độ lệch so với vị trí con nháy nơi sẽ bắt đầu quá trình xoá. Giá trị này có thể là số âm.
số gọi lại

hàm không bắt buộc

Tham số callback sẽ có dạng như sau:
```
()=>void
```

Giá trị trả về

Promise<void>

Chrome 111 trở lên

Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

hideInputView()

chrome.input.ime.hideInputView()

Ẩn cửa sổ chế độ xem phương thức nhập (được hệ thống tự động bật lên). Nếu cửa sổ khung hiển thị đầu vào đã bị ẩn, thì hàm này sẽ không làm gì cả.

keyEventHandled()

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

Cho biết rằng sự kiện chính mà onKeyEvent nhận được đã được xử lý. Lệnh này chỉ nên được gọi nếu trình nghe onKeyEvent không đồng bộ.

Tham số

requestId

string

Mã yêu cầu của sự kiện đã được xử lý. Mã này phải lấy từ keyEvent.requestId
phản hồi

boolean

True nếu thao tác nhấn phím được xử lý, false nếu không xử lý

sendKeyEvents()

Cam kết

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

Gửi các sự kiện chính. Hàm này dự kiến sẽ được dùng cho bàn phím ảo. Khi người dùng nhấn(các) phím trên bàn phím ảo, hàm này được dùng để truyền sự kiện đó đến hệ thống.

Tham số

tham số

đối tượng
- contextID
  
  number
  
  Mã nhận dạng của ngữ cảnh mà các sự kiện chính sẽ được gửi hoặc mã 0 để gửi các sự kiện chính đến trường không phải dữ liệu đầu vào.
- keyData
  
  KeyboardEvent[]
  
  Dữ liệu về sự kiện chính.
số gọi lại

hàm không bắt buộc

Tham số callback sẽ có dạng như sau:
```
()=>void
```

Giá trị trả về

Promise<void>

Chrome 111 trở lên

Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

setAssistiveWindowButtonHighlighted()

Cam kết Chrome 86 trở lên

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

Đánh dấu/Bỏ đánh dấu một nút trong cửa sổ hỗ trợ.

Tham số

tham số

đối tượng
- announceString
  
  chuỗi không bắt buộc
  
  Văn bản để trình đọc màn hình thông báo.
- buttonID
  
  AssistiveWindowButton
  
  Mã của nút
- contextID
  
  number
  
  Mã nhận dạng của ngữ cảnh sở hữu cửa sổ hỗ trợ.
- được làm nổi bật
  
  boolean
  
  Liệu nút có được đánh dấu hay không.
- windowType
  
  Loại cửa sổ chứa nút.
số gọi lại

hàm không bắt buộc

Tham số callback sẽ có dạng như sau:
```
()=>void
```

Giá trị trả về

Promise<void>

Chrome 111 trở lên

Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

setAssistiveWindowProperties()

Cam kết Chrome 85 trở lên

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

Hiện/Ẩn cửa sổ hỗ trợ với các thuộc tính đã cho.

Tham số

tham số

đối tượng
- contextID
  
  number
  
  Mã nhận dạng của ngữ cảnh sở hữu cửa sổ hỗ trợ.
- các tài sản
  
  AssistiveWindowProperties
  
  Thuộc tính của cửa sổ hỗ trợ.
số gọi lại

hàm không bắt buộc

Tham số callback sẽ có dạng như sau:
```
(success: boolean)=>void
```
- thành công
  
  boolean

Giá trị trả về

Promise<boolean>

Chrome 111 trở lên

Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

setCandidates()

Cam kết

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

Đặt danh sách ứng viên hiện tại. Thao tác này sẽ không thành công nếu tiện ích này không sở hữu IME đang hoạt động

Tham số

tham số

đối tượng
- ứng viên
  
  đối tượng[]
  
  Danh sách các đề xuất sẽ hiển thị trong cửa sổ đề xuất
  - chú thích
    
    chuỗi không bắt buộc
    
    Văn bản bổ sung mô tả ứng cử viên
  - đề xuất
    
    string
    
    Ứng viên
  - id
    
    number
    
    Mã của ứng cử viên
  - label
    
    chuỗi không bắt buộc
    
    Chuỗi ngắn hiển thị bên cạnh từ đề xuất, thường là phím tắt hoặc chỉ mục
  - parentId
    
    số không bắt buộc
    
    Mã để thêm các đề xuất này trong
  - mức sử dụng
    
    đối tượng không bắt buộc
    
    Cách sử dụng hoặc mô tả chi tiết của từ.
    
    body
    
    string
    
    Chuỗi nội dung mô tả chi tiết.
    
    title
    
    string
    
    Chuỗi tiêu đề của nội dung mô tả chi tiết.
- contextID
  
  number
  
  Mã của ngữ cảnh sở hữu cửa sổ đề xuất.
số gọi lại

hàm không bắt buộc

Tham số callback sẽ có dạng như sau:
```
(success: boolean)=>void
```
- thành công
  
  boolean

Giá trị trả về

Promise<boolean>

Chrome 111 trở lên

Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

setCandidateWindowProperties()

Cam kết

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

Đặt thuộc tính của cửa sổ đề xuất. Thao tác này sẽ không thành công nếu tiện ích không sở hữu IME đang hoạt động

Tham số

tham số

đối tượng
- engineID
  
  string
  
  Mã của công cụ để đặt thuộc tính.
- các tài sản
  
  đối tượng
  - auxiliaryText
    
    chuỗi không bắt buộc
    
    Văn bản xuất hiện ở cuối cửa sổ đề xuất.
  - auxiliaryTextVisible
    
    boolean không bắt buộc
    
    "True" để hiển thị văn bản phụ trợ, "false" để ẩn văn bản phụ trợ.
  - currentCandidateIndex
    
    số không bắt buộc
    
    Chrome 84 trở lên
    
    Chỉ mục của ứng cử viên hiện được chọn trong tổng số ứng cử viên.
  - cursorVisible
    
    boolean không bắt buộc
    
    True để hiển thị con trỏ, false để ẩn con trỏ.
  - pageSize
    
    số không bắt buộc
    
    Số lượng đề xuất để hiển thị trên mỗi trang.
  - totalCandidates
    
    số không bắt buộc
    
    Chrome 84 trở lên
    
    Tổng số ứng viên cho cửa sổ đề xuất.
  - ngành dọc
    
    boolean không bắt buộc
    
    "True" nếu cửa sổ đề xuất hiển thị theo chiều dọc, "false" nếu cửa sổ đề xuất hiển thị theo chiều ngang.
  - hiển thị
    
    boolean không bắt buộc
    
    Giá trị là "True" để hiển thị cửa sổ Ứng viên, còn "false" để ẩn cửa sổ Ứng viên.
  - windowPosition
    
    WindowPosition không bắt buộc
    
    Vị trí hiển thị cửa sổ đề xuất.
số gọi lại

hàm không bắt buộc

Tham số callback sẽ có dạng như sau:
```
(success: boolean)=>void
```
- thành công
  
  boolean

Giá trị trả về

Promise<boolean>

Chrome 111 trở lên

Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

setComposition()

Cam kết

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

Đặt bố cục hiện tại. Nếu tiện ích này không sở hữu IME đang hoạt động, thì thao tác này sẽ không thành công.

Tham số

tham số

đối tượng
- contextID
  
  number
  
  Mã nhận dạng ngữ cảnh mà văn bản sáng tác sẽ được đặt
- con trỏ
  
  number
  
  Đặt vị trí trong văn bản của con trỏ.
- tương tự
  
  đối tượng[] không bắt buộc
  
  Danh sách phân khúc và loại phân khúc liên quan.
  - end
    
    number
    
    Chỉ mục của ký tự để kết thúc đoạn này sau đó.
  - bắt đầu
    
    number
    
    Chỉ mục của ký tự để bắt đầu đoạn này tại
  - kiểu
    
    UnderlineStyle
    
    Loại dấu gạch chân để sửa đổi đoạn này.
- selectionEnd
  
  số không bắt buộc
  
  Vị trí trong văn bản mà vùng lựa chọn kết thúc.
- selectionStart
  
  số không bắt buộc
  
  Vị trí trong văn bản mà vùng lựa chọn bắt đầu.
- văn bản
  
  string
  
  Nội dung cần đặt
số gọi lại

hàm không bắt buộc

Tham số callback sẽ có dạng như sau:
```
(success: boolean)=>void
```
- thành công
  
  boolean

Giá trị trả về

Promise<boolean>

Chrome 111 trở lên

Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

setCursorPosition()

Cam kết

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

Đặt vị trí của con trỏ trong cửa sổ đề xuất. Đây là tuỳ chọn không hoạt động nếu tiện ích này không sở hữu IME đang hoạt động.

Tham số

tham số

đối tượng
- candidateID
  
  number
  
  Mã của ứng viên cần chọn.
- contextID
  
  number
  
  Mã của ngữ cảnh sở hữu cửa sổ đề xuất.
số gọi lại

hàm không bắt buộc

Tham số callback sẽ có dạng như sau:
```
(success: boolean)=>void
```
- thành công
  
  boolean

Giá trị trả về

Promise<boolean>

Chrome 111 trở lên

Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

setMenuItems()

Cam kết

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

Thêm các mục trình đơn được cung cấp vào trình đơn ngôn ngữ khi IME này đang hoạt động.

Tham số

tham số

MenuParameters
số gọi lại

hàm không bắt buộc

Tham số callback sẽ có dạng như sau:
```
()=>void
```

Giá trị trả về

Promise<void>

Chrome 111 trở lên

Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

updateMenuItems()

Cam kết

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

Cập nhật trạng thái của MenuItems được chỉ định

Tham số

tham số

MenuParameters
số gọi lại

hàm không bắt buộc

Tham số callback sẽ có dạng như sau:
```
()=>void
```

Giá trị trả về

Promise<void>

Chrome 111 trở lên

Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

Sự kiện

onActivate

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

Sự kiện này được gửi khi IME được kích hoạt. Mã này sẽ báo hiệu rằng IME sẽ nhận được các sự kiện onKeyPress.

Tham số

số gọi lại

hàm

Tham số callback sẽ có dạng như sau:
```
(engineID: string,screen: ScreenType)=>void
```
- engineID
  
  string
- màn hình
  
  ScreenType

onAssistiveWindowButtonClicked

Chrome 85 trở lên

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

Sự kiện này được gửi khi nhấp vào một nút trong cửa sổ hỗ trợ.

Tham số

số gọi lại

hàm

Tham số callback sẽ có dạng như sau:
```
(details: object)=>void
```
- chi tiết
  
  đối tượng
  - buttonID
    
    AssistiveWindowButton
    
    Mã của nút được nhấp.
  - windowType
    
    AssistiveWindowType
    
    Loại cửa sổ hỗ trợ.

onBlur

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

Sự kiện này được gửi khi tiêu điểm rời khỏi một hộp văn bản. Thông báo này được gửi đến tất cả các tiện ích đang theo dõi sự kiện này và được người dùng bật.

Tham số

số gọi lại

hàm

Tham số callback sẽ có dạng như sau:
```
(contextID: number)=>void
```
- contextID
  
  number

onCandidateClicked

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

Sự kiện này sẽ được gửi nếu tiện ích này sở hữu IME đang hoạt động.

Tham số

số gọi lại

hàm

Tham số callback sẽ có dạng như sau:
```
(engineID: string,candidateID: number,button: MouseButton)=>void
```
- engineID
  
  string
- candidateID
  
  number
- nút
  
  MouseButton

onDeactivated

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

Sự kiện này được gửi khi bạn huỷ kích hoạt IME. Điều này cho biết rằng IME sẽ không nhận được các sự kiện onKeyPress nữa.

Tham số

số gọi lại

hàm

Tham số callback sẽ có dạng như sau:
```
(engineID: string)=>void
```
- engineID
  
  string

onFocus

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

Sự kiện này được gửi khi tiêu điểm nhập vào một hộp văn bản. Thông báo này được gửi đến tất cả các tiện ích đang theo dõi sự kiện này và được người dùng bật.

Tham số

số gọi lại

hàm

Tham số callback sẽ có dạng như sau:
```
(context: InputContext)=>void
```
- bối cảnh
  
  InputContext

onInputContextUpdate

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

Sự kiện này được gửi khi các thuộc tính của InputContext hiện tại thay đổi, chẳng hạn như loại. Thông báo này được gửi đến tất cả các tiện ích đang theo dõi sự kiện này và được người dùng bật.

Tham số

số gọi lại

hàm

Tham số callback sẽ có dạng như sau:
```
(context: InputContext)=>void
```
- bối cảnh
  
  InputContext

onKeyEvent

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

Được kích hoạt khi một sự kiện chính được gửi từ hệ điều hành. Sự kiện sẽ được gửi tới tiện ích nếu tiện ích này sở hữu IME đang hoạt động. Hàm trình nghe sẽ trả về giá trị true (đúng) nếu sự kiện được xử lý là false nếu sự kiện không được xử lý. Nếu sự kiện được đánh giá không đồng bộ, hàm này phải trả về giá trị không xác định và IME sau đó phải gọi keyEventHandled() với kết quả.

Tham số

số gọi lại

hàm

Tham số callback sẽ có dạng như sau:
```
(engineID: string,keyData: KeyboardEvent,requestId: string)=>boolean|undefined
```
- engineID
  
  string
- keyData
  
  KeyboardEvent
- requestId
  
  string
- giá trị trả về
  boolean|undefined

onMenuItemActivated

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

Được gọi khi người dùng chọn một mục trong trình đơn

Tham số

số gọi lại

hàm

Tham số callback sẽ có dạng như sau:
```
(engineID: string,name: string)=>void
```
- engineID
  
  string
- tên
  
  string

onReset

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

Sự kiện này được gửi khi Chrome chấm dứt phiên nhập văn bản đang diễn ra.

Tham số

số gọi lại

hàm

Tham số callback sẽ có dạng như sau:
```
(engineID: string)=>void
```
- engineID
  
  string

onSurroundingTextChanged

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

Được gọi khi chuỗi có thể chỉnh sửa xung quanh con nháy thay đổi hoặc khi vị trí con nháy được di chuyển. Độ dài văn bản được giới hạn trong 100 ký tự cho mỗi hướng ngược lại.

Tham số

số gọi lại

hàm

Tham số callback sẽ có dạng như sau:
```
(engineID: string,surroundingInfo: object)=>void
```
- engineID
  
  string
- surroundingInfo
  
  đối tượng
  - liên kết
    
    number
    
    Vị trí bắt đầu của vùng lựa chọn. Giá trị này cho biết vị trí con nháy nếu không có lựa chọn nào.
  - tiêu điểm
    
    number
    
    Vị trí kết thúc của vùng lựa chọn. Giá trị này cho biết vị trí con nháy nếu không có lựa chọn nào.
  - bù trừ
    
    number
    
    Chrome 46 trở lên
    
    Vị trí bù trừ của text. Vì text chỉ bao gồm một tập hợp con văn bản xung quanh con trỏ, nên độ lệch cho biết vị trí tuyệt đối của ký tự đầu tiên trong text.
  - văn bản
    
    string
    
    Văn bản xung quanh con trỏ. Đây chỉ là một tập con của tất cả văn bản trong trường nhập dữ liệu.