diff options
| author | Junegunn Choi <junegunn.c@gmail.com> | 2025-10-08 11:08:12 +0900 |
|---|---|---|
| committer | Junegunn Choi <junegunn.c@gmail.com> | 2025-10-09 00:17:00 +0900 |
| commit | d19ce0ad8d68ed71fb24ae3287b847186d3a228e (patch) | |
| tree | 7bb59fdbb9a5d006edbdf2d9f7269855ecfe6b26 /CHANGELOG.md | |
| parent | ed7becfb4768245f8c76325d86276940df07472e (diff) | |
| download | fzf-d19ce0ad8d68ed71fb24ae3287b847186d3a228e.tar.gz | |
Add 'best' action
Diffstat (limited to 'CHANGELOG.md')
| -rw-r--r-- | CHANGELOG.md | 28 |
1 files changed, 28 insertions, 0 deletions
diff --git a/CHANGELOG.md b/CHANGELOG.md index e845abed..d203f62f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -46,6 +46,23 @@ respectively, and also to `ALT-DOWN` and `ALT-UP`. > fzf --bind up:up-match,down:down-match > ``` +#### Customizing the behavior + +In raw mode, the input list is presented in its original order, unfiltered, and +your cursor will not move to the matching item automatically. Here are ways to +customize the behavior. + +```sh +# When the result list is updated, move the cursor to the item with the best score +# (assuming sorting is not disabled) +fzf --raw --bind result:best + +# Move to the first matching item in the original list +# - $FZF_RAW is set to 0 when raw mode is enabled and the current item is a non-match +# - $FZF_DIRECTION is set to either 'up' or 'down' depending on the layout direction +fzf --raw --bind 'result:first+transform:[[ $FZF_RAW = 0 ]] && echo $FZF_DIRECTION-match' +``` + #### Customizing the look ##### Gutter @@ -132,6 +149,17 @@ fzf --gutter ' ' --color gutter:reverse As noted above, the `--gutter-raw CHAR` option was also added for customizing the gutter column in raw mode. +### Added actions + +| Action | Description | +| --- | --- | +| `up-match` | Move up to the matching item; identical to `up` if raw mode is disabled | +| `down-match` | Move down to the matching item; identical to `down` if raw mode is disabled | +| `toggle-raw` | Toggle raw mode | +| `enable-raw` | Enable raw mode | +| `disable-raw` | Disable raw mode | +| `best` | Move to the first matching item with the best score; identical to `first` if raw mode is disabled | + ### Added environment variable `$FZF_DIRECTION` is now exported to child processes, indicating the list direction of the current layout. |