Pode acrescentar propriedades customizadas a sites sob a forma de pares nome/valor. Estas propriedades são armazenadas com o site e disponibilizadas para scripts e componentes nas páginas do site. Estas podem ajudar a parametrizar ou customizar o site sem ter de alterar os scripts subjacentes e o código componente.
Por exemplo, as propriedades customizadas podem ser utilizadas para alterar a cor de fundo da página, refinar resultados de pesquisa, preencher listas e controlar, de modo geral, as variáveis dependentes dos sites.
As propriedades de site customizadas são acrescentadas utilizando o painel de definições ao editar um site.
Abra um site para edição.
Clique em na barra lateral e, em seguida, clique em
Propriedades do Site.
Nota:
As alterações não são fundidas com as propriedades de site customizadas existentes. A confirmação de alterações nas propriedades de site customizadas substitui todas as propriedades de site customizadas existentes no site base.Uma vez definidas, as propriedades de site customizadas podem ser utilizadas para a criação de scripts no site e em componentes do site, por exemplo, no rodapé ou no campo Cadeia de Caracteres de Consulta Adicional em componentes que suportem expansão SCSMacro, como a lista de conteúdos ou através de tokens nos componentes de título e de parágrafo.
Estes scripts funcionam com a SCSRenderAPI durante o runtime e durante a conceção. Adicionalmente, os valores da propriedade de site customizada estão disponíveis para a disposição e código de componente no compilador do modelo através da SCSCompileAPI. Esta API dispõe de uma nova função análoga à SCSRenderAPI, getCustomSiteProperty, que permite que a disposição e o código componente leiam o valor de uma propriedade de secção customizada.
Por exemplo, imagine que pretende definir uma disposição de secção customizada que utiliza a SCSRenderAPI para chamar e obter propriedades do site customizadas para o cabeçalho, nome do contacto e endereço de correio eletrónico do contacto. O script seguinte cria uma cadeia de caracteres em HTML utilizando as propriedades de site customizadas que são anexadas ao DOM.
define([ 'jquery' ], function( $ ){ 'use strict'; function SectionLayout( params ) { } SectionLayout.prototype = { render: function( parentObj ) { var html = ''; try { html += '<div>'; html += '<h1>' + SCSRenderAPI.getCustomSiteProperty('SiteGreeting') + '</h1>; html += '<div>For more information, contact <a href="mailto:' + SCSRenderAPI.getCustomSiteProperty('ContactEmail') '"> + SCSRenderAPI.getCustomSiteProperty('ContactName') + '</a></div>'; html += '</div>'; $(parentObj).append( html ); } catch( e ) { console.error( e ); } }, };
As propriedades customizadas são preservadas ao criar um modelo a partir de um site com propriedades de site customizadas acrescentadas e ao criar um site a partir de um modelo que tenha propriedades de site customizadas.