administrador.base.controller.init.key_select_txt.21.14.0 - gamboamartin/administrador GitHub Wiki

key_select_txt

Este método es responsable de configurar las opciones de un elemento de selección de texto (select) en un formulario HTML.

Signatura

public function key_select_txt(int $cols, string $key, array $keys_selects, string $place_holder, bool $required = true): array

Parámetros

$cols (int): El número de columnas que ocupará el elemento de selección de texto en el formulario.

$key (string): La clave que identifica el elemento de selección de texto.

$keys_selects (array): Un array que contiene las configuraciones de los elementos de selección de texto existentes.

$place_holder (string): El texto de marcador de posición para el elemento de selección de texto.

$required (bool, opcional): Indica si el elemento de selección de texto es obligatorio o no. Por defecto es true.

Retorna

  • array: Un array que contiene las configuraciones actualizadas de los elementos de selección de texto.

Explicación Detallada

  1. Validación de la clave:

    • Se utiliza la función trim() para eliminar espacios en blanco alrededor de la clave.
    • Se verifica si la clave está vacía. Si lo está, se retorna un mensaje de error utilizando el objeto error.

  2. Configuración de las opciones del elemento de selección de texto:

    • Si la clave no existe en el array $keys_selects, se crea un nuevo objeto stdClass para almacenar sus configuraciones.
    • Si el objeto correspondiente a la clave no tiene definido el número de columnas (cols), se establece con el valor proporcionado en el parámetro $cols.
    • Si el objeto correspondiente a la clave no tiene definido el marcador de posición (place_holder), se establece con el valor proporcionado en el parámetro $place_holder.
    • Si el objeto correspondiente a la clave no tiene definido el atributo de obligatoriedad (required), se establece con el valor proporcionado en el parámetro $required.

  3. Retorno:

    • Se retorna el array $keys_selects, que contiene las configuraciones actualizadas de los elementos de selección de texto.

Ejemplos

// Ejemplo: Configuración de opciones para un elemento de selección de texto
$cols = 3;
$key = 'mi_select';
$keys_selects = [];
$place_holder = 'Seleccione una opción';
$required = true;

$resultado = $objeto->key_select_txt($cols, $key, $keys_selects, $place_holder, $required);

echo "Configuración actualizada del elemento de selección de texto:";
print_r($resultado);

Código de la Función

public function key_select_txt(
        int $cols, string $key, array $keys_selects, string $place_holder, bool $required = true): array
    {
        $key = trim($key);
        if($key === ''){
            return $this->error->error(mensaje: 'Error key esta vacio',data:  $key, es_final: true);
        }

        if(!isset($keys_selects[$key])) {
            $keys_selects[$key] = new stdClass();
        }
        if(!isset($keys_selects[$key]->cols)) {
            $keys_selects[$key]->cols = $cols;
        }
        if(!isset($keys_selects[$key]->place_holder)) {
            $keys_selects[$key]->place_holder = $place_holder;
        }
        if(!isset($keys_selects[$key]->required)) {
            $keys_selects[$key]->required = $required;
        }

        return $keys_selects;
    }