Skip to content

CSS: file-drop

.instui-file-drop — Uma área de drop para arquivos com estados de hover, aceito e rejeitado.

As classes -hover/-accepted/-rejected são puramente visuais — a detecção real de arrastar-e-soltar e a validação de arquivos ficam a cargo do JS do consumidor que conecta tudo ao input nativo envolvido.

Source: file-drop.css

Acessibilidade

Envolva um <input type="file"> nativo na zona de drop <label> para que permaneça um controle de arquivo real e rotulado que o teclado e tecnologias assistivas possam operar.

Uso

css
@import "@pantoken/components/components.css";
@import "@pantoken/components/file-drop.css";

Exemplos

html
<label class="instui-file-drop" id="fd">
  <span class="instui-icon -icon-cloud-upload"></span>
  <div class="instui-text"><strong>Drag an image here</strong>, or click to browse.</div>
  <div class="instui-text -size-sm instui-fg-muted" id="fd-msg">PNG or JPG up to 5&nbsp;MB.</div>
  <input type="file" id="fd-input">
</label>

Estrutura

text
.instui-file-drop
  [class*="-icon-"] (0..1)
  text (component)
    strong
  text (component)
  input
flowchart TD n0[".instui-file-drop"]:::cssdoc-root n1("[class*=&quot;-icon-&quot;]"):::cssdoc-part n2(["text"]):::cssdoc-component n3("strong"):::cssdoc-part n4(["text"]):::cssdoc-component n5("input"):::cssdoc-part n0 -.->|0..1| n1 n2 --> n3 n0 --> n2 n0 --> n4 n0 --> n5 click n2 "/api/css/text.md" click n4 "/api/css/text.md" classDef cssdoc-root stroke-width:1px; classDef cssdoc-part stroke-width:1px; classDef cssdoc-slot stroke-width:1px; classDef cssdoc-component stroke-width:1px;

Modificadores

ModificadorDescrição
.-acceptedEstado de arraste para um arquivo aceitável.
.-hoverEstado de hover ou arraste sobre.
.-icon-*Renderiza o ícone de glifo principal da área de drop.
.-rejectedEstado de arraste para um arquivo rejeitado.

Tokens consumidos

TokenTipoValor
--instui-color-text-base<color>LightDarklight-dark(#273540, #F2F4F5)
--instui-component-file-drop-accepted-color<color>LightDarklight-dark(#1D354F, #EEF4FD)
--instui-component-file-drop-background-color<color>LightDarklight-dark(#ffffff, #1C222B)
--instui-component-file-drop-border-color<color>LightDarklight-dark(#7E8792, #5F6E7A)
--instui-component-file-drop-border-radius<length>1rem
--instui-component-file-drop-border-styledashed
--instui-component-file-drop-border-width<length>0.0625rem
--instui-component-file-drop-hover-border-color<color>LightDarklight-dark(#1D354F, #EEF4FD)
--instui-component-file-drop-rejected-color<color>LightDarklight-dark(#CF1F24, #F56050)
--instui-spacing-space-lg<length>1rem

Subcomponentes