Salesforce Reference Extension for VSCode
Search Salesforce Developer Documentation entries in VSCode, and open them in your browser (or with experimental features: in VSCode itself!).
Please Note: this is a community-made plugin, and is not affiliated with Salesforce. If the extension breaks, please open a github issue to let me know, there's a chance Salesforce may change its doc approach, necessitating an update to the plugin
Repository Home: https://github.com/Oblongmana/vscode-salesforce-doc-lookup
VSCode Marketplace Install: https://marketplace.visualstudio.com/items?itemName=Oblongmana.vscode-salesforce-doc-lookup
Table of Contents
Choose a documentation type, and type in your search
The extensions adds commands for different types of documentation that allow you to search them in VSCode, and be taken directly to the corresponding entries in your browser (or with the experimental setting enabled, view it in a WebView in VSCode itself):
The first time you call any of these commands, the Extension will call out to Salesforce to get an index of that documentation type. This will be cached, and future uses of the command will be instant.
Available Documentation Types
Search dev documentation for a word or selection in your editor
With your cursor over a word in your editor, or with something in your editor selected, you can choose a documentation type and search for that string, using the new command:
Invalidating the cache
If you need to invalidate the cache for any reason (e.g. your local documentation index contains outdated entries), there is a command for doing so:
EXPERIMENTAL: Load Documentation in a VSCode Tab
Load documentation directly in VSCode. Enable the "Use WebView" option in your Settings to use this. Please note this is in active development, and is not fully supported. If you encounter bugs, please post an issue on github.
EXPERIMENTAL: New Command: "Salesforce Reference: LWC and Aura Component Library (EXPERIMENTAL)"
This is a very experimental reference type - the LWC/Aura Component Library is built on an Aura app, quite different to the Angular App and ToC JSON underpinning other documentation. Report any bugs on github if you see them!
EXPERIMENTAL, ADVANCED: Override Language and Version Settings
There are now experimental, advanced settings for overriding the documentation version and language the commands use.
Examples are listed below.
Generally, you will likely want to avoid using
Instead, favour using
At some point in future, this functionality will likely be updated to "pre-check" whether versions/languages specified are available, but for now, be aware you can break it fairly easily. You can always erase any broken settings though, to go back to the default behaviour of retrieving the latest English content.
Cached values are cached per language/version combination.
In VSCode or the Extension Marketplace
Search for "Salesforce Reference" in the Extensions view (Ctrl + Shift + X) in VSCode, or install at our VSCode Extension Marketplace page
VSIX files are available in the Version History tab of the Marketplace listing
Adblockers and loading links in Browser - NOFIX:
Because Salesforce's Doc website is an Angular app that dynamically loads content into the page after the page itself has loaded, anchor links
appear to be managed in such a way that the Angular app (rather than the browser) handles the scrolling to the requested item.
e.g. https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_string.htm#apex_System_String_substring - the
section after the
Notable Differences to the original Sublime Text 3 version
A rough roadmap is available at ROADMAP.md
See the Roadmap in ROADMAP.md for details on existing aims. Some not-particularly-tidy notes can be found in NOTES.md. Contributions welcome, though I suggest opening an issue ticket on github to discuss before hand.
Notes on design, future aims etc available in NOTES.md
Salesforce Reference VSCode Extension
Copyright (c) 2014-2020 James Hill firstname.lastname@example.org
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.
All Salesforce Documentation is © Copyright 2000–2020 salesforce.com, inc.
Credit to Luke McFarlane for the inspiration!
A port of my original plugin for Sublime Text