Last data update: 2014.03.03

R: Render Ace
aceEditorR Documentation

Render Ace

Description

Render an Ace editor on an application page.

Usage

aceEditor(outputId, value, mode, theme, vimKeyBinding = FALSE,
  readOnly = FALSE, height = "400px", fontSize = 12, debounce = 1000,
  wordWrap = FALSE, showLineNumbers = TRUE, highlightActiveLine = TRUE,
  selectionId = NULL, cursorId = NULL, hotkeys = NULL,
  autoComplete = c("disabled", "enabled", "live"), autoCompleteList = NULL)

Arguments

outputId

The ID associated with this element

value

The initial text to be contained in the editor.

mode

The Ace mode to be used by the editor. The mode in Ace is often the programming or markup language that you're using and determines things like syntax highlighting and code folding. Use the getAceModes function to enumerate all the modes available.

theme

The Ace theme to be used by the editor. The theme in Ace determines the styling and coloring of the editor. Use getAceThemes to enumerate all the themes available.

vimKeyBinding

If set to TRUE, Ace will enable vim-keybindings. Default value is FALSE.

readOnly

If set to TRUE, Ace will disable client-side editing. If FALSE (the default), it will enable editing.

height

A number (which will be interpreted as a number of pixels) or any valid CSS dimension (such as "50%", "200px", or "auto").

fontSize

Defines the font size (in px) used in the editor and should be an integer. The default is 12.

debounce

The number of milliseconds to debounce the input. This will cause the client to withhold update notifications until the user has stopped typing for this amount of time. If 0, the server will be notified of every keystroke as it happens.

wordWrap

If set to TRUE, Ace will enable word wrapping. Default value is FALSE.

showLineNumbers

If set to TRUE, Ace will show line numbers.

highlightActiveLine

If set to TRUE, Ace will highlight the active line.

selectionId

The ID associated with a change of selected text

cursorId

The ID associated with a cursor change.

hotkeys

A list whose names are ID names and whose elements are the shortcuts of keys. Shortcuts can either be a simple string or a list with elements 'win' and 'mac' that that specifies different shortcuts for win and mac (see example).

autoComplete

Enable/Disable auto code completion. Must be one of the following:

"disabled"

Disable Code Autocomplete

"enabled"

Enable Basic Code Autocomplete. Autocomplete can be triggered using Ctrl-Space, Ctrl-Shift-Space, or Alt-Space.

"live"

Enable Live Code Autocomplete. In addition to Basic Autocomplete, it will automatically trigger at each key stroke.

By default, only local completer is used where all aforementioned code pieces will be considered as candidates. Use autoCompleteList for static completions and aceAutocomplete for dynamic R code completions.

autoCompleteList

A named list that contains static code completions candidates. This can be especially useful for Non-Standard Evaluation (NSE) functions such as those in dplyr and ggvis. Each element in list should be a character array whose words will be listed under the element key. For example, to suggests column names from mtcars and airquality, you can use list(mtcars = colnames(mtcars), airquality = colnames(airquality)).

Author(s)

Jeff Allen jeff@trestletech.com

Examples

## Not run: 
 aceEditor("myEditor", "Initial text for editor here", mode="r", 
   theme="ambiance")
   
 aceEditor("myCodeEditor", "# Enter code", mode="r",
   hotkeys = list(helpKey="F1",
                runKey=list(win="Ctrl-R|Ctrl-Shift-Enter",
                            mac="CMD-ENTER|CMD-SHIFT-ENTER")
                ),
   wordWrap=TRUE, debounce=10) 
   
 aceEditor("mySmartEditor", "plot(wt ~ mpg, data=mtcars)", mode="r",
   autoComplete="live",
   autoCompleteList=list(mtcars=colnames(mtcars)))

## End(Not run) 

Results