Imenu

From WikEmacs
Jump to navigation Jump to search
Imenu
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: show the menu list in a thin sidebar buffer

imenu-list is a plugin (in melpa) to show the current buffer's imenu entries in a separate (and thin) buffer.

See also

helm-imenu

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).

Helm-imenu.gif


ace-jump, quick cursor movements

ace-jump, for quick and direct cursor movement on current view.