Skip to content
This repository has been archived by the owner on Aug 22, 2023. It is now read-only.

Commit

Permalink
Update document about limitation
Browse files Browse the repository at this point in the history
  • Loading branch information
lambdalisue committed Feb 18, 2016
1 parent 5a057d6 commit 0843281
Show file tree
Hide file tree
Showing 2 changed files with 30 additions and 0 deletions.
1 change: 1 addition & 0 deletions CONTRIBUTING.md
Expand Up @@ -26,6 +26,7 @@ Please confirm the following before reporting an issue:
version (and maybe one or two below) is supported
2. Confirm the behavior in [CodeMirror.Vim][]. If the issue is reproducible
even in [CodeMirror.Vim][] then the issue belongs to the [CodeMirror.Vim][]
3. Confirm if the behavior is listed in [Limitation](README.md#Limitation).

[CodeMirror.Vim]: https://codemirror.net/demo/vim.html

Expand Down
29 changes: 29 additions & 0 deletions README.md
Expand Up @@ -146,6 +146,35 @@ See [Customize](https://github.com/lambdalisue/jupyter-vim-binding/wiki/Customiz
[CodeMirror's Vim API]: https://codemirror.net/doc/manual.html#vimapi


Limitation
-------------------------------------------------------------------------------

jupyter-vim-binding has following technical limitation.
If anybody know about a confirmed workaround for these limitations, let me know.

### Google Chrome

Google Chrome prohibits javascript to override several key mappings such as `Ctrl-N`, `Ctrl-T`, etc.
Because of this policy, users have no chance to use default key mappings of jupyter-vim-binding such as `<C-n>` completion.

- https://code.google.com/p/chromium/issues/detail?id=33056
- http://stackoverflow.com/questions/15911785/overriding-shortcut-keys-in-firefox-and-chrome
- https://github.com/liftoff/GateOne/issues/290

### Clipboard

Most of modern browsers prohibit javascript to access a system clipboard without user action such as clicking a button.
Because of this, there is no chance to enable copy and paste through `yy`, `dd`, or `p` while HTML5 clipboard object cannot be retrieved in a `keydown` event or so on.
So Users need to use browser default mappings such as `Ctrl-C`, `Ctrl-V` if they want to copy and paste through a system clipboard.

The followings are clipboard library for javascript but all of them require `click` event or no paste support.

- https://github.com/zeroclipboard/zeroclipboard
- https://clipboardjs.com/

What we need is a `clipboard` object which can used for copy and paste in a `keydown` event rather than `click` event.


License
-------------------------------------------------------------------------------

Expand Down

0 comments on commit 0843281

Please sign in to comment.