Utilização
[(#CHEMIN{minhaimage.png}|balise_img)]
produzirá a tag:
<img src="o_diretorio/minhaimage.png" alt="" width="180" height="56">
o filtro |balise_img aplica-se a um ficheiro JPG, PNG ou GIF e, a partir do, SPIP 4.0, pode igualmente
- aplicar-se aos ficheiros SVG
- aplicar-se a uma tag <img> já formada, por exemplo, resultante de um filtro imagem:
[(#FICHIER|image_reduire{200,200}|balise_img{'uma nuvem','spip_logo'})]
Parâmetros opcionais
-
alttexto alternativo; um valor nulo para não ter explicitamente uma tag alt atribuída à imagem (em vez de um alt vazio) -
classnulo por padrão (ie, se img é uma tag, o seu atributo class não será alterado, nenhuma classe será inserida). -
sizepermite especificar o tamanho da imagem final - a partir do SPIP 4.0.
[(#CHEMIN{minhaimagem.png}|balise_img{paisagem, spip_doc})]
produzirá a tag:
<img class="spip_doc" src="diretorio/minhaimagem.png" width="180" height="56" alt="paisagem">
A partir do SPIP 4.0, o último argumento size permite forçar o tamanho. Este argumento pode assumir várias formas:
- @1.5x, @2x ou @3x permite forças uma densidade de 1.5, 2 ou 3 (o x é aqui o multiplicador de densidade em relação ao tamanho inicial). Uma imagem com a largura de 200px exibida com um @2x terá um atributo width='100'.
- "Um número sozinho, como 64, para forçar uma imagem quadrada com width='64' height='64'"
- Uma largura E uma altura no formato 1024x640 para obter width='1024' height='640'
- Uma largura sozinha e uma altura automática no formato 1024x* para obter width='1024' e height ajustada automaticamente para respeitar a proporção inicial da imagem.
Para facilitar o uso do filtro, o argumento de tamanho (opcional) é colocado sempre ao final, mesmo se não se especificar alt ou class :
[(#FICHIER|balise_img{1024x640})]
[(#FICHIER|balise_img{'uma nuvem',1024x640})]
[(#FICHIER|balise_img{'uma nuvem','spip_logo',1024x640})]
Mas, se eventualmente o alt ou a class forem ambíguos e puderem ser interpretados como um tamanho, basta indicar um tamanho vazio para eliminar a ambiguidade:
[(#FICHIER|balise_img{'uma nuvem','x2',''})]
O filtro pode assim ser facilmente usado para ajustar a exibição de imagem em x2 ou x3 para levar em consideração os ecrãs retina:
[(#FICHIER|image_reduire{400,400}|balise_img{'Minha imagem HD',x2})]
Observações
- O uso de um parâmetro x2 para definir a densidade da imagem força, em qualquer caso, um tamanho duplo, mesmo que o ecrã não seja HD. Portanto, isso não substitui os plugins especializados (como adaptive_image e image_responsive, por exemplo), mas os complementa para gerir, por exemplo, pequenas imagens decorativas ou pictogramas em png: basta fornecer o pictograma em 64px e exibi-lo em 32px para que tenha boa qualidade em qualquer situação.
- Para as imagens SVG, este filtro permite controlar o tamanho de exibição independentemente do tamanho padrão inscrito no ficheiro.
Ver também
As tags
os filtros