Tipos de objetos para configuração de tema

Documentação Guias do Desenvolvedor
,
37

Sim, estou me referindo à limitação do número máximo de itens no array objects.

Atualmente, o recurso não é suportado oficialmente, então estendi essa funcionalidade em um componente de tema privado personalizado. A configuração é a seguinte (apenas para referência):

Configuração de limite máximo de itens no array:

themes/quectel-custom-homepage/settings.yml

banner_images:
  type: objects
  default: []
  schema:
    name: "Imagens de banner"
    max: 9 // Configuração estendida adicionada, limita o número máximo de itens no array
    identifier: image_url
    properties:
      image_url:
        type: upload
        required: true
      link_url:
        type: string
        min: 0
        max: 1023

Código específico da extensão:

themes/quectel-custom-homepage/javascripts/discourse/api-initializers/quectel-custom-homepage.gjs

import { action } from "@ember/object";
import { apiInitializer } from "discourse/lib/api";
import classPrepend from "discourse/lib/class-prepend";
import { i18n } from "discourse-i18n";

export default apiInitializer(() => {
  // Usa classPrepend para estender o componente SchemaSettingNewEditor e suportar o limite max para o tipo objects
  // Carrega o componente apenas no contexto de administrador
  let SchemaSettingNewEditor;
  try {
    SchemaSettingNewEditor =
      require("discourse/admin/components/schema-setting/editor").default;
  } catch {
    // Usuários não administradores não podem carregar este componente, pula a extensão
    return;
  }

  classPrepend(SchemaSettingNewEditor, (Superclass) => {
    return class extends Superclass {
      @action
      addItem() {
        // Verifica se atingiu o limite max
        const maxLimit = this.args.setting.max || this.activeSchema?.max;

        if (maxLimit && this.activeData.length >= maxLimit) {
          this.validationErrorMessage = i18n(
            themePrefix("theme_settings.errors.objects_value_not_valid_max"),
            {
              count: maxLimit,
            }
          );
          return;
        }

        return super.addItem(...arguments);
      }

      @action
      addChildItem(propertyName, parentNodeIndex) {
        const propertySchema = this.activeSchema.properties[propertyName];

        // Verifica se atingiu o limite max
        if (
          propertySchema?.max &&
          this.activeData[parentNodeIndex][propertyName].length >=
            propertySchema.max
        ) {
          this.validationErrorMessage = i18n(
            themePrefix("theme_settings.errors.objects_value_not_valid_max"),
            {
              count: propertySchema.max,
            }
          );
          return;
        }

        return super.addChildItem(...arguments);
      }
    };
  });
});

Configuração de tradução do tema:

themes/quectel-custom-homepage/locales/zh_CN.yml

zh_CN:
  theme_settings:
    errors:
      objects_value_not_valid_max: "A quantidade não pode exceder %{count} itens"

Efeito específico:

image
image1230×753 38.7 KB

  1. Mensagem de erro
  2. Não é possível adicionar mais itens
1 curtida