Utilizzo di regole personalizzate

Panoramica delle regole personalizzate nell'estensione axe Expert

Se desideri che lo strumento axe Expert analizzi le pagine web e le applicazioni in base a regole specifiche per le esigenze specifiche della tua organizzazione, puoi farlo tramite la funzionalità Regole personalizzate nel Rules pannello. Facendo clic sulla voce di collegamento Regole nel menu principale di axe Expert (menu a discesa vicino al logo di axe Expert Extension nella parte superiore del riquadro sinistro) viene visualizzato un Rules pannello che offre un pulsante Aggiungi set di regole personalizzato per visualizzare un modulo nel riquadro di destra per l'invio di un set di regole personalizzate. Il modulo semplice è composto da due campi di immissione testo e da un pulsante di azione che consentono di impostare regole personalizzate che possono essere selezionate per l'esecuzione nel motore automatizzato quando una pagina caricata viene analizzata nel pannello Analizza.

Proprio come quando si analizza una pagina con i set di regole di axe Expert, i risultati mostreranno tutte le violazioni delle regole personalizzate rilevate, insieme alle informazioni specificate nel set di regole personalizzato (destinazione, origine HTML, riepilogo della correzione, collegamento alla guida Ulteriori informazioni, ecc.). Tutte le altre opzioni di azione disponibili con le regole standard si applicano anche alle violazioni delle regole personalizzate (Ispeziona, Evidenzia, Esporta, Carica, ecc.). È consentito un massimo di cinque set di regole personalizzati alla volta.

1. Pulsante Aggiungi un set di regole: nella Custom rulesets sezione del pannello sinistro del Rules pannello, un +Add a ruleset comando presenta un modulo nel riquadro destro per inviare un set di regole personalizzato.
2. Nome per regole personalizzate (solo alfanumerico): questo sarà il nome del ruleset che apparirà nella sezione Standard della scheda Impostazioni. È importante rispettare le convenzioni (caratteri alfanumerici, niente spazi) e assicurarsi che il nome sia significativo e facilmente riconoscibile come opzione di selezione.
3. Inserisci JSON istruzioni.textareaRules: JavaScript Object Notation (JSON) è lo standard basato su testo a cui il contenuto deve conformarsi per funzionare con l'estensione del browser per HTML 2.0 di Firefox. Per ulteriori informazioni, vedere Esempio sotto.
4. Pulsante SALVA E USA SET DI REGOLE : fa sì che le regole personalizzate diventino un'opzione selezionabile nel menu del riquadro della barra laterale sinistra del pannello Rules . Per ulteriori informazioni, vedere Seleziona un set di regole.

Esempio di regola personalizzata

Il codice di esempio seguente può fungere da esempio pratico di un file JSON di regole personalizzate di axe Expert formattato correttamente.

{
  "checks": [
    {
      "id": "test",
      "options": ["test"],
      "evaluate": "function() { return false; }",
      "metadata": {
        "impact": "minor",
        "messages": {
          "pass": "how did you pass",
          "fail": "there is no way to pass"
        }
      }
    }
  ],
  "rules": [
    {
      "id": "test",
      "metadata": {
        "description": "Will always fail",
        "help": "There is no way to make this pass! It is for testing",
        "helpUrl": "https://foo.com/bar"
      },
      "selector": "html",
      "any": [],
      "all": ["test"],
      "none": [],
      "tags": ["wcag2aa"]
    }
  ]
}

Set di regole personalizzati dai progetti di axe Monitor: dopo aver effettuato l'accesso ad axe Monitor e aver selezionato un progetto, tutti i set di regole personalizzati associati a tale progetto vengono caricati automaticamente nel pannello e resi disponibili per la selezione. Rules

Invia regole personalizzate

Per inviare regole personalizzate per un utilizzo futuro nell'estensione axe Expert, segui questi semplici passaggi. L'invio di regole personalizzate avviene specificando un nome per il set di regole per scopi di selezione futuri e incollando il contenuto del file di testo JSON formattato correttamente nei campi di immissione testo, quindi facendo clic su un pulsante per salvarle e utilizzarle.

Per inviare regole personalizzate:

1. Apri DevTools e seleziona axe Expert. Selezionare Regole dal menu principale di axe Expert.

2. Nel riquadro di sinistra, seleziona + Aggiungi un set di regole nella sezione Set di regole personalizzati del menu. Il modulo Set di regole viene visualizzato nel riquadro di destra.

3. Nel campo Nome delle regole personalizzate, immettere il nome alfanumerico desiderato, senza spazi.

   Questo apparirà nella sezione Set di regole personalizzate del riquadro sinistro del Rules pannello, quindi il nome dovrebbe essere significativo e facilmente riconoscibile per la selezione.

4. Nel campo Inserisci JSON, incolla il contenuto del file di testo .json delle regole personalizzate dagli appunti virtuali. Se lo desideri, trascina l'angolo inferiore destro del campo per aumentare l'area visibile.

5. Seleziona SAVE AND USE RULESET.

   

   Il nome immesso appare nella sezione Set di regole personalizzati nel riquadro di sinistra e nella parte superiore del riquadro di destra, nel campo Regolamento. Inoltre, nella parte inferiore del modulo, nel riquadro di destra, vengono visualizzati i pulsanti per eliminare o utilizzare il set di regole.

   Nel riquadro di destra, Seleziona Analyze now.

   ![Successo! Messaggio "Dati delle regole salvati" visualizzato in alto a destra negli strumenti per sviluppatori.(https://media.dequeuniversity.com/product-docs/axe-expert-extension/3.5/en/images/custom-ruleset-add-2.png)

   Il nome del set di regole personalizzato appare nel menu Regole della barra laterale sinistra, preceduto da un segno di spunta per indicare che si tratta del set di regole attualmente selezionato che verrà utilizzato durante l'esecuzione dell'analisi.

Analizza una pagina per violazioni delle regole di accessibilità

Per avviare un'analisi dell'accessibilità nell'estensione axe Expert, accedere al pannello Analizza e fare clic sul pulsante Analizza. Il processo di analisi produce un messaggio che indica il numero totale di violazioni delle regole di accessibilità rilevate nella pagina, nonché una sezione di risultati che mostra il numero totale di violazioni identificate. Attivando una riga nel riquadro dei risultati a sinistra, i dettagli vengono visualizzati nel riquadro dei contenuti principali a destra. Questa azione inizializza anche i pulsanti freccia Indietro e Avanti della violazione, che vengono visualizzati nella parte superiore del riquadro dei contenuti, consentendo di passare da una violazione all'altra per qualsiasi regola selezionata.

Analizza una pagina per violazioni delle regole:

1. Con la scheda Expert di Axe selezionata, seleziona Analizza nel menu principale nel riquadro di sinistra, a destra del logo dell'estensione Expert di Axe. Viene visualizzato il pannello Analizza.

2. Nel riquadro dei contenuti, attiva ANALYZE. A seconda di come hai agganciato gli strumenti per sviluppatori o ridimensionato la finestra del browser, questo si trova solitamente al centro del riquadro sinistro del pannello Analizza.

   Nel riquadro Analizza potrebbe essere visualizzato temporaneamente un messaggio di stato che dice Analyzing...please wait finché non viene completata l'analisi della pagina rispetto al set di regole selezionato.

   Sotto il logo di axe Expert Extension viene visualizzato il numero totale di violazioni rilevate, insieme al numero di problemi che richiedono una revisione manuale. Inoltre, a destra dei conteggi totali vengono visualizzati un menu contestuale a discesa e Run again un collegamento. Una tabella a due colonne mostra il nome abbreviato di ciascuna regola, mentre nella colonna di destra viene visualizzato il numero di violazioni rilevate per ciascuna regola, che si visualizza nel menu contestuale a discesa Mostra.

   

3. Nella sezione rules violated (riquadro a sinistra), fare clic su una riga rule .

   

   Il riquadro dei contenuti a destra viene aggiornato per visualizzare la prima violazione di quella regola. Nella visualizzazione del contenuto sono incluse le sezioni di informazioni Target, HTML e Summary (How to Fix the Problem) , insieme ai collegamenti Inspect e Highlight , un menu contestuale (che include le opzioni per Export, Scope, Upload e Download) e, in basso a destra, un pulsante con freccia espandibile verso sinistra per mostrare gli standard applicabili (set di regole) per la regola selezionata. Per informazioni più dettagliate su ciascun componente visualizzato nel riquadro dei contenuti relativi alla violazione delle regole, fare riferimento alle descrizioni nella panoramica fornita nell'argomento Analyze I pulsanti di navigazione delle violazioni precedente < e successiva > vengono visualizzati nella parte superiore del riquadro, consentendo di navigare tra le violazioni per la regola selezionata. Inoltre, il codice HTML pertinente contenente la violazione viene automaticamente evidenziato nella pagina testata.

4. Fare clic su Avanti (>) per passare alla violazione successiva della regola attualmente selezionata oppure selezionare una regola diversa dal pannello dei risultati delle regole violate a sinistra, come desiderato.

   

Rimuovere un set di regole personalizzato

Rimuovi un ruleset personalizzato dal pannello Rules quando non ti serve più un ruleset personalizzato. Selezionare la regola da eliminare nel pannello Rules e fare clic su un pulsante per eliminarla.

Se desideri riutilizzare parte del contenuto in un futuro ruleset personalizzato, assicurati di salvare il contenuto dal file JSON prima dell'eliminazione, poiché questa procedura comporta una rimozione permanente e irreversibile.

Per rimuovere un set di regole personalizzato:

1. Nella parte inferiore dell'elenco delle opzioni nella sezione Custom rulesets nel riquadro sinistro del pannello Rules , assicurati che il set che desideri rimuovere sia selezionato.
2. Clicca DELETE RULESET.

Il set viene rimosso dal menu del riquadro di sinistra e non è più disponibile per la selezione.