--- title: File.webkitRelativePath slug: Web/API/File/webkitRelativePath tags: - Ficheiro translation_of: Web/API/File/webkitRelativePath ---

{{APIRef("File API")}}

O File.webkitRelativePath é uma propriedade só de leitura que contém um {{domxref("USVString")}} que especifica o caminho do ficheiro em relação ao diretório selecionado pelo utilizador num elemento {{HTMLElement("input")}} com o seu conjunto de atributos {{htmlattrxref("webkitdirectory", "input")}}.

Sintaxe

 relativePath = File.webkitRelativePath

Valor

Um {{domxref("USVString")}} que contem o caminho do ficheiro relativo ao diretório dos antepassados que o utilizador selecionou.

Exemplo

Neste exemplo, é apresentado um seletor de diretórios que permite ao utilizador escolher um ou mais diretórios. Quando o evento {{event("change")}} ocorre, é gerada e apresentada uma lista de todos os ficheiros contidos dentro das hierarquias de diretórios selecionados.

Conteúdo HTML

<input type="file" id="seletorDeFicheiros" name="listaDeFicheiros" webkitdirectory multiple />
<ul id="listagem"></ul>

Conteúdo JavaScript

document.getElementById("seletorDeFicheiros").addEventListener("change", function(event) {
  let output = document.getElementById("listagem");
  let ficheiros = event.target.files;

  for (let i = 0; i < ficheiros.length; i++) {
    let item = document.createElement("li");
    item.innerHTML = ficheiros[i].webkitRelativePath;
    output.appendChild(item);
  };
}, false);

Resultado

{{ EmbedLiveSample('Example') }}

Especificações

Especificação Estado Comentário
{{ SpecName('File System API', '#dom-file-webkitrelativepath', 'webkitRelativePath') }} {{ Spec2('File System API') }} Definição inicial.

Esta IPA não tem especificação oficial do W3C ou do WHATWG.

Compatibilidade

{{Compat("api.File.webkitRelativePath")}}

Ver também