Criando um Link de Comando

Para incluir links de comando na documentação, é necessário primeiro declarar o uso do código JavaScript de suporte. O JavaScript de ajuda ativa está localizado no plug-in org.eclipse.help.  Você pode referir-se a ele utilizando a técnica de referência cruzada do plug-in do sistema de ajuda. Essa referência de script deve ser colocada na seção HEAD do HTML:

<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js> </script>

Agora, no corpo da documentação, chame a função executeCommand. Eis um exemplo:

<a href='javascript:executeCommand("org.eclipse.ui.help.aboutAction")'>
Abrir o diálogo Sobre</a>

O parâmetro para a função executeCommand é um serializado ParameterizedCommand. Consulte o método ParameterizedCommand.serialize() para obter detalhes completos sobre esse formato.

O exemplo anterior mostra o mínimo necessário para incorporar um comando em um link HTML. A documentação do Eclipse suplementa essa com duas informações adicionais. Em primeiro lugar, um atributo class foi especificado para permitir o ajuste da aparência do link por meio de CSS. Depois, uma tag de imagem foi incluída antes do texto do link. A imagem ajuda a diferenciar os links de comando dos links comuns para outras páginas HTML. A complementação do nosso exemplo inicial com esses dois recursos adicionais ficará da seguinte forma:

<a class="command-link" href='javascript:executeCommand("org.eclipse.ui.help.aboutAction")'>
<img src="PLUGINS_ROOT/org.eclipse.help/command_link.png">
Abrir o diálogo Sobre</a>

Nos exemplos acima, o comando do diálogo Sobre não exige nenhum parâmetro; assim, a serialização é apenas seu id de comando: org.eclipse.ui.help.aboutAction. Segue outro exemplo mostrando um comando com um parâmetro. Observe que o ID de comando é seguido pelo ID de parâmetro e o valor entre parênteses:

<a href='javascript:executeCommand(
	"org.eclipse.ui.window.preferences(preferencePageId=org.eclipse.ui.preferencePages.Views)")'>
	Mostrar uma página de preferências</a>

Outro exemplo demonstra que vários parâmetros são possíveis. Eles são separados por vírgula e a ordem deles não é importante.

<a href='javascript:executeCommand(
	"org.eclipse.ui.dialogs.openMessageDialog(imageType=3,buttonLabel2=Maybe,title=Opinion Poll,message=Do you like command links?,buttonLabel0=Yes,defaultIndex=0,buttonLabel1=No)")'>
	Abrir o diálogo de mensagem</a>