Arc Rider Docs · Markdown

Mini Widgets

Signature

Signature (Unterschrift)

AI Defaults
uniqueId
Obligatorio, p. ej. `"signature-" + Nr`.
recordId
Raw `Nr` des Datensatzes (nicht `number(Nr)`).
fieldId
`fieldId(Nr, "Feldname")` – **Textfeld** für die Data-URL (`data:image/png;base64,...`).
value
Aktueller Feldinhalt aus der Formel übergeben, z. B. `Unterschrift`, damit Vorschau und Ansicht funktionieren.
height
z. B. `"200px"` oder `"100%"` im umgebenden Layout.
confirmLabel
Tooltip für den Bestätigen-Button unten rechts.
autoSaveDelay
Optional. Nur setzen, wenn nach einer Pause automatisch gespeichert werden soll. Ohne Wert speichert nur Bestätigen. `0` = sofort nach einem Strich.
Persistence
Speichern/Löschen über **Action Performer** (`type: "update"`). React: `onAction` — kein globales `database`.

Dibujar una firma

El widget arcCustomSignature dibuja una firma con ratón, táctil o lápiz (pointer events) en un canvas HTML, la exporta como data-URL PNG y la guarda mediante Action Performer (update) en el campo de texto indicado. Los trazos separados permanecen en el lienzo hasta pulsar Confirmar.

Código de aplicación

arcCustomSignature({
    uniqueId: "signature-" + Nr,
    recordId: Nr,
    fieldId: fieldId(Nr, "Unterschrift"),
    value: Unterschrift,
    height: "220px",
    lineColor: "#000000",
    lineWidth: 2,
    backgroundColor: "#FFFFFF",
    placeholder: "Hier unterschreiben",
    readonly: false,
    clearLabel: "Löschen",
    confirmLabel: "Bestätigen",
    editLabel: "Neu unterschreiben"
})

Parámetros

ParameterBeschreibung
uniqueIdID único (id HTML).
recordIdRegistro que se actualiza.
fieldIdCampo de texto de destino (string data-URL).
valueOpcional: valor actual para visualización/vista previa.
heightAltura mínima del widget.
lineColorColor del trazo (hex).
lineWidthAncho del trazo en píxeles CSS.
backgroundColorFondo del lienzo.
placeholderTexto de aviso cuando el área está vacía.
readonlytrue: solo visualización, sin entrada.
autoSaveDelayOpcional: confirmación automática en ms tras pointerup. Sin valor, solo guarda el botón de confirmar.
clearLabelTooltip y aria-label para el icono de papelera arriba a la derecha (modo de dibujo).
confirmLabelTooltip y aria-label para el icono de verificación abajo a la derecha (modo de dibujo).
editLabelTooltip y aria-label para el icono de refresco arriba a la izquierda (modo de vista con firma guardada).

Comportamiento

  • Vista: si value es una URL data:image/… válida, la firma se muestra como imagen; el icono de refresco arriba a la izquierda vuelve a abrir el lienzo.
  • Guardado: icono de verificación abajo a la derecha — solo entonces se fija la firma. Así siguen siendo posibles los trazos separados. El autoSaveDelay opcional confirma automáticamente tras una pausa.
  • Borrado: icono de papelera arriba a la derecha en el lienzo — vacía el área y pone el campo en null.

Notas de NinoxScript

  • Crea el campo para la firma como texto (data-URL larga).
  • Establece siempre fieldId con fieldId(Nr, "…").
  • Usa value: Unterschrift (nombre de visualización) para que el widget conozca el contenido guardado.