{"id":31,"date":"2018-04-27T14:55:48","date_gmt":"2018-04-27T14:55:48","guid":{"rendered":"https:\/\/sites.neoninspire.com\/style-guide\/?page_id=31"},"modified":"2018-06-01T22:03:57","modified_gmt":"2018-06-01T22:03:57","slug":"usage","status":"publish","type":"page","link":"https:\/\/sites.neoninspire.com\/style-guide\/components\/buttons\/usage\/","title":{"rendered":"Buttons Usage"},"content":{"rendered":"<p>Components<\/p>\n<h1>\n\t\tButtons<br \/>\n\t<\/h1>\n<h4>\n\t\tButtons are best used to enable a user to commit a change or complete steps in a task. They are typically found inside forms, dialogs, panels or pages. An example of their usage is confirming the deletion of a file in a confirmation dialog.<br \/>\n\t<\/h4>\n<h2>\n\t\tPlacement<br \/>\n\t<\/h2>\n<p>When considering where to place a button, contemplate the order in which a user will flow through the UI. For example, a user\u00a0 will need to read and interact with a form&#8217;s text fields before submitting the form. Therefore, in mose cases, the submit button should be placed at the bottom of the UI container.<\/p>\n<p>While buttons can technically be used to navigate a user to another part of the experience, this is not recommended unless that navigation is part of an action or their flow.<\/p>\n<h2>\n\t\tVariants<br \/>\n\t<\/h2>\n<h5>\n\t\tButton Type<br \/>\n\t<\/h5>\n<h5>\n\t\tPurpose<br \/>\n\t<\/h5>\n<p><strong>Primary<\/strong><\/p>\n<p><strong>Secondary<\/strong><\/p>\n<p><strong>Danger<\/strong><\/p>\n<p><strong>Text<\/strong><\/p>\n<p><strong>Button with Icon<\/strong><\/p>\n<p><strong>Like<\/strong><\/p>\n<p><strong>Disabled<\/strong><\/p>\n<p>For the principle call to action on the page.<\/p>\n<p>For secondary actions on each page.\u00a0<\/p>\n<p>When an action has harmful intentions to the user&#8217;s data (delete, remove, etc.)<\/p>\n<p>When an action does not require primary dominance on the page.<\/p>\n<p>Icons can be used in buttons to better communicate what the button does. Icons are always paired with text. There are three variants ; left icon, right icon, stacked icon<\/p>\n<p>Heart shaped button with SVG animation. Used for favoriting an account<\/p>\n<p>Use when a user cannot proceed until an input is collected<\/p>\n<h2>\n\t\tBest Practices<br \/>\n\t<\/h2>\n<h4>\n\t\t<a href=\"#\" title=\"Do\" target=\"_self\"><br \/>\n\t\tDo<br \/>\n\t\t<\/a><br \/>\n\t<\/h4>\n<ul>\n<li>Make sure the label conveys a clear purpose of the button to the user.<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<ul>\n<li>Button labels must describe the action the button will perform and should include a verb. Use concise, specific, self-explanatory labels, usually a single word.<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<ul>\n<li>Buttons should always include a noun if there is any room for interpretation about what the verb operates on.<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<ul>\n<li>Use only a single line of text in the label of the button.<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<ul>\n<li>Expose only one or two buttons to the user at a time, for example, &#8220;Accept&#8221; and &#8220;Cancel&#8221;. If you need to expose more actions to the user, consider using checkboxes or radio buttons from which the user can select actions, with a single command button to trigger those actions.<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<ul>\n<li>Show only one primary button that inherits theme color at rest state. In the event there are more than two buttons with equal priority, all buttons should have neutral backgrounds.<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<ul>\n<li>&#8220;Submit&#8221;, &#8220;OK&#8221;, and &#8220;Apply&#8221; buttons should always be styled as primary buttons. When &#8220;Reset&#8221; or &#8220;Cancel&#8221; buttons appear alongside one of the above, they should be styled as text buttons.<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<ul>\n<li>Default buttons should always perform safe operations. For example, a default button should never delete.<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<h4>\n\t\t<a href=\"#\" title=\"Don&#039;t\" target=\"_self\"><br \/>\n\t\tDon&#8217;t<br \/>\n\t\t<\/a><br \/>\n\t<\/h4>\n<ul>\n<li>Don&#8217;t use generic labels like &#8220;Ok,&#8221; especially in the case of an error; errors are never &#8220;Ok.&#8221;<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<ul>\n<li>Don\u2019t use a button to navigate to another place, use a link instead. The exception is in a stepper where &#8220;Back&#8221; and &#8220;Next&#8221; buttons may be used.<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<ul>\n<li>Don\u2019t put too much text in a button &#8211; try to keep the length of your text to a minimum.<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Components Buttons Buttons are best used to enable a user to commit a change or complete steps in a task. They are typically found inside forms, dialogs, panels or pages. An example of their usage is confirming the deletion of a file in a confirmation dialog. Placement When considering where to place a button, contemplate&hellip;<\/p>\n","protected":false},"author":32,"featured_media":0,"parent":681,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"inline_featured_image":false,"footnotes":""},"class_list":["post-31","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/sites.neoninspire.com\/style-guide\/wp-json\/wp\/v2\/pages\/31","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/sites.neoninspire.com\/style-guide\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/sites.neoninspire.com\/style-guide\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/sites.neoninspire.com\/style-guide\/wp-json\/wp\/v2\/users\/32"}],"replies":[{"embeddable":true,"href":"https:\/\/sites.neoninspire.com\/style-guide\/wp-json\/wp\/v2\/comments?post=31"}],"version-history":[{"count":65,"href":"https:\/\/sites.neoninspire.com\/style-guide\/wp-json\/wp\/v2\/pages\/31\/revisions"}],"predecessor-version":[{"id":1182,"href":"https:\/\/sites.neoninspire.com\/style-guide\/wp-json\/wp\/v2\/pages\/31\/revisions\/1182"}],"up":[{"embeddable":true,"href":"https:\/\/sites.neoninspire.com\/style-guide\/wp-json\/wp\/v2\/pages\/681"}],"wp:attachment":[{"href":"https:\/\/sites.neoninspire.com\/style-guide\/wp-json\/wp\/v2\/media?parent=31"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}