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

chrome.input.ime

Mô tả

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

Quyền

input

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

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

Phạm vi cung cấp

Chỉ ChromeOS

Ví dụ

Đoạn mã sau đây sẽ tạo một IME để chuyển đổi các chữ cái đã nhập thành chữ in 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ợ.

Enum

"hoàn tác"

"addToTừ điển"

AssistiveWindowProperties

Chrome 85 trở lên

Các 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 dùng để thông báo của ChromeVox.
loại

"hoàn tác"
hiển thị

boolean

Đặt true để hiện AsupportedWindow, đặt false để ẩn.

AssistiveWindowType

Chrome 85 trở lên

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

Giá trị

"hoàn tác"

AutoCapitalizeType

Chrome 69 trở lên

Loại tự động viết hoa của trường văn bản.

Enum

"ký tự"

"words"

"sentence"

InputContext

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

Thuộc tính

autoCapitalize

AutoCapitalizeType

Chrome 69 trở lên

Loại tự động viết hoa 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

số

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

boolean

Chrome 68 trở lên

Liệu có nê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.)

Enum

"text"

"tìm kiếm"

"tel"

"url"

"email"

"number"

"password"

"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 CAPS_LOCK có được bật 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 bố cục bàn phím hoặc đối tượng sửa đổi 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

KeyCode HTML không dùng nữa là mã số phụ thuộc vào hệ thống và việc triển khai biểu thị giá trị nhận dạng chưa sửa đổi được liên kết với phím đã 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 keyup hoặc keydown.

KeyboardEventType

Chrome 44 trở lên

Enum

"keyup"

"keydown"

MenuItem

Mục trong trình đơn mà 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

đã chọn

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 mục này đã được bật.
id

string

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

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

Văn bản hiển thị 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 đang hiển thị.

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 coi là được nhóm lại.

Enum

"kiểm tra"

"radio"

"phân cách"

MenuParameters

Chrome 88 trở lên

Thuộc tính

engineID

string

Mã nhận dạng của công cụ cần sử dụng.
mục

MenuItem[]

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

MouseButton

Chrome 44 trở lên

Nút chuột nào đã được nhấp vào.

Enum

"trái"

"ở giữa"

"phải"

ScreenType

Chrome 44 trở lên

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

Enum

"normal" (bình thường)

"login"

"khoá"

"đăng nhập phụ"

UnderlineStyle

Chrome 44 trở lên

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

Enum

"dấu gạch dưới"

"2Gạch dưới"

"không gạch dưới"

WindowPosition

Chrome 44 trở lên

Vị trí hiển thị cửa sổ ứng viên. Nếu bạn đặt thành "con trỏ", thì cửa sổ sẽ theo sau con trỏ. Nếu bạn đặt thành "thành phần", cửa sổ sẽ bị khoá ở phần đầu của cấu trúc.

Enum

"con trỏ"

"composition"

Phương thức

clearComposition()

Lời hứa

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

Xoá thành phần kết hợp hiện tại. Nếu tiện ích này không sở hữu IME đang hoạt động, thì không thành công.

Tham số

thông số

đối tượng
- contextID
  
  số
  
  Mã của bối cảnh trong đó 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 cho 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. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

commitText()

Lời hứa

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

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

Tham số

thông số

đối tượng
- contextID
  
  số
  
  Mã nhận dạng của ngữ cảnh nơi văn bản sẽ được cam kết
- 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 cho 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. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

deleteSurroundingText()

Lời hứa

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

Xoá văn bản xung quanh dấu nháy.

Tham số

thông số

đối tượng
- contextID
  
  số
  
  Mã của ngữ cảnh trong đó 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
  
  số
  
  Số ký tự cần xoá
- bù trừ
  
  số
  
  Mức chênh lệch so với vị trí con nháy nơi bắt đầu quy 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ề

Lời hứa<vô hiệu>

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 cho 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. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

hideInputView()

chrome.input.ime.hideInputView()

Ẩn cửa sổ chế độ xem nhập dữ liệu do hệ thống tự động bật lên. Nếu cửa sổ chế độ xem nhập dữ liệu đã bị ẩn, hàm này sẽ không hoạt động.

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ý. Bạn chỉ nên gọi lệnh này 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 được 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ý được thao tác nhấn phím

sendKeyEvents()

Lời hứa

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

Gửi các sự kiện chính. Bàn phím ảo dự kiến sẽ sử dụng hàm này. 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ố

thông số

đối tượng
- contextID
  
  số
  
  Mã của ngữ cảnh mà sự kiện chính sẽ được gửi, hoặc bằng 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ề

Lời hứa<vô hiệu>

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 cho 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. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

setAssistiveWindowButtonHighlighted()

Lời hứa 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ố

thông 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ã nhận dạng của nút
- contextID
  
  số
  
  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 có nên làm nổi bật nút này hay không.
- windowType
  
  "hoàn tác"
  
  Loại cửa sổ chứa nút này.
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ề

Lời hứa<vô hiệu>

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 cho 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. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

setAssistiveWindowProperties()

Lời hứa Chrome 85 trở lên

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

Ẩn/hiện một cửa sổ hỗ trợ có các thuộc tính cho trước.

Tham số

thông số

đối tượng
- contextID
  
  số
  
  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
  
  Các 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 cho 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. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

setCandidates()

Lời hứa

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

Thiết lập danh sách ứng viên hiện tại. Thao tác này 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ố

thông số

đối tượng
- ứng viên
  
  object[]
  
  Danh sách đề xuất sẽ hiển thị trong cửa sổ ứng viên
  - 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 cử viên
  - id
    
    số
    
    Mã của ứng viên
  - nhãn
    
    chuỗi không bắt buộc
    
    Chuỗi ngắn hiển thị bên cạnh đề 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
  - 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ừ.
    
    cơ thể
    
    string
    
    Chuỗi nội dung của nội dung mô tả chi tiết.
    
    tiêu đề
    
    string
    
    Chuỗi tiêu đề của nội dung mô tả chi tiết.
- contextID
  
  số
  
  Mã nhận dạng 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 cho 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. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

setCandidateWindowProperties()

Lời hứa

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

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

Tham số

thông 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ổ ứng viên.
  - 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ụ.
  - currentCandidateIndex
    
    số không bắt buộc
    
    Chrome 84 trở lên
    
    Chỉ mục của ứng cử viên hiện đã chọn trong tổng số ứng 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 trong cửa sổ ứng viên.
  - 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" để chuyển cửa sổ sang chiều ngang.
  - hiển thị
    
    boolean không bắt buộc
    
    "True" để hiển thị cửa sổ Ứng viên, "false" để ẩn cửa sổ này.
  - windowPosition
    
    WindowPosition không bắt buộc
    
    Vị trí hiển thị cửa sổ ứng viên.
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 cho 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. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

setComposition()

Lời hứa

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

Đặt thành phần kết hợp hiện tại. Nếu tiện ích này không sở hữu IME đang hoạt động, thì không thành công.

Tham số

thông số

đối tượng
- contextID
  
  số
  
  Mã nhận dạng của ngữ cảnh nơi văn bản sáng tác sẽ được đặt
- con trỏ
  
  số
  
  Vị trí trong văn bản của con trỏ.
- phân đoạn
  
  đối tượng[] không bắt buộc
  
  Danh sách phân khúc và các loại phân khúc có liên quan.
  - end
    
    số
    
    Chỉ mục của ký tự để kết thúc phân đoạn này sau đó.
  - bắt đầu
    
    số
    
    Chỉ mục của ký tự để bắt đầu phân đoạn này
  - kiểu
    
    UnderlineStyle
    
    Loại dấu gạch dưới để 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 chọn kết thúc.
- selectionStart
  
  số không bắt buộc
  
  Vị trí trong văn bản mà vùng chọn sẽ bắt đầu.
- văn bản
  
  string
  
  Văn bản 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 cho 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. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

setCursorPosition()

Lời hứa

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

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

Tham số

thông số

đối tượng
- candidateID
  
  số
  
  Mã của ứng cử viên cần chọn.
- contextID
  
  số
  
  Mã nhận dạng 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 cho 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. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

setMenuItems()

Lời hứa

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

Thêm các mục trong 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ố

thông 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ề

Lời hứa<vô hiệu>

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 cho 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. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

updateMenuItems()

Lời hứa

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

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

Tham số

thông 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ề

Lời hứa<vô hiệu>

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 cho 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. Chiến lược phát hành đĩa đơn Promise phân giải cùng 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. Phương thức này báo hiệu rằng IME sẽ nhận 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 người dùng 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 vào.
  - 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. Lệnh này được gửi đến tất cả tiện ích đang nghe sự kiện này và do 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
  
  số

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
  
  số
- nút
  
  MouseButton

onDeactivated

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

Sự kiện này được gửi khi IME bị huỷ kích hoạt. Phương thức này báo hiệu 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. Lệnh này được gửi đến tất cả tiện ích đang nghe sự kiện này và do 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. Lệnh này được gửi đến tất cả tiện ích đang nghe sự kiện này và do 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 đến tiện ích nếu tiện ích này sở hữu IME đang hoạt động. Hàm trình nghe phải trả về giá trị true nếu sự kiện được xử lý là false (nếu sự kiện không được xử lý là false). 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à sau đó IME 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
- returns
  boolean | chưa xác định

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 bị di chuyển. Độ dài văn bản được giới hạn trong 100 ký tự cho mỗi hướng qua 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
    
    số
    
    Vị trí bắt đầu của phần đã chọn. Giá trị này cho biết vị trí con nháy nếu không có lựa chọn.
  - tiêu điểm
    
    số
    
    Vị trí kết thúc của 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.
  - bù trừ
    
    số
    
    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ỏ, độ 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à tập con của tất cả văn bản trong trường nhập dữ liệu.