Reference

warning: no doc for symbol yas-abort-snippet

Choose a snippet to edit, selection like yas-insert-snippet.

Only success if selected snippet was loaded from a file. Put the visited file in snippet-mode.

Parse and load current buffer's snippet definition into table.

table is a symbol naming a passed to yas--table-get-create.

When called interactively, prompt for the table name.

Toggle Yas minor mode in all buffers. With prefix arg, enable Yas-Global mode if arg is positive; otherwise, disable it. If called from Lisp, enable the mode if arg is omitted or nil.

Yas minor mode is enabled in all buffers where yas-minor-mode-on would do it. See yas-minor-mode for more information on Yas minor mode.

Clears unmodified field if at field start, skips to next tab.

Otherwise deletes a character normally by calling delete-char.

Navigate to the argth next field.

If there's none, exit the snippet.

Choose a snippet to expand, pop-up a list of choices according to yas-prompt-functions.

With prefix argument no-condition, bypass filtering of snippets by condition.

Activates the snippets for the given mode in the buffer.

The function can be called in the hook of a minor mode to activate snippets associated with that mode.

Compile every dir in yas-snippet-dirs.

Create .yas-compiled-snippets.el files under subdirs of top-level-dir.

This works by stubbing a few functions, then calling yas-load-directory.

Force reload the direct keybinding for active snippet tables.

Exit all snippets.

Test current buffer's snippet template in other buffer.

Goto exit-marker of snippet.

Expand a snippet before point. If no snippet expansion is possible, defer to yas-fallback-behavior (which see).

Optional argument field is for non-interactive use and is an object satisfying yas--field-p to restrict the expansion to.

Expand/run snippets from keymaps, possibly falling back to original binding.

Toggle YASnippet mode.

When YASnippet mode is enabled, yas-expand, normally bound to the tab key, expands snippets of code depending on the major mode.

With no argument, this command toggles the mode. positive prefix argument turns on the mode. Negative prefix argument turns off the mode.

Key bindings: \{yas-minor-mode-map}

Turn on YASnippet minor mode.

Honour yas-dont-activate, which see.

Reload all snippets and rebuild the YASnippet menu.

When no-jit is non-nil force immediate reload of all known snippets under yas-snippet-dirs, otherwise use just-in-time loading.

When called interactively, use just-in-time loading when given a prefix argument.

Load snippets in directory hierarchy top-level-dir.

Below top-level-dir each directory should be a mode name.

With prefix argument use-jit do jit-loading of snippets.

Pops a new buffer for writing a snippet.

Expands a snippet-writing snippet, unless the optional prefix arg no-template is non-nil.

Load the snippet with yas-load-snippet-buffer, possibly save, then quit-window if saved.

If the snippet is new, ask the user whether (and where) to save it. If the snippet already has a file, just save it.

The prefix argument kill is passed to quit-window.

Don't use this from a Lisp program, call yas-load-snippet-buffer and kill-buffer instead.

Display snippets for each table.

Deactivates the snippets for the given mode in the buffer.

Try to expand a snippet at a key before point.

Otherwise delegate to yas-next-field.

warning: no doc for symbol yas-about

Navigate to prev field. If there's none, exit the snippet.

Expand a snippet before point.

If no snippet expansion is possible, fall back to the behaviour defined in yas-fallback-behavior.

Optional argument field is for non-interactive use and is an object satisfying yas--field-p to restrict the expansion to.

If non-nil, and multiple eligible snippet tables, prompts user for tables first.

Otherwise, user chooses between the merging together of all eligible tables.

This affects yas-insert-snippet, yas-visit-snippet-file

Non-nil means re-activate snippet fields after undo/redo.

Non-nil means also auto indent first line according to mode.

Naturally this is only valid when yas-indent-line is auto

Default snippet to use when creating a new snippet. If nil, don't use any snippet.

If non-nil, prompt for snippet key first, then for template.

Otherwise prompts for all possible snippet names.

This affects yas-insert-snippet and yas-visit-snippet-file.

How to act when yas-expand does not expand a snippet.

• call-other-command means try to temporarily disable YASnippet and call the next command bound to whatever key was used to invoke yas-expand.
• nil or the symbol return-nil mean do nothing. (and yas-expand returns nil)
• A Lisp form (apply command . args) means interactively call command, if args is non-nil, call command non-interactively with args as arguments.

If non-nil, snippet expansion wraps around selected region.

The wrapping occurs just before the snippet's exit marker. This can be overridden on a per-snippet basis.

Functions to prompt for keys, templates, etc interactively.

These functions are called with the following arguments:

• prompt: A string to prompt the user
• choices: a list of strings or objects.
• optional display-fn : A function that, when applied to each of

the objects in choices will return a string.

The return value of any function you put here should be one of the objects in choices, properly formatted with display-fn (if that is passed).

• To signal that your particular style of prompting is

unavailable at the moment, you can also have the function return nil.

• To signal that the user quit the prompting process, you can

signal quit with

(signal 'quit "user quit!").

If non-nil visit snippets's files from menu, instead of expanding them.

This can only work when snippets are loaded from files.

If non-nil, allow stacked expansions (snippets inside snippets).

Otherwise yas-next-field-or-maybe-expand just moves on to the next field

The text that will be used in menu to represent the trigger.

Display a YASnippet menu in the menu bar.

When non-nil, submenus for each snippet table will be listed under the menu "Yasnippet".

• If set to abbreviate, only the current major-mode

menu and the modes set in yas--extra-modes are listed.

• If set to full, every submenu is listed
• If set to nil, hide the menu.

Any other non-nil value, every submenu is listed.

Controls indenting applied to a recent snippet expansion.

The following values are possible:

• fixed Indent the snippet to the current column;
• auto Indent each line of the snippet with indent-according-to-mode

Every other value means don't apply any snippet-side indentation after expansion (the manual per-line "$>" indentation still applies).

List of last-command values to restrict tab-triggering to, or nil.

Leave this set at nil (the default) to be able to trigger an expansion simply by placing the cursor after a valid tab trigger, using whichever commands.

Optionally, set this to something like '(self-insert-command) if you to wish restrict expansion to only happen when the last letter of the snippet tab trigger was typed immediately before the trigger key itself.

Return variable yas-snippet-dirs as list of strings.

If non-nil, don't raise errors in inline elisp evaluation.

An error string "[yas] error" is returned instead.

warning: no doc for symbol yas-default-from-field

warning: no doc for symbol yas-completing-prompt

Return yas-selected-text if that exists and is non-empty, else nil.

Integrate with hippie expand.

Just put this function in hippie-expand-try-functions-list.

warning: no doc for symbol yas-global-mode-cmhh

Throw a yas–exception with text as the reason.

Return non-nil if the point is inside a string according to font-lock.

Display choices in a x-window prompt.

Like yas-longest-key-from-whitespace but take the shortest key.

As yas-key-syntaxes element, look for longest key between point and whitespace.

A newline will be considered whitespace even if the mode syntax marks it as something else (typically comment ender).

Return yas-text if that exists and is non-empty, else nil.

warning: no doc for symbol yas-ido-prompt

As yas-key-syntaxes element, look for whitespace delimited key.

A newline will be considered whitespace even if the mode syntax marks it as something else (typically comment ender).

warning: no doc for symbol yas-dropdown-prompt

Define snippets for mode.

snippets is a list of snippet definitions, each taking the following form

(key template name condition group expand-env file keybinding uuid)

Within these, only key and template are actually mandatory.

template might be a Lisp form or a string, depending on whether this is a snippet or a snippet-command.

condition, expand-env and keybinding are Lisp forms, they have been yas--read-lisp-ed and will eventually be yas--eval-lisp-ed.

The remaining elements are strings.

file is probably of very little use if you're programatically defining snippets.

uuid is the snippet's "unique-id". Loading a second snippet file with the same uuid would replace the previous snippet.

You can use yas--parse-template to return such lists based on the current buffers contents.

warning: no doc for symbol yas-global-mode-enable-in-buffers

warning: no doc for symbol yas-no-prompt

Return all active trigger keys for current buffer and point.

Define a function func with doc doc and body body. body is executed at most once every snippet expansion attempt, to check expansion conditions.

It doesn't make any sense to call func programatically.

warning: no doc for symbol yas-global-mode-check-buffers

Define a snippet menu for mode according to menu, omitting omit-items.

menu is a list, its elements can be:

• (yas-item uuid) : Creates an entry the snippet identified with uuid. The menu entry for a snippet thus identified is permanent, i.e. it will never move (be reordered) in the menu.
• (yas-separator) : Creates a separator
• (yas-submenu name submenu) : Creates a submenu with name, submenu has the same form as menu. name is also added to the list of groups of the snippets defined thereafter.

omit-items is a list of snippet uuid's that will always be omitted from mode's menu, even if they're manually loaded.

Get the string for field with number.

Use this in primary and mirror transformations to tget.

Verify that the current field value is in possibilities.

Otherwise throw exception.

warning: no doc for symbol yas-key-to-value

Prompt for a string in possibilities and return it.

The last element of possibilities may be a list of strings.

Search pattern in str and return subexpth match.

If found, the content of subexp group subexp (default 0) is returned, or else the original str will be returned.

warning: no doc for symbol yas-unimplemented

Expand snippet content at current point.

Text between start and end will be deleted before inserting template. expand-env is are let-style variable to value bindings considered when expanding the snippet.

warning: no doc for symbol yas-minor-mode-set-explicitly

warning: no doc for symbol yas-global-mode-buffers

Hooks run after yas-reload-all.

Beginning position of the last snippet committed.

Hooks to run after a snippet exited.

The hooks will be run in an environment where some variables bound to proper values:

yas-snippet-beg : The beginning of the region of the snippet.

yas-snippet-end : Similar to beg.

Attention: These hooks are not run when exiting nested/stacked snippet expansion!

Hook run after entering or leaving yas-global-mode. No problems result if this variable is not bound. add-hook automatically binds it. (This is true for all hook variables.)

If non-nil don't let yas-global-mode affect some buffers.

If a function of zero arguments, then its result is used.

If a list of functions, then all functions must return nil to activate yas for this buffer.

In Emacsen <= 23, this variable is buffer-local. Because yas-minor-mode-on is called by yas-global-mode after executing the buffer's major mode hook, setting this variable there is an effective way to define exceptions to the "global" activation behaviour.

In Emacsen > 23, only the global value is used. To define per-mode exceptions to the "global" activation behaviour, call yas-minor-mode with a negative argument directily in the major mode's hook.

The keymap used when yas-minor-mode is active.

Non-nil if user is about to exit field.

Snippet expanding condition.

This variable is a Lisp form which is evaluated every time a snippet expansion is attempted:

• If it evaluates to nil, no snippets can be expanded.
• If it evaluates to the a cons (require-snippet-condition . requirement)
  • Snippets bearing no "# condition:" directive are not considered
  • Snippets bearing conditions that evaluate to nil (or produce an error) won't be considered.
  • If the snippet has a condition that evaluates to non-nil result:
    • If requirement is t, the snippet is considered
    • If requirement is eq result, the snippet is considered
    • Otherwise, the snippet is not considered.
• If it evaluates to the symbol 'always, all snippets are considered for expansion, regardless of any conditions.
• If it evaluates to t or some other non-nil value
  • Snippet bearing no conditions, or conditions that evaluate to non-nil, are considered for expansion.
  • Otherwise, the snippet is not considered.

Here's an example preventing snippets from being expanded from inside comments, in python-mode only, with the exception of snippets returning the symbol 'force-in-comment in their conditions.

(add-hook 'python-mode-hook '(lambda () (setq yas-buffer-local-condition '(if (python-in-string/comment) '(require-snippet-condition . force-in-comment) t))))

The default value is similar, it filters out potential snippet expansions inside comments and string literals, unless the snippet itself contains a condition that returns the symbol force-in-comment.

Non-nil if field has been modified by user or transformation.

Hooks to run just before expanding a snippet.

The active keymap while a snippet expansion is in progress.

Syntaxes and functions to help look for trigger keys before point.

Each element in this list specifies how to skip buffer positions backwards and look for the start of a trigger key.

Each element can be either a string or a function receiving the original point as an argument. A string element is simply passed to skip-syntax-backward whereas a function element is called with no arguments and should also place point before the original position.

The string between the resulting buffer position and the original point is matched against the trigger keys in the active snippet tables.

If no expandable snippets are found, the next element is the list is tried, unless a function element returned the symbol again, in which case it is called again from the previous position and may once more reposition point.

For example, if yas-key-syntaxes' value is '("w" "w_"), trigger keys composed exclusively of "word"-syntax characters are looked for first. Failing that, longer keys composed of "word" or "symbol" syntax are looked for. Therefore, triggering after

foo-bar

will, according to the "w" element first try "barbaz". If that isn't a trigger key, "foo-barbaz" is tried, respecting the second "w_" element. Notice that even if "baz" is a trigger key for an active snippet, it won't be expanded, unless a function is added to yas-key-syntaxes that eventually places point between "bar" and "baz".

See also Info node `(elisp) Syntax Descriptors'.

End position of the last snippet committed.

Hook run after entering or leaving yas-minor-mode. No problems result if this variable is not bound. add-hook automatically binds it. (This is true for all hook variables.)

Log level for yas--message 4 means trace most anything, 0 means nothing.

warning: no doc for symbol yas-minor-mode-major-mode

warning: no doc for symbol yas-installed-snippets-dir