access-nyc-patterns

<!DOCTYPE html> <html class="bg-color-white text-size-0" lang="en"> <head> <meta charset="utf-8" /> <meta content="IE=edge" http-equiv="X-UA-Compatible" /> <meta content="width=device-width, initial-scale=1" name="viewport" /> <link href="images/apple-icon-57x57.png" rel="apple-touch-icon" sizes="57x57" /> <link href="images/apple-icon-60x60.png" rel="apple-touch-icon" sizes="60x60" /> <link href="images/apple-icon-72x72.png" rel="apple-touch-icon" sizes="72x72" /> <link href="images/apple-icon-76x76.png" rel="apple-touch-icon" sizes="76x76" /> <link href="images/apple-icon-114x114.png" rel="apple-touch-icon" sizes="114x114" /> <link href="images/apple-icon-120x120.png" rel="apple-touch-icon" sizes="120x120" /> <link href="images/apple-icon-144x144.png" rel="apple-touch-icon" sizes="144x144" /> <link href="images/apple-icon-152x152.png" rel="apple-touch-icon" sizes="152x152" /> <link href="images/apple-icon-180x180.png" rel="apple-touch-icon" sizes="180x180" /> <link href="images/android-icon-192x192.png" rel="icon" sizes="192x192" type="image/png" /> <link href="images/favicon-32x32.png" rel="icon" sizes="32x32" type="image/png" /> <link href="images/favicon-96x96.png" rel="icon" sizes="96x96" type="image/png" /> <link href="images/favicon-16x16.png" rel="icon" sizes="16x16" type="image/png" /> <meta content="#112E51" name="msapplication-TileColor" /> <meta content="images/ms-icon-144x144.png" name="msapplication-TileImage" /> <link href="images/favicon.ico" rel="icon" type="image/x-icon" /> <link href="styles/site-default.css" rel="stylesheet" /> <title>Buttons | ACCESS NYC Patterns</title><noscript> <style> body { visibility: visible !important; } </style> </noscript> <script type="text/javascript"> function load() { document.body.style.visibility = 'visible' }; </script> </head> <body class="bg-color-blue-dark" onload="load()" style="visibility: hidden;"><a class="sr-only" href="#main-content">Skip to main content</a> <div class="bg-color-white"> <header class="color-light-background px-2"> <div class="border-b border-color-grey-light"> <div class="flex items-center justify-between p-2 screen-tablet:py-4 screen-tablet:px-2"> <div> <h1 class="m-0 p-0 leading-normal"><a href="index"><span class="hidden">ACCESS NYC</span><svg aria-hidden="true" class="icon-logo-mark screen-tablet:hidden"> <use xlink:href="#icon-logo-mark"></use> </svg><svg aria-hidden="true" class="icon-logo-full--large text-color-blue-dark hidden screen-tablet:inline-block"> <use xlink:href="#icon-logo-full"></use> </svg></a></h1> </div> <div class="flex items-center"> <h2 class="text-font-size-small m-0 text-color-blue-dark screen-tablet:hidden">Patterns</h2> <h2 aria-hidden="true" class="type-h1 m-0 text-color-blue-dark hidden screen-tablet:inline-block">Patterns</h2> <nav class="text-font-size-small"><a class="rounded-lg text-color-blue-dark border-2 no-underline px-1 ml-2 hidden screen-tablet:inline-block" href="https://github.com/CityOfNewYork/access-nyc-patterns/tree/v0.8.0">0.8.0</a><a aria-hidden="true" class="ml-1 screen-tablet:ml-2 screen-tablet:hidden" href="https://github.com/CityOfNewYork/access-nyc-patterns/tree/v0.8.0">0.8.0</a><button aria-controls="main-menu" aria-expanded="false" class="btn-link ml-1 screen-tablet:ml-2" data-js="toggle" id="main-menu-control">Menu</button></nav> </div> </div> </div> </header> <aside aria-hidden="true" aria-labelledby="main-menu-control" class="color-mid-background text-font-size-small hidden hidden:overflowFadeInUp animated relative" id="main-menu" role="region" style="top: -1px"> <div class="page-wrapper py-4 animated"> <div class="screen-tablet:flex"> <nav class="screen-tablet:flex-1 mb-1 px-2"><a class="type-h3 text-font-size-small mb-1 block screen-tablet:border-b screen-tablet:pb-2 screen-tablet:mb-1 border-color-white p-1" href="index">Home</a><a class="block p-1" href="about">About</a><a class="block p-1" href="installation">Installation</a><a class="block p-1" href="design-tools">Design Tools</a><a class="block p-1 screen-tablet:border-b screen-tablet:pb-2 screen-tablet:mb-1 border-color-white p-1" href="developer-tools">Developer Tools</a><a class="block p-1" href="https://www.npmjs.com/package/access-nyc-patterns">NPM</a><a class="block p-1" href="https://github.com/CityOfNewYork/access-nyc-patterns">GitHub</a></nav> <nav class="screen-tablet:flex-1 mb-1 px-2 screen-desktop:pl-4"><span class="type-h3 text-font-size-small mb-1 block screen-tablet:border-b screen-tablet:pb-2 screen-tablet:mb-1 border-color-white p-1">Elements</span><a class="block p-1" href="buttons">Buttons</a><a class="block p-1" href="checkboxes">Checkboxes</a><a class="block p-1" href="dividers">Dividers</a><a class="block p-1" href="inputs">Inputs</a><a class="block p-1" href="layouts">Layouts</a><a class="block p-1" href="links">Links</a><a class="block p-1" href="lists">Lists</a><a class="block p-1" href="nav">Nav</a><a class="block p-1" href="program-labels">Program Labels</a><a class="block p-1" href="radios">Radios</a><a class="block p-1" href="tables">Tables</a><a class="block p-1" href="tooltips">Tooltips</a><a class="block p-1" href="toggles">Toggles</a><a class="block p-1" href="selects">Selects</a></nav> <nav class="screen-tablet:flex-1 mb-1 px-2 screen-desktop:pl-4"><span class="type-h3 text-font-size-small mb-1 block screen-tablet:border-b screen-tablet:pb-2 screen-tablet:mb-1 border-color-white p-1">Components</span><a class="block p-1" href="accordion">Accordion</a><a class="block p-1" href="alert-box">Alert Box</a><a class="block p-1" href="alert-banner">Alert Banner</a><a class="block p-1" href="card">Card</a><a class="block p-1" href="checklist">Checklist</a><a class="block p-1" href="disclaimer">Disclaimer</a><a class="block p-1" href="filter">Filter</a><a class="block p-1" href="header">Header</a><a class="block p-1" href="member-list">Member List</a><a class="block p-1" href="nearby-stops">Nearby Stops</a><a class="block p-1" href="share-form">Share Form</a><a class="block p-1" href="side-nav">Side Nav</a><a class="block p-1" href="text-controller">Text Controller</a><a class="block p-1" href="question">Question</a></nav> <nav class="screen-tablet:flex-1 mb-1 px-2 screen-desktop:pl-4"><span class="type-h3 text-font-size-small mb-1 block screen-tablet:border-b screen-tablet:pb-2 screen-tablet:mb-1 border-color-white p-1">Objects</span><a class="block p-1" href="announcements">Announcements</a><a class="block p-1" href="banner">Banner</a><a class="block p-1" href="card-list">Card Lists</a><a class="block p-1" href="content">Content</a><a class="block p-1" href="footer">Footer</a><a class="block p-1" href="formstack">Formstack</a><a class="block p-1" href="mobile-nav">Mobile Nav</a><a class="block p-1" href="navigation">Navigation</a><a class="block p-1" href="newsletter">Newsletter</a><a class="block p-1" href="search-box">Search Box</a></nav> <nav class="screen-tablet:flex-1 mb-1 px-2 screen-desktop:pl-4"><a class="type-h3 text-font-size-small mb-1 block screen-tablet:border-b screen-tablet:pb-2 screen-tablet:mb-1 border-color-white p-1" href="utility">Utilities</a><a class="block p-1" href="accessibility">Accessibility</a><a class="block p-1" href="colors">Colors</a><a class="block p-1" href="cookie">Cookie</a><a class="block p-1" href="font">Fonts</a><a class="block p-1" href="icons">Icons</a><a class="block p-1" href="inherit">Inherit</a><a class="block p-1" href="language">Language</a><a class="block p-1" href="media">Media</a><a class="block p-1" href="text">Text</a><a class="block p-1" href="toggle">Toggle</a><a class="block p-1" href="typography">Typography</a></nav> </div> <div class="text-center"><button aria-controls="main-menu" aria-expanded="false" class="btn-link" data-js="toggle">Close Menu</button></div> </div> </aside> <main class="color-light-background pt-4" id="main-content"> <article class="pt-4"> <header class="page-wrapper px-2 screen-desktop:px-0 layout--home-body"> <div class="my-0 w-full"> <h1 class="text-color-blue-dark px-2 pb-4 mb-4">Buttons</h1> </div> </header> <section class="pb-4 mb-4"> <div class="page-wrapper px-2"> <header class="layout--home-body"> <div class="my-0 px-2 pt-1 pb-4 border-b border-color-grey-light"> <div> <p class="text-font-size-small m-0">Source: <code><a href="https://github.com/CityOfNewYork/access-nyc-patterns/tree/v0.8.0/src/elements/buttons">src/elements/buttons/buttons</a></code></p> </div> </div> </header> <div class="layout--home-body"> <div class="my-0 pt-4 px-2 text-font-size-small table-align-start"><p>The base button class, <code>.btn</code>, is extended with either <code>.btn-primary</code> or <code>.btn-secondary</code>. Any button type class can be added by the the primary or secondary class (see examples below).</p> <p>There are two types for Button Elements:</p> <ul> <li>Buttons associated with functionality (Primary, Blue).</li> <li>Buttons that navigate users through a set of pages, such as through the program pages (Secondary, Green).</li> </ul> <h3>Markup</h3> <p>Buttons should be written using the <code><button></code> html tag. However, if a button is an <code><a></code> tag styled with the <code>.btn</code> class and has in-page functionality (such as toggling elements), the <code>role</code> attribute should be set to "button" and the <code>tabindex</code> attribute should be set to "0." Refer to the best practices illustrated in the <a href="https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/button_role#Best_practices">MDN documentation for the "button" role</a>.</p> <p>If the button is a <code><button></code> element and appears within a <code><form></code> tag, the <code>type</code> attribute should be explicitly set to "submit," "reset," or "submit." By default (without the type attribute) <code><button></code> elements are set to the "submit" type.</p></div> </div> <div class="layout--gutter screen-tablet:layout--columns justify-between pt-4"> <div class="screen-tablet:pr-2"><button class="btn" type="button">Button</button></div> <div> <div class="code-block mb-1"><pre><button class="btn" type="button">Button</button></pre> </div> </div> </div> </div> </section> <section class="pb-4 mb-4" id="primary-button"> <div class="page-wrapper px-2"> <header class="layout--home-body"> <div class="my-0 px-2 pt-1 pb-4 border-b border-color-grey-light"> <h2 class="m-0"><a class="text-color-grey-mid font-normal no-underline capitalize" href="#primary-button">Primary Button</a></h2> <div class="pt-2"> <p class="text-font-size-small m-0">Source: <code><a href="https://github.com/CityOfNewYork/access-nyc-patterns/tree/v0.8.0/src/elements/buttons">src/elements/buttons/buttons-primary</a></code></p> </div> </div> </header> <div class="layout--home-body"> <div class="my-0 pt-4 px-2 text-font-size-small table-align-start"><p>Primary Button Elements are used for functional actions and in some cases have an icon to the left of the call-to-action.</p></div> </div> <div class="layout--gutter screen-tablet:layout--columns justify-between pt-4"> <div class="screen-tablet:pr-2"><button class="btn-primary" type="button">Primary Button</button></div> <div> <div class="code-block mb-1"><pre><button class="btn-primary" type="button">Primary Button</button></pre> </div> </div> </div> </div> </section> <section class="pb-4 mb-4" id="secondary-button"> <div class="page-wrapper px-2"> <header class="layout--home-body"> <div class="my-0 px-2 pt-1 pb-4 border-b border-color-grey-light"> <h2 class="m-0"><a class="text-color-grey-mid font-normal no-underline capitalize" href="#secondary-button">Secondary Button</a></h2> <div class="pt-2"> <p class="text-font-size-small m-0">Source: <code><a href="https://github.com/CityOfNewYork/access-nyc-patterns/tree/v0.8.0/src/elements/buttons">src/elements/buttons/buttons-secondary</a></code></p> </div> </div> </header> <div class="layout--home-body"> <div class="my-0 pt-4 px-2 text-font-size-small table-align-start"><p>Secondary Button Elements are used for navigation.</p></div> </div> <div class="layout--gutter screen-tablet:layout--columns justify-between pt-4"> <div class="screen-tablet:pr-2"><button class="btn-secondary" type="button">Secondary Button</button></div> <div> <div class="code-block mb-1"><pre><button class="btn-secondary" type="button">Secondary Button</button></pre> </div> </div> </div> </div> </section> <section class="pb-4 mb-4" id="small-button"> <div class="page-wrapper px-2"> <header class="layout--home-body"> <div class="my-0 px-2 pt-1 pb-4 border-b border-color-grey-light"> <h2 class="m-0"><a class="text-color-grey-mid font-normal no-underline capitalize" href="#small-button">Small Button</a></h2> <div class="pt-2"> <p class="text-font-size-small m-0">Source: <code><a href="https://github.com/CityOfNewYork/access-nyc-patterns/tree/v0.8.0/src/elements/buttons">src/elements/buttons/buttons-small</a></code></p> </div> </div> </header> <div class="layout--home-body"> <div class="my-0 pt-4 px-2 text-font-size-small table-align-start"><p>The small button modifier will decrease any button font size to .727rem.</p></div> </div> <div class="layout--gutter screen-tablet:layout--columns justify-between pt-4"> <div class="screen-tablet:pr-2"><button class="btn-primary btn-small" type="button">Small Button</button></div> <div> <div class="code-block mb-1"><pre><button class="btn-primary btn-small" type="button">Small Button</button></pre> </div> </div> </div> </div> </section> <section class="pb-4 mb-4" id="normal-button"> <div class="page-wrapper px-2"> <header class="layout--home-body"> <div class="my-0 px-2 pt-1 pb-4 border-b border-color-grey-light"> <h2 class="m-0"><a class="text-color-grey-mid font-normal no-underline capitalize" href="#normal-button">Normal Button</a></h2> <div class="pt-2"> <p class="text-font-size-small m-0">Source: <code><a href="https://github.com/CityOfNewYork/access-nyc-patterns/tree/v0.8.0/src/elements/buttons">src/elements/buttons/buttons-normal</a></code></p> </div> </div> </header> <div class="layout--home-body"> <div class="my-0 pt-4 px-2 text-font-size-small table-align-start"><p>The <code>btn-normal</code> class allows for setting responsive button sizes for tablet and desktop screens. This button will appear smaller on screens less than desktop width using the <code>screen-desktop:</code> media query utility.</p></div> </div> <div class="layout--gutter screen-tablet:layout--columns justify-between pt-4"> <div class="screen-tablet:pr-2"><button class="btn-primary btn-small screen-desktop:btn-normal" type="button">Normal Button</button></div> <div> <div class="code-block mb-1"><pre><button class="btn-primary btn-small screen-desktop:btn-normal" type="button">Normal Button</button></pre> </div> </div> </div> </div> </section> <section class="pb-4 mb-4" id="tag-button"> <div class="page-wrapper px-2"> <header class="layout--home-body"> <div class="my-0 px-2 pt-1 pb-4 border-b border-color-grey-light"> <h2 class="m-0"><a class="text-color-grey-mid font-normal no-underline capitalize" href="#tag-button">Tag Button</a></h2> <div class="pt-2"> <p class="text-font-size-small m-0">Source: <code><a href="https://github.com/CityOfNewYork/access-nyc-patterns/tree/v0.8.0/src/elements/buttons">src/elements/buttons/buttons-tag</a></code></p> </div> </div> </header> <div class="layout--home-body"> <div class="my-0 pt-4 px-2 text-font-size-small table-align-start"><p>Tag Button Elements are associated with related programs. Clicking on a tag should bring up the programs page filtered to the appropriate tag.</p></div> </div> <div class="layout--gutter screen-tablet:layout--columns justify-between pt-4"> <div class="screen-tablet:pr-2"><button class="btn-primary btn-tag" type="button">Tag</button></div> <div> <div class="code-block mb-1"><pre><button class="btn-primary btn-tag" type="button">Tag</button></pre> </div> </div> </div> </div> </section> <section class="pb-4 mb-4" id="toggle-button"> <div class="page-wrapper px-2"> <header class="layout--home-body"> <div class="my-0 px-2 pt-1 pb-4 border-b border-color-grey-light"> <h2 class="m-0"><a class="text-color-grey-mid font-normal no-underline capitalize" href="#toggle-button">Toggle Button</a></h2> <div class="pt-2"> <p class="text-font-size-small m-0">Source: <code><a href="https://github.com/CityOfNewYork/access-nyc-patterns/tree/v0.8.0/src/elements/buttons">src/elements/buttons/buttons-toggle</a></code></p> </div> </div> </header> <div class="layout--home-body"> <div class="my-0 pt-4 px-2 text-font-size-small table-align-start"><p>Toggle Button Elements are used to change the state or appearance of another target element. This example uses the JavaScript <a href="/toggle">Toggle Utility</a> for interactivity and accessibility. Additionally, refer to the <a href="/toggle">Toggle Utility documentation</a> for different toggling animation options.</p></div> </div> <div class="layout--gutter screen-tablet:layout--columns justify-between pt-4"> <div class="screen-tablet:pr-2"><button aria-controls="btn-toggle-target" aria-expanded="true" class="btn-toggle btn-primary mb-2" data-js="toggle" id="btn-toggle" type="button">Toggle Button</button> <div aria-hidden="false" class="bg-color-blue-light p-4 text-center active" id="btn-toggle-target">Toggle button target element</div> </div> <div> <div class="code-block mb-1"><pre><button aria-controls="btn-toggle-target" aria-expanded="true" class="btn-toggle btn-primary mb-2" data-js="toggle" id="btn-toggle" type="button">Toggle Button</button> <div aria-hidden="false" class="bg-color-blue-light p-4 text-center active" id="btn-toggle-target">Toggle button target element</div></pre> </div> </div> </div> </div> </section> <section class="pb-4 mb-4" id="link-button"> <div class="page-wrapper px-2"> <header class="layout--home-body"> <div class="my-0 px-2 pt-1 pb-4 border-b border-color-grey-light"> <h2 class="m-0"><a class="text-color-grey-mid font-normal no-underline capitalize" href="#link-button">Link Button</a></h2> <div class="pt-2"> <p class="text-font-size-small m-0">Source: <code><a href="https://github.com/CityOfNewYork/access-nyc-patterns/tree/v0.8.0/src/elements/buttons">src/elements/buttons/buttons-link</a></code></p> </div> </div> </header> <div class="layout--home-body"> <div class="my-0 pt-4 px-2 text-font-size-small table-align-start"><p>The Link Button Element appears as a hyperlink but because it is marked up as a button element, assistive technologies will convey interactions as they would for buttons.</p></div> </div> <div class="layout--gutter screen-tablet:layout--columns justify-between pt-4"> <div class="screen-tablet:pr-2"><button class="btn-link" type="button">Link Button</button></div> <div> <div class="code-block mb-1"><pre><button class="btn-link" type="button">Link Button</button></pre> </div> </div> </div> </div> </section> <section class="pb-4 mb-4" id="text-button"> <div class="page-wrapper px-2"> <header class="layout--home-body"> <div class="my-0 px-2 pt-1 pb-4 border-b border-color-grey-light"> <h2 class="m-0"><a class="text-color-grey-mid font-normal no-underline capitalize" href="#text-button">Text Button</a></h2> <div class="pt-2"> <p class="text-font-size-small m-0">Source: <code><a href="https://github.com/CityOfNewYork/access-nyc-patterns/tree/v0.8.0/src/elements/buttons">src/elements/buttons/buttons-text</a></code></p> </div> </div> </header> <div class="layout--home-body"> <div class="my-0 pt-4 px-2 text-font-size-small table-align-start"></div> </div> <div class="layout--gutter screen-tablet:layout--columns justify-between pt-4"> <div class="screen-tablet:pr-2"><button class="btn-text" type="button">Plain Text Button</button></div> <div> <div class="code-block mb-1"><pre><button class="btn-text" type="button">Plain Text Button</button></pre> </div> </div> </div> </div> </section> <section class="pb-4 mb-4" id="next-button"> <div class="page-wrapper px-2"> <header class="layout--home-body"> <div class="my-0 px-2 pt-1 pb-4 border-b border-color-grey-light"> <h2 class="m-0"><a class="text-color-grey-mid font-normal no-underline capitalize" href="#next-button">Next Button</a></h2> <div class="pt-2"> <p class="text-font-size-small m-0">Source: <code><a href="https://github.com/CityOfNewYork/access-nyc-patterns/tree/v0.8.0/src/elements/buttons">src/elements/buttons/buttons-next</a></code></p> </div> </div> </header> <div class="layout--home-body"> <div class="my-0 pt-4 px-2 text-font-size-small table-align-start"><p>Next Button Elements prompt the user to navigate to the next page or view.</p></div> </div> <div class="layout--gutter screen-tablet:layout--columns justify-between pt-4"> <div class="screen-tablet:pr-2"><button class="btn-secondary btn-next" type="button">Next Button</button></div> <div> <div class="code-block mb-1"><pre><button class="btn-secondary btn-next" type="button">Next Button</button></pre> </div> </div> </div> </div> </section> <section class="pb-4 mb-4" id="previous-button"> <div class="page-wrapper px-2"> <header class="layout--home-body"> <div class="my-0 px-2 pt-1 pb-4 border-b border-color-grey-light"> <h2 class="m-0"><a class="text-color-grey-mid font-normal no-underline capitalize" href="#previous-button">Previous Button</a></h2> <div class="pt-2"> <p class="text-font-size-small m-0">Source: <code><a href="https://github.com/CityOfNewYork/access-nyc-patterns/tree/v0.8.0/src/elements/buttons">src/elements/buttons/buttons-previous</a></code></p> </div> </div> </header> <div class="layout--home-body"> <div class="my-0 pt-4 px-2 text-font-size-small table-align-start"><p>Previous Button Elements prompt the user to navigate back to the previous page or view.</p></div> </div> <div class="layout--gutter screen-tablet:layout--columns justify-between pt-4"> <div class="screen-tablet:pr-2"><button class="btn-secondary btn-previous" type="button">Previous Button</button></div> <div> <div class="code-block mb-1"><pre><button class="btn-secondary btn-previous" type="button">Previous Button</button></pre> </div> </div> </div> </div> </section> <div class="sticky bottom-0 bg-color-white shadow-up relative z-10 overflow-y-scroll whitespace-no-wrap animated fadeInUp"> <nav class="nav-inline text-font-size-small p-4"><span class="mr-4">Jump to:</span><a class="mr-4" href="#primary-button">Primary Button</a><a class="mr-4" href="#secondary-button">Secondary Button</a><a class="mr-4" href="#small-button">Small Button</a><a class="mr-4" href="#normal-button">Normal Button</a><a class="mr-4" href="#tag-button">Tag Button</a><a class="mr-4" href="#toggle-button">Toggle Button</a><a class="mr-4" href="#link-button">Link Button</a><a class="mr-4" href="#text-button">Text Button</a><a class="mr-4" href="#next-button">Next Button</a><a class="mr-4" href="#previous-button">Previous Button</a></nav> </div> </article> </main> </div> <footer class="py-4 text-center color-dark-background"> <p> <nav><a class="px-1" href="index">Home</a><a class="px-1" href="about">About</a><a class="px-1" href="installation">Installation</a><a class="px-1" href="design-tools">Design Tools</a><a class="px-1" href="developer-tools">Developer Tools</a></nav> </p> <p>Maintained by <a href="https://nyc.gov/opportunity">NYC Opportunity</a></p> <p class="m-0"> <nav><a class="px-1" href="https://github.com/orgs/CityOfNewYork/teams/nycopportunity">GitHub</a><a class="px-1" href="https://twitter.com/nycopportunity">Twitter</a><a class="px-1" href="https://www.facebook.com/NYCOpportunity">Facebook</a><a class="px-1" href="https://www.instagram.com/nycopportunity">Instagram</a></nav> </p> </footer> <script src="scripts/polyfills.js"></script> <script src="scripts/access-nyc.js"></script> <script src="scripts/vue-components.js"></script> <script type="text/javascript"> var access = new AccessNyc(); var VueComponents = new VueComponents(); access.icons(); access.toggle(); access.alertBanner(); </script> </body> </html>