R: Render Ace

aceEditor {shinyAce} | R 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)

[Package shinyAce version 0.2.1 Index]