classe_idioma-js.html
22 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Idioma - i3Geo</title><link rel="stylesheet" type="text/css" href="../../styles/main.css"><script language=JavaScript src="../../javascript/main.js"></script><script language=JavaScript src="../../javascript/prettify.js"></script></head><body class="FramedContentPage" onLoad="NDOnLoad();prettyPrint();"><script language=JavaScript><!--
if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
<!-- Generated by Natural Docs, version 1.51 -->
<!-- http://www.naturaldocs.org -->
<!-- saved from url=(0026)http://www.naturaldocs.org -->
<div id=Content><div class="CSection"><div class=CTopic id=MainTopic><h1 class=CTitle><a name="Idioma"></a>Idioma</h1><div class=CBody><p>i3geo.idioma</p><p>Tradução da interface principal.</p><p>Fornece os métodos para traduzir frases para idiomas específicos.</p><p>O dicionário é definido em i3geo/classesjs/dicionario.js</p><p>Se você está customizando o i3geo,acrescentandonovas funcionalidades, utilize o método alteraDicionario para acrescentar novas traduções, dessa forma, quandoo usuário escolher oidioma ainterface será adaptada corretamente.</p><h4 class=CHeading>Exemplos</h4><p>i3GEO.idioma.define(“pt”);</p><p>i3GEO.idioma.defineDicionario(g_traducao);</p><p>i3GEO.idioma.alteraDicionario(“d22”,”novo oi”);</p><p>alert($trad(“d22”))</p><h4 class=CHeading>Arquivo</h4><p>i3geo/classesjs/classe_idioma.js</p><h4 class=CHeading>Licença</h4><p>GPL2</p><p>i3Geo Interface Integrada de Ferramentas de Geoprocessamento para Internet</p><p>Direitos Autorais Reservados © 2006 Ministério do Meio Ambiente Brasil Desenvolvedor: Edmar Moretti <a href="#" onClick="location.href='mai' + 'lto:' + 'edmar.' + 'moretti' + '@' + 'gmai' + 'l.com'; return false;" class=LEMail>edmar.<span style="display: none">.nosp@m.</span>moretti<span>@</span>gmai<span style="display: none">.nosp@m.</span>l.com</a></p><p>Este programa é software livre; você pode redistribuí-lo e/ou modificá-lo sob os termos da Licença Pública Geral GNU conforme publicada pela Free Software Foundation;</p><p>Este programa é distribuído na expectativa de que seja útil, porém, SEM NENHUMA GARANTIA; nem mesmo a garantia implícita de COMERCIABILIDADE OU ADEQUACÃO A UMA FINALIDADE ESPECÍFICA. Consulte a Licença Pública Geral do GNU para mais detalhes. Você deve ter recebido uma cópia da Licença Pública Geral do GNU junto com este programa; se não, escreva para a Free Software Foundation, Inc., no endereço 59 Temple Street, Suite 330, Boston, MA 02111-1307 USA.</p><!--START_ND_SUMMARY--><div class=Summary><div class=STitle>Summary</div><div class=SBorder><table border=0 cellspacing=0 cellpadding=0 class=STable><tr class="SMain"><td class=SEntry><a href="#Idioma" >Idioma</a></td><td class=SDescription>i3geo.idioma</td></tr><tr class="SGroup SIndent1"><td class=SEntry><a href="#Propriedades" >Propriedades</a></td><td class=SDescription></td></tr><tr class="SPropriedade SIndent2 SMarked"><td class=SEntry><a href="#MOSTRASELETOR" >MOSTRASELETOR</a></td><td class=SDescription>Define se o i3Geo irá incluir no mapa as bandeiras de seleção de idiomas</td></tr><tr class="SPropriedade SIndent2"><td class=SEntry><a href="#IDSELETOR" >IDSELETOR</a></td><td class=SDescription>Define o id do elemento HTML que receberá o seletor. </td></tr><tr class="SPropriedade SIndent2 SMarked"><td class=SEntry><a href="#SELETORES" >SELETORES</a></td><td class=SDescription>Lista os seletores (bandeiras) que serão incluídas no seletor</td></tr><tr class="SPropriedade SIndent2"><td class=SEntry><a href="#DICIONARIO" >DICIONARIO</a></td><td class=SDescription>Objeto contendo o dicionário default utilizado</td></tr><tr class="SGroup SIndent1"><td class=SEntry><a href="#Functions" >Functions</a></td><td class=SDescription></td></tr><tr class="SFunction SIndent2 SMarked"><td class=SEntry><a href="#define" id=link1 onMouseOver="ShowTip(event, 'tt1', 'link1')" onMouseOut="HideTip('tt1')">define</a></td><td class=SDescription>Define qual o idioma em uso. </td></tr><tr class="SFunction SIndent2"><td class=SEntry><a href="#retornaAtual" id=link2 onMouseOver="ShowTip(event, 'tt2', 'link2')" onMouseOut="HideTip('tt2')">retornaAtual</a></td><td class=SDescription>Retorna o idioma atual.</td></tr><tr class="SFunction SIndent2 SMarked"><td class=SEntry><a href="#defineDicionario" id=link3 onMouseOver="ShowTip(event, 'tt3', 'link3')" onMouseOut="HideTip('tt3')">defineDicionario</a></td><td class=SDescription>Define o objeto com as traduções. </td></tr><tr class="SFunction SIndent2"><td class=SEntry><a href="#alteraDicionario" id=link4 onMouseOver="ShowTip(event, 'tt4', 'link4')" onMouseOut="HideTip('tt4')">alteraDicionario</a></td><td class=SDescription>Altera um texto do dicionario ou acresecenta um novo texto para o idioma atual.</td></tr><tr class="SFunction SIndent2 SMarked"><td class=SEntry><a href="#traduzir" id=link5 onMouseOver="ShowTip(event, 'tt5', 'link5')" onMouseOut="HideTip('tt5')">traduzir</a></td><td class=SDescription>Traduz um texto para o idioma escolhido</td></tr><tr class="SFunction SIndent2"><td class=SEntry><a href="#adicionaDicionario" id=link6 onMouseOver="ShowTip(event, 'tt6', 'link6')" onMouseOut="HideTip('tt6')">adicionaDicionario</a></td><td class=SDescription>Adiciona novos registros ao dicionário atual</td></tr><tr class="SFunction SIndent2 SMarked"><td class=SEntry><a href="#mostraDicionario" id=link7 onMouseOver="ShowTip(event, 'tt7', 'link7')" onMouseOut="HideTip('tt7')">mostraDicionario</a></td><td class=SDescription>Abre uma nova janela do navegador com a lista de palavras do dicionário.</td></tr><tr class="SFunction SIndent2"><td class=SEntry><a href="#trocaIdioma" id=link8 onMouseOver="ShowTip(event, 'tt8', 'link8')" onMouseOut="HideTip('tt8')">trocaIdioma</a></td><td class=SDescription>Troca o idioma atual por outro.</td></tr><tr class="SFunction SIndent2 SMarked"><td class=SEntry><a href="#listaIdiomas" id=link9 onMouseOver="ShowTip(event, 'tt9', 'link9')" onMouseOut="HideTip('tt9')">listaIdiomas</a></td><td class=SDescription>Lista os idiomas disponíveis no dicionário ativo</td></tr><tr class="SFunction SIndent2"><td class=SEntry><a href="#mostraSeletor" id=link10 onMouseOver="ShowTip(event, 'tt10', 'link10')" onMouseOut="HideTip('tt10')">mostraSeletor</a></td><td class=SDescription>Inclui as bandeiras no mapa permitindo a seleção do idioma</td></tr><tr class="SFunction SIndent2 SMarked"><td class=SEntry><a href="#$trad" id=link11 onMouseOver="ShowTip(event, 'tt11', 'link11')" onMouseOut="HideTip('tt11')">$trad</a></td><td class=SDescription>Atalho para a função de tradução</td></tr></table></div></div><!--END_ND_SUMMARY--></div></div></div>
<div class="CGroup"><div class=CTopic><h3 class=CTitle><a name="Propriedades"></a>Propriedades</h3></div></div>
<div class="CPropriedade"><div class=CTopic><h3 class=CTitle><a name="MOSTRASELETOR"></a>MOSTRASELETOR</h3><div class=CBody><p>Define se o i3Geo irá incluir no mapa as bandeiras de seleção de idiomas</p><h4 class=CHeading>Tipo</h4><p>{Boolean}</p><h4 class=CHeading>Default</h4><p>{true}</p></div></div></div>
<div class="CPropriedade"><div class=CTopic><h3 class=CTitle><a name="IDSELETOR"></a>IDSELETOR</h3><div class=CBody><p>Define o id do elemento HTML que receberá o seletor. Se não for definido, o seletor será posicionado automaticamente pelo i3Geo</p><h4 class=CHeading>Tipo</h4><p>{String}</p><h4 class=CHeading>Default</h4><p>{“”}</p></div></div></div>
<div class="CPropriedade"><div class=CTopic><h3 class=CTitle><a name="SELETORES"></a>SELETORES</h3><div class=CBody><p>Lista os seletores (bandeiras) que serão incluídas no seletor</p><h4 class=CHeading>Tipo</h4><p>{Array}</p><h4 class=CHeading>Default</h4><p>{[“pt”,”en”,”es”,”it”]}</p></div></div></div>
<div class="CPropriedade"><div class=CTopic><h3 class=CTitle><a name="DICIONARIO"></a>DICIONARIO</h3><div class=CBody><p>Objeto contendo o dicionário default utilizado</p><h4 class=CHeading>Tipo</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>{object}</td><td class=CDLDescription>veja <dicionario.js></td></tr></table><h4 class=CHeading>Default</h4><p>{g_traducao}</p></div></div></div>
<div class="CGroup"><div class=CTopic><h3 class=CTitle><a name="Functions"></a>Functions</h3></div></div>
<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="define"></a>define</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class="Prototype"><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class="PBeforeParameters prettyprint "nowrap>define: function(</td><td class="PParameter prettyprint " nowrap>codigo</td><td class="PAfterParameters prettyprint "nowrap>)</td></tr></table></td></tr></table></blockquote><p>Define qual o idioma em uso. O default é “pt”.</p><h4 class=CHeading>Parametro</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>codigo</td><td class=CDLDescription>{String} Código do idioma.</td></tr></table></div></div></div>
<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="retornaAtual"></a>retornaAtual</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class="Prototype"><tr><td class="prettyprint">retornaAtual: function()</td></tr></table></blockquote><p>Retorna o idioma atual.</p><h4 class=CHeading>Returns</h4><p>{string} Código do idioma.</p></div></div></div>
<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="defineDicionario"></a>defineDicionario</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class="Prototype"><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class="PBeforeParameters prettyprint "nowrap>defineDicionario: function(</td><td class="PParameter prettyprint " nowrap>obj</td><td class="PAfterParameters prettyprint "nowrap>)</td></tr></table></td></tr></table></blockquote><p>Define o objeto com as traduções. O default é “g_traducao”</p><h4 class=CHeading>Parametro</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>obj</td><td class=CDLDescription>{Object} Objeto com a tradução.</td></tr></table><h4 class=CHeading>Example</h4><p>g_traducao = {</p><p>”p1”: [{</p><p>pt:”texto em portugues”,</p><p>en:”texto em ingles”,</p><p>es:”texto em espanhol”</p><p>}]</p><p>}</p></div></div></div>
<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="alteraDicionario"></a>alteraDicionario</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class="Prototype"><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class="PBeforeParameters prettyprint "nowrap>alteraDicionario: function(</td><td class="PParameter prettyprint " nowrap>id,</td></tr><tr><td></td><td class="PParameter prettyprint " nowrap>novo</td><td class="PAfterParameters prettyprint "nowrap>)</td></tr></table></td></tr></table></blockquote><p>Altera um texto do dicionario ou acresecenta um novo texto para o idioma atual.</p><h4 class=CHeading>Parametros</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>id</td><td class=CDLDescription>{String} Código do texto.</td></tr><tr><td class=CDLEntry>novo</td><td class=CDLDescription>(String) Novo texto.</td></tr></table></div></div></div>
<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="traduzir"></a>traduzir</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class="Prototype"><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class="PBeforeParameters prettyprint "nowrap>traduzir: function(</td><td class="PParameter prettyprint " nowrap>id,</td></tr><tr><td></td><td class="PParameter prettyprint " nowrap>dic</td><td class="PAfterParameters prettyprint "nowrap>)</td></tr></table></td></tr></table></blockquote><p>Traduz um texto para o idioma escolhido</p><h4 class=CHeading>Parametro</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>id</td><td class=CDLDescription>{String} Código do texto.</td></tr><tr><td class=CDLEntry>dic</td><td class=CDLDescription>{string} Objeto que contém o dicioná. Por default, utiliza i3GEO.idioma.DICIONARIO</td></tr></table><h4 class=CHeading>Returns</h4><p>{String} Texto traduzido.</p></div></div></div>
<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="adicionaDicionario"></a>adicionaDicionario</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class="Prototype"><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class="PBeforeParameters prettyprint "nowrap>adicionaDicionario: function(</td><td class="PParameter prettyprint " nowrap>novodic</td><td class="PAfterParameters prettyprint "nowrap>)</td></tr></table></td></tr></table></blockquote><p>Adiciona novos registros ao dicionário atual</p><h4 class=CHeading>Parametro</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>novodic</td><td class=CDLDescription>{Object} Objeto novo dicionário.</td></tr></table><h4 class=CHeading>Example</h4><p>var novodic ={ “pp”: [{</p><p>pt:”texto em portugues”,</p><p>en:”texto em ingles”,</p><p>es:”texto em espanhol”</p><p>}]}</p><p>i3GEO.idioma.adicionaDicionario(novodic)</p><p>alert($trad(“pp”))</p></div></div></div>
<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="mostraDicionario"></a>mostraDicionario</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class="Prototype"><tr><td class="prettyprint">mostraDicionario: function()</td></tr></table></blockquote><p>Abre uma nova janela do navegador com a lista de palavras do dicionário.</p></div></div></div>
<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="trocaIdioma"></a>trocaIdioma</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class="Prototype"><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class="PBeforeParameters prettyprint "nowrap>trocaIdioma: function(</td><td class="PParameter prettyprint " nowrap>codigo</td><td class="PAfterParameters prettyprint "nowrap>)</td></tr></table></td></tr></table></blockquote><p>Troca o idioma atual por outro.</p><p>A troca é baseada na definição de um cookie e reload da página.</p><h4 class=CHeading>Parametro</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>codigo</td><td class=CDLDescription>{String} Código do idioma (p.e. “en”)</td></tr></table></div></div></div>
<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="listaIdiomas"></a>listaIdiomas</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class="Prototype"><tr><td class="prettyprint">listaIdiomas: function()</td></tr></table></blockquote><p>Lista os idiomas disponíveis no dicionário ativo</p><h4 class=CHeading>Returns</h4><p>{Array} Array com os códigos de idioma disponíveis.</p></div></div></div>
<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="mostraSeletor"></a>mostraSeletor</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class="Prototype"><tr><td class="prettyprint">mostraSeletor: function()</td></tr></table></blockquote><p>Inclui as bandeiras no mapa permitindo a seleção do idioma</p><p>As imagens das bandeiras devem estar definidas no CSS do i3geo, recebendo como identificadores os ids uk,brasil,italiano,espanhol</p></div></div></div>
<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="$trad"></a>$trad</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class="Prototype"><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class="PBeforeParameters prettyprint "nowrap>$trad = function(</td><td class="PParameter prettyprint " nowrap>id,</td></tr><tr><td></td><td class="PParameter prettyprint " nowrap>dic</td><td class="PAfterParameters prettyprint "nowrap>)</td></tr></table></td></tr></table></blockquote><p>Atalho para a função de tradução</p><h4 class=CHeading>Parametro</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>id</td><td class=CDLDescription>{String} Código do texto.</td></tr><tr><td class=CDLEntry>dic</td><td class=CDLDescription>{string} Objeto que contém o dicioná. Por default, utiliza i3GEO.idioma.DICIONARIO</td></tr></table><h4 class=CHeading>Returns</h4><p>{String} Texto traduzido.</p></div></div></div>
</div><!--Content-->
<!--START_ND_TOOLTIPS-->
<div class=CToolTip id="tt1"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class="Prototype"><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class="PBeforeParameters prettyprint "nowrap>define: function(</td><td class="PParameter prettyprint " nowrap>codigo</td><td class="PAfterParameters prettyprint "nowrap>)</td></tr></table></td></tr></table></blockquote>Define qual o idioma em uso. </div></div><div class=CToolTip id="tt2"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class="Prototype"><tr><td class="prettyprint">retornaAtual: function()</td></tr></table></blockquote>Retorna o idioma atual.</div></div><div class=CToolTip id="tt3"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class="Prototype"><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class="PBeforeParameters prettyprint "nowrap>defineDicionario: function(</td><td class="PParameter prettyprint " nowrap>obj</td><td class="PAfterParameters prettyprint "nowrap>)</td></tr></table></td></tr></table></blockquote>Define o objeto com as traduções. </div></div><div class=CToolTip id="tt4"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class="Prototype"><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class="PBeforeParameters prettyprint "nowrap>alteraDicionario: function(</td><td class="PParameter prettyprint " nowrap>id,</td></tr><tr><td></td><td class="PParameter prettyprint " nowrap>novo</td><td class="PAfterParameters prettyprint "nowrap>)</td></tr></table></td></tr></table></blockquote>Altera um texto do dicionario ou acresecenta um novo texto para o idioma atual.</div></div><div class=CToolTip id="tt5"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class="Prototype"><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class="PBeforeParameters prettyprint "nowrap>traduzir: function(</td><td class="PParameter prettyprint " nowrap>id,</td></tr><tr><td></td><td class="PParameter prettyprint " nowrap>dic</td><td class="PAfterParameters prettyprint "nowrap>)</td></tr></table></td></tr></table></blockquote>Traduz um texto para o idioma escolhido</div></div><div class=CToolTip id="tt6"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class="Prototype"><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class="PBeforeParameters prettyprint "nowrap>adicionaDicionario: function(</td><td class="PParameter prettyprint " nowrap>novodic</td><td class="PAfterParameters prettyprint "nowrap>)</td></tr></table></td></tr></table></blockquote>Adiciona novos registros ao dicionário atual</div></div><div class=CToolTip id="tt7"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class="Prototype"><tr><td class="prettyprint">mostraDicionario: function()</td></tr></table></blockquote>Abre uma nova janela do navegador com a lista de palavras do dicionário.</div></div><div class=CToolTip id="tt8"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class="Prototype"><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class="PBeforeParameters prettyprint "nowrap>trocaIdioma: function(</td><td class="PParameter prettyprint " nowrap>codigo</td><td class="PAfterParameters prettyprint "nowrap>)</td></tr></table></td></tr></table></blockquote>Troca o idioma atual por outro.</div></div><div class=CToolTip id="tt9"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class="Prototype"><tr><td class="prettyprint">listaIdiomas: function()</td></tr></table></blockquote>Lista os idiomas disponíveis no dicionário ativo</div></div><div class=CToolTip id="tt10"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class="Prototype"><tr><td class="prettyprint">mostraSeletor: function()</td></tr></table></blockquote>Inclui as bandeiras no mapa permitindo a seleção do idioma</div></div><div class=CToolTip id="tt11"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class="Prototype"><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class="PBeforeParameters prettyprint "nowrap>$trad = function(</td><td class="PParameter prettyprint " nowrap>id,</td></tr><tr><td></td><td class="PParameter prettyprint " nowrap>dic</td><td class="PAfterParameters prettyprint "nowrap>)</td></tr></table></td></tr></table></blockquote>Atalho para a função de tradução</div></div><!--END_ND_TOOLTIPS-->
<script language=JavaScript><!--
if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>