Difference between revisions of "Imenu"
(link to doc) |
(add category) |
||
Line 95: | Line 95: | ||
[[Category:Intermediate]] | [[Category:Intermediate]] | ||
[[Category:Navigation]] | [[Category:Navigation]] | ||
+ | [[Category:Buffer Navigation]] |
Revision as of 11:16, 10 June 2017
Description | https://www.gnu.org/software/emacs/manual/html_node/elisp/Imenu.html |
---|---|
Maintainer | name of maintainer |
Part of Emacs | yes |
Imenu produces menus for accessing locations in documents, typically in the current buffer. You can access the locations using an ordinary menu (menu bar or other) or using minibuffer completion. A typical use of Imenu shows a menu-bar menu that is an index or table of contents for the current buffer. For a source-code buffer it is typical to index definitions of functions, variables, and so on.
You can use Imenu with any major mode and any programming language or document type. If there is no Imenu support for your context, you can add it using EmacsLisp and the constructs provided in library 'imenu.el'.
Library imenu+.el (Imenu+) extends standard library imenu.el.
Customisation
Using ido
Using ido in conjunction with imenu makes it very easy and quick to use. Add the following function into your ~/.emacs :
(defun ido-goto-symbol (&optional symbol-list)
"Refresh imenu and jump to a place in the buffer using Ido."
(interactive)
(unless (featurep 'imenu)
(require 'imenu nil t))
(cond
((not symbol-list)
(let ((ido-mode ido-mode)
(ido-enable-flex-matching
(if (boundp 'ido-enable-flex-matching)
ido-enable-flex-matching t))
name-and-pos symbol-names position)
(unless ido-mode
(ido-mode 1)
(setq ido-enable-flex-matching t))
(while (progn
(imenu--cleanup)
(setq imenu--index-alist nil)
(ido-goto-symbol (imenu--make-index-alist))
(setq selected-symbol
(ido-completing-read "Symbol? " symbol-names))
(string= (car imenu--rescan-item) selected-symbol)))
(unless (and (boundp 'mark-active) mark-active)
(push-mark nil t nil))
(setq position (cdr (assoc selected-symbol name-and-pos)))
(cond
((overlayp position)
(goto-char (overlay-start position)))
(t
(goto-char position)))))
((listp symbol-list)
(dolist (symbol symbol-list)
(let (name position)
(cond
((and (listp symbol) (imenu--subalist-p symbol))
(ido-goto-symbol symbol))
((listp symbol)
(setq name (car symbol))
(setq position (cdr symbol)))
((stringp symbol)
(setq name symbol)
(setq position
(get-text-property 1 'org-imenu-marker symbol))))
(unless (or (null position) (null name)
(string= (car imenu--rescan-item) name))
(add-to-list 'symbol-names name)
(add-to-list 'name-and-pos (cons name position))))))))
(global-set-key (kbd "C-c i") 'ido-goto-symbol) ; or any key you see fit
Now, M-x eval-current-buffer, hit C-c i and enjoy quick navigation through your code.
imenu-list is a plugin (in melpa) to show the current buffer's imenu entries in a separate (and thin) buffer.
See also
Helm is a nice package that provides interactivity for lots of commands. Here helm-imenu (provided by the helm package) offers to interactively select a variable declaration, a method, a class (or something else depending on the language support).
ace-jump, quick cursor movements
ace-jump, for quick and direct cursor movement on current view.