As introduções são organizadas em páginas que normalmente refletem uma categoria específica de material introdutório. Por exemplo, uma página Novidades pode apresentar novos conceitos ou funcionalidade desde a versão anterior. O conteúdo definido por uma configuração de introdução pode ser referido e estendido a partir de outros plug-ins que utilizam o ponto de extensão org.eclipse.ui.intro.configExtension.
<!ELEMENT extension (handle? , config+)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
<!ELEMENT config (presentation)>
<!ATTLIST config
introId CDATA #REQUIRED
id CDATA #REQUIRED
content CDATA #REQUIRED>
Um elemento de configuração pode ser utilizado para configurar uma Parte de Introdução personalizável. Um elemento de configuração deve especificar um ID, um introId e um arquivo de conteúdo. O arquivo de conteúdo da introdução é um arquivo XML que descreve as páginas, os grupos e os links que a introdução possui.
<!ELEMENT presentation (implementation+ , launchBar?)>
<!ATTLIST presentation
home-page-id CDATA #REQUIRED
standby-page-id CDATA #IMPLIED>
O elemento de apresentação que define todas as possíveis implementações da apresentação de uma parte de introdução. Ele pode conter uma ou mais implementações definidas. Somente uma implementação será escolhida na inicialização, baseado nos atributos os/ws das implementações. Caso contrário, será escolhida a primeira implementação que não tenha atributos os/ws definidos.
<!ELEMENT implementation (head?)>
<!ATTLIST implementation
kind (swt|html)
style CDATA #IMPLIED
os CDATA #IMPLIED
ws CDATA #IMPLIED>
A apresentação da experiência já apresentada da Plataforma possui duas implementações. Uma delas baseia-se no Navegador SWT e a outra baseia-se em Formulários de UI. A parte de introdução personalizável pode ser configurada para obter uma dessas duas apresentações com base no OS e WS atuais. O tipo da implementação pode ser swt ou html.
org.eclipse.core.runtime.Platform
).org.eclipse.core.runtime.Platform
).<!ELEMENT launchBar (handle? , shortcut*)>
<!ATTLIST launchBar
location (left|bottom|right|fastview) "fastview"
bg CDATA #IMPLIED
fg CDATA #IMPLIED>
A barra de ativação funciona em conjunto com o comando 'switchToLaunchBar'. Quando executada, o comando fechará a introdução e criará uma barra de ativação em uma das áreas cortadas da janela principal. A barra de ativação conterá pelo menos um botão que permitirá que os usuários retornem para a última página de introdução. Opcionalmente, ela pode conter botões adicionais definidos utilizando elementos shortcut
. Esses botões podem ser utilizados para ir rapidamente para uma determinada página de introdução. Desde 3.1
esquerda
,
inferior
ou direita
). Se a opção for
configurada como visualização rápida
(o padrão), a barra
de ativação será inicialmente criada onde está a barra de
visualização rápida.<!ELEMENT shortcut EMPTY>
<!ATTLIST shortcut
tooltip CDATA #IMPLIED
icon CDATA #REQUIRED
url CDATA #REQUIRED>
um botão será criado na barra de ativação da introdução para cada elemento shortcut. O atalho definido da URL no atalho será executado quando o botão for pressionado. Desde 3.1
<!ELEMENT handle EMPTY>
<!ATTLIST handle
close (true | false) "true"
image CDATA #IMPLIED>
um elemento opcional que controla a quantidade de manuseio da barra de ativação que é renderizada. Desde 3.1
true
).<!ELEMENT introContent (page+ , group* , extensionContent*)>
O elemento introContent define o corpo do arquivo de conteúdo da introdução. O arquivo de conteúdo é feito de páginas, grupos compartilhados que podem ser incluídos em várias páginas e extensões para pontos de âncora definidos em outras configurações.
<!ELEMENT page (group* | link* | text* | head* | img* | include* | html* | title? | anchor* | contentProvider*)>
<!ATTLIST page
url CDATA #IMPLIED
id CDATA #REQUIRED
style CDATA #IMPLIED
alt-style CDATA #IMPLIED
filteredFrom (swt|html)
content CDATA #IMPLIED
style-id CDATA #IMPLIED
shared-style (true | false) >
Este elemento é utilizado para descrever uma página a ser exibida. A introdução pode exibir páginas dinâmicas e estáticas.
O conteúdo para as páginas dinâmicas é gerado a partir de subelementos da página, descritos a seguir. O estilo ou estilo alt será aplicado, dependendo da apresentação. Os estilos podem ser mais aprimorados, utilizando como referência o id ou o id de classe.
As páginas estáticas permitem a reutilização dos documentos HTML existentes dentro da introdução e podem ser vinculados a partir de qualquer página estática ou dinâmica. As páginas estáticas não estão definidas em um elemento de página, elas são simplesmente arquivos html que podem estar vinculados a outras páginas.
A home page, cujo id está especificado no elemento de apresentação do ponto de extensão da configuração de introdução, pode ter uma url indicando que é uma página estática. Se nenhuma url estiver especificada, presume-se que a home page seja dinâmica. Todas as outras páginas descritas utilizando o elemento de página são dinâmicas.
Observe também que quando a apresentação SWT é utilizada e uma página estática deve ser exibida, um navegador externo é ativado e a página atual permanece visível.
Os subelementos utilizados em uma página dinâmica são os seguintes: Um subelemento group é utilizado para agrupar o conteúdo relacionado e aplicar o estilo no conteúdo agrupado. Um subelemento link define um link que pode ser utilizado para vincular uma página estática ou dinâmica e executar uma ação/comando de introdução. Normalmente, um link é definido no nível de página para navegar entre as páginas principais e os links em uma página. Um subelemento text define o conteúdo textual no nível de página. Um subelemento head só é aplicável para a apresentação baseada na Web e
permite que html adicional seja incluído na seção head de HTML. Isso é útil para incluir scripts java ou folhas de estilo extras. Um subelemento img
define conteúdo de imagem para o nível de página. Um subelemento include permite a reutilização de qualquer elemento diferente de uma página. Um subelemento html
só é aplicável para a apresentação baseada na Web e permite a incorporação ou inclusão de
html no conteúdo da página.A incorporação permite que um arquivo html totalmente
definido seja incorporado em um object HTML, definindo o arquivo html como
referência. A inclusão permite incluir um fragmento html diretamente de um arquivo html. Um subelemento title define o título da página. Um subelemento anchor define um ponto em que as contribuições externas podem ser feitas por um elemento <extensionContent>.
true
(o padrão), o estilo compartilhado será incluído
nos estilos dessa página. Se false
, o estilo
compartilhado definido na configuração de Introdução não será
inseridos nos estilos dessa página.<!ELEMENT group (group* | link* | text* | img* | include* | html* | anchor* | contentProvider*)>
<!ATTLIST group
id CDATA #REQUIRED
label CDATA #IMPLIED
style-id CDATA #IMPLIED
filteredFrom (swt|html) >
Utilizado para agrupar o conteúdo relacionado, o conteúdo deve ter um estilo semelhante aplicado ou o conteúdo que será incluído em outras páginas.
<!ELEMENT head EMPTY>
<!ATTLIST head
src CDATA #REQUIRED
encoding CDATA #IMPLIED>
HTML direto a ser incluído em uma área de conteúdo HEAD da página. Permite que html adicional seja incluído na seção HEAD de HTML. Isso é útil para a inclusão de scripts java ou folhas de estilo extras. Esta marcação deve ser utilizada somente com um HTML com base na implementação da parte da introdução. Ela é simplesmente ignorada no caso de uma implementação dos Formulários da UI. Uma página pode ter mais de um elemento de título.Uma implementação pode ter um e somente um elemento de título (desde que seja compartilhado em todas as páginas).
<!ELEMENT title EMPTY>
<!ATTLIST title
id CDATA #IMPLIED
style-id CDATA #IMPLIED
filteredFrom (swt|html) >
um fragmento do texto que pode opcionalmente conter marcações HTML de escape. É utilizado somente como Título da Página e assim uma determinada página pode ter no máximo um elemento de título.
<!ELEMENT link (text? , img?)>
<!ATTLIST link
id CDATA #IMPLIED
label CDATA #IMPLIED
url CDATA #REQUIRED
style-id CDATA #IMPLIED
filteredFrom (swt|html) >
Pode vincular um arquivo HTML estático, um web site externo ou pode executar um a ação Intro URL.
nome da ação - descrição da ação
parâmetro de ação1 - descrição do parâmetro
parâmetro de ação2 (opcional) - descrição do parâmetro
action parameter3 (optional) = ("true"
"false") "false" - descrição do parâmetro, opção de true ou
false e "false" é o padrão
close - fecha a parte da introdução
nenhum parâmetro necessário
navigate - navega pelas páginas de introdução em uma determinada direção ou retornar para a home page
direction = ("backward"
"forward"
"home") - especifica a direção a navegar
openBrowser - abrir a url em um navegador externo. Desde a
3.1, essa ação conta com o suporte ao Navegador do workbench. Isso significa que quaisquer preferências do usuário configuradas para o navegador serão respeitadas.
url - uma URL válida para um Web site externo ou para um arquivo HTML local
pluginId (opcional) - se a url for relativa, ela será relativo a um plug-in. Especifique aqui o ID do plug-in que contém o arquivo.
openURL - abrir a url incorporada na página de Boas-vindas. No caso de apresentação SWT, a url é exibida em um navegador externo (semelhante à ação openBrowser acima). Desde 3.1
url - uma URL válida para um Web site externo ou para um
arquivo HTML local
pluginId (opcional) - se a url for relativa, então, isso
especifica o id do plug-in que contém o arquivo.
runAction - executa a ação especificada
class - o nome completo da classe que implementa uma dasorg.eclipse.ui.intro.config.IIntroAction
,
org.eclipse.jface.actino.IAction
ou org.eclipse.ui.IActionDelegate
pluginId - A id do plug-in que contém a classe.
standby (optional) = ("true"
"false") "false" - indica se configurar a introdução no modo de
espera após executar a ação
parâmetros adicionais - quaisquer parâmetros adicionais são transmitidos para ações que implementamorg.eclipse.ui.intro.config.IIntroAction
setStandbyMode - define o estado da parte da introdução
standby = ("true"
"false") - true para colocar a parte de introdução em seu modo
de espera parcialmente visível e false para torná-la totalmente
visível
showHelp - Abre o sistema de ajuda.
nenhum parâmetro necessário
showHelpTopic - Abre um tópico da ajuda.
id - a URL do recurso de ajuda. (Consulte Javadoc para
org.eclipse.ui.help.WorkbenchHelp.displayHelpResource)
embed (optional) = ("true"
"false") "true" - indica se o recurso da ajuda precisa ser
exibido incorporado como parte das páginas de Boas-vindas. O padrão é false.
Este sinalizador é simplesmente ignorado no caso da apresentação SWT.É equivalente ao comando openURL(), mas para tópicos do Sistema de Ajuda. A URL incorporada ocupa o estado real completo da página atual. Desde 3.1
embedTarget (optional) - o caminho para uma div na página de
Boas-vindas atual que manterá o conteúdo do tópico Ajuda. Se
especificado, embed será true por padrão e a URL incorporada
será inserida na div com o caminho especificado. O caminho é relativo à página e, portanto, não deve iniciar com o ID da página. Os filhos da div são substituídos pelo conteúdo da URL. Apenas uma div por página pode ser utilizada como um destino de incorporação. Este sinalizador é simplesmente ignorado no caso da apresentação SWT.
Ele também não é suportado quando utilizar XHTML como o conteúdo de
introdução. Desde 3.1
showMessage - Exibe uma mensagem para o usuário, utilizando um diálogo de informações padrão.
message - a mensagem a ser mostrada para o usuário
showStandby - Configura a parte da introdução para o modo de espera e mostra o standbyContentPart com a entrada fornecida
partId - o id de standbyContentPart a ser mostrado
input - a entrada a ser configurada em standbyContentPart
showPage - mostra a página da introdução com o id fornecido
id - o id da página de introdução a ser mostrada
standby (optional) = ("true"
"false") "false" - indica se configurar a introdução no modo de
espera após mostrar a página
Se qualquer um dos parâmetros transmitidos para essas ações tiverem
caracteres especiais (isto é, caracteres ilegais em uma URL), eles
deverão ser codificados utilizando a codificação de URL UTF-8. Para
receber esses parâmetros dentro do estado decodificado de um
parâmetro especial, decode = ("true" "false") pode ser
utilizado para forçar uma decodificação desses parâmetros, quando a
estrutura de Introdução processá-los.
Por exemplo, a seguinte URL de Introdução:
http://org.eclipse.ui.intro/showMessage?message=This+is+a+message
processará o parâmetro de mensagem como "This+is+a+message"
enquanto que
http://org.eclipse.ui.intro/showMessage?message=This+is+a+message&decode=true
processará o parâmetro de mensagem como "This is a message".
<!ELEMENT text EMPTY>
<!ATTLIST text
id CDATA #IMPLIED
style-id CDATA #IMPLIED
filteredFrom (swt|html) >
um fragmento do texto que pode opcionalmente conter marcações HTML de escape. Pode incluir as marcações b e li. Pode conter também as âncoras para urls. Se vários parágrafos são necessários, o texto pode ser dividido em várias seções, começando e terminando com a marcação p.
<!ELEMENT img EMPTY>
<!ATTLIST img
id CDATA #REQUIRED
src CDATA #REQUIRED
alt CDATA #IMPLIED
style-id CDATA #IMPLIED
filteredFrom (swt|html) >
Uma imagem que representa o conteúdo da introdução e não a apresentação (conforme o oposto das imagens de decoração definidas nos estilos).
<!ATTLIST html
id CDATA #REQUIRED
src CDATA #REQUIRED
type (inline|embed)
style-id CDATA #IMPLIED
filteredFrom (swt|html)
encoding CDATA #IMPLIED>
HTML direto a ser incluído na página por incorporação de todo o documento ou inserção de um fragmento do HTML no local. Uma imagem de fallback ou de texto deve ser definida para processamento da apresentação swt alternativa.
A incorporação permite que um arquivo html completamente definido seja incorporado ao conteúdo da página dinâmica. Um elemento do objeto HTML é criado e faz referência ao arquivo html.
A inclusão permite incluir um fragmento de html diretamente de um arquivo para uma página html dinâmica.
<!ELEMENT include EMPTY>
<!ATTLIST include
configId CDATA #IMPLIED
path CDATA #REQUIRED
merge-style (true | false) >
expande um elemento destinado pelo caminho determinado e os atributos configId opcionais. O caminho deve exclusivamente direcionar um elemento dentro da configuração especificada. Poderia apontar para um grupo compartilhado no nível de configuração ou qualquer elemento em uma página.
true
, estilo pertencente à página que possui o elemento incluído será incluído na lista de estilos da página de inclusão. Se false
(o padrão), a página de inclusão será responsável pelo controle das propriedades do elemento incluído.<!ELEMENT anchor EMPTY>
<!ATTLIST anchor
id CDATA #REQUIRED>
uma âncora é o elemento utilizado para declarar extensibilidade. É um local na configuração que permite contribuições externas. Somente as âncoras são valores de destino válidos para o atributo de caminho em um extensionContent
<!ELEMENT extensionContent (text | group | link | html | include)>
<!ATTLIST extensionContent
style CDATA #IMPLIED
alt-style CDATA #IMPLIED
path CDATA #REQUIRED
content CDATA #IMPLIED>
O conteúdo a ser incluído na âncora de destino. Somente um extensionContent é permitido em uma determinada configExtension porque se essa extensão não puder ser resolvida (se a configuração não foi localizada ou o elemento de âncora de destino não foi localizado), as páginas e/ou grupos na extensão precisarão ser ignorados.
<!ELEMENT contentProvider (text?)>
<!ATTLIST contentProvider
id CDATA #REQUIRED
pluginId CDATA #IMPLIED
class CDATA #REQUIRED>
Um proxy para um provedor de conteúdo de introdução que permite que uma página de introdução obtenha dados dinamicamente de várias origens (por exemplo, da Web, do Eclipse, etc.) e forneça conteúdo em tempo de execução com base nesses dados dinâmicos. Se a classe IIntroContentProvider especificada no atributo class não puder ser carregada, o conteúdo do elemento text será renderizado no lugar. Essa é uma versão dinâmica da tag de introdução HTML. Enquanto a tag HTML permite a incorporação ou seqüenciamento de um conteúdo HTML estático na página de introdução HTML gerada, a tag contentProvider permite a criação dinâmica daquele conteúdo em tempo de execução. Outra diferença entre as tags é que a tag HTML é suportada apenas para a apresentação HTML, enquanto essa tag contentProvider é suportada para as apresentações HTML e SWT. Desde 3.0.1
<extension id=
"intro"
point=
"org.eclipse.ui.intro.config"
>
<config introId=
"com.org.xyz.intro"
id=
"com.org.xyz.introConfig"
content=
"introContent.xml"
>
<presentation home-page-id=
"root"
title=
"%intro.title"
>
<implementation ws=
"win32"
style=
"css/shared.css"
kind=
"html"
os=
"win32"
>
</implementation>
<implementation style=
"css/shared_swt.properties"
kind=
"swt"
>
</implementation>
</presentation>
</config>
</extension>
Direitos Autorais (c) 2004 IBM Corporation e outros.
Todos os direitos reservados.
Este programa e os materiais que o acompanham são disponibilizados
sob os termos da Eclipse Public License v1.0 que acompanha esta
distribuição e estão disponíveis no endereço http://www.eclipse.org/legal/epl-v10.html