🔽 APEX Dynamic Action Plugin - Buttons2Dropdown

Plugin do Oracle APEX que converte múltiplos botões em um dropdown do Bootstrap, organizando ações e economizando espaço na interface.

✨ Funcionalidades

• 🎯 Converte botões individuais em um dropdown elegante
• 💾 Preserva eventos onclick dos botões originais
• 🎨 Suporta múltiplos estilos do Bootstrap
• � Detecta automaticamente a versão do Bootstrap (3, 4 ou 5)
• 🎭 Opção de copiar o estilo do primeiro botão
• �🔧 Fácil configuração via Dynamic Action
• 📱 Responsivo e compatível com temas APEX
• ⚡ Sem dependências externas (usa Bootstrap do APEX)- 🔹 Bootstrap 3: Estrutura btn-group com caret e CSS customizado para botões

🚀 Início Rápido

Instalação

Siga o guia detalhado em INSTALACAO.md

Uso Básico

1. Crie uma Dynamic Action
2. Selecione este plugin na ação True
3. Configure os botões a serem agrupados
4. Personalize o texto e estilo do dropdown

📦 Estrutura do Projeto

plugin-apex-dropdown-button/
├── src/                      # Arquivos fonte
│   ├── js/                   # JavaScript do plugin
│   │   └── apex-dropdown-button.js
│   └── sql/                  # Definições SQL
│       └── plugin-definition.sql
├── dist/                     # Arquivos prontos para instalação
│   └── plugin_apex_dropdown_button.sql
├── scripts/                  # Scripts de build
│   └── update_hex.py        # Atualiza hex no SQL
├── examples/                 # Exemplos e demos
│   └── index.html           # Demo standalone
├── CHANGELOG.md             # Histórico de mudanças
├── INSTALACAO.md            # Guia de instalação
└── README.md                # Este arquivo

🔧 Build

Para atualizar o arquivo SQL de instalação após modificar o JavaScript:

cd scripts
python3 update_hex.py

Isso regenera o hexadecimal no arquivo dist/plugin_apex_dropdown_button.sql.

📖 Documentação

• Guia de Instalação - Instruções passo a passo
• Demo HTML - Demonstração funcional standalone

🎯 Casos de Uso

• Agrupar botões de ação em tabelas interativas
• Organizar opções de edição/exclusão/duplicação
• Economizar espaço em formulários complexos
• Melhorar UX em interfaces mobile

🛠️ Tecnologias

• Oracle APEX 5.0+
• Bootstrap 3, 4 ou 5 (detectado automaticamente)
• JavaScript ES5+

📋 Exemplo

Antes:

[✏️ Editar] [📄 Duplicar] [🗑️ Excluir]

Depois:

[⚡ Ações ▼]
  ✏️ Editar
  📄 Duplicar
  🗑️ Excluir

🤝 Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para:

1. Fazer fork do projeto
2. Criar uma branch para sua feature (git checkout -b feature/MinhaFeature)
3. Commit suas mudanças (git commit -m 'Adiciona nova feature')
4. Push para a branch (git push origin feature/MinhaFeature)
5. Abrir um Pull Request

📄 Licença

MIT License - Veja o arquivo LICENSE para detalhes

👤 Autor

Igor Augusto de Faria Costa

🌟 Agradecimentos

• Comunidade Oracle APEX
• Bootstrap Team
• Todos os contribuidores

---

Nota: Este plugin foi desenvolvido para Oracle APEX 5.0+. Para versões anteriores, testes adicionais podem ser necessários. Plug-in apex de Ação Dinâmica que agrupa botões em um dropdown.