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
Mã nhận dạng của các nút trong cửa sổ hỗ trợ.
Liệt kê
AssistiveWindowProperties
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
Loại cửa sổ hỗ trợ.
Giá trị
AutoCapitalizeType
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
-
autoCapitalizeChrome 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ênLiệ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
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
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ênLiệ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ệnonKeyEvent
. -
shiftKey
boolean không bắt buộc
Liệu có nhấn phím SHIFT hay không.
-
loại
Một trong hai phím tắt hoặc nhấn phím.
KeyboardEventType
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
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
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
Nút trên chuột đã được nhấp.
Liệt kê
ScreenType
Loại màn hình mà IME được kích hoạt.
Liệt kê
"login"
UnderlineStyle
Loại dấu gạch chân để sửa đổi đoạn này.
Liệt kê
WindowPosition
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()
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ênLờ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()
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 bả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ênLờ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()
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ênLờ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()
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
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ênLờ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()
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
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ênLờ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()
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
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ênLờ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()
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ênLờ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()
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ênChỉ 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ênTổ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ênLờ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()
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
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 bả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ênLờ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()
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ênLờ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()
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ố
-
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ênLờ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()
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ố
-
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ênLờ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
-
onAssistiveWindowButtonClicked
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
Mã của nút được nhấp.
-
windowType
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
-
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
-
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
-
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
-
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ênVị 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 trongtext
. -
văn bả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.
-
-