spiegel-keyman/web/docs/engine/reference/interface/saveStore.md
Marc Durdin 6c145cb775 refactor(web): move web engine help to app repo
Note: build.sh updated to make sure that test:help build action:target
doesn't also call test.sh by adding `:_all` meta-target.

Note: CI will need a new help-keyman-com.sh build step to deploy web
engine help.

Fixes: #12347
2024-10-31 11:00:06 +07:00

1 KiB

title
saveStore (KSAVE)

Summary

Save an option store value to a cookie for the active keyboard.

Syntax

keyman.interface.saveStore(storeName, value);

or

KeymanWeb.KSAVE(storeName, value); // Shorthand

Parameters

storeName
Type: string
The option store name, which will be embedded in the cookie's name.
value
Type: string
The option value to save.

Return Value

boolean
true if the operation is successful, otherwise false.

Description

keyman.interface.loadStore() and keyman.interface.saveStore()provide API-based functionality similar to that of the keyboard language's option store. Values will persist across multiple visits to the site by use of cookies. However, these functions cannot interact with stores from existing compiled keyboards due to compilation optimizations. As such, they are most useful for custom-coded web-oriented keyboards.

See also