`; omitting parameters reverts values to its defaults; see Reference Information below | ### HTML Data Attributes | Data Attribute | Description | | ------------- | ------------- | | `data-articulate-ignore` | Content from that DOM element and its descendents are ignored | | `data-articulate-recognize` | Content from that DOM element is spoken, overriding the default | | `data-articulate-spell` | Content from that DOM element is spelled out | | `data-articulate-prepend=text` | Specified *text* is spoken prior to the content of its DOM element | | `data-articulate-append=text` | Specified *text* is spoken after to the content of its DOM element | | `data-articulate-swap=text` | Specified *text* is spoken in place of the content of its DOM element | ### Miscellaneous ```html ``` Specified *text* is spoken when encountered in the HTML; the syntax must match exactly — one space separating the opening and closing `` tags and their neighboring comment markers ### Reference Information Chaining calls is acceptable. For example, the following works just fine: ```javascript $('article').articulate('rate',1.3).articulate('speak'); ``` **Ignored Tags:** audio, button, canvas, code, del, dialog, dl, embed, form, head, iframe, meter, nav, noscript, object, s, script, select, style, textarea, video | HTML Tag | Default Prepend Text | Default Append Text | | ------------- | ------------- | ------------- | | `` | There's an embedded image with the description, | n/a | | `

` | Blockquote start. | Blockquote end. | **Note:** A comma followed by a space results in a pause when spoken; a period results in a slightly longer pause ### Examples ```javascript $().articulate('ignore','h5','h6','em'); // Do not speak the content of

,

, and tags ``` ```javascript $().articulate('recognize','button','code'); // Speak the content of and tags ``` ```javascript $().articulate('replace','i.e.','That is'); // When 'i.e.' is encountered, say 'That is' ``` ```javascript $().articulate('customize','img','Embedded'); // Change default intro text spoken when is encountered ``` ```javascript $().articulate('customize','ol','Start of numbered List.','End of Numbered List'); // Change default intro and outro text spoken when

is encountered ``` -------------- ```html

The Gettysburg Address

Despite the speech's prominent place in the history and popular culture of the United States, the exact wording and location of the speech are disputed. The five known manuscripts of the Gettysburg Address in Lincoln's hand differ in a number of details, and also differ from contemporary newspaper reprints of the speech.

Modern scholarship locates the speakers' platform 40 yards (or more) away from the Traditional Site within Soldiers' National Cemetery at the Soldiers' National Monument and entirely within private, adjacent Evergreen Cemetery.

``` Using `$('div.speech').articulate('speak');` The above will be spoken as: > An analysis of The Gettysburg Address. Despite the speech's prominent place in the history and popular culture of the United States of America, the exact wording and location of the speech are disputed. The five known manuscripts of the Gettysburg Address in Lincoln's hand differ in a number of details, and also differ from contemporary newspaper reprints of the speech. Experienced researchers locate the speakers' platform 40 yards away from the Traditional Site within Soldiers' National Cemetery at the Soldiers' National Monument and entirely within private, adjacent Evergreen Cemetery. This is the end of the article. ## Share Links [Facebook](https://www.facebook.com/sharer.php?u=https%3A%2F%2Fgithub.com%2Facoti%2Farticulate.js) [Twitter](https://twitter.com/intent/tweet?url=https%3A%2F%2Fgithub.com%2Facoti%2Farticulate.js&text=A%20jQuery%20plugin%20that%20lets%20the%20browser%20speak%20to%20you.) [LinkedIn](https://www.linkedin.com/shareArticle?mini=true&url=https%3A%2F%2Fgithub.com%2Facoti%2Farticulate.js) ## About Adam Coti I've been a freelance front-end Web developer for over eighteen years. My availability varies, but feel free to contact me if you're interested in the services I offer. My Web site with portfolio and client list is at [www.purefreedom.com](http://www.purefreedom.com). Also, take a look at some recent articles I've written for [CSS-Tricks](https://css-tricks.com/author/adamcoti/).