Mini Widgets
Text
Text
AI Defaults
- Function name
- `arcCustomText`.
- value
- The text content. Supports NinoxScript expressions.
- Use for type consistency
- When `if/else` mixes text and widget, wrap the text branch in `arcCustomText({value: ...})`.
- fontSize
- , **fontColor**, **fontWeight**: Direct properties (not nested).
- truncate
- `true` enables ellipsis when the text exceeds the container width (set an explicit `width`).
- No uniqueId needed
- for simple text display.
Text
Código de aplicación
arcCustomText({
uniqueId: " + Nr,
embedded: true,
width: "",
height: "",
alignY: "",
alignX: "",
fontSize: "",
fontWeight: "",
fontColor: "",
lineHeight: "",
textWrap: "",
textScroll: "",
textAlign: "",
textDirection: "horizontal",
textDecoration: {
type: "",
style: "",
color: "",
thickness: ""
},
truncate: "",
value: ""
})
uniqueId
El * uniqueId* lo asignas individualmente, debe ser único. La razón: si muestras varios customText con distintos settings en tu interfaz, los estilos no se sobrescriben entre sí.
uniqueId: Nr, // Ninox-Feld
uniqueId: "Aufgabe Beschreibung", // Text in "
embedded
El parámetro embedded lo usas cuando el texto no está dentro de otro widget. Por defecto está establecido en true.
embedded: false, // ermöglicht den Standalone Einsatz des Widgets (nicht eingebettet in anderen Widgets)
embedded: true, // wenn Text eingebettet in anderes Widget
embedded: "", // default: true
width
En with defines qué ancho debe tener el contenedor de tu customText.
width: "100%", // Prozent-Werte oder "80px" Pixel-Werte
width: "auto", // witdh passt sich an Inhalt an
width: "", // default: 100%
height
En height defines qué altura debe tener el contenedor de tu customText.
height: "100%", // Prozent Werte
height: "100px", // Pixel Werte
height: "", // default: auto
alignY
El parámetro alignY lo usas para determinar si el contenedor del customText en el eje Y debe estar arriba, abajo o centrado.
alignY: "bottom", // top, bottom, center
alignY: "", // default: top
alignX
El parámetro alignX lo usas para determinar si el contenedor del customText en el eje X debe estar a la izquierda, a la derecha o centrado.
alignX: "right", // left, right, center
alignX: "", // default: left
fontSize
Con fontSize determinas el tamaño de fuente de tu texto.
fontSize: "12px", // Pixel Werte
fontSize: "", // default: 12px
fontWeight
En fontWeight puedes definir el grosor de tu fuente.
fontWeight: "normal", // CSS-Values (bold, lighter etc.)
fontWeight: "800", // Zahl 100-800 in 100er Schritten (400=normal, 800=bold)
fontWeight: "", // default: normal/400
fontColor
Con fontColor defines el color de fuente de tu customText.
fontColor: "#000000", // HEX Werte
fontColor: "rgb(77,166,255)", // RGB Werte
fontColor: "", // default: #000
lineHeight
Con lineHeight determinas el espacio entre las líneas de texto.
lineHeight: "5px", // fixe line-height in px, pt, cm etc.
lineHeight: "1.5", // punkt-getrennte Zahl, multipliziert mit font-size
lineHeight: "150%", // line-height in Prozent von font-size
lineHeight: "", // default: normal
textWrap
Con textWrap determinas cómo debe saltar de línea tu texto. Puedes usar los valores CSS habituales para white-space.
textWrap: "normal", // automatischer Zeilenumbruch, wenn verfügbaren Platz überschritten
textWrap: "nowrap", // Text bleibt in einer Zeile, auch wenn verfügbarer Platz überschritten
textWrap: "pre", // Text wird genau so angezeigt wie im HTML-Code, mit Leerzeichen und Zeilenumbrüchen
textWrap: "pre-wrap", // Text wird umgebrochen, wenn verfügbarer Platz überschritten, behält Leerzeichen und Zeilenumbrüche bei
textWrap: "pre-line", // Text wird wie "pre-wrap" behandelt, aber behält normale Zeilenumbrüche bei und entfernt zusätzliche Leerzeichen
textWrap: "", // default: normal
textScroll
Con textScroll puedes establecer con true o false si el texto, cuando necesita más espacio del que ofrece el contenedor (determinado con width y height), debe ser scrollable o cortarse.
textScroll: true, // Der Text wird scrollbar, wenn er den Container überschreitet.
textScroll: false, // Der Text wird abgeschnitten, wenn er den Container überschreitet.
textScroll: "", // default: true
textAlign
En textAlign determinas cómo debe alinearse el texto: a la izquierda, a la derecha, centrado o justificado a lo ancho de la línea.
textAlign: "right", // left, right, center
textAlign: "justify", // streckt den Text so, dass jede Linie dieselbe Breite hat (wie zB in Zeitungen)
textAlign: "", // left
textDirection
Con el parámetro textDirection puedes determinar si el texto debe orientarse en horizontal o en vertical.
textDirection: "vertical", // vertical, horizontal
textDirection: "", // horizontal
textDecoration
En textDecorationSettings puedes usar el parámetro type para subrayar o tachar tu texto, o crear una línea sobre él, o también tanto debajo como encima del texto. Además, puedes personalizar esta línea con style, color y thickness.
textDecoration: {
type: "",
style: "",
color: "",
thickness: ""
}
El parámetro type determina el tipo de línea o su posición.
type: "none", // keine Linie
type: "overline", // Linie oberhalb des Textes
type: "line-throug", // Text wird durchgestrichen
type: "underline", // Text wird unterstrichen
type: "overline underline", // Erzeugt eine Linie ober- und unterhalb des Textes
type: "", // default: keine Linie
El parámetro style determina el estilo de la línea.
style: "solid", // gerade Linie
style: "double", // doppelte Linie
style: "dotted", // gepunktete Linie
style: "dashed", // gestrichelte Linie
style: "wavy", // gewellte Linie
style: "", // default: solid
El parámetro color determina el color de la línea.
color: "#fff", // hex-code Farben
color: "rgb(249, 201, 36)", // rgb() Farben
color: "", // default: #000
El parámetro thickness determina el grosor de la línea.
thickness: "7px", //
thickness: "", // default: 1px
truncate
Con truncate puedes cortar texto largo con ellipsis (…) cuando es más ancho que el contenedor (típicamente con width fijo).
truncate: true, // Text wird einzeilig abgeschnitten mit Ellipsis
truncate: false, // kein Truncate (default)
truncate: ", // default: false
value
En value introduces el valor que debe mostrarse como customText. Puede ser texto escrito directamente entre comillas o un campo de Ninox. Si no es un campo de texto de Ninox, recuerda incluir el valor dentro de *text()*.
value: "Dies ist mein customText.", // manuell eingefügter Text
value: Beschreibung, // Ninox Wert
value: "", // gibst du keinen value ein, wird nichts ausgegeben
Consejo para columnas estrechas:
En la customTable ahora puedes usar customText para mostrar los títulos de columna en vertical, ahorrando así espacio en celdas que, por ejemplo, solo contienen un checkbox, y dando en consecuencia más espacio a los elementos que lo necesitan💡
---
Idea de función: resaltado tipo rotulador (Handwritten Highlight)
💡 Ampliación planeada: dotar al texto de un efecto realista de «marcador de texto» (como resaltado a mano). Referencia: <a href="https://codepen.io/vii120/pen/KwMBaaY">CodePen</a> — variantes: amarillo, verde, rosa con conic-gradient + linear-gradient.