Documentos de API

Establecer estilo de campo

Establecer estilo de campo - kintone.app.record.setFieldStyle()

Establece el estilo de un campo en el registro actual.

Función

Escritorio

kintone.app.record.setFieldStyle(fieldCode, config)

Móvil

kintone.mobile.app.record.setFieldStyle(fieldCode, config)

Parámetros

Parámetro Tipo Obligatorio Descripción
fieldCode String Sí El código de campo.
config Object / String Sí La configuración de estilo del campo.
  • Si se especifica un objeto, el estilo se aplica según la configuración.
  • Si se especifica DEFAULT, se eliminan todos los estilos.
config.content Object / String Opcional La configuración de estilo del campo que se aplica al contenido del campo.
  • Si se especifica un objeto, el estilo se aplica según la configuración.
  • Si se especifica DEFAULT, se elimina el estilo.
config.content.backgroundColor String Opcional El color de fondo del contenido del campo.
Especifique un código de color hexadecimal de 6 dígitos, como #ffffff.
config.content.color String Opcional El color del texto del contenido del campo.
Especifique un código de color hexadecimal de 6 dígitos, como #ffffff.
config.content.fontWeight String Opcional El grosor de la fuente del texto del contenido del campo.
Se pueden especificar los siguientes valores:
  • normal
  • bold
config.content.textDecoration String Opcional La decoración del texto del contenido del campo, como subrayado o tachado.
Se pueden especificar los siguientes valores:
  • none
  • underline
  • line-through
config.content.borderColor String Opcional El color del borde del contenido del campo.
Especifique un código de color hexadecimal de 6 dígitos, como #ffffff.
config.background Object / String Opcional La configuración de estilo del campo que se aplica al fondo.
  • Si se especifica un objeto, el estilo se aplica según la configuración.
  • Si se especifica DEFAULT, se elimina el estilo.
config.background.backgroundColor String Opcional El color de fondo del campo.
Especifique un código de color hexadecimal de 6 dígitos, como #ffffff.
config.label Object / String Opcional La configuración de estilo del campo que se aplica al campo de etiqueta.
  • Si se especifica un objeto, el estilo se aplica según la configuración.
  • Si se especifica DEFAULT, se elimina el estilo.
config.label.color String Opcional El color del texto del campo de etiqueta.
Especifique un código de color hexadecimal de 6 dígitos, como #ffffff.
config.label.fontWeight String Opcional El grosor de la fuente del texto del campo de etiqueta.
Se pueden especificar los siguientes valores:
  • normal
  • bold
config.label.textDecoration String Opcional La decoración del texto del campo de etiqueta, como subrayado o tachado.
Se pueden especificar los siguientes valores:
  • none
  • underline
  • line-through

Cada estilo se puede eliminar estableciendo DEFAULT en cada propiedad.

Devuelve

Un objeto Promise.
Cuando se cumple el objeto Promise, no se devuelve ningún valor.

Solicitud de ejemplo

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

// Configuración
const config = {
  content: { // Estilo para el contenido del campo (elementos de entrada, etc.)
    backgroundColor: '#95d542',
    color: 'DEFAULT', // Eliminar el estilo
    fontWeight: 'bold',
    textDecoration: 'none',
    borderColor: '#ff8f00'
  },
  background: { // Estilo para el fondo
    backgroundColor: '#ffbf00'
  },
  label: { // Estilo para el campo de etiqueta
    color: '#ff4949',
    fontWeight: 'bold',
    textDecoration: 'underline'
  }
};

// Aplicar estilo
await kintone.app.record.setFieldStyle('Text', config);

// Eliminar estilo
await kintone.app.record.setFieldStyle('Text', 'DEFAULT');

Páginas disponibles

Escritorio

  • Creación de registros
  • Edición de registros
  • Detalles del registro
  • Impresión de registro

Móvil

  • Creación de registros
  • Edición de registros
  • Detalles del registro

Notas

Dependiendo de la combinación de ajustes, pueden producirse problemas menores de visualización.
Los ajustes de cada propiedad pueden actualizarse en futuras versiones del producto.

Limitaciones

Los siguientes campos no son compatibles:

  • Estado
  • Asignado
  • Tabla
  • Campos de una tabla
  • Registros relacionados
  • Grupo de campo
  • Borde
  • Etiqueta
  • Espacio en blanco

Los siguientes campos no admiten los ajustes de content:

  • Creación de registros / Edición de registros
    • Texto enriquecido
    • Calculado
    • Número de registro
    • Creado por
    • Fecha/hora creación
    • Actualizado por
    • Fecha/hora actualización
    • Campos de texto con la opción "Calcular automáticamente"
  • Detalles del registro / Impresión de registro
    • Texto enriquecido