Utilizzo di Regole Personalizzate

Panoramica delle Regole Personalizzate nell'estensione axe Expert

Quando si desidera che lo strumento axe Expert analizzi pagine web e applicazioni in base a regole specifiche per le esigenze uniche della propria organizzazione, è possibile farlo con la funzionalità delle Regole Personalizzate nel pannello Rules. Facendo clic sull'elemento di collegamento Regole nel menu principale di axe Expert (menu a discesa vicino al logo dell'estensione axe Expert nella parte superiore del pannello sinistro) appare un pannello Rules che offre un pulsante Aggiungi serie di regole personalizzate per mostrare un modulo nel pannello destro per l'invio di un set di regole personalizzate. Il modulo semplice si compone di due campi di inserimento testo e un pulsante azione che consente di impostare regole personalizzate selezionabili per l'esecuzione nel motore automatizzato quando viene analizzata una pagina caricata nel pannello Analizza.

Proprio come analizzando una pagina con i set di regole di axe Expert, i risultati visualizzeranno eventuali violazioni delle tue regole personalizzate trovate, insieme alle informazioni specificate nel set di regole personalizzate (Target, sorgente HTML, Riassunto di Rimedi, collegamento di Maggiori Informazioni ecc.). Tutte le altre opzioni di azione disponibili con le regole standard si applicano anche alle violazioni delle tue regole personalizzate (Ispeziona, Evidenzia, Esporta, Carica, ecc.). C'è un limite di cinque set di regole personalizzate consentiti contemporaneamente.

1. Aggiungi pulsante serie di regole: Nella sezione Custom rulesets del pannello sinistro del pannello Rules, un comando +Add a ruleset ti presenta un modulo nel pannello destro per inviare un set di regole personalizzate.
2. Nome per Regole Personalizzate (solo alfanumerico): Questo sarà il nome del set di regole che apparirà nella sezione Standard della scheda Impostazioni. È importante seguire le convenzioni (alfanumerico, senza spazi) e assicurarsi che il nome sia significativo e facilmente riconoscibile come un'opzione di selezione.
3. Inserisci JSON rules.textareaInstructions: JavaScript Object Notation (JSON) è lo standard basato su testo a cui il contenuto deve conformarsi per funzionare con l'estensione del browser HTML 2.0 di Firefox. Per ulteriori informazioni, vedere Esempio qui sotto.
4. SALVA E USA SERIE DI REGOLE pulsante: Fa sì che le regole personalizzate diventino un'opzione selezionabile nel menu del pannello della barra laterale sinistra di Rules. Per ulteriori informazioni, vedere Seleziona un Set di Regole.

Esempio di Regola Personalizzata

Il codice di esempio che segue può servire da esempio funzionante di un file JSON di regola personalizzata formattato correttamente per axe Expert.

{
  "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 Personalizzate dai Progetti di axe Monitor: Dopo aver effettuato l'accesso a axe Monitor e selezionato un progetto, eventuali set di regole personalizzate associati a quel progetto vengono automaticamente caricati nel pannello Rules e resi disponibili per la selezione.

Invia regole personalizzate

Quando si desidera inviare regole personalizzate per utilizzi futuri nell'estensione axe Expert, seguire questi semplici passaggi. L'invio di regole personalizzate avviene specificando un nome per il set di regole per scopi di selezione futura, e incollando il contenuto del file di testo JSON formattato correttamente nei campi di inserimento testo, quindi facendo clic su un pulsante per salvarle e usarle.

Per inviare regole personalizzate:

1. Aprire DevTools e selezionare axe Expert. Selezionare Regole dal menu principale di axe Expert.

2. Nel pannello sinistro, selezionare + Aggiungi serie di regole nella sezione Set di regole personalizzate del menu. Il modulo Set di regole appare nel pannello destro.

3. Nel campo Nome delle Regole Personalizzate, inserire il nome alfanumerico desiderato senza spazi, come desiderato.

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

4. Nel campo Inserisci JSON, incolla il contenuto del tuo file di testo .json delle regole personalizzate dalla clipboard virtuale. Afferra e trascina l'angolo inferiore destro del campo per aumentare l'area visualizzabile, se desiderato.

5. Seleziona SAVE AND USE RULESET.

   

   Il nome inserito appare nella sezione dei set di regole personalizzate nel pannello sinistro, e appare in alto nel pannello destro, nel campo delle serie di regole. Inoltre, i pulsanti per eliminare o usare la serie di regole appaiono in fondo al modulo nel pannello destro.

   Nel pannello destro, selezionare Analyze now.

   

   Il nome del set di regole personalizzate appare nel menu Regole della barra laterale sinistra preceduto da un segno di spunta per indicare che è la serie di regole selezionata attualmente che verrà utilizzata durante l'analisi.

Analizza una pagina per Violazioni delle Regole di Accessibilità

Iniziare un'analisi di accessibilità nell'estensione axe Expert si fa navigando al pannello Analizza e poi cliccando sul pulsante Analizza. Il processo di analisi produce un messaggio che indica il numero totale di violazioni delle regole di accessibilità trovate sulla pagina, oltre a una sezione di risultati che visualizza le violazioni delle regole identificate e il numero totale di violazioni identificate. Attivare una riga nel pannello dei risultati a sinistra visualizza i dettagli nel pannello del contenuto principale a destra. Questa azione inoltre attiva i pulsanti freccia Violazione Precedente e Successiva che appaiono in cima al pannello del contenuto permettendoti di navigare da una violazione all'altra per qualsiasi regola selezionata.

Analizza una pagina per violazioni delle regole:

1. Con la scheda axe Expert selezionata, selezionare Analizza nel menu principale nel pannello sinistro a destra del logo dell'estensione axe Expert. Il pannello Analizza appare.

2. Nel pannello del contenuto, attiva ANALYZE. A seconda di come hai ancorato gli strumenti di sviluppo o ridimensionato la finestra del browser, questo si trova tipicamente al centro del pannello sinistro del pannello Analizza.

   Il pannello Analizza potrebbe mostrare temporaneamente un messaggio di stato che legge Analyzing...please wait fino a quando l'analisi della pagina contro il set di regole selezionato non è completa.

   Sotto il logo dell'estensione axe Expert, viene visualizzato il numero totale di violazioni trovate, insieme al numero di questioni che richiedono revisione manuale. Inoltre, un menu contestuale a discesa e un collegamento Run again vengono mostrati alla destra dei conteggi totali. Una tabella a due colonne che mostra il nome breve di ciascuna regola con la colonna destra che mostra il numero di violazioni trovate per ciascuna appare sotto il menu contestuale a discesa.

   

3. Nella sezione rules violated (pannello sinistro), clicca su una riga rule.

   

   Il pannello del contenuto 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 a Inspect e Highlight collegamenti, un menu contestuale (che include opzioni per Export, Scope, Upload e Download), e in fondo a destra un pulsante freccia che si espande a sinistra per mostrare gli Standard (set di regole) applicabili per la regola selezionata. Per informazioni più dettagliate su ciascun componente visualizzato nel pannello del contenuto delle violazioni delle regole, fare riferimento alle descrizioni nella panoramica fornita nell'argomento Analizza. I pulsanti di navigazione per le violazioni precedenti < e successive > appaiono in cima al pannello permettendoti di navigare tra le violazioni per la regola selezionata. Inoltre, l'HTML rilevante contenente la violazione viene automaticamente evidenziato sulla pagina testata.

4. Clicca Next (>) per navigare alla prossima violazione della regola attualmente selezionata, o seleziona una diversa regola dal pannello dei risultati delle regole violate a sinistra, come desiderato.

   

Rimuovere un insieme di regole personalizzate

Rimuovi un insieme di regole personalizzate dal pannello Rules quando non necessiti più di un insieme di regole personalizzate. Seleziona la regola da eliminare nel pannello Rules e clicca un pulsante per eliminare.

Se pensi di voler riutilizzare parte del contenuto in un futuro insieme di regole personalizzate, potresti voler essere sicuro di salvare il contenuto dal file JSON prima dell'eliminazione, poiché questa procedura porta a una rimozione permanente e irreversibile.

Per rimuovere un insieme di regole personalizzate:

1. In fondo all'elenco delle opzioni nella sezione Custom rulesets nel riquadro di sinistra del pannello Rules, assicurati che l'insieme che desideri rimuovere sia selezionato (attivo).
2. Clicca DELETE RULESET.

L'insieme viene rimosso dal menu del riquadro sinistro e non è più disponibile per la selezione.