Controle de link

Esse controle cria um link para uma página da web externa ou um link que emite um evento fronteira dentro de um serviço ao ser clicado.

Ligação de Dados

Configure ou modifique a ligação de dados para o controle na guia de propriedades Geral. O controle Link pode ser ligado a uma variável Boolean. Se ligado, o valor da variável será configurado como true quando o link for clicado.

É possível usar o controle Link para se vincular a uma página da web externa ou para criar uma referência cruzada para um controle ou uma seção diferente dentro do mesmo coach ou visualização de coach, por exemplo, um link dentro de uma tabela.

Propriedades de configuração

Configure ou modifique as propriedades de configuração para o controle Link, como propriedades de aparência e comportamento, na guia de propriedades de Configuração. Configure as propriedades de configuração de fórmula na guia Eventos.

Tamanho da Tela: Uma propriedade de configuração que tenha o ícone Tamanhos de tela ao lado do nome da propriedade pode ter valores diferentes para cada tamanho de tela. Se um valor não for configurado, o tamanho da tela herdará o valor do próximo maior tamanho de tela como seu valor padrão. Se estiver utilizando o editor de desktop do Process Designer, configure o valor para o tamanho de tela grande. Os outros tamanhos de tela herdam esse valor.

Definições de tema: As definições de tema especificam as cores e os estilos para um controle e determinam a aparência do controle. É possível visualizar a aparência e o comportamento de controles no editor de tema. Consulte o Temas.

As propriedades de configuração de aparência para o controle Link são listadas na tabela a seguir:

Tabela 1. Propriedades de configuração de aparência para o controle Link
Propriedade de configuração de aparência	Descrição	Tipo de Dados
Largura	Especifica a largura do texto do link em `px` (pixels), `%` (percentual) ou unidades `eme`. Por exemplo, `50px`, `20%` ou `0,4em`. Se nenhum tipo de unidade for especificado, então `px` será assumido.	`String`
Alinhamento de texto	Especifica o alinhamento do texto do link, em relação à largura do controle. As opções disponíveis são `Esquerda`, `Centro` e `Direita`.	`String`
Estilo de cor	Especifica um estilo de cor para o controle. As cores correspondem às variáveis no tema especificado. Essa configuração aplica-se apenas ao texto e não ao rótulo.	`String`
Estilo de tamanho	Especifica o tamanho do texto. Essa configuração se aplica ao rótulo e ao texto.	`String`
Peso do texto	Especifica a ponderação do texto. Essa configuração aplica-se apenas ao texto e não ao rótulo. Padrão Esbelto Normal Seminegrito Negrito	`String`
Posicionamento do rótulo	Especifica o posicionamento do rótulo em relação ao texto. As opções disponíveis são `Parte superior` e `Esquerda`. Observe que um posicionamento esquerdo do rótulo muda a largura especificada do controle.	`String`

As propriedades de configuração de comportamento para o controle Link são listadas na tabela a seguir:

Tabela 2. Propriedades de configuração de comportamento para o controle Link
Propriedade de configuração de comportamento	Descrição	Tipo de Dados
Índice de guias	Especifica o índice de sequência de tabulação do controle de formulário. Os índices de tabulação iniciam em 1 e podem ser configurados esparsamente. Por exemplo, é possível usar 1, 5, 10. A propriedade do índice de Tabulação controla a sequência de tabulação quando você pressiona a tecla Tab para se mover entre as áreas de coach.	`Integer`
Texto de link	Fornece o texto para o link.	`String`
Evitar múltiplos cliques	Evita que os usuários cliquem no link mais de uma vez. Essa propriedade é aplicável apenas a links do tipo Evento fronteira.	`Boolean`
Tipo de link	Especifica o tipo do link. As opções disponíveis são: Evento fronteira: emite um evento fronteira em um serviço. URL: vincula a uma página da web externa.	`String`
URL do Link	O endereço da URL para o link. Essa propriedade é aplicável apenas em links de tipo URL.	`String`
Abrir na mesma janela	Abre a página da web com o endereço de URL especificado na mesma janela do navegador. Essa propriedade é aplicável apenas em links de tipo URL.	`Boolean`

Exemplo

Para incluir um link no Suporte IBM em seu coach, conclua as etapas a seguir:

Inclua um controle Link em seu coach no local apropriado e, em seguida, defina as propriedades de configuração a seguir para o link:
1. Em Comportamento, no campo Texto do link, digite Take me to IBM Support, configure o Tipo de link como URL e, em seguida, insira https://www.ibm.com/support na URL do link. Deixe Abrir na mesma janela limpo.
2. Em Aparência, configure Alinhamento de texto como Left, Estilo de cor como Muted, Estilo de tamanho como Large, Peso do texto como Slim e Posicionamento do rótulo como Top.
Salve suas mudanças.

Quando o coach é executado, o resultado é um link cinza claro informando "Leve-me ao Suporte IBM". Quando clicado, o link o leva ao portal do Suporte IBM.

Eventos

Configure ou modifique as propriedades de configuração da fórmula e os manipuladores de eventos para o controle na guia Eventos. É possível configurar eventos para serem acionados programaticamente ou quando um usuário interage com o controle. Para obter informações sobre como definir e codificar eventos, veja Eventos definidos pelo usuário.

As propriedades de configuração de fórmula para o controle Link são mostradas na tabela a seguir:

Tabela 3. Propriedades de configuração de fórmula para o controle Link
Propriedade de configuração de fórmula	Descrição	Tipo de Dados
Texto da fórmula	A fórmula ou expressão para calcular o texto do link.	`String`

O controle de Link tem os tipos de manipuladores de eventos a seguir:

On load: ativado quando a página é carregada. Por exemplo:
```
me.setText("Link to Google")
```
On click: Ativado quando o link é clicado, antes de deixar a página. Se a expressão avaliada retornar false, o clique não disparará o evento fronteira. Por exemplo:
```
return me.getText() != ""
```
On boundary event: ativado quando o fluxo atinge um evento de permanência na página após o evento fronteira ser disparado por meio do controle Link. Para obter mais informações, veja a propriedade context.trigger() no tópico O objeto de contexto de visualização de coach. Por exemplo:
```
me.setColorStyle("G")
```

Dependendo do evento específico, é possível usar a lógica do JavaScript para modificar os efeitos do controle. Mais informações sobre o uso de eventos com controles são encontradas no tópico Eventos definidos pelo usuário.

Métodos

Para obter informações detalhadas sobre os métodos disponíveis para o controle Link, veja a API de JavaScript de Link.

Recursos adicionais

Para obter informações sobre como criar um coach, veja Construindo coaches.
Para obter informações sobre propriedades padrão (Geral, Configuração, Posicionamento, Visibilidade e Atributos HTML), veja Propriedades da visualização de coach.