Pular para o conteúdo

pivotick v3.0.0


pivotick / GraphUI / DockTab

Interface: DockTab ​

Definido em: interfaces/GraphUI.ts:1365

Um painel no encaixe inferior – uma entrada na faixa de guias.

O dock possui a region: a linha da grade, sua altura, o divisor de redimensionamento e a dobra. Uma guia possui o que está in nela - um corpo e, opcionalmente, seus próprios controles de cabeçalho, que o dock alterna para dentro e para fora conforme a guia ativa muda. Com apenas uma aba cadastrada nenhuma faixa é desenhada; não há nada para mudar.

Registre um em qualquer ponto da vida do gráfico com graph.UIManager.addDockTab(), ou a partir de install de um plugin via ctx.addDockTab(). Ou retorna um triturador.

Uma guia é um painel, não uma visualização de um. Um painel com várias visualizações próprias - Nodes e Edges da tabela de dados - é uma guia de encaixe única que desenha seu próprio switch em seu toolbar e chama DockTabHandle.refresh para mudar de corpo. Portanto, a faixa do dock lista os painéis (Table, Events) e nunca nivela as visualizações de um painel ao lado de outro painel; os dois níveis são desenhados de forma diferente pelo mesmo motivo.

A tabela de dados é em si uma dessas guias, portanto uma guia registrada é exatamente tão privilegiada quanto a interna.

Exemplo ​

js
const dispose = graph.UIManager.addDockTab({
    label: 'Audit',
    render: () => myAuditPane(),
    toolbar: () => [clearButton],
})

Estendido por ​

Propriedades ​

icon? ​

optional icon: string

Definido em: interfaces/GraphUI.ts:1382

Um glifo desenhado antes da etiqueta na faixa, marcando a origem do painel.

Uma string SVG, injetada com innerHTML e não higienizada — deve ser confiável, exatamente como PivotDefinition.icon. Útil quando várias guias são iguais tipo de painel: quatro avaliações de candidatos e uma tabela de dados lida como uma lista de cinco, caso contrário.


id? ​

optional id: string

Definido em: interfaces/GraphUI.ts:1371

Identidade estável: o que removeDockTab / activateDockTab leva e o data-tab escrito no botão da tira.

Padrão ​

um pvt-dock-tab-N gerado automaticamente


label ​

label: string

Definido em: interfaces/GraphUI.ts:1373

O rótulo da tira, usado literalmente (para que possa ser traduzido).


onActivate()? ​

optional onActivate: (tab) => void

Definido em: interfaces/GraphUI.ts:1412

Chamado quando esta guia chega à frente e quando sai. Uma guia que monitora dados ao vivo deve parar de funcionar em onDeactivate e recuperar o atraso em onActivate: nada mais indica que está fora da tela.

Parâmetros ​

tab ​

DockTabHandle

Retorno ​

void


onDeactivate()? ​

optional onDeactivate: (tab) => void

Definido em: interfaces/GraphUI.ts:1413

Parâmetros ​

tab ​

DockTabHandle

Retorno ​

void


order? ​

optional order: number

Definido em: interfaces/GraphUI.ts:1406

Ordem de exibição na faixa, crescente. Pedidos iguais mantêm a ordem de registro - e como os plug-ins são instalados após a construção da IU, as guias de um plug-in chegam após as integradas sem a necessidade de avisar.

Padrão ​

ts
0

render() ​

render: (tab) => HTMLElement

Definido em: interfaces/GraphUI.ts:1388

Construa o corpo do painel. Chamado once, preguiçosamente, na primeira vez que a guia aparece na frente - uma guia que ninguém abre não custa nada. O elemento é mantido e reanexado em ativações posteriores, mantendo seu próprio estado (posição de rolagem incluída).

Parâmetros ​

tab ​

DockTabHandle

Retorno ​

HTMLElement


toolbar()? ​

optional toolbar: (tab) => HTMLElement | HTMLElement[]

Definido em: interfaces/GraphUI.ts:1399

Crie os controles de cabeçalho desta guia, dispostos como parte da linha de cabeçalho do encaixe. Invocado novamente na ativação de every, para que os controles possam refletir o estado atual da guia.

Um painel com diversas visualizações próprias desenha a opção aqui. Duas classes públicas dão a mesma aparência da tabela integrada - pvt-dock-views na faixa, pvt-dock-view em cada botão, active no atual - então ela permanece um grupo de comprimidos ao lado das próprias guias do dock e segue o tema.

Parâmetros ​

tab ​

DockTabHandle

Retorno ​

HTMLElement | HTMLElement[]