A API de seleção personalizável oferece uma maneira declarativa e baseada em CSS de animar elementos <select> e os seletores de menu suspenso deles. Ao combinar appearance: base-select com técnicas modernas de animação CSS, como @starting-style e o comportamento de transição allow-discrete, é possível criar transições de interface fluidas e premium para elementos de camada superior sem depender de bibliotecas JavaScript pesadas.
Antes, não era possível animar menus suspensos de seleção nativos porque a interface deles era renderizada fora das restrições da janela de visualização acessível. Com appearance: base-select, o seletor pode ser estilizado e animado como qualquer outro elemento de página.
Como implementar
Para implementar um seletor animado:
- Ativar a personalização: aplique
appearance: base-selectao elemento<select>e ao pseudoelemento::picker(select). - Ativar transições de dimensionamento automático (opcional): defina
interpolate-size: allow-keywords(geralmente em:root) para permitir que o navegador faça a transição entre valores de métricas discretos, comoheight: autoeheight: 0. - Animação do contêiner da camada superior: aplique estilos padrão de entrada/saída a
::picker(select). Para garantir que a transição de opacidade funcione ao alternar entredisplay: noneedisplay: block, usetransition-behavior: allow-discrete(geralmente escrito inline comotransition: display 0.3s allow-discrete). - Conecte-se ao estado de abertura com
@starting-style: use@starting-stylepara definir os estilos de referência que o navegador deve calcular antes do início da transição. Por exemplo, se você quiser que ele apareça gradualmente, defina a opacidade como0dentro do bloco@starting-style. - Girar o ícone: use seletores de foco ou ativos de pseudoelementos, como
:open::picker-icon, para aplicar transições (como rotação ou translação) ao indicador de seta.
Exemplo de código: escala de seleção suave e esmaecimento
O exemplo a seguir demonstra uma seleção personalizada estilizada com animações de página padrão para o contêiner do seletor.
<!-- Always use a <label> linked via 'for' to the select for accessibility -->
<label for="theme-select">Visual Theme</label>
<select id="theme-select" class="animated-select" name="theme">
<!-- The <button> inside <select> becomes the visible trigger when appearance: base-select is used -->
<button>
<!-- <selectedcontent> automatically displays the content of the chosen <option> -->
<selectedcontent></selectedcontent>
</button>
<option value="system">
<!-- MANDATORY: Decorative inline SVGs MUST set aria-hidden="true" to prevent redundant screen reader announcement -->
<svg aria-hidden="true" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
<rect x="2" y="3" width="20" height="14" rx="2" ry="2"></rect>
<line x1="8" y1="21" x2="16" y2="21"></line>
<line x1="12" y1="17" x2="12" y2="21"></line>
</svg>
System Default
</option>
<option value="light">
<svg aria-hidden="true" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
<circle cx="12" cy="12" r="5"></circle>
<line x1="12" y1="1" x2="12" y2="3"></line>
<line x1="12" y1="21" x2="12" y2="23"></line>
<line x1="4.22" y1="4.22" x2="5.64" y2="5.64"></line>
<line x1="18.36" y1="18.36" x2="19.78" y2="19.78"></line>
<line x1="1" y1="12" x2="3" y2="12"></line>
<line x1="21" y1="12" x2="23" y2="12"></line>
<line x1="4.22" y1="19.78" x2="5.64" y2="18.36"></line>
<line x1="18.36" y1="5.64" x2="19.78" y2="4.22"></line>
</svg>
Light UI
</option>
</select>
/* Opt-in to customizable select */
.animated-select,
.animated-select::picker(select) {
appearance: base-select;
}
/* Enable auto-keyword transitions (usually set globally at :root) */
:root {
interpolate-size: allow-keywords;
}
/* Style the visible trigger and icon rotation */
.animated-select {
display: flex;
align-items: center;
justify-content: space-between;
width: 100%;
padding: 0.875rem 1rem;
font-size: 1rem;
border-radius: 8px;
cursor: pointer;
transition: border-color 0.2s ease;
}
.animated-select::picker-icon {
transition: transform 0.3s cubic-bezier(0.16, 1, 0.3, 1);
}
.animated-select:open::picker-icon {
transform: rotate(180deg);
}
/*
* The Picker Container
* Uses top-layer animations with `allow-discrete` visibility hooks
*/
.animated-select::picker(select) {
background: white;
border-radius: 12px;
box-shadow: 0 10px 25px -3px rgba(0,0,0,0.1);
padding: 0.5rem;
margin-top: 0.25rem;
width: anchor-size(width);
overflow: hidden;
/* The crucial transition setting for popover animations */
transition:
display 0.4s allow-discrete,
overlay 0.4s allow-discrete,
opacity 0.4s cubic-bezier(0.16, 1, 0.3, 1),
height 0.4s cubic-bezier(0.16, 1, 0.3, 1);
opacity: 0;
height: 0;
}
/* Open State */
.animated-select:open::picker(select) {
opacity: 1;
height: auto;
}
/* @starting-style to hook the transition on initial popover open */
@starting-style {
.animated-select:open::picker(select) {
opacity: 0;
height: 0;
}
}
/* Support for SVG inside Options and Selected Content */
.animated-select option svg,
.animated-select selectedcontent svg {
flex-shrink: 0; /* Prevent icons from shrinking */
width: 1.25rem;
height: 1.25rem;
}
/* MANDATORY: Provide multiple indicators (e.g. bold font and distinct background) for the checked state to avoid color-only state communication */
.animated-select option:checked {
font-weight: 700;
background-color: #f1f5f9;
}
/* Ensure copy-paste safety for users with motion sensitivities */
@media (prefers-reduced-motion: reduce) {
.animated-select::picker(select),
.animated-select::picker-icon {
transition: none !important;
}
}
Implementação estratégica e práticas recomendadas
- RECOMENDAMOS usar
@starting-stylequando você precisar que as animações sejam acionadas exatamente quando um elemento passar dedisplay: nonepara visível. - NÃO use o bloqueio de rolagem ad-hoc. Os elementos da camada superior gerenciados por "base-select" precisam permitir comportamentos naturais de dispensação de plano de fundo.
- VERIFIQUE as preferências de movimento reduzido. Sempre envolva as restrições de animação em uma consulta de mídia
prefers-reduced-motionpara garantir ambientes acessíveis para pessoas afetadas por cinetose. - Teste o comportamento do layout. Definir
appearance: base-selectremove o comportamento padrão do navegador de dimensionar a seleção com base na largura da opção mais longa. Talvez seja necessário definir uma largura fixa ou usar restrições de flex/grid para evitar mudanças de layout. - Verifique se o
<select>tem um atributonamee um<label>associado. Isso garante que, mesmo com uma interface personalizada, o componente permaneça acessível para leitores de tela e funcione corretamente com envios de formulários padrão. - Use atributos
valuepadrão nas opções para garantir que o envio do formulário funcione exatamente como antes.
Estratégias de fallback
Alternativas e suporte do navegador para <select> personalizável
Para navegadores que ainda não são compatíveis com appearance: base-select, o elemento <select> é degradado de forma otimizada para um menu suspenso padrão do sistema operacional.
- Conteúdo não textual ignorado: navegadores mais antigos removem tags HTML (como
<svg>ou<div>) dentro de tags<option>e renderizam apenas os nós de texto. Verifique se o conteúdo de texto do<option>é legível e significativo por si só. - Processamento da estrutura HTML: os analisadores padrão podem ignorar as tags
<button>e<selectedcontent>dentro de<select>ou tratá-las como inválidas. Não é necessário usar polyfills pesados de JavaScript para o aprimoramento progressivo se você considerar o texto padrão como um substituto legível.
document.addEventListener("DOMContentLoaded", () => {
// Check if browser supports base-select value
if (!CSS.supports("appearance", "base-select")) {
// Custom select overrides are not supported natively.
}
});