Símbolos

Todos los símbolos pueden usarse en diferentes lugares de la visualización. Así es posible definirlos como variable o texto.

Para mostrar un símbolo en la visualización, este se declara directamente en el texto mediante la etiqueta [icon:SYMBOLPFAD]. La ruta del símbolo puede copiarse de la biblioteca de símbolos con el botón derecho del ratón o con CTRL+C. Si es posible, solo debe elegirse Material Symbols para mantener el estilo de la visualización.

Biblioteca De Símbolos

Todos los símbolos disponibles pueden consultarse y buscarse en el menú contextual Visualización ▸ Símbolos. También es posible importar un conjunto de símbolos propio a la biblioteca. El procedimiento se explica más adelante.

Notas: El nombre que se muestra en la lista de símbolos no es idéntico a la ruta del símbolo. Si no se especifica un conjunto de símbolos en la ruta, se utiliza automáticamente el conjunto Glyphicons.

El filtro de la biblioteca de símbolos también busca entre las etiquetas almacenadas. Si no se desea este comportamiento, el filtro puede comenzar con un = para buscar solo en los nombres.

Conjunto De Símbolos Material Symbols (Predeterminado)

Este conjunto de símbolos es completamente dinámico y el estilo de los símbolos se configura automáticamente según el diseño de la visualización. Además, se utiliza un símbolo relleno automáticamente cuando el símbolo debe estar activo. Sin embargo, no todos los símbolos tienen una variante rellena.

Los símbolos se redondean automáticamente si el radio del botón es mayor o igual a 16 píxeles. Si el radio es igual a 0px, se utilizan los símbolos afilados. En el editor, sin embargo, siempre se utilizan los símbolos normales.

Nota: Se recomienda utilizar el conjunto de símbolos "Material Symbols" para diseñar la visualización de manera uniforme.

Conjunto De Símbolos Material Animated

Hay símbolos seleccionados de Material Symbols que han sido animados para representar valores. Estos símbolos tienen solo una animación con el símbolo de la estructura. Al seleccionarlos, se liberan más variables.

Conjunto De Símbolos Philips Hue

Los símbolos de Philips Hue pueden usarse libremente si se utiliza la interfaz Hue. Además, existe un conjunto adicional de símbolos Hue de la comunidad de Home Assistant HASS. Más información puede encontrarse al final de este capítulo.

Conjunto De Símbolos Clima

Este conjunto de símbolos muestra los símbolos climáticos de la visualización. Estos son soportados sin problemas por diversas interfaces. Consulte el capítulo siguiente Clima-Icons.

Conjunto De Símbolos Legacy (obsoleto)

El conjunto de símbolos Legacy incluye todos los símbolos de la antigua visualización. El estilo de visualización de la nueva superficie permanece igual. Los símbolos no deben usarse más, ya que su representación no está optimizada para la nueva superficie.

Varios símbolos antiguos siguen animados:

  • legacy/door
  • legacy/door_2
  • legacy/lock
  • legacy/shutter
  • legacy/shutter_blinds
  • legacy/window
  • legacy/window_tilt

Símbolos Ocultos

También existen símbolos ocultos para la visualización. Estos se explican con más detalle en los capítulos siguientes.

Para llamar a los símbolos solo es necesario un prefijo de URL.

Conjuntos De Símbolos Propios

Es posible importar un conjunto de símbolos propio al proyecto. Cada conjunto de símbolos debe prepararse como archivo ZIP. Algunos datos de ejemplo pueden descargarse aquí:

Consejo profesional: Después de una importación exitosa, puede exportar el conjunto de símbolos como .antobj para simplificar la importación. Haga clic con el botón derecho del ratón en un conjunto de símbolos y seleccione Exportar.

Las siguientes reglas definen la estructura y los requisitos de un conjunto de símbolos. Por favor, léalas cuidadosamente y sígalas al pie de la letra.

Reglas

  • Prefijo
    • Solo puede contener _, a–z y 0–9.
    • Las letras mayúsculas se convierten automáticamente en minúsculas.
    • Los nombres reservados como sys, src o doc no son válidos.
    • Debe comenzar con una letra (a–z). Solo números no están permitidos.
    • Los guiones bajos finales (_) se eliminan.
    • Debe tener al menos 3 caracteres de largo.
    • Los guiones bajos múltiples (__) se reducen a uno solo.
  • Nombres De Símbolo
    • Se convierten automáticamente en minúsculas.
    • Los caracteres permitidos son -, _, a–z y 0–9.
    • Se deben evitar nombres y prefijos demasiado largos.
    • Un prefijo debe ser único y solo usarse una vez.
    • Si un símbolo tiene el mismo nombre y prefijo que un símbolo del sistema, puede reemplazarlo.
  • Restricciones De Archivo
    • Tamaño máximo de archivo después de la limpieza: 10 kB. Los archivos más grandes serán rechazados.
    • Los archivos SVG deben estar limpios:
      • Las saltos de línea se eliminan automáticamente.
      • Los siguientes elementos se eliminan: <title>, <desc>, <script>, <image>, <style>, <foreignObject>.
      • Los siguientes atributos se eliminan: style, fill, stroke, color, stop-color, flood-color, lighting-color.
      • Se rechazan los iconos con scripts, imágenes, CSS o recursos externos incrustados.
      • Si los estilos contienen colores o bloques de estilo, la importación también puede ser rechazada.
  • Requisitos De Encabezado SVG
    • Debe contener: viewBox, width y height. Los valores faltantes se complementan automáticamente, si es posible.
    • Debe contener el espacio de nombres: xmlns="http://www.w3.org/2000/svg". Si falta o está incorrecto, se complementa automáticamente.
    • El nombre del icono debe coincidir exactamente con las dimensiones, de lo contrario el icono será rechazado.
    • Las dimensiones deben ser cuadradas (ancho = alto). Predeterminado: 24px.
    • Se deben evitar estilos contradictorios o dimensiones inadecuadas.
  • General
    • Los iconos mal creados pueden ralentizar gravemente la visualización o incluso causar errores.
    • Asegúrese de respetar los derechos de autor de los símbolos.
    • Todos los vectores se redondean a tres decimales.

Estructura

  • El archivo iconset.ini es obligatorio para reconocer el conjunto de símbolos.
    • Puede estar en el directorio raíz del archivo ZIP o en un subdirectorio.
    • Debe estar en minúsculas (iconset.ini).
    • Los nombres de los archivos de símbolos no son sensibles a mayúsculas y minúsculas.
  • La importación no busca automáticamente archivos SVG.
    • El directorio de iconos debe definirse explícitamente en iconset.ini (distinguir mayúsculas y minúsculas).
    • En la plantilla del archivo ZIP se ha definido un directorio llamado icons/.
  • Subdirectorios
    • Los subdirectorios en el directorio definido (icons/) sirven como categorías.
    • Los nombres de los símbolos deben ser únicos en todas las categorías.
    • Reglas de nomenclatura en el directorio de símbolos:
      • Mínimo: Solo dimensión y extensión del archivo (por ejemplo, 24.svg).
      • Las variantes como filled24.svg o round_filled_24.svg son válidas.
      • Los nombres de archivo con múltiples números (por ejemplo, 24_48.svg) no son válidos.
      • Las variantes de estilo se reconocen por:
        • Relleno: Debe contener filled o fill.
        • Redondeado: Debe contener round.
        • Afilado: Debe contener sharp.
        • Redondeado y afilado no pueden combinarse entre sí.
      • Si se aplican múltiples reglas, se utiliza el archivo reconocido por último (la selección puede parecer aleatoria).
  • Otras Reglas
    • No se buscan sub-subdirectorios anidados (estos pueden usarse para copias de seguridad o originales).
    • Se ignoran los archivos sin .svg.
    • En un directorio de símbolos puede haber un archivo llamado tags.txt para agregar etiquetas adicionales de búsqueda.
      • Las etiquetas pueden separarse con ,, ; o saltos de línea.

Conjuntos De Símbolos Especiales

También existen diversos conjuntos de símbolos especiales que pueden importarse como los conjuntos de símbolos propios, pero no necesitan configurarse según las especificaciones anteriores.

Hass Hue Icons

Uno de ellos es el de la página de GitHub hass-hue-icons. Este es un conjunto adicional de símbolos Hue de la comunidad de Home Assistant HASS y solo puede usarse para proyectos no comerciales, ya que está bajo la licencia Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International. Por eso, el conjunto de símbolos no se incluye con Antcas Control. Sin embargo, los símbolos pueden importarse en cualquier momento como nuevo conjunto de símbolos en el proyecto con el archivo ZIP hass-hue-icons-main.zip. Tenga en cuenta las condiciones de la licencia del proyecto en el sitio web de GitHub.

Fuente: https://github.com/arallsopp/hass-hue-icons.

Material Design Icons de Pictogrammers

Otro es el de Pictogrammers. Para ello, debe empaquetarse el archivo mdi-###.json en un archivo ZIP e importarlo. El archivo puede encontrarse y descargarse en la consola del desarrollador del navegador. Se intenta combinar los símbolos de contorno con los rellenos. La biblioteca es casi igual a Material Symbols. Sin embargo, hay muchas extensiones de la comunidad. Si desea integrar otros conjuntos de símbolos en la biblioteca, puede preguntarnos.

Fuente: https://pictogrammers.com/library/mdi/

Páginas Subordinadas