`). As of v3.x, the plugin creates a list; so, this root element _must_ be a non-list container element (e.g., ``).\n\n### Using Automatic Discovery (default, [example](example.html))\nBy default, the plugin will search for the first element in the DOM with the `vjs-playlist` class.\n\nTo defend against problems caused by multiple playlist players on a page, the plugin will only use an element with the `vjs-playlist` class if that element has not been used by another player's playlist.\n\n### Using a Custom Class ([example](example-custom-class.html))\nA custom `className` option can be passed to override the class the plugin will search for to find the root element. The same defense against multiple playlist players is reused in this case.\n\n```js\nplayer.playlistUi({\n className: 'hello-world'\n});\n```\n\n### Using a Custom Element ([example](example-custom-element.html))\nA custom element can be passed using the `el` option to explicitly define a specific root element.\n\n```js\nplayer.playlistUi({\n el: document.getElementById('hello-world')\n});\n```\n\n## Other Options\n\nThe options passed to the plugin are passed to the internal `PlaylistMenu` [video.js Component][components]; so, you may pass in [any option][components-options] that is accepted by a component.\n\nIn addition, the options object may contain the following specialized properties:\n\n#### `className`\nType: `string`\nDefault: `\"vjs-playlist\"`\n\nAs mentioned [above](#using-a-custom-class), the name of the class to search for to populate the playlist menu.\n\n#### playOnSelect\nType: `boolean`\nDefault: `false`\n\nThe default behavior is that the play state is expected to stay the same between videos. If the player is playing when switching playlist items, continue playing. If paused, stay paused.\n\nWhen this boolean is set to `true`, clicking on the playlist menu items will always play the video.\n\n## Playlists and Advertisements\n\nThe `PlaylistMenu` automatically adapts to ad integrations based on [videojs-contrib-ads][contrib-ads]. When a linear ad is being played, the menu will darken and stop responding to click or touch events. If you'd prefer to allow your viewers to change videos during ad playback, you can override this behavior through CSS. You will also need to make sure that your ad integration is properly cancelled and cleaned up before switching -- consult the documentation for your ad library for details on how to do that.\n\n\n[components]: https://videojs.com/guides/components/\n[components-options]: https://videojs.com/guides/components/#using-options\n[contrib-ads]: https://github.com/videojs/videojs-contrib-ads\n","readmeFilename":"README.md"}