2024-05-30 02:02:10 +00:00
<!DOCTYPE html>
< html lang = "en-US" dir = "ltr" >
< head >
< meta charset = "utf-8" >
< meta name = "viewport" content = "width=device-width,initial-scale=1" >
< title > Tap Dance: A Single Key Can Do 3, 5, or 100 Different Things | QMK Firmware< / title >
< meta name = "description" content = "Documentation for QMK Firmware" >
< meta name = "generator" content = "VitePress v1.1.3" >
2024-05-31 00:38:24 +00:00
< link rel = "preload stylesheet" href = "/assets/style.No8zk9aC.css" as = "style" >
2024-05-30 02:02:10 +00:00
2024-09-02 19:47:23 +00:00
< script type = "module" src = "/assets/app.BUT4IBhn.js" > < / script >
2024-05-30 02:02:10 +00:00
< link rel = "preload" href = "/assets/inter-roman-latin.Di8DUHzh.woff2" as = "font" type = "font/woff2" crossorigin = "" >
< link rel = "modulepreload" href = "/assets/chunks/framework.DyMmIvSC.js" >
2024-09-02 19:47:23 +00:00
< link rel = "modulepreload" href = "/assets/chunks/theme.BKFyoa45.js" >
2024-08-26 03:35:58 +00:00
< link rel = "modulepreload" href = "/assets/features_tap_dance.md.Bfnmm10t.lean.js" >
2024-05-30 02:02:10 +00:00
< script id = "check-dark-mode" > ( ( ) => { const e = localStorage . getItem ( "vitepress-theme-appearance" ) || "auto" , a = window . matchMedia ( "(prefers-color-scheme: dark)" ) . matches ; ( ! e || e === "auto" ? a : e === "dark" ) && document . documentElement . classList . add ( "dark" ) } ) ( ) ; < / script >
< script id = "check-mac-os" > document . documentElement . classList . toggle ( "mac" , /Mac|iPhone|iPod|iPad/i . test ( navigator . platform ) ) ; < / script >
< / head >
< body >
2024-08-26 00:06:22 +00:00
< div id = "app" > < div class = "Layout" data-v-5d98c3a5 > <!-- [ --> <!-- ] --> <!-- [ --> < span tabindex = "-1" data-v-0f60ec36 > < / span > < a href = "#VPContent" class = "VPSkipLink visually-hidden" data-v-0f60ec36 > Skip to content < / a > <!-- ] --> <!-- --> < header class = "VPNav" data-v-5d98c3a5 data-v-ae24b3ad > < div class = "VPNavBar has-sidebar top" data-v-ae24b3ad data-v-ccf7ddec > < div class = "wrapper" data-v-ccf7ddec > < div class = "container" data-v-ccf7ddec > < div class = "title" data-v-ccf7ddec > < div class = "VPNavBarTitle has-sidebar" data-v-ccf7ddec data-v-ab179fa1 > < a class = "title" href = "/" data-v-ab179fa1 > <!-- [ --> <!-- ] --> <!-- [ --> <!-- [ --> <!-- [ --> < img class = "VPImage dark logo" src = "/qmk-logo-dark.svg" alt data-v-8426fc1a > <!-- ] --> <!-- [ --> < img class = "VPImage light logo" src = "/qmk-logo-light.svg" alt data-v-8426fc1a > <!-- ] --> <!-- ] --> <!-- ] --> < span data-v-ab179fa1 > QMK Firmware< / span > <!-- [ --> <!-- ] --> < / a > < / div > < / div > < div class = "content" data-v-ccf7ddec > < div class = "content-body" data-v-ccf7ddec > <!-- [ --> <!-- ] --> < div class = "VPNavBarSearch search" data-v-ccf7ddec > <!-- [ --> <!-- --> < div id = "local-search" > < button type = "button" class = "DocSearch DocSearch-Button" aria-label = "Search" > < span class = "DocSearch-Button-Container" > < span class = "vp-icon DocSearch-Search-Icon" > < / span > < span class = "DocSearch-Button-Placeholder" > Search< / span > < / span > < span class = "DocSearch-Button-Keys" > < kbd class = "DocSearch-Button-Key" > < / kbd > < kbd class = "DocSearch-Button-Key" > K< / kbd > < / span > < / button > < / div > <!-- ] --> < / div > < nav aria-labelledby = "main-nav-aria-label" class = "VPNavBarMenu menu" data-v-ccf7ddec data-v-7f418b0f > < span id = "main-nav-aria-label" class = "visually-hidden" data-v-7f418b0f > Main Navigation< / span > <!-- [ --> <!-- [ --> < a class = "VPLink link VPNavBarMenuLink" href = "/" tabindex = "0" data-v-7f418b0f data-v-9c663999 > <!-- [ --> < span data-v-9c663999 > Home< / span > <!-- ] --> < / a > <!-- ] --> <!-- ] --> < / nav > <!-- --> < div class = "VPNavBarAppearance appearance" data-v-ccf7ddec data-v-e6aabb21 > < button class = "VPSwitch VPSwitchAppearance" type = "button" role = "switch" title = "Switch to dark theme" aria-checked = "false" data-v-e6aabb21 data-v-d1f28634 data-v-1d5665e3 > < span class = "check" data-v-1d5665e3 > < span class = "icon" data-v-1d5665e3 > <!-- [ --> < span class = "vpi-sun sun" data-v-d1f28634 > < / span > < span class = "vpi-moon moon" data-v-d1f28634 > < / span > <!-- ] --> < / span > < / span > < / button > < / div > < div class = "VPSocialLinks VPNavBarSocialLinks social-links" data-v-ccf7ddec data-v-0394ad82 data-v-7bc22406 > <!-- [ --> < a class = "VPSocialLink no-icon" href = "https://reddit.com/r/olkb" aria-label target = "_blank" rel = "noopener" data-v-7bc22406 data-v-eee4e7cb > < svg xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 50 50" width = "50px" height = "50px" > < path d = "M 29 3 C 28 . 0625 3 27 . 164063 3 . 382813 26 . 5 4 C 25 . 835938 4 . 617188 25 . 363281 5 . 433594 25 6 . 40625 C 24 . 355469 8 . 140625 24 . 085938 10 . 394531 24 . 03125 13 . 03125 C 19 . 234375 13 . 179688 14 . 820313 14 . 421875 11 . 28125 16 . 46875 C 10 . 214844 15 . 46875 8 . 855469 14 . 96875 7 . 5 14 . 96875 C 6 . 089844 14 . 96875 4 . 675781 15 . 511719 3 . 59375 16 . 59375 C 1 . 425781 18 . 761719 1 . 425781 22 . 238281 3 . 59375 24 . 40625 L 3 . 84375 24 . 65625 C 3 . 3125 26 . 035156 3 27 . 488281 3 29 C 3 33 . 527344 5 . 566406 37 . 585938 9 . 5625 40 . 4375 C 13 . 558594 43 . 289063 19 . 007813 45 25 45 C 30 . 992188 45 36 . 441406 43 . 289063 40 . 4375 40 . 4375 C 44 . 433594 37 . 585938 47 33 . 527344 47 29 C 47 27 . 488281 46 . 6875 26 . 035156 46 . 15625 24 . 65625 L 46 . 40625 24 . 40625 C 48 . 574219 22 . 238281 48 . 574219 18 . 761719 46 . 40625 16 . 59375 C 45 . 324219 15 . 511719 43 . 910156 14 . 96875 42 . 5 14 . 96875 C 41 . 144531 14 . 96875 39 . 785156 15 . 46875 38 . 71875 16 . 46875 C 35 . 195313 14 . 433594 30 . 800781 13 . 191406 26 . 03125 13 . 03125 C 26 . 09375 10 . 546875 26 . 363281 8 . 46875 26 . 875 7 . 09375 C 27 . 164063 6 . 316406 27 . 527344 5 . 757813 27 . 875 5 . 4375 C 28 . 222656 5 . 117188 28 . 539063 5 29 5 C 29 . 460938 5 29 . 683594 5 . 125 30 . 03125 5 . 40625 C 30 . 378906 5 . 6875 30 . 785156 6 . 148438 31 . 3125 6 . 6875 C 32 . 253906 7 . 652344 33 . 695313 8 . 714844 36 . 09375 8 . 9375 C 36 . 539063 11 . 238281 38 . 574219 13 41 13 C 43 . 75 13 46 10 . 75 46 8 C 46 5 . 25 43 . 75 3 41 3 C 38 . 605469 3 36 . 574219 4 . 710938 36 . 09375 6 . 96875 C 34 . 3125 6 . 796875 33 . 527344 6 . 109375 32 . 75 5 . 3125 C 32 . 300781 4 . 851563 31 . 886719 4
2024-06-02 02:43:43 +00:00
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > #define< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > TAPPING_TERM_PER_KEY< / span > < / span > < / code > < / pre > < / div > < p > The < code > TAPPING_TERM< / code > time is the maximum time allowed between taps of your Tap Dance key, and is measured in milliseconds. For example, if you used the above < code > #define< / code > statement and set up a Tap Dance key that sends < code > Space< / code > on single-tap and < code > Enter< / code > on double-tap, then this key will send < code > ENT< / code > only if you tap this key twice in less than 175ms. If you tap the key, wait more than 175ms, and tap the key again you' ll end up sending < code > SPC SPC< / code > instead. The < code > TAPPING_TERM_PER_KEY< / code > definition is only needed if you control the tapping term through a < a href = "./../tap_hold#tapping_term" > custom < code > get_tapping_term< / code > function< / a > , which may be needed because < code > TAPPING_TERM< / code > affects not just tap-dance keys.< / p > < p > Next, you will want to define some tap-dance keys, which is easiest to do with the < code > TD()< / code > macro. That macro takes a number which will later be used as an index into the < code > tap_dance_actions< / code > array and turns it into a tap-dance keycode.< / p > < p > After this, you' ll want to use the < code > tap_dance_actions< / code > array to specify what actions shall be taken when a tap-dance key is in action. Currently, there are five possible options:< / p > < ul > < li > < code > ACTION_TAP_DANCE_DOUBLE(kc1, kc2)< / code > : Sends the < code > kc1< / code > keycode when tapped once, < code > kc2< / code > otherwise. When the key is held, the appropriate keycode is registered: < code > kc1< / code > when pressed and held, < code > kc2< / code > when tapped once, then pressed and held.< / li > < li > < code > ACTION_TAP_DANCE_LAYER_MOVE(kc, layer)< / code > : Sends the < code > kc< / code > keycode when tapped once, or moves to < code > layer< / code > . (this functions like the < code > TO< / code > layer keycode).< / li > < li > < code > ACTION_TAP_DANCE_LAYER_TOGGLE(kc, layer)< / code > : Sends the < code > kc< / code > keycode when tapped once, or toggles the state of < code > layer< / code > . (this functions like the < code > TG< / code > layer keycode).< / li > < li > < code > ACTION_TAP_DANCE_FN(fn)< / code > : Calls the specified function - defined in the user keymap - with the final tap count of the tap dance action.< / li > < li > < code > ACTION_TAP_DANCE_FN_ADVANCED(on_each_tap_fn, on_dance_finished_fn, on_dance_reset_fn)< / code > : Calls the first specified function - defined in the user keymap - on every tap, the second function when the dance action finishes (like the previous option), and the last function when the tap dance action resets.< / li > < li > < code > ACTION_TAP_DANCE_FN_ADVANCED_WITH_RELEASE(on_each_tap_fn, on_each_release_fn, on_dance_finished_fn, on_dance_reset_fn)< / code > : This macro is identical to < code > ACTION_TAP_DANCE_FN_ADVANCED< / code > with the addition of < code > on_each_release_fn< / code > which is invoked every time the key for the tap dance is released. It is worth noting that < code > on_each_release_fn< / code > will still be called even when the key is released after the dance finishes (e.g. if the key is released after being pressed and held for longer than the < code > TAPPING_TERM< / code > ).< / li > < / ul > < p > The first option is enough for a lot of cases, that just want dual roles. For example, < code > ACTION_TAP_DANCE_DOUBLE(KC_SPC, KC_ENT)< / code > will result in < code > Space< / code > being sent on single-tap, < code > Enter< / code > otherwise.< / p > < div class = "warning custom-block" > < p class = "custom-block-title" > WARNING< / p > < p > Keep in mind that only < a href = "./../keycodes_basic" > basic keycodes< / a > are supported here. Custom keycodes are not supported.< / p > < / div > < p > Similar to the first option, the second and third option are good for simple layer-switching cases.< / p > < p > For more complicated cases, like blink the LEDs, fiddle with the backlighting, and so on, use the fourth or fifth option. Examples of each are listed below.< / p > < h2 id = "implementation" tabindex = "-1" > Implementation Details < a class = "header-anchor" href = "#implementation" aria-label = "Permalink to &
2024-05-30 02:02:10 +00:00
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > enum< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_ESC_CAPS,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > };< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Tap Dance definitions< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_action_t< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > tap_dance_actions< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > []< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Tap once for Escape, twice for Caps Lock< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > [TD_ESC_CAPS] < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > ACTION_TAP_DANCE_DOUBLE< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (KC_ESC, KC_CAPS),< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > };< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Add tap dance item to your keymap in place of a keycode< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > const< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint16_t< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > PROGMEM keymaps< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > []< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > [MATRIX_ROWS][MATRIX_COLS] < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // ...< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > TD< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (TD_ESC_CAPS)< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // ...< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > };< / span > < / span > < / code > < / pre > < / div > < h3 id = "complex-examples" tabindex = "-1" > Complex Examples < a class = "header-anchor" href = "#complex-examples" aria-label = "Permalink to "Complex Examples {#complex-examples}"" > < / a > < / h3 > < p > This section details several complex tap dance examples. All the enums used in the examples are declared like this:< / p > < div class = "language-c vp-adaptive-theme" > < button title = "Copy Code" class = "copy" > < / button > < span class = "lang" > c< / span > < pre class = "shiki shiki-themes github-light github-dark vp-code" > < code > < span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Enums defined for all examples:< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > enum< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_ESC_CAPS,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > CT_EGG,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > CT_FLSH,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > CT_CLN,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > X_CTL,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > };< / span > < / span > < / code > < / pre > < / div > < h4 id = "example-1" tabindex = "-1" > Example 1: Send " Safety Dance!" After 100 Taps < a class = "header-anchor" href = "#example-1" aria-label = "Permalink to "Example 1: Send "Safety Dance!" After 100 Taps {#example-1}"" > < / a > < / h4 > < div class = "language-c vp-adaptive-theme" > < button title = "Copy Code" class = "copy" > < / button > < span class = "lang" > c< / span > < pre class = "shiki shiki-themes github-light github-dark vp-code" > < code > < span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > dance_egg< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_state_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > state< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > user_data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > if< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (state-> count < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > > =< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 100< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > SEND_STRING< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#032F62;--shiki-dark:#9ECBFF;" > " Safety dance!" < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > reset_tap_dance< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (state);< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_action_t< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > tap_dance_actions< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > []< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > [CT_EGG] < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > ACTION_TAP_DANCE_FN< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (dance_egg),< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > };< / span > < / span > < / code > < / pre > < / div > < h4 id = "example-2" tabindex = "-1" > Example 2: Turn LED Lights On Then Off, One at a Time < a class = "header-anchor" href = "#example-2" aria-label = "Permalink to "Example 2: Turn LED Lights On Then Off, One at a Time {#example-2}"" > < / a > < / h4 > < div class = "language-c vp-adaptive-theme" > < button title = "Copy Code" class = "copy" > < / button > < span class = "lang" > c< / span > < pre class = "shiki shiki-themes github-light github-dark vp-code" > < code > < span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // On each tap, light up one LED, from right to left< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // On the fourth tap, turn them off from right to left< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > dance_flsh_each< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_state_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > state< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > user_data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > switch< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (state-> count) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > case< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 1< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > ergodox_right_led_3_on< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ();< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > case< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 2< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > ergodox_right_led_2_on< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ();< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > case< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 3< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > ergodox_right_led_1_on< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ();< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > case< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 4< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > ergodox_right_led_3_off< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ();< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > wait_ms< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 50< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > ergodox_right_led_2_off< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ();< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > wait_ms< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 50< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > ergodox_right_led_1_off< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ();< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // On the fourth tap, set the keyboard on flash state< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > dance_flsh_finished< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_state_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > state< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > user_data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > if< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (state-> count < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > > =< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 4< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > reset_keyboard< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ();< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // If the flash state didn' t happen, then turn off LEDs, left to right< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > dance_flsh_reset< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_state_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > state< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > user_data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > ergodox_right_led_1_off< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ();< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > wait_ms< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 50< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > ergodox_right_led_2_off< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ();< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > wait_ms< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 50< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > ergodox_right_led_3_off< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ();< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // All tap dances now put together. Example 2 is " CT_FLSH" < / span > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_action_t< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > tap_dance_actions< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > []< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > [TD_ESC_CAPS] < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > ACTION_TAP_DANCE_DOUBLE< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (KC_ESC, KC_CAPS),< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > [CT_EGG] < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > ACTION_TAP_DANCE_FN< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (dance_egg),< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > [CT_FLSH] < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > ACTION_TAP_DANCE_FN_ADVANCED< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (dance_flsh_each, dance_flsh_finished, dance_flsh_reset)< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > };< / span > < / span > < / code > < / pre > < / div > < h4 id = "example-3" tabindex = "-1" > Example 3: Send < code > :< / code > on Tap, < code > ;< / code > on Hold < a class = "header-anchor" href = "#example-3" aria-label = "Permalink to "Example 3: Send `:` on Tap, `;` on Hold {#example-3}"" > < / a > < / h4 > < p > With a little effort, powerful tap-hold configurations can be implemented as tap dances. To emit taps as early as possible, we need to act on releases of the tap dance key. There is no callback for this in the tap dance framework, so we use < code > process_record_user()< / code > .< / p > < div class = "language-c vp-adaptive-theme" > < button title = "Copy Code" class = "copy" > < / button > < span class = "lang" > c< / span > < pre class = "shiki shiki-themes github-light github-dark vp-code" > < code > < span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > typedef< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > struct< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint16_t< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > tap;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint16_t< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > hold;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint16_t< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > held;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > } < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_tap_hold_t< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > process_record_user< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint16_t< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > keycode< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > keyrecord_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > record< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_action_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > action;< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > switch< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (keycode) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > case< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > TD< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (CT_CLN):< / span > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // list all tap dance keycodes with tap-hold configurations< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > action < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > & < / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > tap_dance_actions< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > [< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > QK_TAP_DANCE_GET_INDEX< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (keycode)];< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > if< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > !< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > record< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > -> < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > event.pressed < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > & & < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > action< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > -> < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > state.count < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > & & < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > !< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > action< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > -> < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > state.finished) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_tap_hold_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > tap_hold < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_tap_hold_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > )action-> user_data;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > tap_code16< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (tap_hold-> tap);< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > return< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > true< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > tap_dance_tap_hold_finished< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_state_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > state< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > user_data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_tap_hold_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > tap_hold < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_tap_hold_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > )user_data;< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > if< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (state-> pressed) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > if< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (state-> count < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > ==< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 1< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > #ifndef< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > PERMISSIVE_HOLD< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > & & < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > !< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > state-> interrupted< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > #endif< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > register_code16< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (tap_hold-> hold);< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > tap_hold-> held < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > tap_hold-> hold;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > } < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > else< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > register_code16< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (tap_hold-> tap);< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > tap_hold-> held < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > tap_hold-> tap;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > tap_dance_tap_hold_reset< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_state_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > state< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > user_data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_tap_hold_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > tap_hold < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_tap_hold_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > )user_data;< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > if< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (tap_hold-> held) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > unregister_code16< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (tap_hold-> held);< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > tap_hold-> held < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 0< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > #define< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > ACTION_TAP_DANCE_TAP_HOLD< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > tap< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > hold< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > \< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > { .fn < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > NULL< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , tap_dance_tap_hold_finished, tap_dance_tap_hold_reset}, .user_data < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > )< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > & < / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ((< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_tap_hold_t< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ){tap, hold, < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 0< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }), }< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_action_t< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > tap_dance_actions< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > []< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > [CT_CLN] < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > ACTION_TAP_DANCE_TAP_HOLD< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (KC_COLN, KC_SCLN),< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > };< / span > < / span > < / code > < / pre > < / div > < h4 id = "example-4" tabindex = "-1" > Example 4: ' Quad Function Tap-Dance' < a class = "header-anchor" href = "#example-4" aria-label = "Permalink to "Example 4: 'Quad Function Tap-Dance' {#example-4}"" > < / a > < / h4 > < p > By < a href = "https://github.com/danielggordon" target = "_blank" rel = "noreferrer" > DanielGGordon< / a > < / p > < p > Allow one key to have 4 (or more) functions, depending on number of presses, and if the key is held or tapped. Below is a specific example:< / p > < ul > < li > Tap = Send < code > x< / code > < / li > < li > Hold = Send < code > Control< / code > < / li > < li > Double Tap = Send < code > Escape< / code > < / li > < li > Double Tap and Hold = Send < code > Alt< / code > < / li > < / ul > < p > You will need a few things that can be used for ' Quad Function Tap-Dance' .< / p > < p > You' ll need to add these to the top of your < code > keymap.c< / code > file, before your keymap.< / p > < div class = "language-c vp-adaptive-theme" > < button title = "Copy Code" class = "copy" > < / button > < span class = "lang" > c< / span > < pre class = "shiki shiki-themes github-light github-dark vp-code" > < code > < span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > typedef< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > enum< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_NONE,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_UNKNOWN,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_SINGLE_TAP,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_SINGLE_HOLD,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_DOUBLE_TAP,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_DOUBLE_HOLD,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_DOUBLE_SINGLE_TAP,< / span > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Send two single taps< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_TRIPLE_TAP,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_TRIPLE_HOLD< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > } < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > td_state_t< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > typedef< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > struct< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > is_press_action;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > td_state_t< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > state;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > } < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > td_tap_t< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Tap dance enums< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > enum< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > X_CTL,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > SOME_OTHER_DANCE< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > };< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > td_state_t< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > cur_dance< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_state_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > state< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // For the x tap dance. Put it here so it can be used in any keymap< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > x_finished< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_state_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > state< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > user_data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > x_reset< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_state_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > state< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > user_data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span > < / code > < / pre > < / div > < p > Now, at the bottom of your < code > keymap.c< / code > file, you' ll need to add the following:< / p > < div class = "language-c vp-adaptive-theme" > < button title = "Copy Code" class = "copy" > < / button > < span class = "lang" > c< / span > < pre class = "shiki shiki-themes github-light github-dark vp-code" > < code > < span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > /* Return an integer that corresponds to what kind of tap dance should be executed.< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > *< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > * How to figure out tap dance state: interrupted and pressed.< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > *< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > * Interrupted: If the state of a dance is " interrupted" , that means that another key has been hit< / span > < / span >
2024-08-26 03:35:58 +00:00
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > * under the tapping term. This is typically indicative that you are trying to " tap" the key.< / span > < / span >
2024-05-30 02:02:10 +00:00
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > *< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > * Pressed: Whether or not the key is still being pressed. If this value is true, that means the tapping term< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > * has ended, but the key is still being pressed down. This generally means the key is being " held" .< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > *< / span > < / span >
2024-08-26 03:35:58 +00:00
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > * One thing that is currently not possible with qmk software in regards to tap dance is to mimic the " permissive hold" < / span > < / span >
2024-05-30 02:02:10 +00:00
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > * feature. In general, advanced tap dances do not work well if they are used with commonly typed letters.< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > * For example " A" . Tap dances are best used on non-letter keys that are not hit while typing letters.< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > *< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > * Good places to put an advanced tap dance:< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > * z,q,x,j,k,v,b, any function key, home/end, comma, semi-colon< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > *< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > * Criteria for " good placement" of a tap dance key:< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > * Not a key that is hit frequently in a sentence< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > * Not a key that is used frequently to double tap, for example ' tab' is often double tapped in a terminal, or< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > * in a web form. So ' tab' would be a poor choice for a tap dance.< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > * Letters used in common words as a double. For example ' p' in ' pepper' . If a tap dance function existed on the< / span > < / span >
2024-08-26 03:35:58 +00:00
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > * letter ' p' , the word ' pepper' would be quite frustrating to type.< / span > < / span >
2024-05-30 02:02:10 +00:00
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > *< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > * For the third point, there does exist the ' TD_DOUBLE_SINGLE_TAP' , however this is not fully tested< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > *< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > */< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > td_state_t< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > cur_dance< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_state_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > state< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > if< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (state-> count < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > ==< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 1< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > if< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (state-> interrupted < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > ||< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > !< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > state-> pressed) < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > return< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_SINGLE_TAP;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Key has not been interrupted, but the key is still held. Means you want to send a ' HOLD' .< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > else< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > return< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_SINGLE_HOLD;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > } < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > else< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > if< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (state-> count < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > ==< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 2< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // TD_DOUBLE_SINGLE_TAP is to distinguish between typing " pepper" , and actually wanting a double tap< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // action when hitting ' pp' . Suggested use case for this return value is when you want to send two< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // keystrokes of the key, and not the ' double tap' action/macro.< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > if< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (state-> interrupted) < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > return< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_DOUBLE_SINGLE_TAP;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > else< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > if< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (state-> pressed) < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > return< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_DOUBLE_HOLD;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > else< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > return< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_DOUBLE_TAP;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Assumes no one is trying to type the same letter three times (at least not quickly).< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // If your tap dance key is ' KC_W' , and you want to type " www." quickly - then you will need to add< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // an exception here to return a ' TD_TRIPLE_SINGLE_TAP' , and define that enum just like ' TD_DOUBLE_SINGLE_TAP' < / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > if< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (state-> count < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > ==< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 3< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > if< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (state-> interrupted < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > ||< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > !< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > state-> pressed) < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > return< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_TRIPLE_TAP;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > else< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > return< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_TRIPLE_HOLD;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > } < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > else< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > return< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_UNKNOWN;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Create an instance of ' td_tap_t' for the ' x' tap dance.< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > static< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > td_tap_t< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > xtap_state < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > .is_press_action < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > true< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > .state < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_NONE< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > };< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > x_finished< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_state_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > state< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > user_data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > xtap_state.state < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > cur_dance< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (state);< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > switch< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (xtap_state.state) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > case< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_SINGLE_TAP: < / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > register_code< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (KC_X); < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > case< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_SINGLE_HOLD: < / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > register_code< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (KC_LCTL); < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > case< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_DOUBLE_TAP: < / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > register_code< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (KC_ESC); < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > case< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_DOUBLE_HOLD: < / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > register_code< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (KC_LALT); < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Last case is for fast typing. Assuming your key is `f`:< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // For example, when typing the word `buffer`, and you want to make sure that you send `ff` and not `Esc`.< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // In order to type `ff` when typing fast, the next character will have to be hit within the `TAPPING_TERM`, which by default is 200ms.< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > case< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_DOUBLE_SINGLE_TAP: < / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > tap_code< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (KC_X); < / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > register_code< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (KC_X); < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > default< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > : < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > x_reset< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_state_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > state< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > user_data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > switch< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (xtap_state.state) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > case< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_SINGLE_TAP: < / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > unregister_code< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (KC_X); < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > case< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_SINGLE_HOLD: < / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > unregister_code< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (KC_LCTL); < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > case< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_DOUBLE_TAP: < / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > unregister_code< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (KC_ESC); < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > case< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_DOUBLE_HOLD: < / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > unregister_code< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (KC_LALT); < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > case< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_DOUBLE_SINGLE_TAP: < / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > unregister_code< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (KC_X); < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > default< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > : < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > xtap_state.state < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_NONE;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_action_t< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > tap_dance_actions< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > []< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > [X_CTL] < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > ACTION_TAP_DANCE_FN_ADVANCED< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > NULL< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , x_finished, x_reset)< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > };< / span > < / span > < / code > < / pre > < / div > < p > And then simply use < code > TD(X_CTL)< / code > anywhere in your keymap.< / p > < div class = "info custom-block" > < p class = "custom-block-title" > INFO< / p > < p > In this configuration " hold" takes place < strong > after< / strong > tap dance timeout. To achieve instant hold, remove < code > state-> interrupted< / code > checks in conditions. As a result you may use comfortable longer tapping periods to have more time for taps and not to wait too long for holds (try starting with doubled < code > TAPPING_TERM< / code > ).< / p > < / div > < h4 id = "example-5" tabindex = "-1" > Example 5: Using tap dance for advanced mod-tap and layer-tap keys < a class = "header-anchor" href = "#example-5" aria-label = "Permalink to "Example 5: Using tap dance for advanced mod-tap and layer-tap keys {#example-5}"" > < / a > < / h4 > < p > Tap dance can be used to emulate < code > MT()< / code > and < code > LT()< / code > behavior when the tapped code is not a basic keycode. This is useful to send tapped keycodes that normally require < code > Shift< / code > , such as parentheses or curly braces—or other modified keycodes, such as < code > Control + X< / code > .< / p > < p > Below your layers and custom keycodes, add the following:< / p > < div class = "language-c vp-adaptive-theme" > < button title = "Copy Code" class = "copy" > < / button > < span class = "lang" > c< / span > < pre class = "shiki shiki-themes github-light github-dark vp-code" > < code > < span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Tap Dance keycodes< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > enum< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > td_keycodes {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ALT_LP< / span > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Our example key: `LALT` when held, `(` when tapped. Add additional keycodes for each tapdance.< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > };< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Define a type containing as many tapdance states as you need< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > typedef< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > enum< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_NONE,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_UNKNOWN,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_SINGLE_TAP,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_SINGLE_HOLD,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_DOUBLE_SINGLE_TAP< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > } < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > td_state_t< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Create a global instance of the tapdance state type< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > static< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > td_state_t< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > td_state;< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Declare your tapdance functions:< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Function to determine the current tapdance state< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > td_state_t< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > cur_dance< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_state_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > state< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // `finished` and `reset` functions for each tapdance keycode< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > altlp_finished< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_state_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > state< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > user_data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > altlp_reset< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_state_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > state< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > user_data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span > < / code > < / pre > < / div > < p > Below your < code > LAYOUT< / code > , define each of the tapdance functions:< / p > < div class = "language-c vp-adaptive-theme" > < button title = "Copy Code" class = "copy" > < / button > < span class = "lang" > c< / span > < pre class = "shiki shiki-themes github-light github-dark vp-code" > < code > < span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Determine the tapdance state to return< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > td_state_t< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > cur_dance< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_state_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > state< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > if< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (state-> count < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > ==< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 1< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > if< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (state-> interrupted < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > ||< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > !< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > state-> pressed) < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > return< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_SINGLE_TAP;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > else< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > return< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_SINGLE_HOLD;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > if< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (state-> count < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > ==< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 2< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > return< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_DOUBLE_SINGLE_TAP;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > else< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > return< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_UNKNOWN;< / span > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Any number higher than the maximum state value you return above< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Handle the possible states for each tapdance keycode you define:< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > altlp_finished< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_state_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > state< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > user_data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > td_state < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > cur_dance< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (state);< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > switch< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (td_state) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > case< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_SINGLE_TAP:< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > register_code16< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (KC_LPRN);< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > case< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_SINGLE_HOLD:< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > register_mods< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > MOD_BIT< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (KC_LALT));< / span > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // For a layer-tap key, use `layer_on(_MY_LAYER)` here< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > case< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_DOUBLE_SINGLE_TAP:< / span > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Allow nesting of 2 parens `((` within tapping term< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > tap_code16< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (KC_LPRN);< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > register_code16< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (KC_LPRN);< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > default< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > altlp_reset< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_state_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > state< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > user_data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > switch< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (td_state) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > case< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_SINGLE_TAP:< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > unregister_code16< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (KC_LPRN);< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > case< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_SINGLE_HOLD:< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > unregister_mods< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > MOD_BIT< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (KC_LALT));< / span > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // For a layer-tap key, use `layer_off(_MY_LAYER)` here< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > case< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_DOUBLE_SINGLE_TAP:< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > unregister_code16< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (KC_LPRN);< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > default< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Define `ACTION_TAP_DANCE_FN_ADVANCED()` for each tapdance keycode, passing in `finished` and `reset` functions< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_action_t< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > tap_dance_actions< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > []< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > [ALT_LP] < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > ACTION_TAP_DANCE_FN_ADVANCED< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > NULL< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , altlp_finished, altlp_reset)< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > };< / span > < / span > < / code > < / pre > < / div > < p > Wrap each tapdance keycode in < code > TD()< / code > when including it in your keymap, e.g. < code > TD(ALT_LP)< / code > .< / p > < h4 id = "example-6" tabindex = "-1" > Example 6: Using tap dance for momentary-layer-switch and layer-toggle keys < a class = "header-anchor" href = "#example-6" aria-label = "Permalink to "Example 6: Using tap dance for momentary-layer-switch and layer-toggle keys {#example-6}"" > < / a > < / h4 > < p > Tap Dance can be used to mimic MO(layer) and TG(layer) functionality. For this example, we will set up a key to function as < code > KC_QUOT< / code > on single-tap, as < code > MO(_MY_LAYER)< / code > on single-hold, and < code > TG(_MY_LAYER)< / code > on double-tap.< / p > < p > The first step is to include the following code towards the beginning of your < code > keymap.c< / code > :< / p > < div class = "language-c vp-adaptive-theme" > < button title = "Copy Code" class = "copy" > < / button > < span class = "lang" > c< / span > < pre class = "shiki shiki-themes github-light github-dark vp-code" > < code > < span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Define a type for as many tap dance states as you need< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > typedef< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > enum< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_NONE,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_UNKNOWN,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_SINGLE_TAP,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_SINGLE_HOLD,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_DOUBLE_TAP< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > } < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > td_state_t< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > typedef< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > struct< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > bool< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > is_press_action;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > td_state_t< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > state;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > } < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > td_tap_t< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > enum< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > QUOT_LAYR,< / span > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Our custom tap dance key; add any other tap dance keys to this enum < / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > };< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Declare the functions to be used with your tap dance key(s)< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Function associated with all tap dances< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > td_state_t< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > cur_dance< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_state_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > state< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Functions associated with individual tap dances< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > ql_finished< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_state_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > state< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > user_data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > ql_reset< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_state_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > state< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > user_data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > );< / span > < / span > < / code > < / pre > < / div > < p > Towards the bottom of your < code > keymap.c< / code > , include the following code:< / p > < div class = "language-c vp-adaptive-theme" > < button title = "Copy Code" class = "copy" > < / button > < span class = "lang" > c< / span > < pre class = "shiki shiki-themes github-light github-dark vp-code" > < code > < span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Determine the current tap dance state< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > td_state_t< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > cur_dance< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_state_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > state< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > if< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (state-> count < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > ==< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 1< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > if< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > !< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > state-> pressed) < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > return< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_SINGLE_TAP;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > else< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > return< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_SINGLE_HOLD;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > } < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > else< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > if< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (state-> count < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > ==< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 2< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > return< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_DOUBLE_TAP;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > else< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > return< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_UNKNOWN;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Initialize tap structure associated with example tap dance key< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > static< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > td_tap_t< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ql_tap_state < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > .is_press_action < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > true< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ,< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > .state < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_NONE< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > };< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Functions that control what our tap dance key does< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > ql_finished< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_state_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > state< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > user_data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ql_tap_state.state < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > cur_dance< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (state);< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > switch< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (ql_tap_state.state) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > case< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_SINGLE_TAP:< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > tap_code< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (KC_QUOT);< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > case< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_SINGLE_HOLD:< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > layer_on< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (_MY_LAYER);< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > case< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_DOUBLE_TAP:< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Check to see if the layer is already set< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > if< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > layer_state_is< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (_MY_LAYER)) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // If already set, then switch it off< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > layer_off< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (_MY_LAYER);< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > } < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > else< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // If not already set, then switch the layer on< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > layer_on< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (_MY_LAYER);< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > default< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > break< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > ql_reset< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_state_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > state< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > void< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > user_data< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // If the key was held down and now is released then switch off the layer< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > if< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (ql_tap_state.state < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > ==< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_SINGLE_HOLD) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > layer_off< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (_MY_LAYER);< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ql_tap_state.state < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TD_NONE;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Associate our tap dance key with its functionality< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > tap_dance_action_t< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > tap_dance_actions< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > []< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > [QUOT_LAYR] < / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > =< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > ACTION_TAP_DANCE_FN_ADVANCED< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > NULL< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , ql_finished, ql_reset)< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > };< / span > < / span >
< span class = "line" > < / span >
< span class = "line" > < span style = "--shiki-light:#6A737D;--shiki-dark:#6A737D;" > // Set a long-ish tapping term for tap-dance keys< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint16_t< / span > < span style = "--shiki-light:#6F42C1;--shiki-dark:#B392F0;" > get_tapping_term< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > uint16_t< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > keycode< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > , < / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > keyrecord_t< / span > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > *< / span > < span style = "--shiki-light:#E36209;--shiki-dark:#FFAB70;" > record< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > switch< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > (keycode) {< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > case< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > QK_TAP_DANCE ... QK_TAP_DANCE_MAX:< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > return< / span > < span style = "--shiki-light:#005CC5;--shiki-dark:#79B8FF;" > 275< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > ;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > default< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > :< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#D73A49;--shiki-dark:#F97583;" > return< / span > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > TAPPING_TERM;< / span > < / span >
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span >
2024-06-02 02:43:43 +00:00
< span class = "line" > < span style = "--shiki-light:#24292E;--shiki-dark:#E1E4E8;" > }< / span > < / span > < / code > < / pre > < / div > < p > The above code is similar to that used in previous examples. The one point to note is that we need to be able to check which layers are active at any time so we can toggle them if needed. To do this we use the < code > layer_state_is(layer)< / code > function which returns < code > true< / code > if the given < code > layer< / code > is active.< / p > < p > The use of < code > cur_dance()< / code > and < code > ql_tap_state< / code > mirrors the above examples.< / p > < p > The < code > case: TD_SINGLE_TAP< / code > in < code > ql_finished< / code > is similar to the above examples. The < code > TD_SINGLE_HOLD< / code > case works in conjunction with < code > ql_reset()< / code > to switch to < code > _MY_LAYER< / code > while the tap dance key is held, and to switch away from < code > _MY_LAYER< / code > when the key is released. This mirrors the use of < code > MO(_MY_LAYER)< / code > . The < code > TD_DOUBLE_TAP< / code > case works by checking whether < code > _MY_LAYER< / code > is the active layer, and toggling it on or off accordingly. This mirrors the use of < code > TG(_MY_LAYER)< / code > .< / p > < p > < code > tap_dance_actions[]< / code > works similar to the above examples. Note that, additionally, I set a longer tapping term for the tap dance keys. This is because I like my < code > TAPPING_TERM< / code > to be short (~175ms) for my non-tap-dance keys but find that this is too quick for me to reliably complete tap dance actions - thus the increased time of 275ms here. In order for the per-key tapping terms to take effect, < code > TAPPING_TERM_PER_KEY< / code > must be defined in your < code > config.h< / code > .< / p > < p > Finally, to get this tap dance key working, be sure to include < code > TD(QUOT_LAYR)< / code > in your < code > keymaps[]< / code > .< / p > < / div > < / div > < / main > < footer class = "VPDocFooter" data-v-39a288b8 data-v-09de1c0f > <!-- [ --> <!-- ] --> <!-- --> < nav class = "prev-next" data-v-09de1c0f > < div class = "pager" data-v-09de1c0f > < a class = "VPLink link pager-link prev" href = "/features/swap_hands" data-v-09de1c0f > <!-- [ --> < span class = "desc" data-v-09de1c0f > Previous page< / span > < span class = "title" data-v-09de1c0f > Swap Hands< / span > <!-- ] --> < / a > < / div > < div class = "pager" data-v-09de1c0f > < a class = "VPLink link pager-link next" href = "/tap_hold" data-v-09de1c0f > <!-- [ --> < span class = "desc" data-v-09de1c0f > Next page< / span > < span class = "title" data-v-09de1c0f > Tap-Hold Configuration< / span > <!-- ] --> < / a > < / div > < / nav > < / footer > <!-- [ --> <!-- ] --> < / div > < / div > < / div > <!-- [ --> <!-- ] --> < / div > < / div > <!-- --> <!-- [ --> <!-- ] --> < / div > < / div >
2024-09-02 19:47:23 +00:00
< script > w i n d o w . _ _ V P _ H A S H _ M A P _ _ = J S O N . p a r s e ( " { \ " c h a n g e l o g _ 2 0 2 0 0 5 3 0 . m d \ " : \ " D k - v R p T Q \ " , \ " c h a n g e l o g _ 2 0 2 1 0 2 2 7 . m d \ " : \ " B W O t C a e S \ " , \ " c h a n g e l o g _ 2 0 2 0 0 2 2 9 . m d \ " : \ " D N s o w w M 1 \ " , \ " c h a n g e l o g _ 2 0 2 2 0 2 2 6 . m d \ " : \ " B W O 5 r _ e c \ " , \ " c a p a b i l i t i e s . m d \ " : \ " D g K w c j 5 n \ " , \ " c h a n g e l o g _ 2 0 2 4 0 8 2 5 . m d \ " : \ " B Z M 0 W S F G \ " , \ " a p i _ o v e r v i e w . m d \ " : \ " 0 F P a U s M b \ " , \ " c l i _ c o n f i g u r a t i o n . m d \ " : \ " C G S B 1 2 8 P \ " , \ " b r e a k i n g _ c h a n g e s _ h i s t o r y . m d \ " : \ " C J N U 0 o 7 7 \ " , \ " b r e a k i n g _ c h a n g e s . m d \ " : \ " y 7 z f o 2 9 K \ " , \ " c l i . m d \ " : \ " B L z A d A 6 l \ " , \ " c l i _ t a b _ c o m p l e t e . m d \ " : \ " C h a x f z Y o \ " , \ " b r e a k i n g _ c h a n g e s _ i n s t r u c t i o n s . m d \ " : \ " C 9 9 N Y D j O \ " , \ " d o c u m e n t a t i o n _ b e s t _ p r a c t i c e s . m d \ " : \ " B t E j e P a Z \ " , \ " c o d i n g _ c o n v e n t i o n s _ p y t h o n . m d \ " : \ " B V - O K 1 s 5 \ " , \ " d r i v e r s _ i s 3 1 f l 3 7 3 3 . m d \ " : \ " B 2 S u r z g J \ " , \ " c o d i n g _ c o n v e n t i o n s _ c . m d \ " : \ " D d r p X B E h \ " , \ " c o n f i g _ o p t i o n s . m d \ " : \ " D v M e q l p B \ " , \ " c o n f i g u r a t o r _ a r c h i t e c t u r e . m d \ " : \ " D E F T v T l S \ " , \ " c o n f i g u r a t o r _ d e f a u l t _ k e y m a p s . m d \ " : \ " B 3 v 8 d l H d \ " , \ " c o n f i g u r a t o r _ s t e p _ b y _ s t e p . m d \ " : \ " C B 5 U _ k s W \ " , \ " c u s t o m _ m a t r i x . m d \ " : \ " D M n R w _ 5 l \ " , \ " d r i v e r s _ i s 3 1 f l 3 7 4 2 a . m d \ " : \ " C K P j B 5 T 1 \ " , \ " c o n t r i b u t i n g . m d \ " : \ " C g M x 5 Y L W \ " , \ " d r i v e r s _ f l a s h . m d \ " : \ " D h W c H p 8 S \ " , \ " c h a n g e l o g _ 2 0 2 0 0 8 2 9 . m d \ " : \ " C o q r O f f n \ " , \ " f e a t u r e _ d e b o u n c e _ t y p e . m d \ " : \ " C U r S p 0 I y \ " , \ " c h a n g e l o g _ 2 0 2 3 1 1 2 6 . m d \ " : \ " D 2 O k 5 Q A f \ " , \ " c h a n g e l o g _ 2 0 1 9 0 8 3 0 . m d \ " : \ " D r t q 3 l M y \ " , \ " c h a n g e l o g _ 2 0 2 2 1 1 2 6 . m d \ " : \ " D p b r n X e C \ " , \ " d r i v e r s _ i s 3 1 f l 3 7 3 6 . m d \ " : \ " C r 5 S Q U 0 k \ " , \ " c o n f i g u r a t o r _ t r o u b l e s h o o t i n g . m d \ " : \ " B x G L P T 8 G \ " , \ " c l i _ d e v e l o p m e n t . m d \ " : \ " 3 x F A 2 O v S \ " , \ " c o m p a t i b l e _ m i c r o c o n t r o l l e r s . m d \ " : \ " 6 H A 6 F J Z J \ " , \ " d r i v e r s _ i s 3 1 f l 3 2 3 6 . m d \ " : \ " B s b s N _ N u \ " , \ " d r i v e r s _ i s 3 1 f l 3 7 2 9 . m d \ " : \ " u Z A m - 5 9 P \ " , \ " d r i v e r s _ u a r t . m d \ " : \ " B N B s - m 3 h \ " , \ " d r i v e r s _ s n l e d 2 7 3 5 1 . m d \ " : \ " C q 7 2 5 B 0 _ \ " , \ " d r i v e r s _ s p i . m d \ " : \ " t J V e I T 7 e \ " , \ " d r i v e r s _ s e r i a l . m d \ " : \ " C n l L G _ H 1 \ " , \ " c h a n g e l o g _ 2 0 2 1 0 8 2 8 . m d \ " : \ " D N b H I u u M \ " , \ " c h a n g e l o g _ 2 0 2 2 0 5 2 8 . m d \ " : \ " B X 3 C C Y 1 Z \ " , \ " a r m _ d e b u g g i n g . m d \ " : \ " B H - H 2 U k z \ " , \ " c h i b i o s _ u p g r a d e _ i n s t r u c t i o n s . m d \ " : \ " B 5 d M t L 5 R \ " , \ " f e a t u r e _ e e p r o m . m d \ " : \ " a 0 e o T Z m 7 \ " , \ " f e a t u r e s _ a u d i o . m d \ " : \ " D W N Y t e 3 W \ " , \ " f e a t u r e _ u s e r s p a c e . m d \ " : \ " B s m Y 9 y W w \ " , \ " c u s t o m _ q u a n t u m _ f u n c t i o n s . m d \ " : \ " B r 1 x U G G a \ " , \ " f e a t u r e _ l a y o u t s . m d \ " : \ " q c y 8 h N M O \ " , \ " c h a n g e l o g _ 2 0 2 4 0 2 2 5 . m d \ " : \ " B 4 - W r X j 6 \ " , \ " c h a n g e l o g _ 2 0 2 1 0 5 2 9 . m d \ " : \ " C R 1 Y N f Z X \ " , \ " c h a n g e l o g _ 2 0 2 2 0 8 2 7 . m d \ " : \ " D j P t h q D k \ " , \ " c h a n g e l o g _ 2 0 2 1 1 1 2 7 . m d \ " : \ " C l U a w W k q \ " , \ " f e a t u r e _ m a c r o s . m d \ " : \ " B y 1 M 5 R 8 G \ " , \ " c h a n g e l o g _ 2 0 2 3 0 2 2 6 . m d \ " : \ " C g 0 A Y x I n \ " , \ " f e a t u r e _ l a y e r s . m d \ " : \ " 8 G w B U T Z N \ " , \ " a p i _ d e v e l o p m e n t _ e n v i r o n m e n t . m d \ " : \ " E h J C l b 9 f \ " , \ " a p i _ d o c s . m d \ " : \ " C R o D 6 C b L \ " , \ " d r i v e r s _ i s 3 1 f l 3 7 4 3 a . m d \ " : \ " 9 T i N S _ b m \ " , \ " c h a n g e l o g _ 2 0 2 4 0 5 2 6 . m d \ " : \ " D A m A E D G 5 \ " , \ " c a p a b i l i t i e s _ i n c . m d \ " : \ " C a 9 z p M c e \ " , \ " d a t a _ d r i v e n _ c o n f i g . m d \ " : \ " B v L Q 7 P 2 0 \ " , \ " d r i v e r s _ i s 3 1 f l 3 7 4 1 . m d \ " : \ " D z s u N W J t \ " , \ " f e a t u r e s _ c a p s _ w o r d . m d \ " : \ " B D Q G M 0 - x \ " , \ " f e a t u r e s _ b o o t m a g i c . m d \ " : \ " C e N S U s B Q \ " , \ " d r i v e r s _ i s 3 1 f l 3 7 4 5 . m d \ " : \ " C p C p R 0 N p \ " , \ " d r i v e r s _ g p i o . m d \ " : \ " C 5 P v y J V h \ " , \ " d r i v e r s _ i s 3 1 f l 3 7 4 6 a . m d \ " : \ " B F c z K 5 c - \ " , \ " d r i v e r _ i n s t a l l a t i o n _ z a d i g . m d \ " : \ " C X 9 - B A C t \ " , \ " d r i v e r s _ a p a 1 0 2 . m d \ " : \ " C l 7 X e r 3 S \ " , \ " d r i v e r s _ i 2 c . m d \ " : \ " C u j 8 7 r e B \ " , \ " d r i v e r s _ a w 2 0 2 1 6 s . m d \ " : \ " C g K e h E z B \ " , \ " f a q _ d e b u g . m d \ " : \ " D u T h V a l w \ " , \ " c l i _ c o m m a n d s . m d \ " : \ " D G x - q N i E \ " , \ " d r i v e r s _ a u d i o . m d \ " : \ " m q a z 6 p 5 N \ " , \ " d r i v e r s _ i s 3 1 f l 3 2 1 8 . m d \ " : \ " C 7 R o k 4 l 6 \ " , \ " f a q _ b u i l d . m d \ " : \ " D L _ W e z A 1 \ " , \ " d r i v e r s _ a d c . m d \ " : \ " D z U 8 t x f 8 \ " , \ " e a s y _ m a k e r . m d \ " : \ " D A f b I K 4 w \ " , \ " f a q _ g e n e r a l . m d \ " : \ " B O l G s W S k \ " , \ " f a q _ k e y m a p . m d \ " : \ " B s E m E Z T o \ " , \ " f a q _ m i s c . m d \ " : \ " q G r h O T u 4 \ " , \ " c h a n g e l o g _ 2 0 2 0 1 1 2 8 . m d \ " : \ " 7 X X L 0 2 B n \ " , \ " d r i v e r s _ e e p r o m . m d \ " : \ " D M r _ G _ 5 d \ " , \ " a p i _ d e v e l o p m e n t _ o v e r v i e w . m d \ " : \ " D c e y 4 n t L \ " , \ " f e a t u r e _ a d v a n c e d _ k e y c o d e s . m d \ " : \ " C X 8 d J k Y - \ " , \ " f e a t u r e s _ b l u e t o o t h . m d \ " : \ " C i A j l 8 7 5 \ " , \ " d r i v e r s _ i s 3 1 f l 3 7 3 1 . m d \ " : \ " _ m T T 6 8 l h \ " , \ " d r i v e r s _ w s 2 8 1 2 . m d \ " : \ " D 9 E 3 W b - Y \ " , \ " f e a t u r e _ c o n v e r t e r s . m d \ " : \ " D c w m z U c D \ " , \ " c h a n g e l o g _ 2 0 2 3 0 8 2 7 . m d \ " : \ " N S P h m B 6 l \ " , \ " f e a t u r e s _ l e d _ i n d i c a t o r s . m d \ " : \ " B I 8 5 7 z K H \ " , \ " f e a t u r e s _ l e a d e r _ k e y . m d \ " : \ " D B Q T n B R h \ " , \ " f e a t u r e s _ d y n a m i c _ m a c r o s . m d \ " : \ " C r J 1 v h B A \ " , \ " n e w b s _ t e s t i n g _ d e b u g g i n g . m d \ " : \ " D - c 7 G l e _ \ " , \ " o n e _ s h o t _ k e y s . m d \ " : \ " Q R 0 9 r S b - \ " , \ " o t h e r _ e c l i p s e . m d \ " : \ " C - z q y J O 9 \ " , \ " f e a t u r e s _ e n c o d e r s . m d \ " : \ " B Y - - 6 W Y Q \ " , \ " f e a t u r e s _ h a p t i c _ f e e d b a c k . m d \ " : \ " D S 8 C m C 7 e \ " , \ " f e a t u r e s _ c o m m a n d . m d \ " : \ " B y l 9 Y o T 7 \ " , \ " f e a t u r e s _ b a c k l i g h t . m d \ " : \ " D 7 R 4 F k Y o \ " , \ " f e a t u r e s _ a u t o c o r r e c t . m d \ " : \ " D H R D c u h o \ " , \ " c h a n g e l o g _ 2 0 2 3 0 5 2 8 . m d \ " : \ " n X 9 R 4 8 z P \ " , \ " f e a t u r e s _ h d 4 4 7 8 0 . m d \ " : \ " 1 5 K 4 0 o _ e \ " , \ " f e a t u r e s _ o s _ d e t e c t i o n . m d \ " : \ " D Z K T W v S d \ " , \ " f e a t u r e s _ o l e d
2024-05-30 02:02:10 +00:00
< / body >
< / html >
