summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDrashna Jaelre <drashna@live.com>2018-05-14 07:17:50 -0700
committerJack Humbert <jack.humb@gmail.com>2018-05-14 10:17:50 -0400
commitbfb5922f877f81ff0182bf6204fa8d5c5e343161 (patch)
treee4b9062760bafc02ad686f52f77a9c3ff5121411
parenta98a91cf1b923107e9f26df316c1ef2192ff14f7 (diff)
downloadqmk_firmware-bfb5922f877f81ff0182bf6204fa8d5c5e343161.tar.gz
qmk_firmware-bfb5922f877f81ff0182bf6204fa8d5c5e343161.zip
List all Tap Dancing functions (#2945)
* List all Tap Dancing functions * Spelling, which drashna can't do apparently
-rw-r--r--docs/feature_tap_dance.md2
1 files changed, 2 insertions, 0 deletions
diff --git a/docs/feature_tap_dance.md b/docs/feature_tap_dance.md
index 141c3108d0..4b05bd51bd 100644
--- a/docs/feature_tap_dance.md
+++ b/docs/feature_tap_dance.md
@@ -19,8 +19,10 @@ First, you will need `TAP_DANCE_ENABLE=yes` in your `rules.mk`, because the feat
This array specifies what actions shall be taken when a tap-dance key is in action. Currently, there are three possible options:
* `ACTION_TAP_DANCE_DOUBLE(kc1, kc2)`: Sends the `kc1` keycode when tapped once, `kc2` otherwise. When the key is held, the appropriate keycode is registered: `kc1` when pressed and held, `kc2` when tapped once, then pressed and held.
+* `ACTION_TAP_DANCE_DUAL_ROLE(kc, layer)`: Sends the `kc` keycode when tapped once, or moves to `layer`. (this functions like the `TO` layer keycode).
* `ACTION_TAP_DANCE_FN(fn)`: Calls the specified function - defined in the user keymap - with the final tap count of the tap dance action.
* `ACTION_TAP_DANCE_FN_ADVANCED(on_each_tap_fn, on_dance_finished_fn, on_dance_reset_fn)`: Calls the first specified function - defined in the user keymap - on every tap, the second function on when the dance action finishes (like the previous option), and the last function when the tap dance action resets.
+** `ACTION_TAP_DANCE_FN_ADVANCED_TIME(on_each_tap_fn, on_dance_finished_fn, on_dance_reset_fn, tap_specific_tapping_term)`: This functions identically to the `ACTION_TAP_DANCE_FN_ADVANCED` function, but uses a custom tapping term for it, instead of the predefined `TAPPING_TERM`.
The first option is enough for a lot of cases, that just want dual roles. For example, `ACTION_TAP_DANCE_DOUBLE(KC_SPC, KC_ENT)` will result in `Space` being sent on single-tap, `Enter` otherwise.