Edge templates syntax highlighter

This is the official extension for VSCode created by the creators of Edge.js. The extension adds support for the following features.

• Syntax highlighting for both HTML and Edge
• Code folding for Edge tags
• "Go To Template" in .edge and .js/.ts files
• Auto-completion for components and templates
• Tags snippets
• Inbuilt helpers snippets
• AdonisJS specific snippets

[!IMPORTANT] This extension does not perform code formatting.

Code formatting with template engine syntax embedded inside HTML is tricky and needs dedicated resources to fight edge cases. We do not have the bandwidth to work on the same right now.

Configuration

Following is the list of available configuration options :

edge.disks

In order to benefit from autocompletion and Go-To links, the extension needs to know the directories hosting your Edge templates.

That's what this option is for : it's an object whose keys are the disk names and values the paths to the template directories, relative to the root of your project.

By default, edge.disk has this value:

{
  "edge.disks": {
    "default": "resources/views"
  }
}

This is perfectly suited to AdonisJS projects by default.

If you set up a secondary disk with Edge, like this

const BASE_URL = new URL('./', import.meta.url)
edge.mount('mydisk', new URL('my/sub/directory', BASE_URL))

You can configure the extension as follows:

{
  "edge.disks": {
    "default": "resources/views",
    "mydisk": "my/sub/directory"
  }
}

If you are using packages such as edge-uikit or @dimer/docs-theme which add extra templates, you can configure new disks like this:

{
  "edge.disks": {
    "default": "resources/views",
    "docs": "node_modules/dimerapp/docs-theme/build/templates",
    "ui": "node_modules/edge-uikit/build/views"
  }
}

Emmet support

If you want to use Emmet in your Edge templates, you can add the following configuration:

{
  "emmet.includeLanguages": {
    "edge": "html"
  }
}

Tags snippets

Following is the list of available snippets

@if(TAB_STOP_1)
  TAB_STOP_2
@end

@elseif(TAB_STOP_1)
  TAB_STOP_2

@else
  TAB_STOP_1

@if(TAB_STOP_1)
  TAB_STOP_2
@else
  TAB_STOP_3
@end

@unless(TAB_STOP_1)
  TAB_STOP_2
@end

@each(TAB_STOP_1 in TAB_STOP_2)
  TAB_STOP_3
@end

@each((TAB_STOP_1, TAB_STOP_2) in TAB_STOP_3)
  TAB_STOP_4
@end

@component('components/')
  TAB_STOP
@end

@!component('components/')

@slot('TAB_STOP_1')
  TAB_STOP_2
@end

@inject(TAB_STOP_1)

@eval(TAB_STOP_1)

@newError(
  'TAB_STOP_1',
  $caller.filename,
  $caller.line,
  $caller.col
)

@include('partials/')

@includeIf(TAB_STOP_1, 'partials/')

@svg('TAB_STOP_1')

@debugger

@let(TAB_STOP_1 = 'TAB_STOP_2')

@assign(TAB_STOP_1 = 'TAB_STOP_2')

@vite('TAB_STOP_1')

Inbuilt helpers snippets

$props.toAttrs()

$props
  .merge({ TAB_STOP_1 })
  .toAttrs()

$props
  .only(['TAB_STOP_1'])
  .toAttrs()

$props
  .except(['TAB_STOP_1'])
  .toAttrs()

await $slots.TAB_STOP_1

$filename

$caller.filename

$caller.line

$caller.col

nl2br(html.escape(TAB_STOP))

inspect(TAB_STOP_1)

truncate(TAB_STOP_1, TAB_STOP_2)

excerpt(TAB_STOP_1, TAB_STOP_2)

html.escape(TAB_STOP)

html.safe(TAB_STOP)

html.classNames(TAB_STOP)

html.attrs(TAB_STOP)

js.stringify(TAB_STOP_1)

camelCase(TAB_STOP_1)

snakeCase(TAB_STOP_1)

dashCase(TAB_STOP_1)

pascalCase(TAB_STOP_1)

capitalCase(TAB_STOP_1)

capitalCase(TAB_STOP_1)

sentenceCase(TAB_STOP_1)

dotCase(TAB_STOP_1)

noCase(TAB_STOP_1)

titleCase(TAB_STOP_1)

pluralize(TAB_STOP_1)

sentence(TAB_STOP_1)

prettyMs(TAB_STOP_1)

toMs(TAB_STOP_1)

prettyBytes(TAB_STOP_1)

toBytes(TAB_STOP_1)

ordinal(TAB_STOP_1)

AdonisJS-specific snippets

route('TAB_STOP_1', [TAB_STOP_2])

signedRoute('TAB_STOP_1', [TAB_STOP_2])

flashMessages.has(TAB_STOP)

flashMessages.get(TAB_STOP)

asset('TAB_STOP_1')

csrfField()

cspNonce()

auth.user

auth.isAuthenticated

config('TAB_STOP_1')

t('TAB_STOP_1', { TAB_STOP_2 })