Conjuntos de requisitos da API JavaScript do Excel
Os conjuntos de requisitos são grupos nomeados de membros da API. Os Suplementos do Office usam conjuntos de requisitos especificados no manifesto ou usam uma verificação de tempo de execução para determinar se um aplicativo do Office oferece suporte para as APIs necessárias para um suplemento. Para obter mais informações, consulte Versões do Office e conjuntos de requisitos.
Disponibilidade do conjunto de requisitos
Os suplementos do Excel são executados em várias versões do Office, incluindo o Office 2016 ou posterior no Windows, Office na Web, Mac e iPad. A tabela seguinte lista os conjuntos de requisitos do Excel, as aplicações cliente do Office suportadas e as compilações ou versões mínimas para essas aplicações, sempre que aplicável.
Observação
Para usar APIs em qualquer um dos conjuntos de requisitos numerados ou ExcelApiOnline, você deve fazer referência à biblioteca de produçãona rede de distribuição de conteúdo (CDN) do Office.js.
Para obter informações sobre o uso de APIs de visualização, confira o artigo APIs de visualização do JavaScript para Excel.
| Conjunto de requisitos | Office na Web | Office no Windows
|
Office no Windows
|
Office no Mac | Office no iPad |
|---|---|---|---|---|---|
| Visualização | Utilize a versão mais recente do Office para experimentar as APIs de pré-visualização (poderá ter de aderir ao programa Microsoft 365 Insider). | ||||
| ExcelApiOnline | Mais recente (confira a página conjunto de requisitos) | Não aplicável | Não aplicável | Não aplicável | Não aplicável |
| ExcelApi 1.17 | Com suporte | Versão 2302 (Compilação 16130.20332) | Office 2024: Versão 2302 (Compilação 16130.20332) | Versão 16.70 (23021201) | Versão 16.70 |
| ExcelApi 1.16 | Com suporte | Versão 2208 (Compilação 15601.20148) | Office 2024: Versão 2208 (Compilação 15601.20148) | Versão 16.64 (22081401) | Versão 16.66 |
| ExcelApi 1.15 | Com suporte | Versão 2202 (Build 14931.20132) | Office 2024: Versão 2202 (Compilação 14931.20132) | Versão 16.58 (22021501) | Versão 16.59 |
| ExcelApi 1.14 | Com suporte | Versão 2108 (Build 14326.20508) | Office 2021: Versão 2108 (Compilação 14326.20508) | Versão 16.52 (21080801) | Versão 16.53 |
| ExcelApi 1.13 | Com suporte | Versão 2102 (Build 13801.20738) | Office 2021: Versão 2102 (Compilação 13801.20738) | Versão 16.50 (21061301) | Versão 16.50 |
| ExcelApi 1.12 | Com suporte | Versão 2008 (Build 13127.20408) | Office 2021: Versão 2008 (Compilação 13127.20408) | Versão 16.40 (20081000) | Versão 16.40 |
| ExcelApi 1.11 | Com suporte | Versão 2002 (Compilação 12527.20470) | Office 2021: Versão 2002 (Compilação 12527.20470) | Versão 16.33 (20011301) | Versão 16.35 |
| ExcelApi 1.10 | Com suporte | Versão 1907 (Compilação 11929.20306) | Office 2021: Versão 1907 (Compilação 11929.20306) | Versão 16.30 (19101301) | Versão 16.0 |
| ExcelApi 1.9 | Com suporte | Versão 1903 (Build 11425.20204) | Office 2021: Versão 1903 (Compilação 11425.20204) | Versão 16.24 (19041401) | Versão 16.0 |
| ExcelApi 1.8 | Com suporte | Versão 1808 (build 10730.20102) | Office 2021: Versão 1808 (Compilação 10730.20102) | Versão 16.17 (18090901) | Versão 16.0 |
| ExcelApi 1.7 | Com suporte | Versão 1801 (build 9001.2171) | Office 2019: Versão 1801 (Compilação 9001.2171) | Versão 16.9 (18011602) | Versão 16.0 |
| ExcelApi 1.6 | Com suporte | Versão 1704 (Compilação 8201.2001) | Office 2019: Versão 1704 (Compilação 8201.2001) | Versão 15.36 (17070200) | Versão 15.0 |
| ExcelApi 1.5 | Com suporte | Versão 1703 (Compilação 8067.2070) | Office 2019: Versão 1703 (Compilação 8067.2070) | Versão 15.36 (17070200) | Versão 15.0 |
| ExcelApi 1.4 | Com suporte | Versão 1701 (Compilação 7870.2024) | Office 2019: Versão 1701 (Compilação 7870.2024) | Versão 15.36 (17070200) | Versão 15.0 |
| ExcelApi 1.3 | Com suporte | Versão 1608 (Compilação 7369.2055) | Office 2019: Versão 1608 (Compilação 7369.2055) | Versão 15.27 | Versão 15.0 |
| ExcelApi 1.2 | Com suporte | Versão 1601 (Compilação 6741.2088) | Office 2019: Versão 1601 (Compilação 6741.2088) | Versão 15.22 | Versão 15.0 |
| ExcelApi 1.1 | Com suporte | Versão 1509 (Compilação 4266.1001) | Office 2016: Versão 1509 (Compilação 4266.1001) | Versão 15.20 | Versão 15.0 |
Versões do Office e números de build
Para saber mais sobre as versões do Office e os números de build, confira:
- Números de versão e compilação de lançamentos de canais de atualização para clientes do Microsoft 365
- Qual versão do Office estou usando?
Como usar os conjuntos de requisitos do Excel no tempo de execução e no manifesto
Observação
Esta seção pressupõe que você esteja familiarizado com a visão geral dos conjuntos de requisitos em Versões e conjuntos de requisitos do Office e Especificar aplicativos do Office e requisitos de API.
Os conjuntos de requisitos são grupos nomeados de membros da API. Um Suplemento do Office pode executar uma verificação de tempo de execução ou usar conjuntos de requisitos especificados no manifesto para determinar se um aplicativo do Office dá suporte às APIs necessárias ao suplemento.
Verificando o suporte ao conjunto de requisitos no tempo de execução
O exemplo de código a seguir mostra como determinar se o aplicativo do Office, onde o suplemento está em execução, dá suporte ao conjunto de requisitos da API especificado.
if (Office.context.requirements.isSetSupported('ExcelApi', '1.3')) {
// Perform actions.
}
else {
// Provide alternate flow/logic.
}
Definindo o suporte ao conjunto de requisitos no manifesto
Você pode usar o elemento Requirements no manifesto do suplemento para especificar os conjuntos de requisitos mínimos e/ou os métodos de API exigidos pelo suplemento para ser ativado. Se a plataforma ou o aplicativo do Office não for compatível com os conjuntos de requisitos ou métodos de API especificados no Requirements elemento do manifesto, o suplemento não será executado nesse aplicativo ou plataforma, e não será exibido na lista de suplementos mostrados no Meus suplementos. Se o seu suplemento exige um conjunto específico de requisitos para funcionalidade total, mas pode fornecer um valor mesmo para os usuários nas plataformas que não têm suporte para o conjunto de requisitos, recomendamos verificar o suporte a requisitos no tempo de execução conforme descrito acima, em vez de definir o suporte ao conjunto de requisitos no manifesto.
O exemplo de código a seguir mostra o elemento Requirements em um manifesto de suplemento que especifica se o suplemento deve ser carregado em todos os aplicativos cliente do Office que dão suporte ao conjunto de requisitos ExcelApi, versão 1.3 ou superior.
<Requirements>
<Sets DefaultMinVersion="1.3">
<Set Name="ExcelApi" MinVersion="1.3"/>
</Sets>
</Requirements>