diff --git a/ARIA/apg/patterns/accordion/accordion-pattern.md b/ARIA/apg/patterns/accordion/accordion-pattern.md index 7f4ad6bbd..67f8a7c17 100644 --- a/ARIA/apg/patterns/accordion/accordion-pattern.md +++ b/ARIA/apg/patterns/accordion/accordion-pattern.md @@ -80,9 +80,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

-
+
+

Example

Accordion Example: demonstrates a form divided into three sections using an accordion to show one section at a time.

diff --git a/ARIA/apg/patterns/accordion/examples/accordion.md b/ARIA/apg/patterns/accordion/examples/accordion.md index beb4e6d37..2ec8428da 100644 --- a/ARIA/apg/patterns/accordion/examples/accordion.md +++ b/ARIA/apg/patterns/accordion/examples/accordion.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/accordion/examples/accordion/ sidebar: true -footer: " " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -65,6 +65,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

Read This First

+

Read This First

The code in this example is not intended for production environments. @@ -93,10 +94,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
-

About This Example

+

About This Example

+

The below example section contains a simple personal information input form divided into 3 sections that demonstrates the Accordion Pattern.

diff --git a/ARIA/apg/patterns/alert/alert-pattern.md b/ARIA/apg/patterns/alert/alert-pattern.md index f2a259fdd..20830a675 100644 --- a/ARIA/apg/patterns/alert/alert-pattern.md +++ b/ARIA/apg/patterns/alert/alert-pattern.md @@ -81,9 +81,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

-
+
+

Example

Alert Example

diff --git a/ARIA/apg/patterns/alert/examples/alert.md b/ARIA/apg/patterns/alert/examples/alert.md index d2e78d523..a20e8d18d 100644 --- a/ARIA/apg/patterns/alert/examples/alert.md +++ b/ARIA/apg/patterns/alert/examples/alert.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/alert/examples/alert/ sidebar: true -footer: " " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -69,6 +69,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

Read This First

+

Read This First

The code in this example is not intended for production environments. @@ -97,10 +98,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
-

About This Example

+

About This Example

+

The below example demonstrates the Alert Pattern. Activating the Trigger Alert button causes a message to be inserted into the example alert element. diff --git a/ARIA/apg/patterns/alertdialog/alertdialog-pattern.md b/ARIA/apg/patterns/alertdialog/alertdialog-pattern.md index 8c66ba215..227b5467c 100644 --- a/ARIA/apg/patterns/alertdialog/alertdialog-pattern.md +++ b/ARIA/apg/patterns/alertdialog/alertdialog-pattern.md @@ -69,9 +69,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

-
+
+

Example

Alert Dialog Example: A confirmation prompt that demonstrates an alert dialog.

diff --git a/ARIA/apg/patterns/alertdialog/examples/alertdialog.md b/ARIA/apg/patterns/alertdialog/examples/alertdialog.md index a69b9ebf8..450cfe4a7 100644 --- a/ARIA/apg/patterns/alertdialog/examples/alertdialog.md +++ b/ARIA/apg/patterns/alertdialog/examples/alertdialog.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/alertdialog/examples/alertdialog/ sidebar: true -footer: " " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -67,6 +67,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

Read This First

+

Read This First

The code in this example is not intended for production environments. @@ -95,10 +96,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
-

About This Example

+

About This Example

+

The below example of a confirmation prompt demonstrates the Alert Dialog Pattern. It also includes an example of the Alert Pattern to make comparing the experiences provided by the two patterns easy. diff --git a/ARIA/apg/patterns/breadcrumb/breadcrumb-pattern.md b/ARIA/apg/patterns/breadcrumb/breadcrumb-pattern.md index 64edb83de..05f50cfa1 100644 --- a/ARIA/apg/patterns/breadcrumb/breadcrumb-pattern.md +++ b/ARIA/apg/patterns/breadcrumb/breadcrumb-pattern.md @@ -69,9 +69,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

-
+
+

Example

Breadcrumb design pattern example

diff --git a/ARIA/apg/patterns/breadcrumb/examples/breadcrumb.md b/ARIA/apg/patterns/breadcrumb/examples/breadcrumb.md index c99aeb3a9..075660a08 100644 --- a/ARIA/apg/patterns/breadcrumb/examples/breadcrumb.md +++ b/ARIA/apg/patterns/breadcrumb/examples/breadcrumb.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/breadcrumb/examples/breadcrumb/ sidebar: true -footer: " " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -65,6 +65,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

Read This First

+

Read This First

The code in this example is not intended for production environments. @@ -93,10 +94,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
-

About This Example

+

About This Example

+

The following example demonstrates the Breadcrumb Pattern.

diff --git a/ARIA/apg/patterns/button/button-pattern.md b/ARIA/apg/patterns/button/button-pattern.md index 05a4decd8..fe26dada7 100644 --- a/ARIA/apg/patterns/button/button-pattern.md +++ b/ARIA/apg/patterns/button/button-pattern.md @@ -90,9 +90,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
-
+
+

Examples

  • Button Examples: Examples of clickable HTML div and span elements made into accessible command and toggle buttons.
  • diff --git a/ARIA/apg/patterns/button/examples/button.md b/ARIA/apg/patterns/button/examples/button.md index 7ad3a0ff9..967b8a7f6 100644 --- a/ARIA/apg/patterns/button/examples/button.md +++ b/ARIA/apg/patterns/button/examples/button.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/button/examples/button/ sidebar: true -footer: " " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -66,6 +66,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

    Read This First

    +

    Read This First

    The code in this example is not intended for production environments. @@ -95,10 +96,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
    -

    About This Example

    +

    About This Example

    +

    The following command and toggle button examples demonstrate the Button Pattern.

    Similar examples include:

      diff --git a/ARIA/apg/patterns/button/examples/button_idl.md b/ARIA/apg/patterns/button/examples/button_idl.md index 490736efc..d022b9257 100644 --- a/ARIA/apg/patterns/button/examples/button_idl.md +++ b/ARIA/apg/patterns/button/examples/button_idl.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/button/examples/button_idl/ sidebar: true -footer: " " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -66,6 +66,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

      Read This First

      +

      Read This First

      The code in this example is not intended for production environments. @@ -96,6 +97,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

      About This example

      +

      The following examples of the Button Pattern demonstrate a new JavaScript syntax for coding ARIA attributes.

      The JavaScript for the example buttons on this page uses the IDL Interface defined in ARIA 1.2. @@ -121,10 +123,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar'); browser that does not yet provide support for ARIA attribute reflection, the buttons will not be styled correctly.

      - +

      This Print action button uses a div element.

      Print Page
      diff --git a/ARIA/apg/patterns/carousel/carousel-pattern.md b/ARIA/apg/patterns/carousel/carousel-pattern.md index bf7a66c4b..b23f0e162 100644 --- a/ARIA/apg/patterns/carousel/carousel-pattern.md +++ b/ARIA/apg/patterns/carousel/carousel-pattern.md @@ -97,9 +97,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
    -
    +
    +

    Examples

    • Auto-Rotating Image Carousel with Buttons for Slide Control: A basic image carousel that demonstrates the accessibility features necessary for carousels that rotate automatically on page load and also enables users to choose which slide is displayed with buttons for previous and next slide.
    • diff --git a/ARIA/apg/patterns/carousel/examples/carousel-1-prev-next.md b/ARIA/apg/patterns/carousel/examples/carousel-1-prev-next.md index 27c883a51..ee336f8e1 100644 --- a/ARIA/apg/patterns/carousel/examples/carousel-1-prev-next.md +++ b/ARIA/apg/patterns/carousel/examples/carousel-1-prev-next.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/carousel/examples/carousel-1-prev-next/ sidebar: true -footer: " " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -68,6 +68,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

      Read This First

      +

      Read This First

      The code in this example is not intended for production environments. @@ -96,10 +97,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
      -

      About This Example

      +

      About This Example

      +

      The following example implementation of the Carousel Pattern demonstrates features of the pattern that are essential to accessibility for carousels that automatically start rotating when the page loads. For instance, rotation stops when users either move focus into the carousel or hover the mouse over carousel content, and users can manually control which slide is displayed with previous and next slide buttons. diff --git a/ARIA/apg/patterns/carousel/examples/carousel-2-tablist.md b/ARIA/apg/patterns/carousel/examples/carousel-2-tablist.md index 7dffc906d..d3d0cb379 100644 --- a/ARIA/apg/patterns/carousel/examples/carousel-2-tablist.md +++ b/ARIA/apg/patterns/carousel/examples/carousel-2-tablist.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/carousel/examples/carousel-2-tablist/ sidebar: true -footer: "

      " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -66,6 +66,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

      Read This First

      +

      Read This First

      The code in this example is not intended for production environments. @@ -94,10 +95,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
      -

      About This Example

      +

      About This Example

      +

      The following example implementation of the Carousel Pattern demonstrates features of the pattern that are essential to accessibility for carousels that automatically start rotating when the page loads. This example also illustrates how to use the tabs pattern to provide users with a way to skip slides in the sequence by directly choosing which one to view. diff --git a/ARIA/apg/patterns/checkbox/checkbox-pattern.md b/ARIA/apg/patterns/checkbox/checkbox-pattern.md index 69c0fb460..2dbabed66 100644 --- a/ARIA/apg/patterns/checkbox/checkbox-pattern.md +++ b/ARIA/apg/patterns/checkbox/checkbox-pattern.md @@ -83,9 +83,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

    -
    +
    +

    Examples

    • Checkbox (Two-State) Example: Demonstrates a simple 2-state checkbox.
    • diff --git a/ARIA/apg/patterns/checkbox/examples/checkbox-mixed.md b/ARIA/apg/patterns/checkbox/examples/checkbox-mixed.md index 217051e7e..03b70c3ae 100644 --- a/ARIA/apg/patterns/checkbox/examples/checkbox-mixed.md +++ b/ARIA/apg/patterns/checkbox/examples/checkbox-mixed.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/checkbox/examples/checkbox-mixed/ sidebar: true -footer: " " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -66,6 +66,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

      Read This First

      +

      Read This First

      The code in this example is not intended for production environments. @@ -94,10 +95,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
      -

      About This Example

      +

      About This Example

      +

      This example demonstrates using the Checkbox Pattern to create a tri-state, or mixed-state, checkbox. In this implementation, the mixed-state checkbox represents the state of a set of standard HTML checkboxes. diff --git a/ARIA/apg/patterns/checkbox/examples/checkbox.md b/ARIA/apg/patterns/checkbox/examples/checkbox.md index f9682aff1..da76c4c55 100644 --- a/ARIA/apg/patterns/checkbox/examples/checkbox.md +++ b/ARIA/apg/patterns/checkbox/examples/checkbox.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/checkbox/examples/checkbox/ sidebar: true -footer: "

      " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -66,6 +66,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

      Read This First

      +

      Read This First

      The code in this example is not intended for production environments. @@ -94,10 +95,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
      -

      About This Example

      +

      About This Example

      +

      This example implements the Checkbox Pattern for a two state checkbox using div elements.

      Similar examples include:

      diff --git a/ARIA/apg/patterns/combobox/combobox-pattern.md b/ARIA/apg/patterns/combobox/combobox-pattern.md index 718a5d967..888e772e1 100644 --- a/ARIA/apg/patterns/combobox/combobox-pattern.md +++ b/ARIA/apg/patterns/combobox/combobox-pattern.md @@ -143,9 +143,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

      -
      +
      +

      Examples

      • Select-Only Combobox: A single-select combobox with no text input that is functionally similar to an HTML select element.
      • diff --git a/ARIA/apg/patterns/combobox/examples/combobox-autocomplete-both.md b/ARIA/apg/patterns/combobox/examples/combobox-autocomplete-both.md index 6b763323f..83fca7d78 100644 --- a/ARIA/apg/patterns/combobox/examples/combobox-autocomplete-both.md +++ b/ARIA/apg/patterns/combobox/examples/combobox-autocomplete-both.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/combobox/examples/combobox-autocomplete-both/ sidebar: true -footer: " " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -66,6 +66,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

        Read This First

        +

        Read This First

        The code in this example is not intended for production environments. @@ -94,10 +95,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
        -

        About This Example

        +

        About This Example

        +

        The below combobox for choosing the name of a US state or territory demonstrates the Combobox Pattern. The design pattern describes four types of autocomplete behavior. diff --git a/ARIA/apg/patterns/combobox/examples/combobox-autocomplete-list.md b/ARIA/apg/patterns/combobox/examples/combobox-autocomplete-list.md index c0872733f..1b639023b 100644 --- a/ARIA/apg/patterns/combobox/examples/combobox-autocomplete-list.md +++ b/ARIA/apg/patterns/combobox/examples/combobox-autocomplete-list.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/combobox/examples/combobox-autocomplete-list/ sidebar: true -footer: "

        " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -66,6 +66,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

        Read This First

        +

        Read This First

        The code in this example is not intended for production environments. @@ -94,10 +95,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
        -

        About This Example

        +

        About This Example

        +

        The below combobox for choosing the name of a US state or territory demonstrates the Combobox Pattern. The design pattern describes four types of autocomplete behavior. diff --git a/ARIA/apg/patterns/combobox/examples/combobox-autocomplete-none.md b/ARIA/apg/patterns/combobox/examples/combobox-autocomplete-none.md index 47409e19d..0a7602983 100644 --- a/ARIA/apg/patterns/combobox/examples/combobox-autocomplete-none.md +++ b/ARIA/apg/patterns/combobox/examples/combobox-autocomplete-none.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/combobox/examples/combobox-autocomplete-none/ sidebar: true -footer: "

        " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -66,6 +66,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

        Read This First

        +

        Read This First

        The code in this example is not intended for production environments. @@ -94,10 +95,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
        -

        About This Example

        +

        About This Example

        +

        The below combobox that enables users to choose a term from a hypothetical list of previously searched terms demonstrates the Combobox Pattern. The design pattern describes four types of autocomplete behavior. diff --git a/ARIA/apg/patterns/combobox/examples/combobox-datepicker.md b/ARIA/apg/patterns/combobox/examples/combobox-datepicker.md index 491116275..54d6a6829 100644 --- a/ARIA/apg/patterns/combobox/examples/combobox-datepicker.md +++ b/ARIA/apg/patterns/combobox/examples/combobox-datepicker.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/combobox/examples/combobox-datepicker/ sidebar: true -footer: "

        " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -72,6 +72,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

        Read This First

        +

        Read This First

        The code in this example is not intended for production environments. @@ -100,10 +101,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
        -

        About This Example

        +

        About This Example

        +

        The below date picker demonstrates an implementation of the Combobox Pattern that opens a dialog. The date picker dialog is opened by activating the choose date button or by moving keyboard focus to the combobox and pressing Down Arrow or Alt + Down Arrow. diff --git a/ARIA/apg/patterns/combobox/examples/combobox-select-only.md b/ARIA/apg/patterns/combobox/examples/combobox-select-only.md index f3213e345..e94dfb5f6 100644 --- a/ARIA/apg/patterns/combobox/examples/combobox-select-only.md +++ b/ARIA/apg/patterns/combobox/examples/combobox-select-only.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/combobox/examples/combobox-select-only/ sidebar: true -footer: "

        " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -66,6 +66,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

        Read This First

        +

        Read This First

        The code in this example is not intended for production environments. @@ -94,10 +95,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
        -

        About This Example

        +

        About This Example

        +

        The following example implementation of the Combobox Pattern demonstrates a single-select combobox widget that is functionally similar to an HTML select element. Unlike the editable combobox examples, this select-only combobox is not made with an <input> element, and it does not accept freeform user input. diff --git a/ARIA/apg/patterns/combobox/examples/grid-combo.md b/ARIA/apg/patterns/combobox/examples/grid-combo.md index 7e6377520..24b7c95e7 100644 --- a/ARIA/apg/patterns/combobox/examples/grid-combo.md +++ b/ARIA/apg/patterns/combobox/examples/grid-combo.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/combobox/examples/grid-combo/ sidebar: true -footer: "

        " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -68,6 +68,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

        Read This First

        +

        Read This First

        The code in this example is not intended for production environments. @@ -96,10 +97,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
        -

        About This Example

        +

        About This Example

        +

        The following example combobox implements the combobox pattern using a grid for the suggested values popup.

        diff --git a/ARIA/apg/patterns/dialog-modal/dialog-modal-pattern.md b/ARIA/apg/patterns/dialog-modal/dialog-modal-pattern.md index 25f04db0d..28809d303 100644 --- a/ARIA/apg/patterns/dialog-modal/dialog-modal-pattern.md +++ b/ARIA/apg/patterns/dialog-modal/dialog-modal-pattern.md @@ -79,9 +79,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

        -
        +
        +

        Examples

        • Modal Dialog Example: Demonstrates multiple layers of modal dialogs with both small and large amounts of content.
        • diff --git a/ARIA/apg/patterns/dialog-modal/examples/datepicker-dialog.md b/ARIA/apg/patterns/dialog-modal/examples/datepicker-dialog.md index 7c38f70f9..75dc68989 100644 --- a/ARIA/apg/patterns/dialog-modal/examples/datepicker-dialog.md +++ b/ARIA/apg/patterns/dialog-modal/examples/datepicker-dialog.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/dialog-modal/examples/datepicker-dialog/ sidebar: true -footer: " " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -72,6 +72,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

          Read This First

          +

          Read This First

          The code in this example is not intended for production environments. @@ -100,10 +101,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
          -

          About This Example

          +

          About This Example

          +

          The example below includes a date input field and a button that opens a date picker that implements the Dialog (Modal) Pattern. The dialog contains a calendar that uses the grid pattern to present buttons that enable the user to choose a day from the calendar. diff --git a/ARIA/apg/patterns/dialog-modal/examples/dialog.md b/ARIA/apg/patterns/dialog-modal/examples/dialog.md index aee446fcc..2b45bbf50 100644 --- a/ARIA/apg/patterns/dialog-modal/examples/dialog.md +++ b/ARIA/apg/patterns/dialog-modal/examples/dialog.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/dialog-modal/examples/dialog/ sidebar: true -footer: "

          " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -67,6 +67,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

          Read This First

          +

          Read This First

          The code in this example is not intended for production environments. @@ -95,10 +96,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
          -

          About This Example

          +

          About This Example

          +

          Following is an example implementation of the Dialog (Modal) Pattern. The below Add Delivery Address button opens a modal dialog that contains two buttons that open other dialogs. diff --git a/ARIA/apg/patterns/disclosure/disclosure-pattern.md b/ARIA/apg/patterns/disclosure/disclosure-pattern.md index d35de64ec..6c6c371fe 100644 --- a/ARIA/apg/patterns/disclosure/disclosure-pattern.md +++ b/ARIA/apg/patterns/disclosure/disclosure-pattern.md @@ -70,9 +70,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

          -
          +
          +

          Examples

          • Disclosure (Show/Hide) of Image Description
          • diff --git a/ARIA/apg/patterns/disclosure/examples/disclosure-faq.md b/ARIA/apg/patterns/disclosure/examples/disclosure-faq.md index 5f201761d..ab748fbe1 100644 --- a/ARIA/apg/patterns/disclosure/examples/disclosure-faq.md +++ b/ARIA/apg/patterns/disclosure/examples/disclosure-faq.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/disclosure/examples/disclosure-faq/ sidebar: true -footer: " " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -68,6 +68,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

            Read This First

            +

            Read This First

            The code in this example is not intended for production environments. @@ -96,10 +97,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
            -

            About This Example

            +

            About This Example

            +

            The following example demonstrates using the Disclosure Pattern to create a set of frequently asked questions where the answers may be independently shown or hidden.

            diff --git a/ARIA/apg/patterns/disclosure/examples/disclosure-image-description.md b/ARIA/apg/patterns/disclosure/examples/disclosure-image-description.md index fee070ceb..31ca737d2 100644 --- a/ARIA/apg/patterns/disclosure/examples/disclosure-image-description.md +++ b/ARIA/apg/patterns/disclosure/examples/disclosure-image-description.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/disclosure/examples/disclosure-image-description/ sidebar: true -footer: " " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -66,6 +66,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

            Read This First

            +

            Read This First

            The code in this example is not intended for production environments. @@ -94,10 +95,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
            -

            About This Example

            +

            About This Example

            +

            The following example demonstrates using the Disclosure Pattern to provide a way of revealing a table of data that complements an image.

            diff --git a/ARIA/apg/patterns/disclosure/examples/disclosure-navigation-hybrid.md b/ARIA/apg/patterns/disclosure/examples/disclosure-navigation-hybrid.md index 41ce85325..7356d6d89 100644 --- a/ARIA/apg/patterns/disclosure/examples/disclosure-navigation-hybrid.md +++ b/ARIA/apg/patterns/disclosure/examples/disclosure-navigation-hybrid.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/disclosure/examples/disclosure-navigation-hybrid/ sidebar: true -footer: " " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -66,6 +66,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

            Read This First

            +

            Read This First

            The code in this example is not intended for production environments. @@ -103,11 +104,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar'); Typical site navigation does not need all the keyboard interactions specified by the menu and menubar pattern.

            - - + +

            The following example demonstrates using the Disclosure Pattern to show and hide dropdown lists of links in a navigation bar for a mythical university web site. Unlike the other disclosure navigation menu example, this example includes top-level links alongside the disclosure buttons. diff --git a/ARIA/apg/patterns/disclosure/examples/disclosure-navigation.md b/ARIA/apg/patterns/disclosure/examples/disclosure-navigation.md index 64283cbc7..2dd69b421 100644 --- a/ARIA/apg/patterns/disclosure/examples/disclosure-navigation.md +++ b/ARIA/apg/patterns/disclosure/examples/disclosure-navigation.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/disclosure/examples/disclosure-navigation/ sidebar: true -footer: "

            " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -66,6 +66,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

            Read This First

            +

            Read This First

            The code in this example is not intended for production environments. @@ -103,10 +104,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar'); Typical site navigation does not need all the keyboard interactions specified by the menu and menubar pattern.

            - + +

            The following example demonstrates using the Disclosure Pattern to show and hide dropdown lists of links in a navigation bar for a mythical university web site. Each disclosure button represents a section of the web site, and expanding it shows a list of links to pages within that section. diff --git a/ARIA/apg/patterns/feed/examples/feed.md b/ARIA/apg/patterns/feed/examples/feed.md index 82a8776d1..3f410b750 100644 --- a/ARIA/apg/patterns/feed/examples/feed.md +++ b/ARIA/apg/patterns/feed/examples/feed.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/feed/examples/feed/ sidebar: true -footer: "

            " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -60,6 +60,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

            Read This First

            +

            Read This First

            The code in this example is not intended for production environments. @@ -88,10 +89,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
            -

            About This Example

            +

            About This Example

            +

            NOTE: The feed role is a new WAI-ARIA feature, introduced by WAI-ARIA 1.1. This page provides a proposed implementation of a feed component. diff --git a/ARIA/apg/patterns/feed/feed-pattern.md b/ARIA/apg/patterns/feed/feed-pattern.md index 39ea59724..c9a4d65b4 100644 --- a/ARIA/apg/patterns/feed/feed-pattern.md +++ b/ARIA/apg/patterns/feed/feed-pattern.md @@ -105,9 +105,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

            -
            +
            +

            Example

            Example Implementation of Feed Pattern diff --git a/ARIA/apg/patterns/grid/examples/advanced-data-grid.md b/ARIA/apg/patterns/grid/examples/advanced-data-grid.md index 6b282ddaf..6f754c37a 100644 --- a/ARIA/apg/patterns/grid/examples/advanced-data-grid.md +++ b/ARIA/apg/patterns/grid/examples/advanced-data-grid.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/grid/examples/advanced-data-grid/ sidebar: true -footer: "

            " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -73,6 +73,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

            Read This First

            +

            Read This First

            The code in this example is not intended for production environments. @@ -101,10 +102,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
            -

            About This Example

            +

            About This Example

            +

            This example has not yet been developed. Development is described in issue 155. diff --git a/ARIA/apg/patterns/grid/examples/data-grids.md b/ARIA/apg/patterns/grid/examples/data-grids.md index 3dc9a8ab9..b5c975e14 100644 --- a/ARIA/apg/patterns/grid/examples/data-grids.md +++ b/ARIA/apg/patterns/grid/examples/data-grids.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/grid/examples/data-grids/ sidebar: true -footer: "

            " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -73,6 +73,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

            Read This First

            +

            Read This First

            The code in this example is not intended for production environments. @@ -101,10 +102,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
            -

            About This Example

            +

            About This Example

            +

            Following are three example implementations of the Grid Pattern that demonstrate the keyboard interactions and ARIA features that enable accessible, interactive presentation of tabular information. Each of the following three grids presents a set of financial transactions. diff --git a/ARIA/apg/patterns/grid/examples/layout-grids.md b/ARIA/apg/patterns/grid/examples/layout-grids.md index 94bbbc738..bf558439e 100644 --- a/ARIA/apg/patterns/grid/examples/layout-grids.md +++ b/ARIA/apg/patterns/grid/examples/layout-grids.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/grid/examples/layout-grids/ sidebar: true -footer: "

            " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -68,6 +68,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

            Read This First

            +

            Read This First

            The code in this example is not intended for production environments. @@ -96,10 +97,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
            -

            About This Example

            +

            About This Example

            +

            The following examples demonstrate how the Grid Pattern can be used to group a collection of interactive widgets into a single tab stop. In these examples, each widget, such as a link or button, is in a separate cell of the grid, and the user can navigate between them with the arrow keys. diff --git a/ARIA/apg/patterns/grid/grid-pattern.md b/ARIA/apg/patterns/grid/grid-pattern.md index 5ecd923e8..2c321243f 100644 --- a/ARIA/apg/patterns/grid/grid-pattern.md +++ b/ARIA/apg/patterns/grid/grid-pattern.md @@ -95,9 +95,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

            -
            +
            +

            Examples

            • Layout Grid Examples: Three example implementations of grids that are used to lay out widgets, including a collection of navigation links, a message recipients list, and a set of search results.
            • diff --git a/ARIA/apg/patterns/landmarks/examples/general-principles.html b/ARIA/apg/patterns/landmarks/examples/general-principles.html index f2db7214a..76975b01c 100644 --- a/ARIA/apg/patterns/landmarks/examples/general-principles.html +++ b/ARIA/apg/patterns/landmarks/examples/general-principles.html @@ -84,6 +84,11 @@

              General Principles

            • Landmark roles can be nested to identify parent/child relationships of the information being presented.
            • +
            • + Note that wrapping the content of a modal dialog in a landmark region is unnecessary. + A landmark that wraps modal content cannot provide any benefit to users because it is not perceivable unless the modal is open. + In addition, when a modal is open, a landmark containing its content is superfluous because the modal itself is a container that provides both a name and boundaries. +

            Step 3: Label each area

            diff --git a/ARIA/apg/patterns/landmarks/landmarks-pattern.md b/ARIA/apg/patterns/landmarks/landmarks-pattern.md index 7b1096366..e9315f7a4 100644 --- a/ARIA/apg/patterns/landmarks/landmarks-pattern.md +++ b/ARIA/apg/patterns/landmarks/landmarks-pattern.md @@ -80,9 +80,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

            -
            +
            +

            Examples

            • Main Landmark Example
            • diff --git a/ARIA/apg/patterns/link/examples/link.md b/ARIA/apg/patterns/link/examples/link.md index 5a55c20a1..6311881d0 100644 --- a/ARIA/apg/patterns/link/examples/link.md +++ b/ARIA/apg/patterns/link/examples/link.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/link/examples/link/ sidebar: true -footer: " " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -66,6 +66,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

              Read This First

              +

              Read This First

              The code in this example is not intended for production environments. @@ -94,10 +95,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
              -

              About This Example

              +

              About This Example

              +

              The examples below demonstrate three variations of the Link Pattern. The link pattern is used when it is necessary for elements other than the HTML a element to have link behaviors. diff --git a/ARIA/apg/patterns/link/link-pattern.md b/ARIA/apg/patterns/link/link-pattern.md index e6cb9546f..5851d1dd7 100644 --- a/ARIA/apg/patterns/link/link-pattern.md +++ b/ARIA/apg/patterns/link/link-pattern.md @@ -74,9 +74,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

              -
              +
              +

              Examples

              Link Examples: Link widgets constructed from HTML span and img elements.

              diff --git a/ARIA/apg/patterns/listbox/examples/listbox-collapsible.md b/ARIA/apg/patterns/listbox/examples/listbox-collapsible.md index 1df9cb988..134b771c9 100644 --- a/ARIA/apg/patterns/listbox/examples/listbox-collapsible.md +++ b/ARIA/apg/patterns/listbox/examples/listbox-collapsible.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/listbox/examples/listbox-collapsible/ sidebar: true -footer: " " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -67,6 +67,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

              Read This First

              +

              Read This First

              The code in this example is not intended for production environments. @@ -102,10 +103,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar'); This pattern has been deprecated, and will be removed in a future version of the ARIA Authoring Practices. The select-only combobox should be used as an alternative to this pattern.

              - + +

              The following example implementation of the Listbox Pattern demonstrates a collapsible single-select listbox widget that is functionally similar to an HTML select input with the attribute size="1". The widget consists of a button that triggers the display of a listbox. diff --git a/ARIA/apg/patterns/listbox/examples/listbox-grouped.md b/ARIA/apg/patterns/listbox/examples/listbox-grouped.md index 41e0e5c17..95cefcb1b 100644 --- a/ARIA/apg/patterns/listbox/examples/listbox-grouped.md +++ b/ARIA/apg/patterns/listbox/examples/listbox-grouped.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/listbox/examples/listbox-grouped/ sidebar: true -footer: "

              " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -67,6 +67,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

              Read This First

              +

              Read This First

              The code in this example is not intended for production environments. @@ -95,10 +96,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
              -

              About This Example

              +

              About This Example

              +

              The following example implementation of the Listbox Pattern demonstrates a single-select listbox widget with grouped options. This widget is functionally similar to an HTML select element with size greater than 1 and options grouped into categories with labeled optgroup elements. diff --git a/ARIA/apg/patterns/listbox/examples/listbox-rearrangeable.md b/ARIA/apg/patterns/listbox/examples/listbox-rearrangeable.md index c219ca4f0..f614027f5 100644 --- a/ARIA/apg/patterns/listbox/examples/listbox-rearrangeable.md +++ b/ARIA/apg/patterns/listbox/examples/listbox-rearrangeable.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/listbox/examples/listbox-rearrangeable/ sidebar: true -footer: "

              " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -68,6 +68,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

              Read This First

              +

              Read This First

              The code in this example is not intended for production environments. @@ -96,10 +97,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
              -

              About This Example

              +

              About This Example

              +

              The following two example implementations of the Listbox Pattern demonstrate differences between single-select and multi-select functionality. In both examples, users can use action buttons to move options from one list to another. diff --git a/ARIA/apg/patterns/listbox/examples/listbox-scrollable.md b/ARIA/apg/patterns/listbox/examples/listbox-scrollable.md index 4890e5c9f..353644f15 100644 --- a/ARIA/apg/patterns/listbox/examples/listbox-scrollable.md +++ b/ARIA/apg/patterns/listbox/examples/listbox-scrollable.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/listbox/examples/listbox-scrollable/ sidebar: true -footer: "

              " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -67,6 +67,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

              Read This First

              +

              Read This First

              The code in this example is not intended for production environments. @@ -95,10 +96,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
              -

              About This Example

              +

              About This Example

              +

              The following example implementation of the Listbox Pattern demonstrates a scrollable single-select listbox widget. This widget is functionally similar to an HTML select input where the size attribute has a value greater than one. diff --git a/ARIA/apg/patterns/listbox/listbox-pattern.md b/ARIA/apg/patterns/listbox/listbox-pattern.md index c08d2224c..466f6887c 100644 --- a/ARIA/apg/patterns/listbox/listbox-pattern.md +++ b/ARIA/apg/patterns/listbox/listbox-pattern.md @@ -90,9 +90,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

              -
              +
              +

              Examples

              • Scrollable Listbox Example: Single-select listbox that scrolls to reveal more options, similar to HTML select with size attribute greater than one.
              • diff --git a/ARIA/apg/patterns/menu-button/examples/menu-button-actions-active-descendant.md b/ARIA/apg/patterns/menu-button/examples/menu-button-actions-active-descendant.md index 91331573a..e8b9c696d 100644 --- a/ARIA/apg/patterns/menu-button/examples/menu-button-actions-active-descendant.md +++ b/ARIA/apg/patterns/menu-button/examples/menu-button-actions-active-descendant.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/menu-button/examples/menu-button-actions-active-de sidebar: true -footer: " " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -66,6 +66,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

                Read This First

                +

                Read This First

                The code in this example is not intended for production environments. @@ -94,10 +95,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
                -

                About This Example

                +

                About This Example

                +

                This example demonstrates how the Menu Button Pattern can be used to create a button that opens an actions menu. In this example, choosing an action from the menu will cause the chosen action to be displayed in the Last Action edit box. diff --git a/ARIA/apg/patterns/menu-button/examples/menu-button-actions.md b/ARIA/apg/patterns/menu-button/examples/menu-button-actions.md index efc2bd7b0..98c318495 100644 --- a/ARIA/apg/patterns/menu-button/examples/menu-button-actions.md +++ b/ARIA/apg/patterns/menu-button/examples/menu-button-actions.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/menu-button/examples/menu-button-actions/ sidebar: true -footer: "

                " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -66,6 +66,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

                Read This First

                +

                Read This First

                The code in this example is not intended for production environments. @@ -94,10 +95,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
                -

                About This Example

                +

                About This Example

                +

                This example demonstrates how the Menu Button Pattern can be used to create a button that opens an actions menu. In this example, choosing an action from the menu will cause the chosen action to be displayed in the Last Action edit box. diff --git a/ARIA/apg/patterns/menu-button/examples/menu-button-links.md b/ARIA/apg/patterns/menu-button/examples/menu-button-links.md index d926553f2..8c257be56 100644 --- a/ARIA/apg/patterns/menu-button/examples/menu-button-links.md +++ b/ARIA/apg/patterns/menu-button/examples/menu-button-links.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/menu-button/examples/menu-button-links/ sidebar: true -footer: "

                " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -66,6 +66,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

                Read This First

                +

                Read This First

                The code in this example is not intended for production environments. @@ -94,10 +95,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
                -

                About This Example

                +

                About This Example

                +

                This example demonstrates the Menu Button Pattern for a button that displays a menu of link targets. The menu items are made from HTML links, so they maintain their HTML link behaviors. diff --git a/ARIA/apg/patterns/menu-button/menu-button-pattern.md b/ARIA/apg/patterns/menu-button/menu-button-pattern.md index 4dc578da5..6d829c59d 100644 --- a/ARIA/apg/patterns/menu-button/menu-button-pattern.md +++ b/ARIA/apg/patterns/menu-button/menu-button-pattern.md @@ -68,9 +68,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

                -
                +
                +

                Examples

                • Action Menu Button Example Using aria-activedescendant: A button that opens a menu of actions or commands where focus in the menu is managed using aria-activedescendant.
                • diff --git a/ARIA/apg/patterns/menubar/examples/menubar-editor.md b/ARIA/apg/patterns/menubar/examples/menubar-editor.md index 6c16eaec5..05d8a5d7e 100644 --- a/ARIA/apg/patterns/menubar/examples/menubar-editor.md +++ b/ARIA/apg/patterns/menubar/examples/menubar-editor.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/menubar/examples/menubar-editor/ sidebar: true -footer: " " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -67,6 +67,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

                  Read This First

                  +

                  Read This First

                  The code in this example is not intended for production environments. @@ -95,10 +96,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
                  -

                  About This Example

                  +

                  About This Example

                  +

                  The following example demonstrates using the Menubar Pattern to provide access to editing actions for a text area. Each item in the menubar identifies a category of text formatting actions that can be executed from its submenu. diff --git a/ARIA/apg/patterns/menubar/examples/menubar-navigation.md b/ARIA/apg/patterns/menubar/examples/menubar-navigation.md index 60084d2e3..dfb98e83c 100644 --- a/ARIA/apg/patterns/menubar/examples/menubar-navigation.md +++ b/ARIA/apg/patterns/menubar/examples/menubar-navigation.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/menubar/examples/menubar-navigation/ sidebar: true -footer: "

                  " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -66,6 +66,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

                  Read This First

                  +

                  Read This First

                  The code in this example is not intended for production environments. @@ -105,10 +106,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar'); For an example, see Example Disclosure Navigation Menu.
                - + +

                The following implementation of the Menubar Pattern demonstrates how a menubar can provide navigation menus. The parent menu items in the menubar represent a section of a mythical university web site and open a submenu containing menu items that link to pages within that section. diff --git a/ARIA/apg/patterns/menubar/menu-and-menubar-pattern.md b/ARIA/apg/patterns/menubar/menu-and-menubar-pattern.md index e122c3a81..a779de41a 100644 --- a/ARIA/apg/patterns/menubar/menu-and-menubar-pattern.md +++ b/ARIA/apg/patterns/menubar/menu-and-menubar-pattern.md @@ -77,9 +77,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

                A common convention for indicating that a menu item launches a dialog box is to append "…" (ellipsis) to the menu item label, e.g., "Save as …".

                -
                +
                +

                Examples

                • Editor Menubar Example: Demonstrates menu radios and menu checkboxes in submenus of a menubar that provides text formatting commands for a text field.
                • diff --git a/ARIA/apg/patterns/meter/examples/meter.md b/ARIA/apg/patterns/meter/examples/meter.md index aabc8a12f..64fd9f5c2 100644 --- a/ARIA/apg/patterns/meter/examples/meter.md +++ b/ARIA/apg/patterns/meter/examples/meter.md @@ -12,7 +12,7 @@ permalink: /ARIA/apg/patterns/meter/examples/meter/ sidebar: true -footer: " " +footer: " " # Context here: https://github.com/w3c/wai-aria-practices/issues/31 type_of_guidance: APG @@ -72,6 +72,7 @@ if (enableSidebar) document.body.classList.add('has-sidebar');

                  Read This First

                  +

                  Read This First

                  The code in this example is not intended for production environments. @@ -100,10 +101,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
                  -

                  About This Example

                  +

                  About This Example

                  +

                  The following example of a CPU meter demonstrates the Meter Pattern.

                  diff --git a/ARIA/apg/patterns/meter/meter-pattern.md b/ARIA/apg/patterns/meter/meter-pattern.md index 6ce8e7a7d..8beee95c4 100644 --- a/ARIA/apg/patterns/meter/meter-pattern.md +++ b/ARIA/apg/patterns/meter/meter-pattern.md @@ -78,9 +78,8 @@ if (enableSidebar) document.body.classList.add('has-sidebar');
                -
                +
                +

                Example

                Meter Example

                diff --git a/ARIA/apg/patterns/patterns.md b/ARIA/apg/patterns/patterns.md index 016248f72..d01717963 100644 --- a/ARIA/apg/patterns/patterns.md +++ b/ARIA/apg/patterns/patterns.md @@ -19,6 +19,14 @@ type_of_guidance: APG lang: en --- + + + +Patterns + + + +
                - {% include read-this-first.html %} + +
                +
                + Illustration of a brown-skinned woman with a slight smile gesturing towards the right with her hand +

                Read This First

                +

                + No ARIA is better than Bad ARIA. Before using any ARIA, read this to understand why. +

                +
                +
                + + +
                  - -
                • - -

                  - - Accordion (Sections With Show/Hide Functionality) -

                  -
                  -
                  - An accordion is a vertically stacked set of interactive headings that each contain a title, content snippet, or thumbnail representing a section of content.
                  -
                • - -
                • - -

                  - - Alert -

                  -
                  -
                  - An alert is an element that displays a brief, important message in a way that attracts the user's attention without interrupting the user's task.
                  -
                • - -
                • - -

                  - - Alert and Message Dialogs -

                  -
                  -
                  - An alert dialog is a modal dialog that interrupts the user's workflow to communicate an important message and acquire a response.
                  -
                • - -
                • - -

                  - - Breadcrumb -

                  -
                  -
                  - A breadcrumb trail consists of a list of links to the parent pages of the current page in hierarchical order.
                  -
                • - -
                • - -

                  - - Button -

                  -
                  -
                  - A button is a widget that enables users to trigger an action or event, such as submitting a form, opening a dialog, canceling an action, or performing a delete operation.
                  -
                • - - - -
                • - -

                  - - Checkbox -

                  -
                  -
                  WAI-ARIA supports two types of checkbox widgets: dual-state checkboxes toggle between two choices -- checked and not checked -- and tri-state checkboxes, which allow an additional third state known as partially checked.
                  -
                • - -
                • - -

                  - - Combobox -

                  -
                  -
                  - A combobox is an input widget that has an associated popup.
                  -
                • - -
                • - -

                  - - Dialog (Modal) -

                  -
                  -
                  - A dialog is a window overlaid on either the primary window or another dialog window.
                  -
                • - -
                • - -

                  - - Disclosure (Show/Hide) -

                  -
                  -
                  - A disclosure is a widget that enables content to be either collapsed (hidden) or expanded (visible).
                  -
                • - -
                • - -

                  - - Feed -

                  -
                  -
                  - A feed is a section of a page that automatically loads new sections of content as the user scrolls.
                  -
                • - -
                • - -

                  - - Grid (Interactive Tabular Data and Layout Containers) -

                  -
                  -
                  - A grid widget is a container that enables users to navigate the information or interactive elements it contains using directional navigation keys, such as arrow keys, Home, and End.
                  -
                • - -
                • - -

                  - - Landmarks -

                  -
                  -
                  - Landmarks are a set of eight roles that identify the major sections of a page.
                  -
                • - - - -
                • - -

                  - - Listbox -

                  -
                  -
                  - A listbox widget presents a list of options and allows a user to select one or more of them.
                  -
                • - -
                • - -

                  - - Menu and Menubar -

                  -
                  -
                  - A menu is a widget that offers a list of choices to the user, such as a set of actions or functions.
                  -
                • - -
                • - -

                  - - Menu Button -

                  -
                  -
                  - A menu button is a button that opens a menu as described in the Menu and Menubar Pattern.
                  -
                • - -
                • - -

                  - - Meter -

                  -
                  -
                  - A meter is a graphical display of a numeric value that varies within a defined range.
                  -
                • - -
                • - -

                  - - Radio Group -

                  -
                  -
                  - A radio group is a set of checkable buttons, known as radio buttons, where no more than one of the buttons can be checked at a time.
                  -
                • - -
                • - -

                  - - Slider -

                  -
                  -
                  - A slider is an input where the user selects a value from within a given range.
                  -
                • - -
                • - -

                  - - Slider (Multi-Thumb) -

                  -
                  -
                  - A multi-thumb slider implements the Slider Pattern but includes two or more thumbs, often on a single rail.
                  -
                • - -
                • - -

                  - - Spinbutton -

                  -
                  -
                  - A spinbutton is an input widget that restricts its value to a set or range of discrete values.
                  -
                • - -
                • - -

                  - - Switch -

                  -
                  -
                  - A switch is an input widget that allows users to choose one of two values: on or off.
                  -
                • - -
                • - -

                  - - Table -

                  -
                  -
                  - Like an HTML table element, a WAI-ARIA table is a static tabular structure containing one or more rows that each contain one or more cells; it is not an interactive widget.
                  -
                • - -
                • - -

                  - - Tabs -

                  -
                  -
                  - Tabs are a set of layered sections of content, known as tab panels, that display one panel of content at a time.
                  -
                • - -
                • - -

                  - - Toolbar -

                  -
                  -
                  A toolbar is a container for grouping a set of controls, such as buttons, menubuttons, or checkboxes.
                  -
                • - -
                • - -

                  - - Tooltip -

                  -
                  -
                  - A tooltip is a popup that displays information related to an element when the element receives keyboard focus or the mouse hovers over it.
                  -
                • - -
                • - -

                  - - Tree View -

                  -
                  -
                  - A tree view widget presents a hierarchical list.
                  -
                • - -
                • - -

                  - - Treegrid -

                  -
                  -
                  - A treegrid widget presents a hierarchical data grid consisting of tabular information that is editable or interactive.
                  -
                • - -
                • - -

                  - - Window Splitter -

                  -
                  -
                  - A window splitter is a moveable separator between two sections, or panes, of a window that enables users to change the relative size of the panes.
                  -
                • - +
                • + +

                  + + Accordion (Sections With Show/Hide Functionality) +

                  +
                  +
                  + An accordion is a vertically stacked set of interactive headings that each contain a title, content snippet, or thumbnail representing a section of content. +
                  +
                • + +
                • + +

                  + + Alert +

                  +
                  +
                  + An alert is an element that displays a brief, important message in a way that attracts the user's attention without interrupting the user's task. +
                  +
                • + +
                • + +

                  + + Alert and Message Dialogs +

                  +
                  +
                  + An alert dialog is a modal dialog that interrupts the user's workflow to communicate an important message and acquire a response. +
                  +
                • + +
                • + +

                  + + Breadcrumb +

                  +
                  +
                  + A breadcrumb trail consists of a list of links to the parent pages of the current page in hierarchical order. +
                  +
                • + +
                • + +

                  + + Button +

                  +
                  +
                  + A button is a widget that enables users to trigger an action or event, such as submitting a form, opening a dialog, canceling an action, or performing a delete operation. +
                  +
                • + +
                • + +

                  + + Carousel (Slide Show or Image Rotator) +

                  +
                  +
                  + A carousel presents a set of items, referred to as slides, by sequentially displaying a subset of one or more slides. +
                  +
                • + +
                • + +

                  + + Checkbox +

                  +
                  +
                  + WAI-ARIA supports two types of checkbox widgets: dual-state checkboxes toggle between two choices -- checked and not checked -- and tri-state checkboxes, which allow an additional third state known as partially checked. +
                  +
                • + +
                • + +

                  + + Combobox +

                  +
                  +
                  + A combobox is an input widget that has an associated popup. +
                  +
                • + +
                • + +

                  + + Dialog (Modal) +

                  +
                  +
                  + A dialog is a window overlaid on either the primary window or another dialog window. +
                  +
                • + +
                • + +

                  + + Disclosure (Show/Hide) +

                  +
                  +
                  + A disclosure is a widget that enables content to be either collapsed (hidden) or expanded (visible). +
                  +
                • + +
                • + +

                  + + Feed +

                  +
                  +
                  + A feed is a section of a page that automatically loads new sections of content as the user scrolls. +
                  +
                • + +
                • + +

                  + + Grid (Interactive Tabular Data and Layout Containers) +

                  +
                  +
                  + A grid widget is a container that enables users to navigate the information or interactive elements it contains using directional navigation keys, such as arrow keys, Home, and End. +
                  +
                • + +
                • + +

                  + + Landmarks +

                  +
                  +
                  + Landmarks are a set of eight roles that identify the major sections of a page. +
                  +
                • + +
                • + +

                  + + Link +

                  +
                  +
                  + A link widget provides an interactive reference to a resource. +
                  +
                • + +
                • + +

                  + + Listbox +

                  +
                  +
                  + A listbox widget presents a list of options and allows a user to select one or more of them. +
                  +
                • + +
                • + +

                  + + Menu and Menubar +

                  +
                  +
                  + A menu is a widget that offers a list of choices to the user, such as a set of actions or functions. +
                  +
                • + +
                • + +

                  + + Menu Button +

                  +
                  +
                  + A menu button is a button that opens a menu as described in the Menu and Menubar Pattern. +
                  +
                • + +
                • + +

                  + + Meter +

                  +
                  +
                  + A meter is a graphical display of a numeric value that varies within a defined range. +
                  +
                • + +
                • + +

                  + + Radio Group +

                  +
                  +
                  + A radio group is a set of checkable buttons, known as radio buttons, where no more than one of the buttons can be checked at a time. +
                  +
                • + +
                • + +

                  + + Slider +

                  +
                  +
                  + A slider is an input where the user selects a value from within a given range. +
                  +
                • + +
                • + +

                  + + Slider (Multi-Thumb) +

                  +
                  +
                  + A multi-thumb slider implements the Slider Pattern but includes two or more thumbs, often on a single rail. +
                  +
                • + +
                • + +

                  + + Spinbutton +

                  +
                  +
                  + A spinbutton is an input widget that restricts its value to a set or range of discrete values. +
                  +
                • + +
                • + +

                  + + Switch +

                  +
                  +
                  + A switch is an input widget that allows users to choose one of two values: on or off. +
                  +
                • + +
                • + +

                  + + Table +

                  +
                  +
                  + Like an HTML table element, a WAI-ARIA table is a static tabular structure containing one or more rows that each contain one or more cells; it is not an interactive widget. +
                  +
                • + +
                • + +

                  + + Tabs +

                  +
                  +
                  + Tabs are a set of layered sections of content, known as tab panels, that display one panel of content at a time. +
                  +
                • + +
                • + +

                  + + Toolbar +

                  +
                  +
                  + A toolbar is a container for grouping a set of controls, such as buttons, menubuttons, or checkboxes. +
                  +
                • + +
                • + +

                  + + Tooltip +

                  +
                  +
                  + A tooltip is a popup that displays information related to an element when the element receives keyboard focus or the mouse hovers over it. +
                  +
                • + +
                • + +

                  + + Tree View +

                  +
                  +
                  + A tree view widget presents a hierarchical list. +
                  +
                • + +
                • + +

                  + + Treegrid +

                  +
                  +
                  + A treegrid widget presents a hierarchical data grid consisting of tabular information that is editable or interactive. +
                  +
                • + +
                • + +

                  + + Window Splitter +

                  +
                  +
                  + A window splitter is a moveable separator between two sections, or panes, of a window that enables users to change the relative size of the panes. +
                  +
                +
                + +
                - {% include read-this-first.html %} + +
                +
                + Illustration of a brown-skinned woman with a slight smile gesturing towards the right with her hand +

                Read This First

                +

                + No ARIA is better than Bad ARIA. Before using any ARIA, read this to understand why. +

                +
                +
                + + +
                  - -
                • - -

                  - Landmark Regions -

                  -
                  -
                  - ARIA landmark roles provide a powerful way to identify the organization and structure of a web page.
                  -
                • - -
                • - -

                  - Providing Accessible Names and Descriptions -

                  -
                  -
                  - Providing elements with accessible names, and where appropriate, accessible descriptions, is one of the most important responsibilities authors have when developing accessible web experiences.
                  -
                • - -
                • - -

                  - Developing a Keyboard Interface -

                  -
                  -
                  - Unlike native HTML form elements, browsers do not provide keyboard support for graphical user interface (GUI) components that are made accessible with ARIA; authors have to provide the keyboard support in their code.
                  -
                • - -
                • - -

                  - Grid and Table Properties -

                  -
                  -
                  - To fully present and describe a grid or table, in addition to parsing the headers, rows, and cells using the roles described in the grid pattern or table pattern, assistive technologies need to be able to determine other structural and presentation characteristics, such as the number and visibility of rows and columns.
                  -
                • - - - -
                • - -

                  - Structural Roles -

                  -
                  -
                  - ARIA provides a set of roles that convey the accessibility semantics of structures on a page.
                  -
                • - -
                • - -

                  - Hiding Semantics with the presentation Role -

                  -
                  -
                  - While ARIA is primarily used to express semantics, there are some situations where hiding an element’s semantics from assistive technologies is helpful.
                  -
                • - +
                • + +

                  + Landmark Regions +

                  +
                  +
                  + ARIA landmark roles provide a powerful way to identify the organization and structure of a web page. +
                  +
                • + +
                • + +

                  + Providing Accessible Names and Descriptions +

                  +
                  +
                  + Providing elements with accessible names, and where appropriate, accessible descriptions, is one of the most important responsibilities authors have when developing accessible web experiences. +
                  +
                • + +
                • + +

                  + Developing a Keyboard Interface +

                  +
                  +
                  + Unlike native HTML form elements, browsers do not provide keyboard support for graphical user interface (GUI) components that are made accessible with ARIA; authors have to provide the keyboard support in their code. +
                  +
                • + +
                • + +

                  + Grid and Table Properties +

                  +
                  +
                  + To fully present and describe a grid or table, in addition to parsing the headers, rows, and cells using the roles described in the grid pattern or table pattern, assistive technologies need to be able to determine other structural and presentation characteristics, such as the number and visibility of rows and columns. +
                  +
                • + +
                • + +

                  + Communicating Value and Limits for Range Widgets +

                  +
                  +
                  + ARIA defines the following roles as range widgets, which means they communicate a value that is typically numeric and constrained to defined limits. +
                  +
                • + +
                • + +

                  + Structural Roles +

                  +
                  +
                  + ARIA provides a set of roles that convey the accessibility semantics of structures on a page. +
                  +
                • + +
                • + +

                  + Hiding Semantics with the presentation Role +

                  +
                  +
                  + While ARIA is primarily used to express semantics, there are some situations where hiding an element’s semantics from assistive technologies is helpful. +
                  +
                +