Conjunto de requisitos somente online da API JavaScript do Word

O WordApiOnline conjunto de requisitos é um conjunto de requisitos especiais que inclui recursos disponíveis apenas para o Word na Web. As APIs nesse conjunto de requisitos são consideradas APIs de produção para o aplicativo Word na Web. Elas seguem as políticas de suporte para desenvolvedores do Microsoft 365. WordApiOnline As APIs são consideradas APIs de "visualização" para outras plataformas (Windows, Mac, iPad) e podem não ter suporte em nenhuma dessas plataformas.

Quando as WordApiOnline APIs no conjunto de requisitos tiverem suporte em todas as plataformas, elas serão adicionadas ao próximo conjunto de requisitos lançado (WordApi 1.[NEXT]). Depois que o novo conjunto de requisitos for público, essas APIs serão removidas do WordApiOnline. Pense nisso como um processo de promoção semelhante a uma API que passa da prévia para o lançamento.

Importante

WordApiOnline é um superconjunto do conjunto de requisitos numerados mais recente.

Importante

WordApiOnline 1.1 é a única versão das APIs somente online. Isso ocorre porque o Word na Web sempre terá uma única versão disponível para os usuários que seja a versão mais recente.

A tabela a seguir fornece um resumo conciso das APIs, enquanto a tabela de lista de APIs subsequente fornece uma lista detalhada das APIs atuais WordApiOnline .

Área de recurso Descrição Objetos relevantes
Nenhum

Como WordApiOnline as APIs só têm suporte do Word na Web, seu suplemento deve marcar se o conjunto de requisitos tem suporte antes de chamar essas APIs. Isso evita qualquer tentativa de usar APIs somente online em uma plataforma sem suporte.

if (Office.context.requirements.isSetSupported("WordApiOnline", "1.1")) {
   // Any API exclusive to the WordApiOnline requirement set.
}

Depois que a API estiver em um conjunto de requisitos de plataforma cruzada, você deverá remover ou editar a isSetSupported marcação. Isso habilitará o recurso do seu suplemento em outras plataformas. Certifique-se de testar o recurso nessas plataformas ao fazer essa alteração.

Importante

O manifesto somente do suplemento (XML) não pode especificar conjuntos de requisitos somente para área de trabalho ou somente online como requisitos de ativação. Não é um valor válido a ser usado no elemento Set. O manifesto unificado dá suporte a "requirements.capabilities" conjuntos de requisitos somente desktop na propriedade.

Lista de APIs

A tabela a seguir lista as APIs JavaScript do Word atualmente incluídas no WordApiOnline conjunto de requisitos. Para obter uma lista completa de todas as APIs JavaScript do Word (incluindo WordApiOnline APIs e APIs lançadas anteriormente), consulte todas as APIs JavaScript do Word.

Classe Campos Descrição

Confira também