\n```\n\n## Initialize the plugin\n\n```js\njqueryI18next.init(i18nextInstance, $, {\n tName: 't', // --> appends $.t = i18next.t\n i18nName: 'i18n', // --> appends $.i18n = i18next\n handleName: 'localize', // --> appends $(selector).localize(opts);\n selectorAttr: 'data-i18n', // selector for translating elements\n targetAttr: 'i18n-target', // data-() attribute to grab target element to translate (if different than itself)\n optionsAttr: 'i18n-options', // data-() attribute that contains options, will load/set if useOptionsAttr = true\n useOptionsAttr: false, // see optionsAttr\n parseDefaultValueFromContent: true // parses default values from content ele.val or ele.text\n});\n```\n\n## TypeScript\n\njquery-i18next ships with type definitions. The `init` options are fully typed, and (when you keep the default handle names) `$.t`, `$.i18n` and `$(selector).localize(opts)` are added to the jQuery types via [`@types/jquery`](https://www.npmjs.com/package/@types/jquery).\n\n```ts\nimport i18next from 'i18next';\nimport jqueryI18next from 'jquery-i18next';\n\njqueryI18next.init(i18next, $, {\n useOptionsAttr: true, // typed, autocompleted and checked\n});\n\n$('.nav').localize();\n$('#btn1').localize({ count: 2 });\nconst home: string = $.t('nav.home');\n```\n\n> If you rename the handles (`tName` / `i18nName` / `handleName`), the bundled jQuery augmentation still reflects the default names — type those custom members yourself via module augmentation.\n\n## using options in translation function\n\n```js\n\n$(\"#btn1\").localize(options);\n```\n\nor\n\n```js\n\n$(\"#btn1\").localize();\n// make sure you set the useOptionsAttr option to true if you want to pass the i18n options via data-i18n-options attribute.\n```\n\n`data-i18n-options` attribute must be a valid JSON object.\n\n## usage of selector function\n\n### translate an element\n\n```js\n\n$(\"#btn1\").localize(options);\n```\n\nmyKey: same key as used in i18next (optionally with namespaces)\noptions: same options as supported in i18next.t\n\n### translate children of an element\n\n```js\n
\n
\n
\n
\n
\n$(\".nav\").localize();\n```\n\n### translate some inner element\n```js\n
\n \n
\n$(\".outer\").localize();\n```\n\n### set different attribute\n```js\n\n$(\"#btn1\").localize();\n```\n\n### set multiple attributes\n```js\n\n$(\"#btn1\").localize();\n```\n\n### set innerHtml attributes\n```js\n\n$(\"#btn1\").localize();\n```\n\n### prepend content\n```js\ninsert before me, please!\n$(\"#btn1\").localize();\n```\n\n### append content\n```js\nappend after me, please!\n$(\"#btn1\").localize();\n```\n\n### set data\n```js\n\n$(\"#btn1\").localize();\n```\n\n--------------\n\n
![](\"https://raw.githubusercontent.com/i18next/i18next/master/assets/locize_sponsor_240.gif\")
\n \n