diff --git a/src/data/components.json b/src/data/components.json index e45566068..279016f95 100644 --- a/src/data/components.json +++ b/src/data/components.json @@ -409,7 +409,7 @@ "Video": { "url": "/components/video", "designLink": "https://ibm.box.com/s/9q7rdj73m32hufcw1xwl1td6nr88rghm", - "description": "Video allows you to embed Kaltura videos from the media center in various ways throughout a page.", + "description": "Video allows you to embed videos from Media Center throughout a page, using the IBM standard video player, Kaltura.", "storybook": { "webcomponents": "http://www.ibm.com/standards/carbon/web-components/?path=/story/components-video-player--default", "reactwrapper": "https://www.ibm.com/standards/carbon/web-components/react/?path=/story/components-video-player--default" diff --git a/src/pages/components/video.mdx b/src/pages/components/video.mdx index 1727e9ea4..edfcc1546 100644 --- a/src/pages/components/video.mdx +++ b/src/pages/components/video.mdx @@ -1,6 +1,6 @@ --- title: Video -description: The Video component allows you to embed Kaltura videos from the media center in various ways throughout a page. +description: Video allows you to embed videos from Media Center throughout a page, using the IBM standard video player, Kaltura. --- import ComponentDescription from 'components/ComponentDescription'; @@ -11,19 +11,18 @@ import ResourceLinks from 'components/ResourceLinks'; -Resources Overview +Resources Content guidance Feedback - ## Overview The video component defaults to the aspect ratio of the source video, or one of the standard aspect ratios specified -below can be used instead. In most cases 16x9 is recommended. +in the [content guidance](#content-guidance) table can be used instead. In most cases, 16:9 is recommended. By default, the component is prefilled with content returned from the Kaltura service. You can override this default content and provide a custom video title, description, and poster image. If the content is optional for the component @@ -45,6 +44,8 @@ The latter is recommended for a more immersive viewing experience. Example of a video inside lightbox media viewer + + ## Content guidance | Element | Content type | Required | Instances | Character limit
(English / translated) | Notes | @@ -53,7 +54,7 @@ The latter is recommended for a more immersive viewing experience. | Video title | Text | No | 1 | 65 / 85 | Optional overide of default title appears as caption under poster image. Video duration appended to title. | | Video description | Text | No | 1 | 200 / 260 | Default populates but can be overridden. Only appears in [Lightbox media viewer](./lightbox-media-viewer). | | Play mode | Option list | No | 1 | – | In-line (default), lightbox. | -| Aspect ratio | Option list | No | 1 | – | Default is 16x9. Other ratios are 9x16, 2x1, 1x2, 4x3, 3x4, 1x1. | +| Aspect ratio | Option list | No | 1 | – | Default is 16:9. Other ratios are 9:16, 2:1, 1:2, 4:3, 3:4, 1:1. | | Poster image | [Image](https://www.ibm.com/standards/carbon/components/images) | No | 1 | – | Default to poster image from video source. Optional overide. | For more information, see the [character count standards](https://www.ibm.com/standards/carbon/guidelines/content#character-count-standards).