F2 Fragments

Manage repeated or similar XML fragments by maintaining them in single files with multiple references in other files.

How to use

Create an XML fragment to reuse:

Reference a fragment file using XML comment syntax:

Reference content is now automatically updated from fragment file:

Features

Syntax highlight and decorations

Comment syntax has syntax highlight to make it more noticable.

Fragment reference content is decorated with faded colors and cursor and hover warning to signify that content should not be edited.

Commands / Code actions

Update reference content in file.

Update all references of a fragment file.

Clear reference content of single reference.

Create fragment from selection

Parameters

Use parameter syntax in fragment files to allow replacement from references.

Fragment parameter: {{myParam}}

Assigning value in fragment reference: myParam='Some value'

Use backslashes to escape single-quote characters: myParam='Some \'quoted\' value'

Make parameters optional: {{myOptionalParam?}}

Optional parameters are removed if no value is provided

Navigation and hover

See preview of fragment file on hover, and navigate to the file with go-to definition (default F12).

Show all parameter references, and navigate to them (default Shift-F12)

Repeat content

Repeat the content of a fragment file any number of times.

Use the predefined parameter {{i}} to add indexing to values in the content.

Repeat a fragment reference: x5

Snippets

Use the snippets frag and fragp to quickly start a new fragment reference and add parameters.

Settings

Fragment content opacity

Use the setting fragments.opacity to control the dimming opacity level of the fragment content in reference files. Default value is 0.75.