mirror of
https://github.com/keymanapp/keyman.git
synced 2026-08-15 21:29:23 +00:00
Deprecate the following obsolete functions and properties: * `keyman.helpURL` * `keyman.util.rgba` * `keyman.util.toFloat` * `keyman.util.toNumber` * `keyman.util.toNzString` Use correct language for code blocks in Keyman Engine for Web documentation. Test-bot: skip
57 lines
1.2 KiB
Markdown
57 lines
1.2 KiB
Markdown
---
|
|
title: deleteContext (KDC)
|
|
---
|
|
|
|
## Summary
|
|
|
|
Context deletion - removes the specified number of deadkeys and characters from before the caret.
|
|
|
|
## Syntax
|
|
|
|
```js
|
|
keyman.interface.deleteContext(dn, Pelem);
|
|
```
|
|
|
|
or
|
|
|
|
```js
|
|
KeymanWeb.KDC(n, Pelem); // Shorthand
|
|
```
|
|
|
|
### Parameters
|
|
|
|
`dn`
|
|
: Type: `number`
|
|
: The number of entries (deadkeys, characters) to be deleted from the current context.
|
|
|
|
`Pelem`
|
|
: Type: `Element`
|
|
: The element being operated upon.
|
|
|
|
### Return Value
|
|
|
|
`undefined`
|
|
|
|
## Description
|
|
|
|
This is a core element of keyboard input management within KeymanWeb introduced with version 10. It is utilized to manage the deletion of context in a deadkey-aware manner, in parallel to [`keyman.interface.fullContextMatch`](fullContextMatch). For comparison with [Developer 'rules'](/developer/language/guide/rules) from keyboard source code...
|
|
|
|
```keyman
|
|
store(pair_1) 'uU'
|
|
store(pair_2) 'lL'
|
|
|
|
c Lots of keyboard rules...
|
|
|
|
'nul' dk(nothing) + '.' > nul
|
|
```
|
|
|
|
would have a rule output as follows:
|
|
|
|
```js
|
|
// Context is length four (three characters + one deadkey), so we delete all four.
|
|
keyman.interface.deleteContext(4, element);
|
|
```
|
|
|
|
## See also
|
|
|
|
- [`keyman.interface.fullContextMatch()`](fullContextMatch)
|